用途:自动化 ADR(架构决策记录)生成流水线,属于框架第 5 层。上游可为 BRD §8、PRD §14、EARS、BDD、用户提示或 IPLAN;下游产出一个通过校验的 ADR 及索引条目。
主要能力:智能识别输入类型;判断目标 ADR 是否已存在,缺失则生成、已存在则审查并修复;确定 deliverable_type(code/document/ux/risk/process)与来源主题;每次记录一个决策;生成 Document Control、§2–§10、术语表、附录、2–3 个备选方案及其淘汰因素、元素 ID、累积标签与架构流程图;运行审计评分,低于阈值(默认 90)时循环修复,最多默认 3 轮;更新 ADR-00_index.md。支持单个、批量(每批 3 个,先处理被依赖项)与 dry-run 模式。
使用方式:团队模式首步执行驱动命令:python3 "${CLAUDE_PLUGIN_ROOT}/tools/saga_driver.py" --layer 05_ADR --allow-skip-permissions,超时建议 ≥1800s;返回后读取 .aidoc/review/05_ADR/${ARTIFACT_ID}/saga.json 报告状态,仅在 CLOSED 时更新索引。可选模型预检查依据 .claude/aidoc-flow.config.yaml,支持 warn|silent|block,但无法切换会话模型。single_pass 线性模式为旧行为,不产生 saga.json,仅适合手动演练。
适用场景与限制:适合需要规范化架构决策文档的项目。依赖 ../doc-adr、../doc-adr-audit、../doc-adr-fixer、../doc-naming、../adr-roadmap 与 ../charts-flow 等技能;上游缺失会停止,多决策来源需拆分,超迭代上限则标记人工复核。配置读取 .aidoc/profile.yaml,支持 section_toggles、active_layers、audit_threshold(仅可调严)与 glossary;未知键忽略。具体价格与平台支持暂未提供。