What problem does it solve?
It prevents wasted time and new regressions by forcing you to investigate the true root cause of bugs, test failures, and unexpected behavior instead of applying random fixes.
Core Features & Use Cases
- Root-cause-first debugging mandate: Use the “Iron Law” to avoid proposing any fixes until Phase 1 (root cause investigation) is complete.
- Four-phase process: Follow Investigation → Pattern Analysis → Hypothesis & Testing → Implementation, with explicit rules for moving forward and handling failure.
- Pressure-resistant guardrails: Includes anti-shortcuts and clear stop conditions (e.g., do not add more fixes after a failed hypothesis; question architecture after 3+ failures).
- Works for many failure types: Applies to production bugs, CI/build failures, flaky tests, integration issues, performance problems, and deep call-stack errors.
Quick Start
Use this skill when you hit a bug or test failure and start at Phase 1 by reading errors carefully, reproducing the issue consistently, and tracing data flow backward until you identify the root cause.