What problem does it solve?
This Skill enforces an investigation-first workflow to reliably identify root causes of software bugs and failing tests so that fixes do not introduce regressions.
Core Features & Use Cases
- Reproduce & Trace: Reproduce issues consistently and trace data flow from user action through event handlers, services, APIs, and databases to find where data first diverges.
- Hypothesis-Driven Testing: Form explicit hypotheses, validate them with logs, console outputs or debugger, and confirm the cause before changing code.
- Controlled Fixing & Escalation: Require the smallest possible fix with a failing regression test added first, and apply a 3-strike rule that stops attempts and escalates when fixes fail.
- Use Case: A frontend developer traces a mismatched UI value back to an API query, writes a failing test, verifies the hypothesis with logging, implements a minimal fix, and documents the investigation.
Quick Start
Use the investigate skill to trace the failing test's data flow, verify the root cause with logs or a debugger, add a failing regression test, then apply the minimal fix.