| name | debug |
| description | Use for bugs, unexpected behavior, regressions, or failing tests you did not write. |
Debug
- Reproduce. Minimal deterministic repro. No repro -> no fix.
- Root-cause. Ask "why" until one cause explains all symptoms. Symptoms != cause.
- Regression test first (red), then fix at the root (green). Use
tdd.
Don't
- Guess. Read the code and the full error.
- Change two things at once.
- Stop at the first plausible cause.
3 failed hypotheses -> re-read from scratch. Done = repro + regression test + root cause named + green.