Decision Record — 架构决策记录 (ADR)

入口/出口

• 入口: build 中面临技术选型、方案取舍、架构决策
• 出口: docs/features/<name>/adr/<num>.md — 可追溯的决策文件
• 指向: 决策记录后继续 build
• 前置加载: CANON.md
• 输出路径: 决策记录后继续 build-workflow-execute

何时不使用

• 只是变量命名、局部文件拆分或框架惯例内的实现细节
• 方案没有真实取舍，只有一个显然符合现有模式的做法
• 已有 ADR 覆盖当前决策，只需要引用而不是新建

何时写 ADR

必须写: 选择技术方案（X vs Y）、改变架构模式、引入新依赖、选择数据存储方案、采用新通信模式、决定废弃某个系统