investigate

Installation
SKILL.md

Investigate

Systematic debugging skill that enforces the Iron Law: never fix without a confirmed root cause. Produces a structured debug report with full evidence chain, minimal fix, and regression test.

Iron Law Principle

No fix without confirmed root cause. Every investigation follows a strict evidence chain:

  1. Reproduce the bug with concrete evidence
  2. Analyze patterns to assess scope
  3. Form and test hypotheses (max 3 strikes)
  4. Implement minimal fix ONLY after root cause is confirmed
  5. Verify fix and generate structured report

Violation of the Iron Law (skipping to Phase 4 without Phase 3 confirmation) is prohibited.

Key Design Principles

  1. Evidence-First: Collect before theorizing. Logs, stack traces, and reproduction steps are mandatory inputs.
  2. Minimal Fix: Change only what is necessary. Refactoring is not debugging.
Related skills
Installs
8
GitHub Stars
2.0K
First Seen
Apr 6, 2026