# Specs

> 叙事性设计文档（多章节，narrative）。

## 放什么

- 完整的系统设计推理（多章节，含 alternatives 与 tradeoff）
- 项目元设计（如 framework-redesign 这类哲学源文档）
- 大跨度的技术深度文档（不适合拆 ADR 的）

## 不放什么

- 单个决策 → 用 [`../decisions/`](../decisions/)（ADR）
- 当前态参考 → 用 wiki 顶层文档
- 讨论中的提案 → 用 [`../rfcs/`](../rfcs/)
- 时间敏感的复盘 → 用 [`../post-mortems/`](../post-mortems/)

## 命名约定

`<topic>.md`，下划线或连字符分隔。例如：`framework-design.md`、`migration-strategy.md`。

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