post-mortem

Draft structured post-mortems for fixed bugs with validation evidence.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mbaho10/claude-code-skills-9arm-workspace --skill post-mortem-mbaho10
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: post-mortem
Source: https://github.com/mbaho10/claude-code-skills-9arm-workspace/tree/main/.claude/skills/post-mortem
Command: npx skills add https://github.com/mbaho10/claude-code-skills-9arm-workspace --skill post-mortem-mbaho10

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The post-mortem standardizes the engineering record of a resolved bug, ensuring clear accountability, traceability, and learnings across teams.

Core Features & Use Cases

  • Creates a structured artifact including Summary, Root Cause, Fix, Validation, Why it slipped through, How it was found, and Action items.
  • Enables blameless analysis, precise code identifiers, and links to PRs or commits for reproducibility.
  • Serves as the reference for post-release learning and future prevention.

Quick Start

Provide a draft post-mortem using inputs: reliable repro, known root cause, identified fix, and validation results.

Frequently Asked Questions about post-mortem

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

FAQPage Schema
How do I write a blameless post-mortem for a resolved bug?

A blameless post-mortem standardizes the engineering record of a resolved bug through structured sections like root cause, fix, and action items. It requires inputs such as a reliable repro and validated outcome to ensure accountability and traceability without assigning individual blame.

What is included in a standard incident report for a bug fix?

A standard incident report includes a summary, root cause, how the bug was found, why it slipped through, the fix, validation results, and actionable follow-up items. It references precise code identifiers and links to commits for full reproducibility and future prevention.

What inputs do I need to draft a post-mortem after debugging?

You need a reliable reproduction of the issue, a known root cause, an identified fix, and validated outcome results. Providing these inputs allows the post-mortem process to generate a structured artifact with precise analysis and traceable follow-up items.

When do I need to create a post-mortem for an incident?

You need a post-mortem after validating a bug fix or completing a post-incident debugging scenario. It serves as the canonical engineering record for post-release learning, ensuring clear accountability, traceability, and future prevention across teams.

How do I document why a bug slipped through to production?

You document why a bug slipped through using the structured 'Why it slipped through' section of a post-mortem. This enables blameless analysis by focusing on systemic gaps and measurable evidence rather than individual errors.