postmortem-review-board · git:20260718.7c1285c · 2026-07-18 · sha256 a6a975c315d3ebd3
postmortem-review-board git:20260718.7c1285cA
Immutable. This exact content is served forever at /api/v1/blob/a6a975c315d3ebd3.
--- name: postmortem-review-board description: Run an org-level board that reviews incident postmortems for quality, promotes cross-cutting fixes, and surfaces trends no single incident reveals. Use when your organization produces enough postmortems that reading them one at a time misses the systemic pattern. --- # Postmortem review board A single postmortem fixes one incident. A review board exists to catch what one document cannot see: the fifth outage this quarter with the same root cause, the action items that were filed and never done, the failure class spreading across teams. Without the board, every team learns its own lesson in isolation and the organization relearns the same lesson at increasing cost. ## Method 1. **Set the entry bar by severity, not by volunteering.** Every SEV1 and SEV2, plus any incident with customer or revenue impact above a stated threshold, comes to the board. Leave lower severities to team-local review so the board reads the incidents that carry organizational signal, not all of them. 2. **Grade each postmortem against a written rubric before discussing it.** A pass needs a real timeline, a root cause that survives "5 whys" past the first human, contributing factors, and action items with owners and dates. "Operator error" is not a root cause: it is where the analysis stopped. Send failing documents back rather than reviewing them. 3. **Keep it blameless out loud.** The board judges the writeup and the system, never the responder. The moment a review becomes a tribunal, the next postmortem gets sanitized and the board loses its only source of truth. 4. **Separate local fixes from cross-cutting actions.** For each incident, ask whether the fix protects only the team that had the outage or a shared weakness others share too. Promote the systemic ones to owned, tracked work with an executive sponsor: a retry storm that took down one service will take down the next unless the shared client library changes. 5. **Age the action items and refuse to let them rot.** Report open action-item count and age every session. Postmortem actions are the first work dropped when a team gets busy, so a board that files them without tracking closure is theater. A recurring incident whose prior action item is still open is the board's clearest indictment of itself. 6. **Read across postmortems for trends, not just down each one.** Tag incidents by trigger class: deploy, config change, capacity, dependency failure. Each quarter, name the top classes and the teams they cluster in. This pattern is invisible from any single document and is the board's real product. 7. **Feed the trends into planning.** Turn the recurring classes into roadmap input: a hardening project, a guardrail, a paved path. A trend report that reaches no planning cycle changes nothing next quarter. ## Signals - Would a postmortem that blamed a person and stopped there get sent back, or wave through? - Can you state this quarter's top three incident classes and who owns fixing each? - Is the open action-item age trending down, or does the backlog only grow? - When an incident recurs, does the board catch that its prior fix never shipped? ## Boundaries This is the org-level review of many postmortems, not the writing of one: the authoring of an individual incident report belongs to your incident-response process. The board sets a quality bar and spots patterns; it does not run the live incident or approve releases. Match cadence and severity thresholds to your organization's existing incident taxonomy.