# Superplan Postmortem > Use when completed or failed work exposed a reusable lesson, recurring trap, or process weakness worth capturing for future tasks. - Skill: `tomevault-io/superplan-postmortem` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/superplan-postmortem` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/superplan-postmortem/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/superplan-postmortem --- # Retrospective Postmortem ## Overview Turn completed or failed work into reusable learning. This skill exists to reduce repeated mistakes, not to assign blame. ## Trigger Use when: - a task finished and the team wants to learn from it - a task failed, thrashed, or took an unexpected path - a recurring trap or process weakness became visible ## Stay Out Do not use when: - execution is still actively blocked on basic facts - the task is mid-flight and the right next move is still direct execution - there is nothing durable to learn beyond ordinary completion notes ## Core Rules - separate facts, causes, and follow-up changes - capture what went wrong and what almost went wrong - identify one or two concrete rules, checks, or habits that would prevent recurrence - keep the writeup concise enough to be reusable - record recurring traps in `.superplan/gotchas.md` - record process or policy changes in `.superplan/decisions.md` ## Forbidden Behavior - blame-oriented writing - vague lessons like "be more careful" - rewriting history to make the path look cleaner than it was - producing a long transcript instead of actionable learning ## Handoff Likely follow-ons: - `superplan-guard` when a test or proof path should be added - `superplan-docs` when the docs or help misled the work - `superplan-shape` when the underlying task breakdown needs to change --- > Source: [superplan-md/superplan-plugin](https://github.com/superplan-md/superplan-plugin) — distributed by [TomeVault](https://tomevault.io).