What problem does it solve?
This Skill prevents guess-and-check debugging by forcing a disciplined root-cause investigation before any implementation changes.
Core Features & Use Cases
- Root-cause-first debugging: Guides you through investigation, pattern analysis, hypothesis testing, and only then implementation.
- Evidence gathering in multi-component systems: Prompts you to instrument boundaries (CIābuildāsigning, APIāserviceāDB, etc.) so you can pinpoint where failures occur.
- Controlled change discipline: Requires a failing test case, a single fix, and verification before claiming the issue is resolved.
- Use Case: When a CI build fails after a dependency or config change, this Skill helps you reproduce the failure, identify the failing component, test a minimal hypothesis, then validate the fix with tests and verification.
Quick Start
Use the debug skill for this task: Investigate the failing test, identify the root cause using the four phases, then propose a single-root-cause fix with a failing test and a verification plan.