/diagnose-root

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.

BOOST

danielvm-git@danielvm-git

GitHub

From plugin

bigpowers

26781 skills1 hook1 MCP

Install

$ npx -y skills add danielvm-git/bigpowers --skill diagnose-root --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/diagnose-root

Context preview

The summary Claude sees to decide when to auto-load this skill.

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.

SKILL.md

diagnose-root.SKILL.md

name: diagnose-root
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.
model: sonnet
effort: standard

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 ]`

Read it on GitHub ↗

Ships withbigpowers

Agent skills synthesizing 17 years of software engineering discipline — from Clean Code to AI-native architecture — into a single, prescriptive methodology for solo developers.

Get the whole plugin

Stats

TypeScript JavaScript Node React Next.js

+7 tags

HTML Bash Git GitHub Anthropic Gemini MCP

267

Stars

Forks

Active

Maintenance

Shell

Language