# Research Docs

这个目录用于放置非 canonical 的内部调研、设计推导、差距分析和 cutover 方案。

放在这里的文档通常具有这些特征：

- 目的主要是内部讨论、方案比较、现状分析或迁移计划
- 可能包含阶段性结论、历史背景或待验证假设
- 不直接定义当前产品契约或工程约束

不应放在这里的文档：

- `SPECS.md`
- `specs/**/*.md`
- `docs/architecture-spec.md`
- `docs/tech_design.md`
- `docs/testing/*.md`
- runbook、部署文档、对客网站文档

判断原则：

- 如果文档回答的是“当前系统必须是什么”，应放在 canonical spec / architecture / tech design
- 如果文档回答的是“我们如何分析、比较、迁移或推导到这里”，应放在 `docs/research/`