What problem does it solve?
Random quick fixes and guesswork hide true causes, waste time, introduce regressions, and prolong outages; this Skill guides a disciplined, repeatable process to find and fix root causes rather than symptoms.
Core Features & Use Cases
- Four-phase, stepwise workflow: mandatory Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, and Implementation.
- Reproducibility and instrumentation: reproduce issues consistently, add diagnostics across component boundaries, and collect evidence before changing code.
- Hypothesis-driven minimal changes: test one variable at a time, create a failing reproduction, and verify fixes before proceeding.
- Defense-in-depth: add validation at multiple layers to make classes of bugs structurally impossible.
- Adapts to contexts: useful for production incidents, flaky tests, build or integration failures, and multi-component tracing.
Quick Start
Open the systematic-debugging skill and follow Phase 1 to reproduce the issue, gather targeted evidence across layers, form a single hypothesis, test with the smallest change, and then implement the verified root-cause fix.