What problem does it solve?
This Skill enforces diagnosing the true root cause of errors, crashes, unexpected behavior, and failing tests before any code changes are made, preventing symptom-only patches and regression cascades.
Core Features & Use Cases
- Evidence-first diagnosis: Require a one-sentence, testable hypothesis that names a specific file, function, line, or condition and cites supporting evidence.
- Progress signals & instrumentation: Recommend a single targeted instrument (log line, failing assertion, or minimal test) to confirm or refute the hypothesis before applying a fix.
- Hard safety rules: Enforce environment verification, grep-before-edit, stop after three failed hypotheses with user escalation, and avoid editing from memory.
- Use Case: When a CI test suddenly fails or a runtime crash appears, run this Skill to trace execution paths, validate hypotheses with concrete evidence, and produce a minimal, testable fix plan.
Quick Start
Ask the hunt skill to diagnose the root cause of the failing test and propose one minimal instrument to confirm it before making any code changes.