post-mortem

Document a bug fix's root cause, mechanism, fix, validation, and lessons learned.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/weerachai8266/CWT-maintenance_V2 --skill post-mortem-weerachai8266
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: post-mortem
Source: https://github.com/weerachai8266/CWT-maintenance_V2/tree/main/skills/engineering/post-mortem
Command: npx skills add https://github.com/weerachai8266/CWT-maintenance_V2 --skill post-mortem-weerachai8266

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The canonical engineering record of a bug fix, capturing the root cause, mechanism, fix, validation, and lessons learned to accelerate future debugging and prevent recurrence.

Core Features & Use Cases

  • Structured post-mortems capture root cause, fix, validation, and learnings in a single authoritative document.
  • Blameless storytelling focuses on process gaps, not people, driving improvements.
  • Use Case: after a debug session yields a fix, produce the post-mortem before closing the ticket to share with engineers and leadership.

Quick Start

Draft a complete post-mortem for a recently fixed bug using the four inputs: reliable repro, known root cause, identified fix, and validation.

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 bug fix?

A blameless post-mortem documents the root cause, mechanism, fix, validation, and lessons learned of a bug fix, focusing on process gaps rather than people to drive engineering improvements.

What inputs do I need to document a root-cause analysis for a resolved bug?

Documenting a root-cause analysis requires four inputs: a reliable reproduction, a known root cause, an identified fix, and validation, ensuring a thorough narrative before closing the ticket.

When should I create an engineering record for a debug session?

Create an engineering record after a debug session yields a real fix and before closing the ticket, capturing the validation and learnings to share with engineers and leadership.

What is the best way to structure a retrospective for software engineering incidents?

The best way to structure a retrospective uses a canonical format capturing root cause, fix, validation, and learnings in a single authoritative document to accelerate future debugging and prevent recurrence.

Does a blameless post-mortem require validation before closing the engineering ticket?

Yes, a blameless post-mortem requires validation as one of four mandatory inputs, alongside reliable repro, known root cause, and identified fix, to ensure a thorough narrative before ticket closure.