К основному содержанию
скилл CX Codex

postmortem · sethgammon — скилл для Claude Code: отчёт о сбоях и установка

Скилл postmortem разбирает завершённую кампанию или инцидент по файлам проекта, телеметрии и истории Git. Помогает выяснить, что сломалось и что поймали защитные проверки.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает postmortem

Для завершённой кампании скилл сопоставляет план с результатом, изучает журнал решений, изменения в Git и телеметрию из .planning/telemetry/. Он отмечает ошибки, отклонения от плана, срабатывания защитных механизмов и повторяющиеся проблемы. Разбор можно запустить и для отдельного инцидента по недавней истории Git.

Результат сохраняется в .planning/postmortems/postmortem-{slug}-{date}.md: там будут причины сбоев, что их обнаружило, рекомендации и фактические показатели. Можно указать путь к файлу кампании или период; без аргументов скилл берёт последнюю завершённую кампанию. Если каталога .planning/ нет, отчёт выводится прямо в диалог, а значит, файл автоматически не сохранится.

Какие задачи решает

  • разобрать сбои после завершения кампании
  • сравнить запланированную работу с тем, что попало в feature ledger
  • выяснить, какие ошибки остановили хуки и quality gates
  • найти повторяющиеся ошибки в коммитах и изменённых файлах
  • составить отчёт по инциденту из недавней истории Git

Примеры запросов агенту

  • Составь postmortem по последней завершённой кампании.
  • Разбери, что сломалось за последнюю сессию, по истории Git и телеметрии.
  • Сравни план кампании из .planning/campaigns/launch.md с результатом и запиши разбор.

Как установить postmortem

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill postmortem -a claude-code

3Вручную: положить файлы

~/.claude/skills/postmortem/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/postmortem/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о postmortem

Как установить postmortem в Claude Code?

Выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local.

Что делает скилл postmortem?

Он собирает сведения о кампании или инциденте из файлов проекта, телеметрии и истории Git, затем записывает структурированный разбор сбоев, защитных срабатываний и повторяющихся проблем.

Можно ли запустить postmortem без файла кампании?

Да. Укажите период, например «последняя сессия», или запустите скилл без аргументов: тогда он возьмёт последнюю завершённую кампанию. Для разбора инцидента без кампании используется недавняя история Git и контекст сессии.

Исходный текст

SKILL.md · MIT
---
name: postmortem
license: MIT
description: >-
  Auto-generates a structured postmortem from a completed campaign. Reads the
  campaign file, telemetry logs, and feature ledger. Produces a documented
  analysis of what broke, what the safety systems caught, and what patterns
  emerged. Can also be invoked manually for any incident.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - postmortem
  - retro
  - what broke
  - what happened
  - debrief
effort: medium
---

# /postmortem — Campaign Postmortem Generator

## Orientation

**Use when:** A campaign just completed and you want a structured analysis of what broke, what safety systems caught, and what patterns emerged. Also for ad-hoc incident analysis from recent git history.

**Don't use when:** You want to preserve session context for the next conversation (use `/session-handoff`), extract reusable patterns from findings into the knowledge base (use `/learn`), or score and improve quality iteratively (use `/improve`).

## When to Use

- After any Archon campaign completes (Archon should suggest it)
- After a difficult debugging session
- When the user says "what just happened" or "what broke"
- When /do routes "postmortem", "retro", "what broke", "what happened"

## Inputs

