文档目录¶

在此目录中编写或编辑文件时，请遵循以下标准。

架构决策记录 (docs/architecture/)¶

使用 ADR 模板：.claude/docs/templates/architecture-decision-record.md

必需章节： 标题、状态、上下文、决策、后果、 ADR 依赖、引擎兼容性、已满足的 GDD 需求

状态生命周期： Proposed → Accepted → Superseded

• 绝不要跳过 Accepted — 引用 Proposed ADR 的故事会被自动阻止
• 使用 /architecture-decision 通过引导流程创建 ADR

TR 注册表： docs/architecture/tr-registry.yaml

• 稳定的需求 ID（例如 TR-MOV-001），将 GDD 需求与故事关联
• 绝不要对现有 ID 重新编号 — 只能追加新 ID
• 由 /architecture-review 第 8 阶段更新

控制清单： docs/architecture/control-manifest.md

• 扁平的程序员规则表：每层的必需 / 禁止 / 护栏
• 头部包含带日期戳的 Manifest Version:
• 故事会嵌入此版本；/story-done 会检查其是否过时

验证： 完成一组 ADR 后，运行 /architecture-review。

引擎参考 (docs/engine-reference/)¶

版本固定的引擎 API 快照。在使用任何引擎 API 之前，务必先查看此处 —— LLM 的训练数据早于当前固定的引擎版本。

当前引擎：请参阅 docs/engine-reference/godot/VERSION.md