What problem does it solve?
This Skill enforces a disciplined diagnostic workflow to find the true root cause of errors, crashes, unexpected behavior, and failing tests before any code changes are made, preventing symptom-only patches that introduce new bugs.
Core Features & Use Cases
- Hypothesis-first diagnosis: Require a one-sentence, testable hypothesis naming a specific file, function, or line before attempting fixes.
- Targeted instrumentation & verification: Add the smallest possible instrument (log line, test, or assertion) to validate or falsify the hypothesis and seek independent corroborating evidence.
- Hard rules and escalation: Stop after repeated failed hypotheses, enumerate environment differences, grep to confirm identifiers, and report a concise outcome that includes root cause, fix, and confirmation evidence.
- Use Case: Reproduce a failing CI test, name the exact suspected file:line, add a minimal assertion or log, confirm with two independent evidence points, and only then implement and test the fix.
Quick Start
State a one-sentence, testable hypothesis identifying the exact file:line and add one targeted instrument to prove or disprove it before proposing any fix.