| name | debug-session |
| description | Start a structured debugging session for an error or unexpected behavior. Use when encountering bugs or test failures. |
Debug Session
Structured debugging workflow for: $ARGUMENTS
Process
- Reproduce — get a minimal reproduction
- Isolate — binary search to find the smallest failing case
- Hypothesize — form 2-3 hypotheses about root cause
- Test each hypothesis with targeted logging/reading
- Fix the root cause, not symptoms
- Verify fix doesn't break other tests
- Document what was found in a comment or ADR
See debugging-patterns.md for common patterns.