What problem does it solve?
This skill prevents the common pitfall of symptom-based patching, which often leads to wasted time, recurring issues, and the introduction of new bugs. It provides a structured, pressure-resistant methodology to ensure you identify and resolve the actual root cause of any technical failure.
Core Features & Use Cases
- Four-Phase Framework: Guides you through investigation, pattern analysis, hypothesis testing, and implementation.
- Anti-Shortcut Guardrails: Explicitly identifies and blocks common debugging traps like shotgun debugging or skipping tests under time pressure.
- Root Cause Tracing: Includes techniques for tracing data flow and adding diagnostic instrumentation to complex, multi-component systems.
- Use Case: Use this when you are facing a persistent production bug, a flaky test suite, or a complex integration failure where previous attempts to fix the issue have failed.
Quick Start
Load the systematic-debugging skill and follow the phase-by-phase checklist to investigate the root cause of the current test failure.