Debug

Systematic root-cause analysis — reproduce, isolate, hypothesize, fix, verify.

Process

1. Read the error — full message, stack trace, error code. Don't skip this.
2. Reproduce reliably — minimal steps before touching any code.
3. Isolate — binary search via git bisect, comment blocks, or minimal repro.
4. Hypothesize — one specific theory. Don't change multiple things at once.
5. Test hypothesis — add logging, use debugger, modify code.
6. Apply minimal fix — smallest change that addresses root cause, not symptoms.
7. Verify — confirm fix works and no regressions.

Diagnosis Checklist

Start here before touching code: