src/bmm-skills/4-implementation/bmad-investigate/references/case-file-template.md
| Field | Value |
|---|---|
| Ticket | {ticket-id or "N/A"} |
| Date opened | {date} |
| Status | Active |
| System | {OS, version, relevant environment details} |
| Evidence sources | {diagnostic archive, logs, crash dump, code, version control, etc.} |
{User-reported description; the initial claim. May be refined or contradicted by evidence.}
| Source | Status | Notes |
|---|---|---|
| {source} | {Available / Partial / Missing} | {details} |
| # | Path to Explore | Priority | Status | Notes |
|---|---|---|---|---|
| 1 | {description} | {High / Medium / Low} | {Open / In Progress / Done / Blocked} | {context} |
| Time | Event | Source | Confidence |
|---|---|---|---|
| {timestamp} | {event description} | {log file, commit, …} | {Confirmed / Deduced} |
Evidence: {citation — path:line, log timestamp, or commit hash}
Detail: {description}
Based on: {which Confirmed Findings}
Reasoning: {logical chain}
Conclusion: {what follows}
Status: {Open / Confirmed / Refuted}
Theory: {description}
Supporting indicators: {what makes this plausible}
Would confirm: {specific evidence that would prove this}
Would refute: {specific evidence that would disprove this}
Resolution: {when Status changes from Open, what evidence settled it}
| Gap | Impact | How to Obtain |
|---|---|---|
| {what's missing} | {what it would confirm or eliminate} | {how to get it} |
| Element | Detail |
|---|---|
| Error origin | {file:line, function name} |
| Trigger | {what causes this code to execute} |
| Condition | {what state produces the observed behavior} |
| Related files | {other files in the same code path} |
Confidence: {High / Medium / Low}
{Summary stating what is Confirmed vs. what remains Hypothesized. If a root cause is identified, state it; otherwise name the most promising hypothesized paths and what would resolve the remaining uncertainty.}
{What needs to change and why. Categorize by mechanism when multiple issues combine.}
{Steps to confirm the root cause: additional logging, targeted tests, data to collect.}
{Setup, trigger, expected results. Scale from isolated proof to full system reproduction.}
Tangential observations surfaced during the investigation, evidence-graded, with citation when applicable.