用途:为有重大影响的架构选择(如数据库、消息队列、语言运行时选型)编写架构决策记录(ADR),并登记到项目 ADR 目录。适用于团队对重大技术选型做出承诺、偏离基线约束或参考架构、废弃或替代既有决策、决策影响多个模块/团队/成本模型时。
主要能力:生成每项决策一份 ADR,包含决策问题、架构背景、约束、至少两个可行选项、评估证据、受影响接口、理由与权衡、后果、决策者(角色名)、决策日期、状态及替代链接;同时维护审计可见的 ADR 目录,供 Phase 09 门禁与文件系统核对。状态生命周期:proposed、accepted、deprecated、superseded,其中 superseded 的 superseded_by 必须指向已存在的目录 ID。
使用方式:确认请求的产物、受众、范围、决策负责人与适用基线;默认只读,编辑仅限明确授权的草稿或项目文件。按顺序选取下一个 ADR-NNNN 编号,写入 projects/<ProjectName>/09-governance-compliance/05-adr/NNNN-slug.md,并将条目追加到 projects/<ProjectName>/_registry/adr-catalog.yaml(按 engine/registry/schemas/adr-catalog.schema.json 校验)。若替代旧 ADR,需更新旧条目状态为 superseded 及其 superseded_by 字段。
必要输入:决策问题、架构背景、约束、可行选项、评估证据、受影响接口、决策负责人,以及范围、受众、基线/版本,均属必需;缺失时停止依赖工作并记录缺口、负责人与影响。
限制:不用于不影响系统结构、成本或未来灵活性的琐碎实现选择;不得虚构缺失的项目事实、法律结论、测试结果、审批或认证;发布、签署、认证、生产变更、破坏性操作、支出与风险接受需显式授权;证据不足或检查无法运行时标记为未评估,绝不视为通过。参考文件:工程规则参考仓库运行规则;多租户 SaaS 可参见 references/saas-adr-catalogue.md。