What problem does it solve?
Systematic Debugging prevents wasted time and recurring regressions by replacing guesswork and quick symptom fixes with a disciplined, evidence-driven process that locates and fixes the true root cause of bugs, test failures, and unexpected behavior.
Core Features & Use Cases
- Four-phase workflow: explicit phases for investigation, pattern analysis, hypothesis testing, and implementation to ensure you never propose fixes before understanding the problem.
- Instrumentation and tracing: guidance on layered logging, stack trace capture, and cross-component data flow tracing to find where failures originate.
- Defenses and validation: defense-in-depth patterns and test-first verification to make bugs structurally impossible and prevent regressions.
- Practical tools and examples: includes scripts and patterns for finding polluting tests, condition-based waiting, and concrete test-case creation scenarios for CI and local debugging.
Quick Start
Use the systematic-debugging skill to reproduce the failure, gather layered evidence, form a single testable hypothesis, and run the smallest change to verify the root cause before implementing a fix.