# Post-mortems

> 事故复盘。**永久保留**——历史教训不能消失。

## 放什么

- 生产事故复盘（中断、数据损坏、安全事件）
- 重大 bug 调查记录
- 流程失败的分析（如 release 卡住、CI 长期不稳）

## 命名约定

`YYYY-MM-DD-<short-title>.md`，例如：

- `2026-08-12-auth-token-leak.md`
- `2026-09-03-database-migration-rollback.md`

## 标准结构（5 W）

```
---
date: YYYY-MM-DD
severity: P0 | P1 | P2
duration: <事故持续时间>
---

# Post-mortem: <短标题>

## What
<什么坏了>

## When
<时间线，按 UTC>

## Who/Where
<影响范围、用户、系统>

## Why（根因）
<五个为什么 / fishbone 分析>

## How（修复 + 预防）
- 立即修复：...
- 长期预防：[ ] 写新 ADR / 加 invariant / ...
```

## 铁律

- **不指责个人**——blameless post-mortem
- **不删**——历史记录永久保留
- **每条预防项必须有跟进 issue 或 ADR**

> 此目录由 koala-core init 创建。删除本 README 或保留作为指引——你的选择。
