What problem does it solve?
Random or superficial fixes waste time, introduce new bugs, and leave the underlying causes unresolved. This Skill enforces a disciplined, evidence-driven workflow so engineers reliably identify and fix root causes instead of masking symptoms.
Core Features & Use Cases
- Four-phase, checklist-driven process: Root Cause Investigation, Pattern Analysis, Hypothesis & Testing, Implementation with stop conditions.
- Pressure-resistant guidance: Explicit anti-patterns, red flags, and language to resist rushed or social-pressure-driven shortcuts.
- Practical tools and references: Includes tracing and instrumentation techniques, a bisection helper for test pollution, condition-based waiting patterns, and defense-in-depth validation strategies to make bugs structurally impossible.
- Use cases: Debugging flaky tests, diagnosing production incidents, investigating integration failures across components, and preventing repeated symptom fixes during code reviews.
Quick Start
Run the four-phase systematic debugging checklist on the failing test or incident, gather evidence at component boundaries, form a single hypothesis, create a minimal failing test, and verify the single fix before committing.