用途:在需要做技术决策时运行 /architect,例如在多种方案间取舍、设计新功能或页面、为新项目挑选技术栈,或 /develop 指出存在待决事项。它执行结构化调研、权衡选项,并在 docs/adr/ 下撰写或更新架构决策记录(ADR),本身不写代码,也不更新 AGENTS.md/CLAUDE.md(由 /sync 负责)。
四种模式:FEATURE 从零设计新功能;ARCHITECTURE 为新项目选技术栈或基础架构;ENHANCEMENT 改进、替换或扩展已有内容;CROSS-CUTTING 在全代码库统一某类模式(错误处理、日志、鉴权、命名)。操作分创建(新 ADR,状态 Proposed)、更新(就地编辑现有 ADR)、取代(新 ADR 并更新旧 ADR 状态行)。
ADR 状态:与可构建范围功能关联的 ADR 状态跟随功能生命周期,由 /develop 推进;独立决策 ADR 由工程师确认后转为 Accepted;记录已交付工作的 ADR 直接为 Accepted。
使用方式:主线程负责全部设计对话与 ADR 撰写,只把只读的代码库扫描或网页抓取交给廉价子代理。撰写前先做定向提问,问题分为可推断、需询问、可推荐三类;技术栈、数据模型、工具与供应商选择逐阶段由工程师决定,并始终提供自定义输入。ADR 默认放在 docs/,若 docs/ 是已发布文档站点则改用 .workflow/。文件位置按仓库形态(单仓库 docs/adr/,monorepo 按工作区或 _root/),形态按决策规模(单文件或目录加 index.md、rationale.md)。
限制:仅 git 为必需命令行工具;无交互提问支持时以纯文本选项回退;输出要求使用简单语言且不使用任何破折号。具体收费、价格与平台支持等资料暂未提供。