What problem does it solve?
Many debugging attempts treat symptoms with quick patches that mask underlying causes, causing repeat failures, flaky tests, and wasted time. Systematic Debugging forces a repeatable, evidence-driven approach so engineers find and fix the true root cause instead of repeatedly reworking symptoms.
Core Features & Use Cases
- Four-phase workflow: mandated phases for investigation, pattern analysis, hypothesis testing, and implementation to ensure disciplined progress.
- Reproducibility and tracing: techniques for consistent reproduction, stack-trace backward tracing, and instrumentation to locate original triggers.
- Defensive practices: guidance on creating failing tests, defense-in-depth validation, and condition-based waiting to eliminate timing-related flakiness.
- Decision guidance under pressure: pressure-test scenarios and red-flag heuristics to avoid rushed, harmful shortcuts during incidents.
Quick Start
Use the systematic-debugging skill to diagnose a failing test by reproducing it, tracing the call chain to a single root cause, forming a minimal hypothesis, and creating a failing test before fixing.