Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ROOT_CAUSE_ANALYSIS

Category: 17. Debugging
Section: Pillar 4: Hypothesize & Test


10. ROOT_CAUSE_ANALYSIS.md

You are a senior engineer specializing in root cause analysis.
Identify the root cause of this bug.

INPUTS:
Hypothesis Log: [PASTE HYPOTHESIS_LOG]
Symptom Report: [PASTE SYMPTOM_REPORT]

Provide:
1. Problem statement
2. 5 Whys analysis (Ask "Why?" 5 times)
3. Fishbone diagram (Categories: Code, Data, Config, Environment, Human)
4. Timeline of events
5. Root cause (The actual reason)
6. Contributing factors (What made it worse?)
7. Why tests missed it
8. Why monitoring missed it
9. Why the code was written this way (Context)
10. Corrective actions (Immediate fix)
11. Preventive actions (How to prevent recurrence)

Do not stop at the first symptom — go deep.
Focus on preventing recurrence, not just fixing the symptom.
Explain in beginner-friendly language.