diagnose-root · git:20260726.2ca3448 · 2026-07-26 · sha256 15d7839d2f647913
diagnose-root git:20260726.2ca3448A
Immutable. This exact content never changes and is served at /api/v1/blob/15d7839d2f647913.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_2ronm3abdtpw4wbl/15d7839d2f647913e9978bbe66323a68908cc75550bdfaa6bae7a51e4c5ff04c.json
Then /plugin install diagnose-root@markdownregistry-2ronm3abdtpw4wbl in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: diagnose-root model: sonnet description: "Run 4-phase root cause analysis — reproduce, isolate, hypothesize, verify. Use when a bug is confirmed but root cause is unclear, after investigate-bug, or when user mentions root cause analysis." --- # Diagnose Root **Boundary**: Canonical, reusable 4-phase RCA engine. Invoked by `investigate-bug` (as step 2 of the end-to-end flow) and by `fix-bug` (when no bug file exists). Does not write the bug file — that is `investigate-bug`'s responsibility. Four phases — do not skip. Update the active `specs/bugs/BUG-*.md` file at each phase. ## Phases 1. **Reproduce** — minimal steps; record environment; capture logs. 2. **Isolate** — narrow to module/function; binary-search commits or config. 3. **Hypothesize** — list ranked hypotheses with falsification test each. 4. **Verify** — run falsification; confirm single root cause; link to fix plan. > **HARD GATE** — Do not propose a fix until phase 4 confirms one root cause with evidence. ## Verify → verify: `[ "$(grep -lE 'Reproduce' specs/bugs/BUG-*.md 2>/dev/null | grep -cv "\.okf\.md$")" -ge 1 ]`