Postmortem as Craft

Skill to develop.

Overview

Postmortem authoring is a real engineering skill, not a template-filling exercise. The teams that produce useful postmortems treat them as craft: timelines need construction, root-cause analysis needs technique, action items need SMART framing.

• Skill to develop. Postmortem authoring takes practice and feedback to do well. Junior engineers improve through mentoring.
• Timeline construction. Assembling the timeline from chat logs, dashboards, and memory is the first craft skill.
• Root-cause analysis. Five Whys is one tool. Cause-and-effect diagrams, contributing-factor analysis, and timeline-anomaly review are others.
• Action-item quality plus mentoring. SMART action items survive review; senior engineers teach PM authoring through pairing and review.

The approach

Three habits develop postmortem craft: read good postmortems, mentor on the craft, and peer-review every postmortem before it ships.

• Review industry exemplars. Read Cloudflare, Stripe, Honeycomb postmortems. Standards live in the published work, not in templates.
• Mentor on craft. Senior engineers review junior postmortems with concrete feedback. The skill scales through mentoring.
• Peer review before publish. Each postmortem reviewed by a peer for clarity, accuracy, and action-item quality. Catches the lazy framings.
• Per-team template plus authoring guide. Standard structure supports consistency; per-team authoring guide captures the craft expectations.

Why this compounds

Each well-crafted postmortem grows the team’s incident expertise. The compounding works because postmortems are how the team learns; better postmortems mean faster learning.

• Better learning. Quality postmortems produce real learning. Sloppy postmortems produce checkboxes.
• Better follow-through. SMART action items survive scrutiny and actually get completed.
• Team scaling. Mentored craft scales to new engineers. The skill spreads through the team rather than living with one author.
• Year-one investment, year-two habit. The first set of postmortems takes deliberate practice. By year two the craft is shared and the standard is high.