Debugging
Follow the loop: reproduce → isolate → hypothesize → fix → verify.
- Reproduce with the smallest possible case; write it down as a failing test first.
- Isolate by bisecting: halve the input, disable half the code, check git blame for recent changes.
- Read the actual error and stack trace — top frame first, then the first frame in OUR code.
- Hypothesize ONE cause at a time; change one thing, re-run, observe.
- Fix at the root, not the symptom; add the regression test before closing.
- Verify: full related suite green, no new warnings. If stuck after 30 minutes, shrink the repro further or explain the system state out loud in the timeline.