From 3d1814be04dcab3bf76b78444665b8ae85e08f13 Mon Sep 17 00:00:00 2001 From: catlog22 Date: Sun, 14 Sep 2025 11:26:50 +0800 Subject: [PATCH] feat: Add comprehensive workflow and task command relationship diagrams MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add 6 new detailed mermaid diagrams showing complete development workflow from brainstorming to execution - Document workflow vs task command relationships and dependencies - Include planning method selection flow based on project complexity - Add brainstorming to execution pipeline with multi-agent coordination - Show task command hierarchy with execution modes and agent selection - Integrate CLI tools (Gemini/Codex) within workflow context - Update README files with workflow examples and planning method guides - Provide clear visual guidance for choosing appropriate development paths Enhanced documentation now covers complete workflow orchestration from initial requirements through planning, execution, and final delivery. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- README.md | 26 +++- README_CN.md | 26 +++- WORKFLOW_DIAGRAMS.md | 319 ++++++++++++++++++++++++++++++++++++++++++- 3 files changed, 368 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 879d15c0..1f981d64 100644 --- a/README.md +++ b/README.md @@ -146,7 +146,31 @@ sequenceDiagram CLI->>User: Display Results ``` -> 📊 **Comprehensive Workflow Diagrams**: For detailed system architecture, agent coordination, session management, and CLI integration diagrams, see [WORKFLOW_DIAGRAMS.md](WORKFLOW_DIAGRAMS.md). +## Complete Development Workflow Examples + +### 🚀 **Complex Feature Development Flow** +```mermaid +graph TD + START[New Feature Request] --> SESSION["/workflow:session:start 'OAuth2 System'"] + SESSION --> BRAINSTORM["/workflow:brainstorm --perspectives=system-architect,security-expert"] + BRAINSTORM --> SYNTHESIS["/workflow:brainstorm:synthesis"] + SYNTHESIS --> PLAN["/workflow:plan --from-brainstorming"] + PLAN --> EXECUTE["/workflow:execute --type=complex"] + EXECUTE --> TASKS["/task:breakdown impl-1 --depth=2"] + TASKS --> IMPL["/task:execute impl-1.1"] + IMPL --> REVIEW["/workflow:review --auto-fix"] + REVIEW --> DOCS["/update-memory-related"] +``` + +### 🎯 **Planning Method Selection Guide** +| Project Type | Recommended Flow | Commands | +|--------------|------------------|----------| +| **Bug Fix** | Direct Planning | `/workflow:plan` → `/task:execute` | +| **Small Feature** | Gemini Analysis | `/gemini:mode:plan` → `/workflow:execute` | +| **Medium Feature** | Document + Gemini | Review docs → `/gemini:analyze` → `/workflow:plan` | +| **Large System** | Full Brainstorming | `/workflow:brainstorm` → synthesis → `/workflow:plan-deep` | + +> 📊 **Comprehensive Workflow Diagrams**: For detailed system architecture, agent coordination, session management, and complete workflow variations, see [WORKFLOW_DIAGRAMS.md](WORKFLOW_DIAGRAMS.md). ## Core Components diff --git a/README_CN.md b/README_CN.md index 926fc6f7..078ed6cf 100644 --- a/README_CN.md +++ b/README_CN.md @@ -146,7 +146,31 @@ sequenceDiagram CLI->>User: 显示结果 ``` -> 📊 **完整工作流图表**: 有关详细的系统架构、智能体协调、会话管理和CLI集成图表，请参见 [WORKFLOW_DIAGRAMS.md](WORKFLOW_DIAGRAMS.md)。 +## 完整开发工作流示例 + +### 🚀 **复杂功能开发流程** +```mermaid +graph TD + START[新功能请求] --> SESSION["/workflow:session:start 'OAuth2系统'"] + SESSION --> BRAINSTORM["/workflow:brainstorm --perspectives=system-architect,security-expert"] + BRAINSTORM --> SYNTHESIS["/workflow:brainstorm:synthesis"] + SYNTHESIS --> PLAN["/workflow:plan --from-brainstorming"] + PLAN --> EXECUTE["/workflow:execute --type=complex"] + EXECUTE --> TASKS["/task:breakdown impl-1 --depth=2"] + TASKS --> IMPL["/task:execute impl-1.1"] + IMPL --> REVIEW["/workflow:review --auto-fix"] + REVIEW --> DOCS["/update-memory-related"] +``` + +### 🎯 **规划方法选择指南** +| 项目类型 | 推荐流程 | 命令序列 | +|----------|----------|----------| +| **Bug修复** | 直接规划 | `/workflow:plan` → `/task:execute` | +| **小功能** | Gemini分析 | `/gemini:mode:plan` → `/workflow:execute` | +| **中等功能** | 文档+Gemini | 查看文档 → `/gemini:analyze` → `/workflow:plan` | +| **大型系统** | 完整头脑风暴 | `/workflow:brainstorm` → 综合 → `/workflow:plan-deep` | + +> 📊 **完整工作流图表**: 有关详细的系统架构、智能体协调、会话管理和完整工作流变体的图表，请参见 [WORKFLOW_DIAGRAMS.md](WORKFLOW_DIAGRAMS.md)。 ## 核心组件 diff --git a/WORKFLOW_DIAGRAMS.md b/WORKFLOW_DIAGRAMS.md index 796863f7..efbdfd64 100644 --- a/WORKFLOW_DIAGRAMS.md +++ b/WORKFLOW_DIAGRAMS.md @@ -448,4 +448,321 @@ flowchart TD - 10-minute execution timeout for complex operations - Sub-millisecond JSON query performance - Atomic session switching with zero overhead -- Intelligent file discovery reducing context switching \ No newline at end of file +- Intelligent file discovery reducing context switching + +## 9. Complete Development Workflow (Workflow vs Task Commands) + +```mermaid +graph TD + START[Project Requirement] --> SESSION["/workflow:session:start"] + + SESSION --> PLANNING_CHOICE{Choose Planning Method} + + PLANNING_CHOICE -->|Collaborative Analysis| BRAINSTORM["/workflow:brainstorm"] + PLANNING_CHOICE -->|AI-Powered Planning| GEMINI_PLAN["/gemini:mode:plan"] + PLANNING_CHOICE -->|Document Analysis| DOC_ANALYSIS["Document Review"] + PLANNING_CHOICE -->|Direct Planning| DIRECT_PLAN["/workflow:plan"] + + subgraph "Brainstorming Path" + BRAINSTORM --> SYNTHESIS["/workflow:brainstorm:synthesis"] + SYNTHESIS --> BRAINSTORM_PLAN["/workflow:plan --from-brainstorming"] + end + + subgraph "Gemini Planning Path" + GEMINI_PLAN --> GEMINI_ANALYSIS["Gemini Analysis Results"] + GEMINI_ANALYSIS --> GEMINI_WF_PLAN["/workflow:plan"] + end + + subgraph "Document Analysis Path" + DOC_ANALYSIS --> DOC_INSIGHTS["Extract Requirements"] + DOC_INSIGHTS --> DOC_PLAN["/workflow:plan"] + end + + BRAINSTORM_PLAN --> WORKFLOW_EXECUTE + GEMINI_WF_PLAN --> WORKFLOW_EXECUTE + DOC_PLAN --> WORKFLOW_EXECUTE + DIRECT_PLAN --> WORKFLOW_EXECUTE + + WORKFLOW_EXECUTE["/workflow:execute"] --> TASK_CREATION["Auto-Create Tasks"] + + subgraph "Task Management Layer" + TASK_CREATION --> TASK_BREAKDOWN["/task:breakdown"] + TASK_BREAKDOWN --> TASK_EXECUTE["/task:execute"] + TASK_EXECUTE --> TASK_STATUS{Task Status} + + TASK_STATUS -->|More Tasks| NEXT_TASK["/task:execute next"] + TASK_STATUS -->|Blocked| TASK_REPLAN["/task:replan"] + TASK_STATUS -->|Complete| TASK_DONE[Task Complete] + + NEXT_TASK --> TASK_EXECUTE + TASK_REPLAN --> TASK_EXECUTE + end + + TASK_DONE --> ALL_DONE{All Tasks Done?} + ALL_DONE -->|No| TASK_EXECUTE + ALL_DONE -->|Yes| WORKFLOW_REVIEW["/workflow:review"] + + WORKFLOW_REVIEW --> FINAL_DOCS["/update-memory-related"] + FINAL_DOCS --> PROJECT_COMPLETE[Project Complete] +``` + +## 10. Workflow Command Relationships + +```mermaid +graph LR + subgraph "Session Management" + WFS_START["/workflow:session:start"] + WFS_PAUSE["/workflow:session:pause"] + WFS_RESUME["/workflow:session:resume"] + WFS_SWITCH["/workflow:session:switch"] + WFS_LIST["/workflow:session:list"] + + WFS_START --> WFS_PAUSE + WFS_PAUSE --> WFS_RESUME + WFS_RESUME --> WFS_SWITCH + WFS_SWITCH --> WFS_LIST + end + + subgraph "Planning Phase" + WF_BRAINSTORM["/workflow:brainstorm"] + WF_PLAN["/workflow:plan"] + WF_PLAN_DEEP["/workflow:plan-deep"] + + WF_BRAINSTORM --> WF_PLAN + WF_PLAN_DEEP --> WF_PLAN + end + + subgraph "Execution Phase" + WF_EXECUTE["/workflow:execute"] + WF_REVIEW["/workflow:review"] + + WF_EXECUTE --> WF_REVIEW + end + + subgraph "Task Layer" + TASK_CREATE["/task:create"] + TASK_BREAKDOWN["/task:breakdown"] + TASK_EXECUTE["/task:execute"] + TASK_REPLAN["/task:replan"] + + TASK_CREATE --> TASK_BREAKDOWN + TASK_BREAKDOWN --> TASK_EXECUTE + TASK_EXECUTE --> TASK_REPLAN + TASK_REPLAN --> TASK_EXECUTE + end + + WFS_START --> WF_BRAINSTORM + WF_PLAN --> WF_EXECUTE + WF_EXECUTE --> TASK_CREATE + WF_REVIEW --> WFS_PAUSE +``` + +## 11. Planning Method Selection Flow + +```mermaid +flowchart TD + PROJECT_START[New Project/Feature] --> COMPLEXITY{Assess Complexity} + + COMPLEXITY -->|Simple < 5 tasks| SIMPLE_FLOW + COMPLEXITY -->|Medium 5-15 tasks| MEDIUM_FLOW + COMPLEXITY -->|Complex > 15 tasks| COMPLEX_FLOW + + subgraph SIMPLE_FLOW["Simple Workflow"] + S_DIRECT["/workflow:plan (direct)"] + S_EXECUTE["/workflow:execute --type=simple"] + S_TASKS["Direct task execution"] + + S_DIRECT --> S_EXECUTE --> S_TASKS + end + + subgraph MEDIUM_FLOW["Medium Workflow"] + M_CHOICE{Planning Method?} + M_GEMINI["/gemini:mode:plan"] + M_DOCS["Review existing docs"] + M_PLAN["/workflow:plan"] + M_EXECUTE["/workflow:execute --type=medium"] + M_BREAKDOWN["/task:breakdown"] + + M_CHOICE -->|AI Planning| M_GEMINI + M_CHOICE -->|Documentation| M_DOCS + M_GEMINI --> M_PLAN + M_DOCS --> M_PLAN + M_PLAN --> M_EXECUTE + M_EXECUTE --> M_BREAKDOWN + end + + subgraph COMPLEX_FLOW["Complex Workflow"] + C_BRAINSTORM["/workflow:brainstorm --perspectives=multiple"] + C_SYNTHESIS["/workflow:brainstorm:synthesis"] + C_PLAN_DEEP["/workflow:plan-deep"] + C_PLAN["/workflow:plan --from-brainstorming"] + C_EXECUTE["/workflow:execute --type=complex"] + C_TASKS["Hierarchical task management"] + + C_BRAINSTORM --> C_SYNTHESIS + C_SYNTHESIS --> C_PLAN_DEEP + C_PLAN_DEEP --> C_PLAN + C_PLAN --> C_EXECUTE + C_EXECUTE --> C_TASKS + end +``` + +## 12. Brainstorming to Execution Pipeline + +```mermaid +sequenceDiagram + participant User + participant WF as Workflow System + participant BS as Brainstorm Agents + participant PLAN as Planning Agent + participant TASK as Task System + participant EXEC as Execution Agents + + User->>WF: /workflow:session:start "Feature Name" + WF->>User: Session Created + + User->>BS: /workflow:brainstorm "topic" --perspectives=system-architect,security-expert + BS->>BS: Multiple Agent Perspectives + BS->>WF: Generate Ideas & Analysis + + User->>BS: /workflow:brainstorm:synthesis + BS->>WF: Consolidated Recommendations + + User->>PLAN: /workflow:plan --from-brainstorming + PLAN->>PLAN: Convert Ideas to Implementation Plan + PLAN->>WF: Generate IMPL_PLAN.md + TODO_LIST.md + + User->>WF: /workflow:execute --type=complex + WF->>TASK: Auto-create task hierarchy + TASK->>TASK: Create impl-*.json files + + loop Task Execution + User->>EXEC: /task:execute impl-1 + EXEC->>EXEC: Execute Implementation + EXEC->>TASK: Update task status + + alt Task needs breakdown + EXEC->>TASK: /task:breakdown impl-1 + TASK->>TASK: Create subtasks + else Task blocked + EXEC->>TASK: /task:replan impl-1 + TASK->>TASK: Adjust task plan + end + end + + User->>WF: /workflow:review + WF->>User: Quality validation complete + + User->>WF: /update-memory-related + WF->>User: Documentation updated +``` + +## 13. Task Command Hierarchy and Dependencies + +```mermaid +graph TB + subgraph "Workflow Layer" + WF_PLAN["/workflow:plan"] + WF_EXECUTE["/workflow:execute"] + WF_REVIEW["/workflow:review"] + end + + subgraph "Task Management Layer" + TASK_CREATE["/task:create"] + TASK_BREAKDOWN["/task:breakdown"] + TASK_REPLAN["/task:replan"] + end + + subgraph "Task Execution Layer" + TASK_EXECUTE["/task:execute"] + + subgraph "Execution Modes" + MANUAL["--mode=guided"] + AUTO["--mode=auto"] + end + + subgraph "Agent Selection" + CODE_AGENT["--agent=code-developer"] + PLAN_AGENT["--agent=planning-agent"] + REVIEW_AGENT["--agent=code-review-test-agent"] + end + end + + subgraph "Task Hierarchy" + MAIN_TASK["impl-1 (Main Task)"] + SUB_TASK1["impl-1.1 (Subtask)"] + SUB_TASK2["impl-1.2 (Subtask)"] + + MAIN_TASK --> SUB_TASK1 + MAIN_TASK --> SUB_TASK2 + end + + WF_PLAN --> TASK_CREATE + WF_EXECUTE --> TASK_CREATE + TASK_CREATE --> TASK_BREAKDOWN + TASK_BREAKDOWN --> MAIN_TASK + MAIN_TASK --> SUB_TASK1 + MAIN_TASK --> SUB_TASK2 + + SUB_TASK1 --> TASK_EXECUTE + SUB_TASK2 --> TASK_EXECUTE + + TASK_EXECUTE --> MANUAL + TASK_EXECUTE --> AUTO + TASK_EXECUTE --> CODE_AGENT + TASK_EXECUTE --> PLAN_AGENT + TASK_EXECUTE --> REVIEW_AGENT + + TASK_EXECUTE --> TASK_REPLAN + TASK_REPLAN --> TASK_BREAKDOWN +``` + +## 14. CLI Integration in Workflow Context + +```mermaid +graph LR + subgraph "Planning Phase CLIs" + GEMINI_PLAN["/gemini:mode:plan"] + GEMINI_ANALYZE["/gemini:analyze"] + CODEX_PLAN["/codex:mode:plan"] + end + + subgraph "Execution Phase CLIs" + GEMINI_EXEC["/gemini:execute"] + CODEX_AUTO["/codex:mode:auto"] + CODEX_EXEC["/codex:execute"] + end + + subgraph "Workflow Commands" + WF_BRAINSTORM["/workflow:brainstorm"] + WF_PLAN["/workflow:plan"] + WF_EXECUTE["/workflow:execute"] + end + + subgraph "Task Commands" + TASK_CREATE["/task:create"] + TASK_EXECUTE["/task:execute"] + end + + subgraph "Context Integration" + UPDATE_MEMORY["/update-memory-related"] + CONTEXT["/context"] + end + + GEMINI_PLAN --> WF_PLAN + GEMINI_ANALYZE --> WF_BRAINSTORM + CODEX_PLAN --> WF_PLAN + + WF_PLAN --> TASK_CREATE + WF_EXECUTE --> TASK_EXECUTE + + TASK_EXECUTE --> GEMINI_EXEC + TASK_EXECUTE --> CODEX_AUTO + TASK_EXECUTE --> CODEX_EXEC + + CODEX_AUTO --> UPDATE_MEMORY + GEMINI_EXEC --> CONTEXT + + UPDATE_MEMORY --> WF_EXECUTE + CONTEXT --> TASK_EXECUTE +``` \ No newline at end of file