Engineering Note

An incident review isn't successful because the incident is documented. It's successful when the same incident becomes harder to repeat.

We've all seen incident reviews that look complete.

Incident summary.
Timeline.
Root cause.
Action items.

Everything is documented.

And a few months later, the same class of incident happens again.

The problem is usually not the incident review.

It's what happens after it.

For production incidents, I prefer to structure incident reviews around a few questions:

* What happened and what was the actual impact?
* How did we detect it?
* What was the root cause?
* What made the incident worse?
* What helped us recover?
* What failed during detection or recovery?

Then comes the most important part:
Corrective actions.

Every action should have:
* A clear owner
* A priority
* A deadline
* A measurable outcome

But even that isn't enough.

We also ask:
Can we detect this earlier?
Can we prevent it automatically?
Can we reduce the blast radius?

And finally: How will we verify that the fix actually prevents recurrence?

A incident review shouldn't end when the code fix is deployed.

It should end when the system is more resilient than it was before the incident.

The goal isn't to find someone to blame.

The goal is to make the next incident less likely, less severe, or faster to recover from.

A good incident review explains what happened.

A great incident review changes the system.