What problem does it solve?
This Skill prevents wasted time and recurring bugs by forcing you to locate the root cause of failures instead of applying symptom-based patches.
Core Features & Use Cases
- Root-cause-first debugging: Enforces the Iron Law that no fixes happen until Phase 1 evidence is gathered.
- Pressure-resistant process: Uses explicit stop conditions (especially when fixes fail or time pressure hits) to prevent rationalizations.
- Phase-driven workflow: Provides a structured progression through investigation, pattern analysis, hypothesis/testing, and implementation/verification.
- Supports debugging across layers: Includes guidance for multi-component systems and backward tracing when the bug appears deep in the call stack.
Use cases: test failures, production bugs, unexpected behavior, build/integration issues, and flaky systems where timing/races are likely.
Quick Start
Use the systematic-debugging skill to debug any failing test or unexpected behavior by following the four required phases and refusing to propose fixes until Phase 1 root-cause investigation is complete.