five-whys-root-cause
Paste into Claude Code, Claude.ai, the desktop app, or the browser extension — ⌘/Ctrl+V. ✓ Copied. Switch to Claude and paste — ⌘/Ctrl+V.
Five Whys Root-Cause Analysis
Trace a stated problem back to its actionable root cause using structured Five Whys chains. Produces a cause chain, a fishbone diagram (Ishikawa), and root-cause recommendations calibrated for digital-experience and content-operations contexts.
When this skill applies
- User states a problem and wants to understand why it happens
- Discovery interviews have surfaced a recurring pain point the team needs to understand before designing a solution
- A platform is underperforming and the team wants to separate symptoms from causes
- Post-launch retrospective: understanding why a launch issue occurred
Workflow
Step 1 — State the problem clearly
A good problem statement is:
- Observable — something you can see or measure
- Specific — not "the website is bad" but "content authors spend an average of 3 extra hours per week duplicating content across two systems"
- Bounded — describes one failure mode, not a cluster
If the user's problem statement is vague, offer a more specific version and ask for confirmation before proceeding.
Step 2 — Run the Five Whys chain
Starting from the problem statement, ask "Why does this happen?" iteratively. For each answer:
- Ground the answer in evidence from the provided material where possible; flag assumptions where evidence is absent
- Test whether the answer is a cause or just another symptom — if it could still ask "why?", it is a symptom
- Stop when you reach a root cause — something that, if addressed, would prevent the symptom from recurring — or when you hit a system boundary (regulatory constraint, irreversible resource decision)
Run parallel chains when an answer at step N has multiple independent causes. Label parallel chains A, B, C.
Format:
Problem: [Statement]
Why 1: [First cause]
Why 2: [Cause of cause 1]
Why 3: [Cause of cause 2]
Why 4: [Cause of cause 3]
Why 5: [Root cause]
Standard depth is 5. Extend to 7 if the chain has not reached an actionable root cause by Why 5. Stop at 3 if the root cause is clearly identified before Why 5 — do not pad to reach 5.
Step 3 — Validate each root cause
For each identified root cause, evaluate:
- Evidence quality: Is this root cause supported by interview data, system logs, observation, or is it inferred?
- Actionability: Can the project team address this root cause, or does it require a decision beyond the project's scope?
- Independence: Is this root cause truly independent, or is it itself a symptom of a deeper cause in another chain?
- Recurrence test: If this root cause were addressed, would the problem be permanently resolved or merely suppressed?
Flag root causes that fail the recurrence test with [SYMPTOMATIC — further analysis needed].
Step 4 — Build the fishbone diagram
Organize root causes and intermediate causes into a fishbone (Ishikawa) structure. For DXP and digital-experience engagements, use these standard bone categories:
- People — skills gaps, ownership gaps, training deficits, org structure misalignment
- Process — workflow breakdowns, approval bottlenecks, missing governance, manual workarounds
- Platform — capability gaps, integration failures, performance issues, configuration debt
- Data — poor data quality, missing data, inaccessible data, inconsistent data models
- Governance — policy gaps, unclear decision rights, compliance obligations not operationalized
- Environment — external factors: market, regulatory, vendor-imposed constraints
Each intermediate cause maps to one bone. Root causes sit at the bone tips. The problem statement is the fish head.
Render as an ASCII diagram or structured markdown table depending on output preference.
Step 5 — Produce root-cause recommendations
For each validated root cause, produce a recommendation entry:
| Root cause | Category | Evidence quality | Recommended intervention | Scope (project / engagement / org) | Priority |
|---|---|---|---|---|---|
| [Root cause statement] | People / Process / Platform / Data / Governance / Environment | High / Medium / Low | [Specific action] | [Scope] | High / Medium / Low |
Scope guidance:
- Project — addressable within the current engagement without additional budget or decisions
- Engagement — requires a change in the engagement scope or a new workstream; surface to the engagement lead
- Org — a structural or policy change the client organization needs to make; outside RBA's direct control; flag as a recommendation, not a commitment
Step 6 — Self-check before returning
- Every root cause is either evidence-grounded or explicitly flagged as inferred
- Parallel chains are clearly labeled and separated
- No cause has been skipped to reach a desired conclusion
- Root causes at "Org" scope are framed as client recommendations, not RBA deliverables
- The fishbone categories cover all identified causes; nothing is left in "miscellaneous"
Common DXP root-cause patterns
See reference.md for a library of pre-mapped Five Whys chains for recurring DXP pain points — use these as starting points, not pre-built answers.
Technical details
- Plugin
- discovery-synthesizer
- Author
- Dakota Smith
- Skill name
five-whys-root-cause- Maturity
- experimental
- Security review
- No security review
- Owners
-
- strategy
- Argument hint
[problem statement] [--evidence transcripts or @file-path] [--depth 3|5|7] [--output chain|fishbone|report]- Allowed tools
-
ReadWrite
- Source
plugins/discovery-synthesizer/skills/five-whys-root-cause/SKILL.md
Edit this skill on GitHub — opens GitHub's web editor. No git knowledge needed.