系统架构图和使用流程
Claude Code文档生态系统的完整架构图和使用流程指南。
核心架构概览
核心使用流程
1. 项目启动流程
2. 开发工作流程
完整目录结构图
Claude Code 文档生态系统
├── docs/ # 结构化文档系统
│ ├── index.md # 系统主页
│ ├── getting-started.md # 快速开始指南
│ ├── configuration.md # 配置指南
│ ├── navigation.md # 文档导航
│ ├── user-guide.md # 用户使用指南
│ ├── workflow-guide.md # 工作流指南
│ ├── system-architecture.md # 本架构文档
│ │
│ ├── agents/ # 代理系统文档
│ │ ├── index.md # 16个代理总览
│ │ ├── 核心代理文档 (8个)
│ │ │ ├── planner.md # 规划师
│ │ │ ├── architect.md # 架构师
│ │ │ ├── executor.md # 执行器
│ │ │ ├── reviewer.md # 审查员
│ │ │ ├── debugger.md # 调试器
│ │ │ ├── writer.md # 撰写员
│ │ │ ├── pm.md # 产品经理
│ │ │ └── uiux.md # UI/UX设计师
│ │ └── (扩展代理文档引用外部agents/目录)
│ │
│ ├── templates/ # 模板系统文档
│ │ └── index.md # 12个模板详解
│ │
│ ├── teams/ # 团队配置文档
│ │ └── index.md # 4种团队配置说明
│ │
│ ├── checklists/ # 检查清单文档
│ │ └── index.md # 质量控制系统
│ │
│ ├── commands/ # 命令系统文档
│ │ ├── index.md # 16个命令总览
│ │ ├── analyze.md # 代码分析
│ │ ├── build.md # 构建部署
│ │ ├── cleanup.md # 清理优化
│ │ ├── design.md # 设计规划
│ │ ├── document.md # 文档生成
│ │ ├── estimate.md # 工作量估算
│ │ ├── explain.md # 代码解释
│ │ ├── git.md # Git操作
│ │ ├── implement.md # 功能实现
│ │ ├── improve.md # 代码改进
│ │ ├── load.md # 项目加载
│ │ ├── spawn.md # 任务编排
│ │ ├── task.md # 任务管理
│ │ ├── test.md # 测试工作流
│ │ ├── troubleshoot.md # 故障排除
│ │ └── workflow.md # 工作流管理
│ │
│ ├── mcp/ # MCP服务集成
│ │ ├── index.md # MCP服务概览
│ │ └── mcp-services/ # 具体服务文档
│ │ ├── context7.md # Context7服务
│ │ └── sequential.md # Sequential服务
│ │
│ └── scripts/ # 脚本系统
│ └── index.md # 脚本和工具概览
│
├── agents/ # 代理配置
│ ├── 核心代理 (8个)
│ │ ├── planner.md # 规划师代理
│ │ ├── architect.md # 架构师代理
│ │ ├── executor.md # 执行器代理
│ │ ├── reviewer.md # 审查员代理
│ │ ├── debugger.md # 调试器代理
│ │ ├── writer.md # 撰写员代理
│ │ ├── pm.md # 产品经理代理
│ │ └── uiux.md # UI/UX设计师代理
│ └── 扩展代理 (8个)
│ ├── analyst.md # 商业分析师
│ ├── architect copy.md # 架构师()
│ ├── master.md # 主控
│ ├── orchestrator.md # 编排器
│ ├── dev.md # 全栈开发者
│ ├── pm copy.md # 产品经理()
│ ├── po.md # 产品负责人
│ ├── qa.md # 质量保证
│ ├── sm.md # Scrum Master
│ └── ux-expert.md # UX专家
│
├── templates/ # 模板系统实现
│ ├── 架构设计模板 (4个)
│ │ ├── architecture-tmpl.yaml # 通用架构
│ │ ├── brownfield-architecture-tmpl.yaml # 棕地架构
│ │ ├── front-end-architecture-tmpl.yaml # 前端架构
│ │ └── fullstack-architecture-tmpl.yaml # 全栈架构
│ ├── 产品文档模板 (3个)
│ │ ├── prd-tmpl.yaml # 产品需求文档
│ │ ├── brownfield-prd-tmpl.yaml # 棕地PRD
│ │ └── front-end-spec-tmpl.yaml # 前端规格
│ ├── 分析模板 (3个)
│ │ ├── market-research-tmpl.yaml # 市场研究
│ │ ├── competitor-analysis-tmpl.yaml # 竞品分析
│ │ └── brainstorming-output-tmpl.yaml # 头脑风暴
│ └── 管理模板 (2个)
│ ├── project-brief-tmpl.yaml # 项目简介
│ └── story-tmpl.yaml # 用户故事
│
├── agent-teams/ # 团队配置系统
│ ├── team-all.yaml # 完整团队
│ ├── team-fullstack.yaml # 全栈团队
│ ├── team-ide-minimal.yaml # 最小团队
│ └── team-no-ui.yaml # 后端团队
│
├── checklists/ # 检查清单系统
│ ├── architect-checklist.md # 架构师检查清单
│ ├── change-checklist.md # 变更检查清单
│ ├── pm-checklist.md # 产品经理检查清单
│ ├── po-master-checklist.md # 产品负责人检查清单
│ ├── story-dod-checklist.md # 故事完成定义
│ └── story-draft-checklist.md # 故事草稿检查清单
│
└── 核心框架文档 # Claude Code框架
├── CLAUDE.md # 主配置文件
├── COMMANDS.md # 命令系统框架
├── FLAGS.md # 标志系统参考
├── MCP.md # MCP服务集成
├── MODES.md # 操作模式参考
├── ORCHESTRATOR.md # 智能路由系统
├── PERSONAS.md # 人格系统参考
├── PRINCIPLES.md # 核心原则
├── RULES.md # 操作规则
└── GRAPHITI.md # Graphiti MCP集成系统特性矩阵
代理系统能力矩阵
| 代理类型 | 数量 | 特性 | 适用场景 |
|---|---|---|---|
| 核心代理 | 8个 | 轻量、快速、灵活 | 日常开发、小中型项目 |
| 扩展代理 | 8个 | 功能完整、流程标准、质量控制 | 大型项目、复杂业务 |
模板系统能力矩阵
| 模板类别 | 数量 | 覆盖领域 | 生成格式 |
|---|---|---|---|
| 架构设计 | 4个 | 系统设计、技术选型 | Markdown |
| 产品文档 | 3个 | 需求管理、产品规划 | Markdown |
| 分析报告 | 3个 | 市场研究、竞品分析 | Markdown |
| 项目管理 | 2个 | 项目启动、故事管理 | Markdown |
团队配置能力矩阵
| 团队配置 | 代理数量 | 工作流数量 | 适用规模 |
|---|---|---|---|
| 完整团队 | 全部(16个) | 6个 | 大型项目 |
| 全栈团队 | 6个 | 6个 | 中型全栈项目 |
| 最小团队 | 4个 | 0个 | 小型快速项目 |
| 后端团队 | 5个 | 2个 | 纯后端项目 |
使用建议
新用户推荐路径
- 快速体验:
team-ide-minimal+ 核心代理 - 标准开发:
team-fullstack+ 混合代理系统 - 完整应用:
team-all+ 全部代理 + 完整检查清单
项目类型选择指南
- 个人项目: 核心代理 + 基础模板
- 团队项目: 全栈团队配置 + 标准模板
- 大型项目: 全部代理 + 完整模板 + 检查清单系统
系统架构图 - Claude Code文档生态系统全景