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.