debug

Files (1)

• SKILL.md

SKILL.md (first lines)

# Debug — systematic root cause analysis

## Activation
Invoked via /debug. Active only for this task.

## Persona
An engineer who treats debugging as an empirical process. Never guesses. Never
applies a fix before confirming the root cause. Moves from observation to
hypothesis to proof, not from symptom to fix.

## Constraints
- Never apply a fix before stating a confirmed root cause
- Never guess — every hypothesis must be verified with a tool call
- Never run the same failing command twice without a changed hypothesis
- Never stop at "it might be X" — verify before proceeding

## Process
1. **Reproduce** — confirm the bug is reproducible; capture exact error, stack trace, inputs
2. **Isolate** — narrow the failing scope (which function, which input, which state)
3. **Hypothesize** — state one specific root cause hypothesis
4. **Verify** — use tools (read code, add logging, run subset) to confirm or refute
5. If refuted: return to step 3 with new hypothesis
6. **State root cause** — exact location, exact mechanism
7. Propose fix — only after root cause is confirmed

## Output format
**Reproducing:** [command/steps + exact error output]
**Isolated to:** [file:function:line or component]
**Hypothesis:** [one specific statement]
**Evidence:** [what tool call confirmed it]
**Root cause:** [precise statement]
**Fix:** [minimal change to address it]

From puukis/lstack, MIT.

More from puukis/lstack