用途:在 build 流程中面临技术选型、方案取舍或架构决策时,生成架构决策记录(ADR),输出到 docs/features/<name>/adr/<num>.md,作为可追溯的决策文件,之后继续 build-workflow-execute。前置加载 CANON.md。
主要能力:提供 ADR 模板(优先 templates/feature/adr/template.md),包含 Status、Decision Summary、Context、Decision Drivers、Constraints、Options Considered、Decision、Rationale、Consequences、Reversibility、Follow-up、Evidence Links 等章节;给出决策生命周期(提议→接受→取代→废弃,旧 ADR 不删除);提供验证清单与失败处理。
何时写:选择技术方案(X vs Y)、改变架构模式、引入新依赖、选择数据存储方案、采用新通信模式、决定废弃某系统。不必写:变量命名、文件拆分、单行实现细节、框架惯例。
核心原则:每个重要设计决策必须记录;代码说明 WHAT,ADR 说明 WHY;至少评估 2 个选项,记录驱动因素、约束、正负后果与可逆性。
限制:资料未提供安装命令、收费、平台或效果信息;模板与示例中的具体技术(如 Prisma)仅为示例,不代表推荐。