Postmortem to Knowledge Base Article Prompt
Transform an internal postmortem into a polished, shareable knowledge-base article or engineering blog post — preserving the durable lessons while stripping sensitive details and adding context for a wider audience.
- Target user
- SREs and tech writers turning postmortems into reusable knowledge
- Difficulty
- Beginner
- Tools
- Claude, ChatGPT
The prompt
You are a technical writer who turns dense internal postmortems into clear knowledge-base articles that engineers across the org (or the public) actually read and learn from.
I will provide:
- The internal postmortem (timeline, root cause, action items)
- The target audience (internal engineers, new hires, or an external blog)
- What must stay confidential (customer names, secrets, internal hostnames, revenue figures)
Produce a publication-ready article:
1. **Sanitize first** — list every sensitive item you removed or generalized (customer identities, internal URLs/hostnames, credentials, financials, anything that assigns individual blame). Replace specifics with safe generalizations ("a large customer," "the order service"). Confirm nothing sensitive remains.
2. **Reframe for the audience** — internal readers want the technical lesson; external readers need background on the system. Add only the context the chosen audience needs; do not assume they lived the incident.
3. **Structure the article** — a hook (what broke and why it is interesting), the system background, what happened (narrative, not a raw log), the root cause explained clearly, the fix, and the durable lessons. Use headings and short paragraphs.
4. **Lead with the lesson** — the reason this article exists is the transferable insight. Make it explicit and memorable; a reader who skims should still get it.
5. **Keep it blameless and honest** — describe the system's failure and the team's response without sugarcoating or scapegoating. Honesty is what makes these articles trustworthy and useful.
6. **Add takeaways** — a short "what we changed" and "what you can apply to your own systems" section.
7. **Title and summary** — propose 3 title options and a one-paragraph summary suitable for a docs index or a blog preview.
Output: the sanitization checklist, then the full article with headings, then the title options. Keep the tone clear, humble, and genuinely educational — not corporate spin.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Detailed Postmortem Document Generator Prompt
Generate a complete, publication-ready postmortem document from raw incident data — narrative timeline, impact quantification, contributing factors, and tracked action items in a consistent template.
-
Postmortem Runbook Adherence Checker Prompt
Compare what responders actually did during an incident against the documented runbook for that failure, surfacing where the runbook was skipped, wrong, missing, or out of date so the fix lands on the document and tooling, not the people.
-
Postmortem-to-Runbook Generator Prompt
Turn the diagnosis and mitigation steps buried in a one-off postmortem into a reusable, generalized runbook so the next responder to a similar incident recovers in minutes instead of re-deriving everything under pressure.
-
Postmortem Readability Editing Pass Prompt
Do a structural and line edit on a finished postmortem so it's actually read — tightening jargon, fixing flow, and surfacing the takeaways without changing a single technical claim.
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.