What problem does it solve?
Systematic debugging provides a disciplined, phase-driven approach to diagnosing and resolving bugs by focusing on root causes rather than quick symptom fixes, reducing rework and firefighting.
It enforces a four-phase process and mandates root-cause investigation before proposing changes, leveraging anti-pattern awareness and defense-in-depth practices to make failures traceable and prevent regression.
Core Features & Use Cases
- Phase-based workflow with four clearly defined stages: Root Cause Investigation, Pattern Analysis, Hypothesis and Testing, and Implementation.
- Mandatory Phase 1 before any fixes are proposed to ensure root causes are understood.
- Anti-patterns and red-flag guidance that resist rushing or guessing under time pressure.
- Defense-in-depth approach: validate data and behavior across multiple layers and add contextual instrumentation.
- References and templates to trace data flow, verify hypotheses, and verify fixes.
Use Case: When debugging a flaky test, a production incident, or a performance regression, follow the process to identify the actual trigger and prevent recurring issues.
Quick Start
Load the skill, begin with Phase 1: Root Cause Investigation, then proceed through Phases 2–4 following the defined steps and anti-pattern guidance.
