ADR Writer 用于编写架构决策记录(ADR),把关键技术决策的背景、选择、备选方案与影响固化成可追溯的文档。
主要能力:提供标准 ADR 模板,包含状态(Proposed/Accepted/Deprecated/Superseded by ADR-XXX)、日期、决策人、负责人、Context、Decision、Alternatives Considered、Tradeoffs、Consequences、Risks、Implementation Notes、Follow-up Actions、References、Revision History 等部分;覆盖技术选型、架构模式、基础设施、安全等常见决策类型;附带状态工作流、编号规则、评审清单和输出清单。
使用方式:复制模板创建新文件,例如 cp templates/adr-template.md docs/adr/ADR-042-title.md;填写各段落后在架构渠道分享评审,更新状态为 Accepted 并从主架构文档链接。
适用场景:数据库/框架/云服务等选型、微服务与单体、同步与异步通信、部署与监控策略、认证与加密方案等需要留痕的重要决策。
限制与注意:应为重要决策撰写,保持简洁(1-2 页);避免缺少备选方案、忽略负面后果、没有负责人或状态过期;另需包含风险与缓解措施、带责任人和期限的后续行动。具体安装或运行方式资料中暂未提供。