MikuMikuAR 文档

Appearance

ADR-001: 项目基础设施决策 ​

日期: 2026-07-16 状态: 已完成 — 5 条基础设施决策已定案。注意：foundation.md / fix-cycle.md / reusables.md 已于 ADR-039 删除，AGENTS.md 章节编号已在 ADR-031 重构后变更

本次会话集中确立了项目文档体系和组织规则。以下 5 条为一次性定案，后续不反复讨论。

1. 项目地基独立成文 ​

  • 决定：创建 docs/foundation.md（后于 ADR-039 删除，硬约束已浓缩至 AGENTS.md）
  • 理由：之前分散在各处，AI 改代码前不知道哪些能碰哪些不能碰。独立成文后 AI 10 秒可知

2. 文档结构扁平化，单点维护目录索引 ​

  • 决定：AGENTS.md 是目录索引的唯一入口，requirements.md 中冗余的项目结构树已删除
  • 理由：两份树不同步导致 AI 困惑。docs/README.md 给人看，AGENTS.md 地图给 AI 看，职责分离
  • 排除：不单独维护 docs/TREE.md

3. 修复周期引入验收契约 ​

  • 决定：创建 docs/fix-cycle.md（后于 ADR-039 删除，验收契约原则已融入通用 AI 工作流）
  • 理由：之前 AI 经常「build 过了就以为修好了」，实际运行还是有问题

4. 复用函数索引防重复造轮 ​

  • 决定：创建 docs/reusables.md（后于 ADR-039 删除，功能已被 docs/function-map.md + grep 覆盖）
  • 理由：AI 经常重复实现已有函数。索引 + AGENTS.md 工作流规则「写新函数前先查」

5. 会话边界规则 ​

  • 决定：AGENTS.md 定义开新窗口条件（功能无关 / 超 30 轮 / AI 重复问），新窗口只带 5 样文件
  • 理由：长上下文 AI 精度退化不可避免。主动分会话比等出问题再回滚高效