| 目录 / 文件 | 内容 | 读者 |
|---|---|---|
| architecture.md | 架构设计文档：定位、设计原则、系统分层、核心设计、双模型剧场、路线图 | 所有贡献者，动手前必读 |
| vision.md | 北极星：成本模型反转、投机代理、夜班、睡眠周期（本地 LoRA 自我进化） | 想知道这个项目要去哪的人 |
| adr/ | 架构决策记录：每个重大选型一份，含备选方案、否决理由与重开条件 | 质疑"为什么这么设计"的人 |
| research/ | 竞品与技术调研报告：架构文档中结论的证据基础 | 想核查依据或续做调研的人 |
| planning/ | 在途文档：任务看板、里程碑计划、头脑风暴候选池（非事实源，定案后收敛） | 想看"正在做什么 / 在想什么"的人 |
- 架构文档是唯一的设计事实源；代码注释里引用章节号（如 §5.2）。
- 重大设计变更先写 ADR（编号递增，永不删除，被推翻的标记 Superseded）。
- 调研报告按
YYYY-MM-主题.md命名，保留当时的数据与链接，不回头改写。 docs/根目录只放事实源（architecture.md / vision.md）与各分类目录；任务看板、 头脑风暴等在途文档一律进planning/，不散落在根。