用途:创建或修订架构决策记录(ADR),让决策依据代码现实而非主观判断。适用于已有代码库中引入或变更架构决策,以及需要更新、替代既有 ADR 的场景。
主要能力:先澄清决策标题、背景与至少两个备选方案;随后做现状发现,检查基础设施即代码(CDK、CloudFormation、Terraform)、受影响的应用代码、配置与依赖清单、环境变量、既有模式约定及验证当前行为的测试,记录当前实现、受影响文件、集成点、代码约束与依赖,并标注每个方案需改动的文件及数量。接着按方案评估实现工作量和 Well-Architected 支柱影响(仅列相关支柱,标注正面、中性、权衡或负面并给出代码证据),再说明监控告警、运维手册、值班和发布策略等运维影响,识别权衡、风险与可逆性,输出结构化 ADR。
使用方式:在代码库中先分析代码,再按步骤推进;无代码时按口头描述进行,但实现部分需标注待与代码核实。步骤 3 结束后设有检查点,须用户明确确认才继续;产出后可继续生成实现代码、迁移脚本、测试或后续 ADR。修订既有 ADR 时需读取原文件、对比 git 历史与文件差异,判断是否触发复审条件,必要时新建 ADR 并引用旧记录。
限制:不编造未提供的功能、价格或效果;无代码时结论可靠性下降;实现工作量和时间估算基于代码分析,资料未给出具体数值示例。