Summary
- Structured debugging workflow for reproducing, minimizing, and fixing hard bugs and performance regressions.
- Prioritizes building a fast, deterministic feedback loop (failing test, curl script, CLI fixture, browser automation, or replay harness) before any hypothesis testing—the loop is the core skill Requires explicit reproduction confirmation, ranked falsifiable hypotheses, and targeted instrumentation mapped to specific predictions before attempting fixes Includes techniques for non-deterministic bugs (raising reproduction rate through loops and stress), performance regressions (baseline measurement and bisection), and cases where no loop is possible (explicit stop with artifact requests) Enforces regression test writing at the correct architectural seam before applying fixes, cleanup of debug instrumentation, and post-mortem analysis to identify preventative architectural changes