问题
第一次文档治理后，LoopTrain 的文档系统变得更可靠，但网站本身开始变乱。
顶部导航同时出现：
首页 / 试玩 / 开发日志 / 设计 / 技术 / 决策 / AI 工程笔记 / 路线图 / 更新记录 / 角色 / 关于这些不是同一层级的东西。有的是页面，有的是文档类型，有的是主题，有的是状态。
更麻烦的是，同一件事开始出现在多个位置：
- Devlog 里有文档治理行动记录。
- Design 里有文档治理设计。
- Technical 里有文档治理检查器。
- Decisions 里有 Devlog 作为正式文档中心的决策记录。
它们各自都有合理职责，但如果没有主从关系，读者会不知道哪一篇代表当前事实。
判断
这次问题不是“栏目不够多”，而是“栏目维度混杂”。
继续加分类不会解决问题。文章越多，混乱只会从文件目录转移到网站导航。
所以这次调整的核心判断是：
分类用于结构，标签只用于检索。一篇内容首先应该有文档类型：
Devlog / Design / Technical / Decision / Postmortem / Changelog / Character然后才是主题标签：
AI Coding / 状态管理 / 文档治理 / 部署 / LLM Bridge调整
1. 收敛一级导航
一级导航不再平铺所有文档类型，而是收敛为：
首页 / 试玩 / 项目状态 / 文档库 / 开发日志 / 角色档案 / 关于设计、技术、决策、AI 工程笔记、更新记录 不再全部挤在一级导航里。
2. 建立 /docs 文档库
新增：
/docs按内容类型组织：
- 项目状态
- 游戏设计
- 技术实现
- AI 工程实验
- 决策记录
- 事故复盘
- Legacy
这样读者先判断自己要找什么类型的内容，再进入具体主题。
3. 隐藏 planned 占位文档
之前为了纳入治理，我创建了几个 status: planned 的正式文档占位：
api-reference
llm-bridge
testing-guide
content-schema
deployment-topology它们对治理有用，但不应该作为公开文档卡片展示。现在列表页和详情页会过滤 status: planned 的正式文档。
这些文件仍然存在，仍然被检查器管理，但不会污染公开文档库。
4. Devlog 回到“记录已发生事实”
计划中设计、RFC、ADR、工具说明应该进入对应的设计/技术/决策文档。
Devlog 只保留：
- 做了什么
- 为什么做
- 发生了什么问题
- 如何解决
- 这次迭代留下什么判断
这比把所有内容都塞进开发日志更清楚。
新规则
这轮之后，文档系统遵守三条规则：
- 一级导航只放读者入口，不放所有文档类型。
- 文档库按内容类型组织，标签只负责检索。
- planned 文档可以存在于仓库，但默认不作为公开页面展示。
为什么不一次做完
这次没有引入完整的 docType / domain / canonical 字段体系。
原因很简单：现在还不需要。
当前最乱的是导航和 planned 占位文档公开展示。先解决这两个问题，就能让网站读起来稳定很多。
未来如果文档数量继续增长，再把 docType、domain、canonical 加入 schema 和检查器。
结果
这次调整后，文档治理从“把内容放进不同栏目”前进了一步：
文档先有类型
再有主题
最后才是标签LoopTrain 的 devlog 不应该变成一个越分越碎的博客系统。它更像一个长期项目知识库：开发日志、技术实现、设计判断、决策记录、事故复盘，都应该有自己的位置。