Skip to content

Post-Incident Review — [Incident Title] ​

Metadata ​

FieldValue
DateYYYY-MM-DD
Severitysev1 / sev2 / sev3 / sev4
DurationHH:MM (detection to resolution)
Incident Commander[name]
Author[name]
Statusdraft / reviewed / actions tracked

Summary ​

One paragraph describing what happened, who was affected, and how it was resolved. Write for someone who was not involved.

Impact ​

  • Users affected: [number or scope]
  • Revenue impact: [if applicable]
  • Data impact: [loss, corruption, exposure — or none]
  • SLA breach: yes / no
  • External communication required: yes / no

Timeline ​

All times in UTC.

TimeEvent
HH:MM[First anomaly detected / alert fired]
HH:MM[Incident acknowledged, severity classified]
HH:MM[Key decision or action taken]
HH:MM[Service restored / mitigation applied]
HH:MM[Confirmed stable, incident closed]

Root Cause ​

Describe the technical root cause. Be specific. "Human error" is not a root cause — describe what system allowed the error to have impact.

Contributing Factors ​

What conditions made this incident possible or worse:

  • [ ] Missing or insufficient test coverage
  • [ ] Inadequate monitoring or alerting
  • [ ] Unclear runbook or missing procedure
  • [ ] Configuration drift or undocumented change
  • [ ] Insufficient review of change
  • [ ] Agent-generated code with insufficient validation
  • [ ] Missing rollback capability
  • [ ] Other: [describe]

What Went Well ​

What worked as intended during the response:

What Could Be Improved ​

What did not work well or was missing:

Agent Involvement ​

If the incident involved agent-generated code or agent-assisted operations:

  • Agent identity: [which agent or tool]
  • What the agent produced: [code, config, migration, etc.]
  • Review process: [was it reviewed? by whom?]
  • Prompt or task context: [what triggered the agent work]
  • Remediation: [prompt update, permission change, process change]

If no agent involvement, remove this section.

Corrective Actions ​

IDActionOwnerDue DateStatus
1[specific, measurable action][name]YYYY-MM-DDopen
2
3

Action Categories ​

Label each action:

  • prevent: stop this class of incident from recurring
  • detect: catch this failure earlier
  • mitigate: reduce the blast radius if it happens again
  • process: improve the response workflow

Systemic Observations ​

If this incident reveals a pattern (third time this quarter, same class of failure in multiple services, recurring gap in a specific team), note it here. Systemic issues should be escalated beyond the incident team.

Follow-Up Review ​

Schedule a follow-up to verify actions are completed:

  • Review date: YYYY-MM-DD
  • Reviewer: [name]

Principles ​

  • This review is blameless. The goal is to improve the system, not assign fault.
  • Actions must have owners and deadlines. Unowned actions do not get done.
  • The output should change something. If nothing changes, the review was theater.