nwave-ai/nw-root-why
nWave/skills/nw-root-why/SKILL.md
Root cause analysis and debugging
$ install --global
skillsauthnpx skillsauth add nwave-ai/nwave nw-root-whyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 12, 2026, 7:09 AM128.5s1 file scanned
SKILL.md
- name:
- nw-root-why
- description:
- Root cause analysis and debugging
- user-invocable:
- true
- argument-hint:
- [problem-description] - Optional: --depth=[3|5|7-whys] --output=[text|diagram|report]
NW-ROOT-WHY: Toyota 5 Whys Root Cause Analysis
Wave: CROSS_WAVE Agent: Rex (nw-troubleshooter)
Overview
Systematic root cause analysis using Toyota's 5 Whys with multi-causal investigation and evidence-based validation. Investigates multiple cause branches at each level|validates solutions against all identified root causes.
Agent Invocation
@nw-troubleshooter
Execute *investigate-root-cause for {problem-statement}.
Configuration:
- investigation_depth: 5
- multi_causal: true
- evidence_required: true
Usage: DELIVER Wave Retrospective (Phase 3.5)
When invoked as part of /nw-deliver Phase 3.5, execute in order:
- Gather Inputs — Read the evolution document, mutation results, git log,
roadmap.json, andexecution-log.json. Gate: all available inputs loaded. - Analyze What Worked Well — Identify practices that succeeded and document why — preserve these. Gate: at least one practice documented with rationale.
- Analyze What Improved — Identify what worked better than before and why — record as reinforcements. Gate: delta from prior execution captured.
- Analyze What Worked Badly — Apply 5 Whys root cause analysis to failures; produce actionable fix per root cause. Gate: each failure has a root cause and fix.
- Analyze What Regressed — Apply 5 Whys to anything worse than before; produce prevention action. Gate: each regression has a root cause and prevention action.
- Tag Meta-Improvements — Mark any items requiring nWave framework changes as meta-improvements. Gate: all framework-level issues flagged.
- Append Retrospective — Write retrospective section to evolution document. If clean execution (no skips, no failures, no tooling issues), generate brief summary only. Gate: evolution document updated.
Success Criteria
- [ ] All 5 WHY levels investigated with evidence
- [ ] Multi-causal branches explored at each level
- [ ] Root causes identified and validated
- [ ] Solutions address all identified root causes
- [ ] Backward chain validation performed
Next Wave
Handoff To: {invoking-agent-returns-to-workflow} Deliverables: Root cause analysis report with solutions
Examples
Example 1: Investigate test flakiness
/nw-root-why "Integration tests fail intermittently on CI but pass locally"
Rex investigates 5 WHY levels with multi-causal branches, discovers race condition in database cleanup, proposes transaction-isolated test fixtures.
Expected Outputs
docs/analysis/root-cause-analysis-{problem}.md
Related Skills
nwave-ai/nw-distill
testing
VerifiedTrustedCommunity
Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.
563SKILL.mdUpdated May 21, 2026
nwave-ai/nw-collaboration-and-handoffs
development
VerifiedTrustedCommunity
Cross-agent collaboration protocols, workflow handoff patterns, and commit message formats for TDD/Mikado/refactoring workflows
563SKILL.mdUpdated Apr 16, 2026
nwave-ai/nw-roadmap
development
VerifiedTrustedCommunity
Creates a phased roadmap.json for a feature goal with acceptance criteria and TDD steps. Use when planning implementation steps before execution.
563SKILL.mdUpdated Apr 9, 2026
nwave-ai/nw-distill
testing
VerifiedTrustedCommunity
Acceptance test creation methodology for the DISTILL wave. Domain knowledge for the acceptance designer agent: port-to-port principle, prior wave reading, wave-decision reconciliation, graceful degradation, and document back-propagation.
563SKILL.mdUpdated Apr 9, 2026