用途：为当前代码库生成或更新一份持续维护的 ARCHITECTURE.md，让智能体与工程师快速、完整地了解系统结构、技术栈与部署模型。
主要能力：支持三种模式——创建（无文档时）、刷新（已有符合模板的文档时做漂移检测并更新）、重构（已有内容但不符合模板时，先给出重构、追加、试运行三个选项，需用户明确选择后才改动）。可识别 monorepo 根与包级作用域，包级文档会引用根级文档而非重复共享基础设施。发现阶段可并行使用子智能体，覆盖项目身份与结构、技术栈与组件、基础设施与 CI/CD、数据安全与外部 API、测试与代码质量等域，并将结果标记为推断或未知。
使用方式：先检测作用域与相关文件（如 pnpm-workspace.yaml、turbo.json、nx.json、lerna.json、package.json 的 workspaces 字段，以及 openspec/config.yml），再判定模式并施加对应门禁；随后执行发现并合并结果，仅针对真正缺口进行定向访谈（组件、基础设施与部署、安全、路线图、身份与术语），最后展示预览并等待确认后才写入。
限制与护栏：写入前必须先读取已有 ARCHITECTURE.md，不得覆盖人工撰写的上下文；不得编造基础设施细节，无法确定时标记 <!-- TODO: fill in -->；不得逐字粘贴完整目录树；刷新模式必须先做漂移检测；不得让全部 11 个章节都留为 TODO；系统图章节不得记录内部实现细节；预览是必需检查点，未获明确确认前不得写入。
适用场景：需要为代码库建立或维护架构文档、在 monorepo 中生成包级文档、或在代码变更后同步架构说明时使用。具体模板章节细节与完整命令暂未提供。