用途:通过结构化对话与架构师共同起草 ADR,架构师不会看到初稿,只会看到自评修订后的版本。
主要能力:分七个阶段推进——理解(读取 discovery-brief.md,只追问未确认的 MUST)、上下文(分类既有 ADR 的 supersedes/amends/relates-to/tension 关系)、选项(由架构师列出并逐项分析利弊、工作量、风险)、决策(失败模式、脚本化质疑、置信度、复审日期)、起草(逐节确认,默认 MADR 4.0.0)、自评(对照 adr-is-not.md 逐条标记违规)、保存(自动编号、写入文件、更新索引、输出交叉链接说明)。
使用方式:需提供 docs/architecture/discovery-brief.md 且五项 MUST 全部 CONFIRMED,否则拒绝并转 adr-discovery;可选 docs/architecture/open-questions.md。每条消息只问一个问题或一步。保存时先查找 docs/adr/、docs/decisions/、docs/architecture/decisions/、**/adr/*.md,取首个存在目录,否则创建 docs/adr/;文件名格式 NNNN-kebab-imperative-title.md,编号取现有最大值加一并补零到四位。
限制:决策者必须是具名人类,不能写“团队”;失败模式未阐明、组件超过 5 个、自评违规未解决、编号冲突、缺少 YAML frontmatter 或关系镜像不一致时拒绝保存。frontmatter 与正文 ### Relationships 必须一致,否则一半工具无法解析。具体收费、平台支持等信息暂未提供。