用途:在架构生成前审查 ADR(架构决策记录),识别说明不足之处,并通过针对性澄清问题加以完善,使 ADR 完整、一致、可进入架构生成阶段。
主要能力:按 MADR 标准校验 ADR 完整性;检查上下文、决策陈述、正负后果、备选方案、风险与缓解、状态准确性;检测 ADR 之间的冲突及与 constitution 的冲突;做风险与缺口分析(运营缺口、技术债、单点故障、安全);给出跨 ADR 一致性与 constitution 合规对照,并提出修订或豁免建议。
使用方式:适用于 /architect-init 之后、重大里程碑前的 ADR 审查、新成员理解 ADR、解决已识别的不一致。无 ADR 时先运行 /architect-init;棕地项目也先用 /architect-init 从代码反推 ADR。流程读取 {REPO_ROOT}/.adlc/drafts/adr/ 中的单个 ADR 文件与 {REPO_ROOT}/docs/adlc/memory/constitution.md(旧路径 {REPO_ROOT}/.adlc/memory/constitution.md 作为回退),运行 scripts/bash/setup-architect.sh 获取路径;逐项分析、列出缺口、按严重度一次提出一个澄清问题、写回 ADR,并请求将 ADR 状态批准为 Accepted;获批后需写入 {REPO_ROOT}/.adlc/architect/state.json,其中包含 clarify_completed、adrs_approved_count 等字段,否则 /architect-implement 会因预检校验失败而停止。
限制:每次会话默认最多 5 条澄清(存在架构时可增至 10);不得删除 ADR 除非用户明确同意;ADR 不得在无明确理由时覆盖 constitution 的 MUST 原则。费用、价格与平台等信息暂未提供。