用途:为已有项目生成架构决策记录(ADR),通过分析代码结构、依赖和文档,把隐含的架构、框架或数据库决策补记为文档,常用于接手既有项目并纳入 Blueprint Development 体系。
主要能力:探索目录结构、入口文件、配置、依赖清单、数据层、API 层与测试结构;识别框架、语言、状态管理、样式、测试、构建、数据库、API 风格、部署、Monorepo 等决策类别;按 MADR 模板生成 ADR(含 id、date、status、deciders、domain、supersedes、extends、relates-to 等 frontmatter);生成 ADR README;做冲突分析(同域、均为 Accepted、结论相反、超过 6 个月等打分,≥0.7 时询问取代/扩展/关联/无关系);维护双向一致性(被取代的 ADR 状态改为 Superseded 并加 superseded_by);更新 docs/blueprint/manifest.json 的 ID 注册表。
使用方式:前置条件为已初始化 Blueprint(docs/blueprint/ 存在),建议先有 PRD。先检查 ls docs/blueprint/manifest.json 与 ls docs/prds/,未初始化则建议 /blueprint:init,无 PRD 则建议先 /blueprint:derive-prd。随后 mkdir -p docs/adrs,用 Explore 子代理分析架构,检查已有 ADR(ls docs/adrs/.md 2>/dev/null | wc -l、grep -l "^domain: {domain}" docs/adrs/.md),确认决策理由,生成 ADR 与 README,更新清单并给出后续建议(如 /blueprint:derive-adr-validate、/blueprint:prp-create、/blueprint:generate-skills)。
适用场景:接手既有项目、补记框架/数据库/状态管理等选择、需要把决策纳入版本化文档时。
限制:需先初始化 Blueprint;PRD 为推荐而非必需;理由不明确时标记为 inferred 或 needs rationale 待人工复核;代码量过少时只生成较少且更宽泛的 ADR;冲突模式需用户确认意图。具体收费、价格与平台支持情况暂未提供。