Postmortem QA Reviewer Prompt
Run a quality pass over a finished postmortem draft to flag missing sections, claims unsupported by the timeline, and unaddressed single points of failure — before it goes to review.
- Target user
- SRE / eng manager doing pre-review QA on a postmortem
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT, Cursor
The prompt
You are a staff SRE who reviews postmortems for completeness and rigor before they reach the wider team. You are a tough but fair editor: you do not rewrite the document, you find the gaps the author missed. I will paste the draft postmortem below: [POSTMORTEM DRAFT] [TEMPLATE/SECTIONS EXPECTED: list the sections your standard requires, or "use a sensible default"] Do the following: 1. Completeness check: list which expected sections are present, thin, or missing (summary, impact, timeline, contributing factors, what-went-well, action items, detection/response analysis). 2. Claim support: scan every causal and impact claim. For each, check whether the timeline or pasted data actually supports it. Flag unsupported or overstated claims and quote the offending sentence. 3. Single points of failure: identify any SPOF revealed by the incident that the document mentions but does not address with an action item. Flag each unaddressed SPOF. 4. Action-item quality: flag items that are vague, ownerless, untestable, or that restate the problem instead of fixing it. Do not rewrite them — just flag. 5. Blameless tone: flag any sentence that assigns intent or fault to a person rather than describing a system condition. Output format: a findings list grouped by category (Completeness / Unsupported claims / Unaddressed SPOFs / Weak action items / Tone), each finding with a location quote and a one-line reason. End with a short readiness verdict: ready / needs-minor / needs-major. Guardrails: you are reviewing, not authoring — do not invent facts, do not fill gaps with assumptions, and mark anything you are unsure about as [UNVERIFIED]. The author owns every fix; your job is to surface issues for a human to decide on.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Why this prompt works
The weakest moment in a postmortem’s life is the gap between “the author thinks it’s done” and “a senior reviewer reads it.” Authors are too close to the incident to see their own holes: a causal claim the timeline does not actually support, a single point of failure mentioned in passing but never turned into an action, a section that is present in name but empty of substance. A structured QA pass catches these before the document wastes a review meeting.
The prompt is deliberately a reviewer, not a rewriter. It quotes the offending sentence and gives a one-line reason, leaving the fix to the author. This matters because the model cannot know the ground truth of the incident — it can only check internal consistency between claims and the pasted timeline. Asking it to flag rather than fix keeps it inside its competence and keeps the author accountable for every word.
The unaddressed-SPOF check is the highest-leverage part. Incidents routinely expose a fragile dependency that everyone nods at during the writeup and no one converts into a tracked fix; six months later the same SPOF takes the site down again. Surfacing those explicitly, alongside weak action items and any fault-assigning language, turns a generic proofread into a rigor check — while leaving the readiness call and every edit with the human.
Related prompts
-
Postmortem Format Selector Prompt
Decide whether this specific incident is best told as a narrative, a strict timeline, a 5-whys, or a contributing-factors analysis — before you start writing the document.
-
Postmortem Assumptions and Unknowns Extractor Prompt
Read a postmortem draft and surface every unstated assumption and open unknown that is being treated as settled fact, so the root-cause analysis and action items don't quietly rest on unverified claims.
-
Postmortem to Game-Day Scenario Generator Prompt
Convert a real incident postmortem into a runnable game-day or chaos-engineering exercise so you can prove the fixes actually work under realistic failure conditions instead of assuming they do.
-
Postmortem Incident Commander Decision Review Prompt
Review the key decisions an incident commander made during a response and evaluate each for local rationality given the information available at the time — blamelessly, focused on decision-support tooling and process.
More Post Mortems with AI prompts & error guides
Browse every Post Mortems with AI prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.