Tooluck logoTooluck
SKILL.md

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)

skills/thinking-five-whys-plus/SKILL.md

MITFull file
1# Five Whys Plus
2
3Build an evidence-linked causal chain from a known proximate fault to an actionable systemic root, then prescribe a countermeasure that would have blocked it.
4
5## When to Use
6
7- 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.
11
12## When NOT to Use
13
14- 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.
20
21## Procedure
22
231. **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.

More skills in cc-thinking-skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates