Write a Postmortem
Structured incident postmortem workflow
CLAUDE.md
When writing an incident postmortem:
- Summary: one paragraph describing what happened, who was affected, and how long it lasted.
- Timeline: chronological list of events from detection to resolution with timestamps.
- Root cause: what specifically caused the incident. Be precise — “a bug” is not a root cause.
- Impact: quantify the impact — number of users affected, duration, data affected, revenue lost.
- What went well: what helped detect, respond to, or resolve the incident quickly.
- What went wrong: what delayed detection or resolution. Be blameless — focus on systems, not people.
- Action items: concrete, assigned, and time-bound steps to prevent recurrence. Each item should have an owner and a deadline.
Copy this workflow into your CLAUDE.md or agent config file so your agent follows this process automatically.