用途：为已经做出的架构决策生成一份 ADR，每次调用只产出一份。若决策尚未确定，应改用 /create-rfc 先形成决策，再回来记录。
主要能力：按五步流程执行——收集上下文、校验必填字段、选择格式、分配编号、生成并放置文件。格式默认 MADR，也可用 Nygard 或 Y-Statement，分别对应 templates/adr-madr.md、templates/adr-nygard.md、templates/adr-y-statement.md 模板。编号通过扫描目录分配下一个顺序号，参考资料包括 references/process.md、formats.md、numbering.md、quality.md。
使用方式：依次执行各步骤，每一步动手前先完整阅读对应参考文件。第 1 步向用户询问决策、格式、状态、被取代关系；第 2 步确保标题、日期、状态、上下文、决策、后果齐全；第 5 步填写模板、跑质量检查清单、确认文件位置后再写入。建议 200–500 词，过长则把细节移到链接的设计文档或 RFC。
限制与规则：不得编造事实，缺少必填字段要询问，不得用看似合理的填充内容；不得编辑已有 ADR 来改变决策，应新建 ADR 并双向链接（旧记录标注 Superseded by ADR-{NNN}）；后果须诚实写明权衡，包括变得更困难的部分；必须使用用户当前会话的语言；无法填写的字段应询问或保留斜体占位（to be confirmed）。写入前需先建议路径并经用户确认。技术栈、平台、版本、收费与效果等未在资料中提供。