postmortem

Generates structured 5 Whys post-mortem documents tracing root causes and escaped quality gates.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/Zeyad-37/tech-agency --skill postmortem-zeyad-37
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: postmortem
Source: https://github.com/Zeyad-37/tech-agency/tree/main/.claude/skills/postmortem
Command: npx skills add https://github.com/Zeyad-37/tech-agency --skill postmortem-zeyad-37

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a bug or crash reaches production, teams often fix the symptom without understanding the systemic failures that allowed it. This Skill produces a rigorous post-mortem that traces both how the issue was introduced and how it escaped every quality gate, then converts findings into tracked prevention tasks. ## Core Features & Use Cases - Dual-Chain 5 Whys Analysis: Traces how the issue was introduced (Chain A) and how it escaped unit tests, integration tests, code review, CI, QA, staging, and monitoring (Chain B). - Structured Post-Mortem Document: Generates a complete markdown report with timeline, systemic root cause classification, impact, resolution, and recurrence checks, saved to docs/artifacts/post-mortem/. - Mandatory Prevention Tasks: Creates one Kanban board task per prevention action via the board adapter, with priority SLAs and recurrence escalation. - Use Case: After running /investigate-crash on a production NullPointerException, run this Skill to deepen the analysis, discover that DTO nullability was never validated against the API contract, and file P1 tasks to add a Konsist test and fix the mock data fixtures. ## Quick Start Ask the AI to write a 5 Whys post-mortem for the crash investigation you just completed, including prevention tasks on the board.

Frequently Asked Questions about postmortem

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a post-mortem after a production bug?▼

Run the postmortem skill after completing a bug or crash investigation. It gathers incident context, conducts a 5 Whys analysis across two chains, and generates a structured document in docs/artifacts/post-mortem/ with timeline, root cause, and prevention actions.

What is the 5 Whys root cause analysis method?▼

The 5 Whys method repeatedly asks why an issue occurred until reaching a systemic process-level cause rather than a code-level one. This skill runs two parallel chains: how the issue was introduced and how it escaped each quality gate to production.

Can I run a post-mortem without a prior crash investigation?▼

Yes, the skill supports standalone runs. If no prior investigation artifacts exist, it asks you for the symptom, timeline, immediate fix, and severity, then proceeds with the full 5 Whys analysis and document generation.

How does the post-mortem track prevention action items?▼

Every prevention action becomes a mandatory Kanban board task created via board.create_task(), with priority SLAs (P0: 48 hours, P1: 1 week). On markdown backends, board edits ship in the same PR as the post-mortem document.

What happens when an incident is a recurrence of a previous one?▼

The skill checks the post-mortem INDEX.md for similar past incidents and documents why previous prevention actions failed. It also creates an additional P0 task to investigate why the earlier prevention measures did not stop the recurrence.