What problem does it solve?
Systematic debugging that prevents whack-a-mole fixes by forcing root cause investigation before any change. It turns vague bug reports and intermittent failures into a concrete, testable hypothesis and a minimal, verifiable fix.
Core Features & Use Cases
- Structured phases: collect symptoms, read code, check recent changes, reproduce, hypothesize, test, and implement a minimal fix with a regression test.
- Scope locking and safety: supports freeze checks to limit edits to the affected module and avoids broad, unverified changes.
- Verification-first workflow: requires reproducing the issue, instrumenting to confirm hypotheses, running the full test suite, and producing a structured debug report.
- Use Case: reproduce a failing CI test, trace the failure to a recent commit, write a small fix plus a regression test, and run the suite to prove the problem is resolved.
Quick Start
Invoke the investigate skill with a concise symptom, reproduction steps, and any error output or failing test names so it can form a root cause hypothesis and propose a verified fix.