What problem does it solve? Debugging under pressure often devolves into guessing, symptom patches, and stacked fixes that never address the real cause. This Skill enforces a disciplined root-cause-first method so bugs get fixed at the source and verified with evidence instead of workarounds. ## Core Features & Use Cases - Structured five-phase method: Frame and reproduce, investigate with file:line evidence, hypothesize and test one variable at a time, fix with a failing test first, then verify against the project's real gate. - Root-cause tracing toolkit: Reference guides cover backward call-chain tracing, defense-in-depth validation layers, condition-based waiting to replace flaky timeouts, and a bisection script that finds which test pollutes shared state. - Workaround catalog: A categorized catalog of 30 anti-patterns (type evasion, error swallowing, timing hacks, monkey patching) with the proper fix for each. - Use Case: A test suite creates a stray .git directory in source code. The Skill traces the empty projectDir back through five call levels to its origin, fixes the source, and adds validation at every layer. ## Quick Start Ask the agent to diagnose why a specific test or behavior is failing and fix the root cause rather than the symptom.
