What problem does it solve?
Provides a disciplined four-phase methodology to investigate, reproduce, and resolve software bugs and test failures so fixes address root causes rather than symptoms.
Core Features & Use Cases
- Root Cause Investigation: Reproduce issues, read full error messages, collect logs, and trace the call chain to the original trigger.
- Pattern Analysis: Compare failing implementations with working examples and identify dependency or assumption differences.
- Hypothesis-driven Testing: Formulate one clear hypothesis, design a minimal test, and iterate until the cause is confirmed.
- Implementation Guardrails: Create failing tests, implement a minimal fix that targets the root cause, run the full suite, and stop if multiple fixes fail.
- Use Case: Diagnose flaky CI test failures, trace runtime exceptions to their origin, or perform git bisect to find breaking commits.
Quick Start
Use the systematic-debugging skill to reproduce the failure, trace the upstream cause, create a minimal failing test, and propose a single root-cause fix.