One of:
1. A campaign file path (.planning/campaigns/*.md)
2. A time range ("last session", "today", "this week")
3. Nothing (reads the most recent completed campaign)

## Protocol

### Step 1: GATHER

Collect data from all available sources:

**From the campaign file (if it exists):**
- Direction vs what was actually built (scope drift?)
- Phase completion timeline (which phases needed rework?)
- Decision log entries (what architectural choices were made?)
- Review queue items (what needed human eyes?)
- Circuit breaker activations (what hit the limit?)
- Feature ledger (what shipped?)

**From telemetry (.planning/telemetry/):**
- hook-timing.jsonl: which hooks fired most, any patterns
- hook-errors.log: what was blocked, what failed, what had parse errors
- Circuit breaker trips
- Quality gate violations

**From git history:**
- Commits during the campaign period
- Files changed (which areas got the most churn?)
- Any reverts (what was undone?)
- Commit message patterns (fix: commits indicate bugs found)

**From the session itself (if no campaign):**
- Recent tool calls and their outcomes
- Files edited and errors encountered

### Step 2: ANALYZE

Identify patterns across the data:

1. **What broke:** List every failure, error, or unexpected outcome.
   For each: what happened, what caught it (hook/gate/human/nothing),
   what it cost (time, rework, tokens).

2. **What the safety systems caught:** Circuit breaker activations,
   quality gate blocks, anti-pattern warnings, typecheck failures.
   This is the "invisible value" section — problems prevented.

3. **What drifted:** Compare the campaign direction to what was built.
   Did scope expand? Did phases get skipped or reordered? Did the
   architecture change mid-build?

4. **What patterns emerged:** Recurring error types, files that kept
   needing fixes, phases that took longest, common anti-patterns.

### Step 3: PRODUCE

Write to `.planning/postmortems/postmortem-{slug}-{date}.md`:

```markdown
# Postmortem: {Campaign Name or Session Description}

> Date: {ISO date}
> Campaign: {path to campaign file, or "ad-hoc session"}
> Duration: {time from first to last commit}
> Outcome: {completed | partial | parked}

## Summary
{2-3 sentences: what was attempted, what happened, what the result was}

## What Broke
{Numbered list. For each:}
### {N}. {Short description}
- **What happened:** {the failure}
- **Caught by:** {hook name / quality gate / human / nothing}
- **Cost:** {rework time, files affected, phases repeated}
- **Fix:** {what resolved it}
- **Infrastructure created:** {new hook rule, new anti-pattern, new end condition — or "none needed"}

## What Safety Systems Caught
{Things that WOULD have been problems without the hooks/gates}
| System | What It Caught | Times | Impact Prevented |
|--------|---------------|-------|-----------------|
| {hook/gate name} | {description} | {count} | {what would have happened} |

## Scope Analysis
- **Planned:** {what the campaign direction said}
- **Built:** {what the feature ledger shows}
- **Drift:** {none | minor | significant — with specifics}

## Patterns
{Recurring themes worth watching:}
- {pattern 1}
- {pattern 2}

## Recommendations
{Concrete next actions:}
1. {recommendation — e.g., "Add anti-pattern rule for X"}
2. {recommendation — e.g., "Phase Y needs tighter end conditions"}

## Numbers
| Metric | Value |
|--------|-------|
| Phases planned | {N} |
| Phases completed | {N} |
| Commits | {N} |
| Files changed | {N} |
| Circuit breaker trips | {N} |
| Quality gate blocks | {N} |
| Anti-pattern warnings | {N} |
| Rework cycles | {N} |
```

### Step 4: HANDOFF

Output the HANDOFF block from the Exit Protocol, then suggest: `Run /learn {campaign-slug} to extract patterns into the knowledge base.`

## What /postmortem Does NOT Do

- Invent failures that didn't happen (real data only)
- Blame the user or the model (document what happened, not whose fault)
- Recommend changes to skill files (that's for the user to decide)
- Run during a campaign (only after completion or on demand)

## Quality Gates

- Every "What Broke" entry has all 5 fields filled
- Numbers section has real data (not estimates)
- Recommendations are concrete actions (not "be more careful")
- If no failures occurred, say so honestly (don't manufacture drama)

## Fringe Cases

**Campaign not found**: If the specified campaign file doesn't exist, check `.planning/campaigns/` for the most recently modified campaign. If no campaigns exist, run in ad-hoc mode using recent git history and session context.

**No telemetry data**: Proceed without telemetry. Mark the "What Safety Systems Caught" table as "No telemetry available" and the Numbers section fields as "N/A". Don't manufacture data.

**Partial campaign** (parked or in-progress): Generate the postmortem with `Outcome: partial`. Document what was completed and what was parked. Include a "Remaining Work" section listing incomplete phases.

**If .planning/postmortems/ does not exist**: Create it before writing. If `.planning/` itself doesn't exist, output the postmortem inline and note: "Run /do setup to initialize .planning/ for future storage."

## Exit Protocol

```
---HANDOFF---
- Postmortem: {name}
- Document: .planning/postmortems/postmortem-{slug}-{date}.md
- Failures documented: {count}
- Safety catches: {count}
- Recommendations: {count}
- Reversibility: green — one file written to .planning/postmortems/; git rm to undo
---
```

After displaying the HANDOFF block, suggest: `Run /learn {campaign-slug} to extract patterns into the knowledge base.`

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — postmortem от других авторов.

postmortem Alireza Rezvani Скилл postmortem проводит разбор неудач по методу «5 почему» и фиксирует изменения с ответственными. Пригодится после сорванного запуска, провала функции или неудачного найма. CX Codex +1 1 465установок game-postmortem AlterLab-IEU Скилл game-postmortem для Claude Code, Codex и Cursor проводит постмортем релизнутой, отменённой или завершившей крупную фазу игры. Собирает метрики из Git, ретро и отчётов, архивируя выводы в production/milestones/. CX Codex +1 ★ 57звёзд репо postmortem-writing Seth Hobson Скилл postmortem-writing помогает разбирать инциденты без поиска виноватых: собрать таймлайн, найти корневые причины и оформить задачи для исправления. CX Codex +1 10 800установок postmortem-writer patricio0312rev Скилл postmortem-writer собирает разбор инцидента в готовый документ: таймлайн, корневая причина, задачи с владельцами. Пригодится, пока детали аварии ещё свежи в памяти. CX Codex +1 265установок write-a-postmortem Inkeep Скилл write-a-postmortem помогает разобрать сбой и составить отчёт по стандартам Google SRE в папке postmortems/. Он исключает обвинения людей и опирается на факты. CX Codex +1 243установок incident-postmortem официальный github Скилл incident-postmortem для GitHub Copilot готовит разбор сбоя в формате Google SRE без поиска виноватых. Запускается по просьбе написать постмортем, RCA или отчёт об outage. CX Codex +1 81установок signal-postmortem tradermonty Скилл signal-postmortem для Claude Code разбирает исходы торговых сигналов и возвращает ошибки в настройку весов. Запускается после закрытия сделки или окончания периода удержания. CX Codex +1 3 700установок

Из того же набора55

Весь набор →
deploy-steward Скилл deploy-steward для Claude Code по очереди вливает готовые PR в main, проверяет CI, запускает деплой и создаёт задачи на починку при сбоях. CX Codex +1 ★ 937звёзд репо prd Собирает PRD по описанию приложения: задаёт вопросы, определяет объём и технические решения. Документ можно передать Archon для разбиения на кампанию. CX Codex +1 ★ 937звёзд репо organize Скилл organize для аудита и исправления структуры проекта: проверяет, где лежат файлы, переносит их по конвенции и обновляет импорты. Код внутри файлов не трогает. CX Codex +1 ★ 937звёзд репо create-app Скилл create-app для Claude Code и Codex автоматизирует создание приложений по текстовому описанию. Он делит задачу на пять уровней и ведёт разработку через PRD, архитектуру и верификацию. CX Codex +1 ★ 937звёзд репо map Скилл map строит компактный JSON-индекс кодовой базы с файлами, экспортами, импортами и графом зависимостей, чтобы агент находил нужные файлы без лишних Glob и Grep. CX Codex +1 ★ 937звёзд репо phase-validator Субагент phase-validator сверяет отчёт о завершении этапа с условиями выхода и выносит вердикт pass или fail. Помогает контролировать автоматические конвейеры разработки. CX Codex ★ 937звёзд репо fleet Субагент fleet для Claude Code делит работу на кампании и ведёт их волнами по 2–3 агента, передавая находки следующей волне. Разбивает задачи, не пересекающиеся по файлам. CX Codex ★ 937звёзд репо workspace Скилл workspace координирует изменения в нескольких репозиториях в рамках одной задачи. Разбивает работу на волны, запускает кампании по репозиториям, проверяет контракты между ними. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой