What problem does it solve?
Random fixes and guesswork lead to wasted time, recurring regressions, and brittle code; this skill enforces a disciplined approach so you fix the true source of bugs rather than symptoms.
Core Features & Use Cases
- Four-phase workflow: explicit phases for Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation to prevent premature fixes.
- Evidence-driven diagnosis: instructions for reproducing issues, multi-component instrumentation, and backward tracing to locate the original trigger.
- Pressure-resistant rules: anti-patterns, stop-gates, and failure-mode guidance to resist time pressure and authority bias.
- Supporting techniques: condition-based waiting, defense-in-depth validation, and bisection helpers to find polluting tests or flaky behaviors.
- Use cases: reproducing and fixing flaky tests, diagnosing production errors, tracing deep call-stack failures, and avoiding shotgun fixes during emergencies.
Quick Start
Run the systematic-debugging skill to investigate a failing test, gather cross-component evidence, form a single hypothesis, and produce a minimal failing test plus a targeted fix.