Systematic Debugging

Leverage native parallel subagent dispatch and 200k+ context windows where available.

Quick Cheat Sheet

Phase	Goal	Minimum Evidence	Key Red Flags
1. Root Cause	Reproduce and isolate the failure	Real error output, stable repro or repro notes, and boundary evidence	Proposing a fix before tracing inputs or recent changes
2. Pattern Analysis	Compare the broken path to a working reference	A concrete diff between working and failing behavior	Hand-waving away small differences as irrelevant
3. Hypothesis and Testing	Test one explanation at a time	One explicit hypothesis and one minimal experiment	Bundling multiple fixes into the same attempt
4. Implementation	Fix the confirmed cause and verify it stays fixed	Failing test or repro first, passing verification after	Calling it done without rerunning the evidence path

Random fixes waste time and create new bugs. Quick patches mask underlying issues.

Core principle: ALWAYS find root cause before attempting fixes. Symptom fixes are failure.