目标：让人和 AI 只读取当前任务需要的最小文档集合。
- 根目录 AGENTS.md —— 开发流程、改动分级标准（本地/链路/治理改动）、Skills 入口
- 最窄的 app/service 自己的
docs/（如apps/platform-api/docs/）
不要默认读取整个 docs/ 目录。
- 提交与 Changelog 规范
- 更新日志
- 发布记录
- 功能现状总览 —— 按服务分组的当前功能清单，看仓库现在有什么直接看这份
- Dear Agent 总纲与能力迁移 —— 第二版规划；先搭前后端框架，独立前端复用 Chat，逐章接续与 23 个 Skills 验收，待治理评审
- Platform Web 架构与 Agent Chat 重构 —— 原前端六专题已批准、待实施；第 07 专题多端队列与 Runtime Middleware 最后完成，记录 GraphHarbor 仓库位置及通用引擎边界
链路/治理改动的项目文档统一放在 projects/ 下，AI 判断出对应级别后自动用 plan-project Skill 创建，无需手动调用；单服务改动的留痕记录见对应 apps/{app}/docs/changes/，仓库级/工具链改动见 changes/。三者的选择标准见 AGENTS.md 的「文档组织」。
quickstart/：新人必读（架构、本地开发、部署）guides/：开发规范FEATURES.md：全仓库功能现状总览changes/：仓库级/工具链级单项目改动记录projects/：链路/治理改动的项目文档decisions/：仓库级/跨服务技术决策（ADR）archive/：过时内容归档releases/：历史发布记录runbooks/：运维操作手册