five-whys

Drives root-cause analysis by iteratively questioning why and updating AGENTS.md.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/dmooney/Rundale --skill five-whys-dmooney
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: five-whys
Source: https://github.com/dmooney/Rundale/tree/main/.agents/skills/five-whys
Command: npx skills add https://github.com/dmooney/Rundale --skill five-whys-dmooney

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Five Whys helps you stop chasing symptoms by drilling into the underlying cause of a bug, regression, incident, or unexpected behavior until the true driver is found.

Core Features & Use Cases

  • Iterative root-cause questioning: Ask "why?" repeatedly, using each answer as the next question target to progressively move from surface effects toward the real cause.
  • Evidence-first answers: Answers must be verifiable facts (from logs, code, tests, or measurements), not assumptions, to keep the analysis accurate.
  • Prevention-focused closure: Conclude by checking what is missing from AGENTS.md (rules, enforcement, mode-parity coverage, test gaps, or conventions) and proposing the needed change alongside the fix.

Use when you’re investigating a failing test, a regression after an update, a CI/incident mystery, or any behavior that surprises users and can’t be resolved confidently without understanding why it happens.

Quick Start

Use the five-whys approach to analyze a specific issue by stating the exact observed problem, answering each "why?" with a verifiable fact, and continuing for about five iterations until you identify the root cause and the prevention change needed in AGENTS.md.

Frequently Asked Questions about five-whys

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of a test failure or regression?

Root cause analysis for test failures and regressions is found by iteratively asking "why" until the underlying issue is identified. Each answer must be an evidence-based fact from logs or code, preventing you from merely treating symptoms instead of the actual failure mechanism.

What is the best way to investigate an incident without chasing symptoms?

Incident review requires evidence-based root cause analysis, repeatedly questioning why the issue occurred until the true driver is found. This disciplined approach stops you from fixing surface effects and ensures the actual failure mechanism is addressed before resolution.

How do I conduct evidence-based debugging for unexpected software behavior?

Evidence-based debugging involves asking "why" repeatedly, demanding verifiable facts from logs, tests, or measurements for each answer. This prevents assumptions from corrupting your root cause analysis when investigating unexpected behavior or CI mysteries.

How do I prevent recurring bugs after a root cause analysis?

Preventing recurring bugs requires updating AGENTS.md with missing rules, enforcement, or test coverage identified during root cause analysis. This final prevention step ensures the systemic gap that allowed the failure is closed alongside the immediate fix.

When should I stop asking why during root cause analysis?

You should stop asking why during root cause analysis when a disciplined stop condition is met, typically after about five iterations. The process concludes once you identify the underlying cause and the specific prevention change needed in AGENTS.md.