thinking-five-whys-plus
Agent skill fromtjboudreaux/cc-thinking-skills
When a fault is localized and the proximate cause is known but the systemic root is not, chain evidence-linked whys with a counterfactual stop and a countermeasure.
How to install thinking-five-whys-plus
install thinking-five-whys-plus
# install the cc-thinking-skills pack with the skills CLI
npx skills add tjboudreaux/cc-thinking-skills# or add only this skill to Claude Code: copy the folder
skills/thinking-five-whys-plus/
# into
~/.claude/skills/thinking-five-whys-plus/ (all projects)
.claude/skills/thinking-five-whys-plus/ (one project)
1# Five Whys Plus23Build an evidence-linked causal chain from a known proximate fault to an actionable systemic root, then prescribe a countermeasure that would have blocked it.45## When to Use67- A fault is already localized to a component, path, or subsystem.8- The proximate cause is known, but recurrence or systemic root is not.9- Prior symptom-only fixes failed and the failure returned.10- You need prevention that addresses why the proximate cause was possible.1112## When NOT to Use1314- Fault is not localized or multiple candidate causes remain — discriminate first.15- Root is evidenced and actionable — fix it.16- No evidence can answer the next "why" — gather evidence.17- One-off error without a process, tooling, or design enabler.18- Selective defect needing IS/IS-NOT analysis.19- Forward failure forecasting before commitment.2021## Procedure22231. **State the localized problem.** Record the observable symptom, confirmed component/path, time window, scope, and impact. Stop if localization is missing.242. **Chain why with evidence.** Make the prior answer the new effect; propose a cause; cite logs, code, config, metrics, or witnesses; name and rule out alternatives. Stop on speculation.253. **Branch before descending.** Ask what else could produce the same effect; keep every evidenced independent pathway. Treat the retained branches as a causal set rather than forcing one root.26…
Excerpt shown under the repository's MIT license.
