Appearance
Everything Claude Code Architect Agent 是专为开发者提供系统设计、架构决策和可扩展性分析的专业 AI 代理。它不仅能自动分析现有架构、识别技术债务，还能输出高质量的架构方案、权衡技术选型、生成 ADR（Architecture Decision Records），并与其他 Agent 协同保障从设计到落地的全流程一致性。相比直接用 Claude 聊天，Architect Agent 能保证架构决策的系统性、可追溯性和生产级标准，极大提升团队的架构治理效率。
Everything Claude Code Architect Agent：系统设计与架构决策的专职 AI 代理
在现代软件开发中，架构设计和技术决策直接决定了项目的可维护性、可扩展性和长期成本。Everything Claude Code Architect Agent（下称 Architect Agent）正是为此而生——它是 Everything Claude Code 插件体系中专注于系统设计与架构治理的核心 Agent，能够为开发者和团队提供自动化、结构化、可复用的架构决策支持。
本指南将详细介绍 Architect Agent 的核心用途、能力边界、触发方式、与其他 Agent 的协作模式，以及实际使用示例，帮助你在 AI 辅助编程场景下系统性提升架构决策质量。
1. Architect Agent 是什么？解决什么问题？
Architect Agent 是一名“AI 架构师”，专注于系统设计、技术选型、可扩展性分析与架构决策记录。它的主要目标是：
- 在新功能规划、大型重构、系统扩展等关键节点，自动输出高质量的架构方案和权衡分析；
- 识别现有系统的技术债务、可维护性和性能瓶颈，提出结构化改进建议；
- 生成标准化的 ADR（Architecture Decision Record），确保团队架构决策的可追溯性和知识沉淀；
- 保证架构设计阶段与后续开发、测试、上线等环节的流程一致性。
适用场景举例：
- 规划新模块/服务、需要评估多种技术路线时
- 对现有系统进行大规模重构或性能优化
- 需要为团队/项目建立架构决策记录（ADR）
- 评估系统扩展到 10x、100x 用户量的可行性
- 需要落地领域最佳实践和通用架构模式
相比直接和 Claude 聊天，Architect Agent 具备专业分工、流程规范、输出结构化、自动协作等优势，能显著降低架构决策的随意性和遗漏风险。
2. Architect Agent 能做什么？不能做什么？
2.1 能做什么
Architect Agent 具备如下核心能力：
- 现有架构分析：自动梳理系统现状、识别架构模式、技术债务和扩展瓶颈
- 需求收集与澄清：结构化整理功能与非功能需求（性能、安全、可用性等）
- 架构方案输出：生成高层架构图、组件职责、数据模型、API 合同、集成模式等
- 技术选型权衡：对每项关键决策输出 Pros/Cons/Alternatives/Decision 四段式权衡分析
- 架构原则落地：推荐高内聚低耦合、可扩展、可维护、安全优先等最佳实践
- 常见架构模式建议：如前端组件分层、后端 Repository/Service/Event/CQRS、数据层范式/缓存/一致性等
- 生成 ADR：自动生成标准化的 Architecture Decision Record，便于团队知识沉淀与追溯
- 可扩展性规划：给出不同量级用户下的架构演进路线
- 反模式预警：自动识别 Big Ball of Mud、God Object、过度耦合等架构反模式
2.2 不能做什么
- 不会直接生成具体业务代码（但会输出架构蓝图、接口合同、数据模型等开发基础）
- 不替代详细的安全审查、性能测试（但会提出安全与性能注意事项，需配合 security-reviewer 等 Agent 深入分析）
- 不负责项目管理和需求优先级排序（建议配合 planner Agent 进行任务拆解和排期）
- 不处理具体的构建错误、测试失败（请交给 build-error-resolver 或 tdd-guide）
3. Architect Agent 的触发方式
3.1 自动激活（Proactive）
在以下场景，Architect Agent 会自动被触发：
- 用户提出“新功能/模块/服务设计”或“系统重构”相关需求时
- 检测到涉及系统级技术选型、架构模式变更的请求
- 需要生成或更新 ADR 时
- 复杂业务流程或跨团队协作需求出现时
示例：
“我们要支持 10 万用户并引入实时通知，系统架构需要怎么升级？”
此时，Architect Agent 会自动介入，输出系统现状分析、演进方案、权衡分析和 ADR。
3.2 手动调用
你也可以显式指定由 Architect Agent 处理：
- 在命令行或对话中输入
/architect或选择“架构设计”Agent - 在 Everything Claude Code 完全指南 配置中将 Architect Agent 作为默认架构审查工具
4. 与其他 Agent 的协作模式
Architect Agent 并不是孤立工作的，它常与以下 Agent 组成架构治理流水线：
- planner Agent：负责将 Architect Agent 产出的架构方案拆解为可执行开发计划和任务
- tdd-guide Agent：根据架构输出的接口合同、数据模型，生成测试用例和 TDD 流程
- code-reviewer Agent：在开发完成后，结合架构原则进行代码审查，确保实现与架构一致
- security-reviewer Agent：对架构设计中的安全风险点进行专项审查
- doc-updater Agent：自动将架构决策、ADR、架构图同步到项目文档
常见协作流程：
- 用户发起新系统/模块设计需求
- Architect Agent 介入，输出架构蓝图、权衡分析、ADR
- planner Agent 拆解为开发任务
- tdd-guide Agent 生成测试规范
- 开发实现后，code-reviewer 和 security-reviewer 进行审查
- doc-updater 自动更新文档
这种多 Agent 协作模式，极大提升了从架构到交付的全流程一致性和生产效率。更多协作模式可参考Claude Code 快速上手指南。
5. 实际使用示例
场景：你准备为现有 SaaS 平台增加“AI 智能搜索”功能，需要评估技术路线、输出架构方案并记录 ADR。
对话过程：
用户：我们想为平台增加语义搜索功能，要求支持 10 万条数据，响应时间 < 50ms，数据需加密存储。请给出推荐的系统架构和权衡分析。
Architect Agent 响应：
markdown
## 当前架构分析
- 前端：Next.js 15（Vercel）
- 后端：Express（Cloud Run）
- 数据库：PostgreSQL（Supabase）
## 需求澄清
- 支持 10 万条高维向量的语义检索
- 响应时间 < 50ms
- 数据需加密存储
- 兼容现有用户体系
## 架构方案
- 向量存储：Redis Stack（Upstash）用于语义向量检索
- 数据加密：应用层加密，密钥托管于 GCP Secret Manager
- 后端服务：Express 增加 `/search` API，调用 Redis 向量检索
- 前端：调用新 API，展示搜索结果
## 技术选型权衡（ADR-002）
### Pros
- Redis Stack 检索速度快，支持 KNN 算法
- 简单部署，兼容现有架构
- 加密方案安全合规
### Cons
- Redis 内存成本高，需监控扩容
- 单点故障风险，建议后续引入集群
### Alternatives
- PostgreSQL pgvector：持久化更强，检索速度略慢
- Pinecone：托管服务，成本高
### Decision
采用 Redis Stack + 应用层加密，后续关注扩容与高可用。
## 架构图
（此处可自动生成 Mermaid 或 PlantUML 图）
## 下一步建议
- 由 planner Agent 拆解开发任务
- 由 tdd-guide Agent 生成测试用例
- 由 doc-updater 更新 ADR 和架构图到项目文档6. 为什么要用专门的 Architect Agent，而不是直接问 Claude？
- 结构化输出：Architect Agent 始终按“现状分析→需求澄清→方案输出→权衡分析→ADR”标准流程输出，避免遗漏关键环节。
- 专业分工：自动调用架构相关最佳实践和领域知识，输出可落地、可追溯、可协作的架构成果，而不是零散建议。
- 自动协作：与 planner、tdd-guide、code-reviewer 等 Agent 无缝衔接，保障从设计到实现的全流程一致性。
- 生产级标准：内置架构反模式预警、可扩展性规划、安全合规等生产环境必备能力，远超通用聊天模型。
- 知识沉淀：自动生成和更新 ADR，便于团队长期治理和新成员快速上手。
这一切，都是直接与 Claude 聊天无法高效、系统性实现的。
FAQ
Q: Architect Agent 会自动生成架构图和 ADR 吗？ A: 是的，Architect Agent 会根据输入自动输出架构图（如 Mermaid/PlantUML）和标准化 ADR，支持团队知识沉淀。
Q: Architect Agent 能处理多语言、多技术栈项目吗？ A: 可以。它支持多种主流架构模式和技术选型，适用于前后端、微服务、AI 系统等多种场景。
Q: 如何保证 Architect Agent 的建议与实际开发一致？ A: 建议与 planner、tdd-guide、code-reviewer 等 Agent 协作，确保从架构设计到开发、测试、上线全流程一致，并通过 ADR 记录每次决策。