用途:把架构决策写成轻量、结构化的 ADR 文档,保留背景、理由、备选方案与后果,解决数月后回看时“当初为什么这么做”的问题。
主要能力:生成带编号(ADR-001、ADR-002…)和状态生命周期(Proposed、Accepted、Deprecated、Superseded by ADR-XXX)的文档;按固定结构输出标题、状态、日期、作者、Supersedes、Context、Decision、Alternatives Considered、Consequences、References。工作流分六阶段:识别决策、捕获背景、枚举备选方案、记录决策、预测后果、分配元数据。
参考文件:references/adr-template.md(标准模板,始终加载)、references/status-lifecycle.md(状态转换与取代规则,引用既有决策时加载)、references/context-capture.md(复杂或多方决策时加载)、references/alternatives-analysis.md(存在多个选项时加载)。
使用方式:需准备决策目录(通常为 docs/adr/ 或 docs/decisions/),并明确待决策内容,必要时通过澄清问题帮助用户表述。
适用场景:影响系统结构、难以逆转、存在非显而易见权衡、日后会被追问“为什么”的决策。
限制:易逆转的决策、无备选的标准实践、实现细节、已被取代的旧决策均不建议写 ADR;接受后的 ADR 不再编辑,变更需新写一篇取代旧篇;每个 ADR 只记录一个决策。资料未提供安装命令、收费或平台信息。