feat: Add comprehensive workflow and task command relationship diagrams

- 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 <noreply@anthropic.com>

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
 

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)。
 
 ## 核心组件
 

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
+- 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
+```