diff --git a/.claude/workflows/codex-unified.md b/.claude/workflows/codex-unified.md index f95ec55e..db0a69ca 100644 --- a/.claude/workflows/codex-unified.md +++ b/.claude/workflows/codex-unified.md @@ -4,7 +4,7 @@ description: Comprehensive Codex CLI guidelines - core rules, syntax, patterns, type: technical-guideline --- -### 🚀 Command Overview: `codex` +### 🚀 Command Overview: Bash(codex *) - **Purpose**: An AI-powered CLI tool for automated codebase analysis, intelligent code generation, and autonomous development workflows. - **Key Characteristic**: **No `--all-files` flag** - requires explicit `@` pattern references for file inclusion. diff --git a/.claude/workflows/gemini-unified.md b/.claude/workflows/gemini-unified.md index 5c877f95..5363924a 100644 --- a/.claude/workflows/gemini-unified.md +++ b/.claude/workflows/gemini-unified.md @@ -4,7 +4,7 @@ description: Consolidated Gemini CLI guidelines - core rules, syntax, patterns, type: technical-guideline --- -### 🚀 Command Overview: `gemini` +### 🚀 Command Overview: Bash(gemini *) - **Purpose**: A CLI tool for comprehensive codebase analysis, context gathering, and pattern detection across multiple files. - **Directory Analysis Rule**: When user intends to analyze specific directory (cd XXX), always navigate first: `cd XXX && gemini -p "prompt"` diff --git a/README.md b/README.md index 7e8adced..879d15c0 100644 --- a/README.md +++ b/README.md @@ -8,11 +8,61 @@ A comprehensive multi-agent automation framework for software development that orchestrates complex development tasks through intelligent workflow management and autonomous execution. -> **📦 Latest Release v1.1**: Unified CLI architecture with integrated Gemini (analysis) and Codex (development) workflows, shared template system, and autonomous development capabilities. See [CHANGELOG.md](CHANGELOG.md) for details. +> **📦 Latest Release v1.2**: Enhanced workflow diagrams, intelligent task saturation control, path-specific analysis system, and comprehensive documentation updates with detailed mermaid visualizations. See [CHANGELOG.md](CHANGELOG.md) for details. ## Architecture Overview -Claude Code Workflow (CCW) is built on three core architectural principles: +Claude Code Workflow (CCW) is built on three core architectural principles enhanced with intelligent workflow orchestration: + +### **System Architecture Visualization** + +```mermaid +graph TB + subgraph "CLI Interface Layer" + CLI[CLI Commands] + GEM[Gemini CLI] + COD[Codex CLI] + WRAPPER[Gemini Wrapper] + end + + subgraph "Session Management" + MARKER[".active-session marker"] + SESSION["workflow-session.json"] + WDIR[".workflow/ directories"] + end + + subgraph "Task System" + TASK_JSON[".task/impl-*.json"] + HIERARCHY["Task Hierarchy (max 2 levels)"] + STATUS["Task Status Management"] + end + + subgraph "Agent Orchestration" + PLAN_AGENT[Conceptual Planning Agent] + ACTION_AGENT[Action Planning Agent] + CODE_AGENT[Code Developer] + REVIEW_AGENT[Code Review Agent] + MEMORY_AGENT[Memory Gemini Bridge] + end + + CLI --> GEM + CLI --> COD + CLI --> WRAPPER + WRAPPER --> GEM + + GEM --> PLAN_AGENT + COD --> CODE_AGENT + + PLAN_AGENT --> TASK_JSON + ACTION_AGENT --> TASK_JSON + CODE_AGENT --> TASK_JSON + + TASK_JSON --> HIERARCHY + HIERARCHY --> STATUS + + SESSION --> MARKER + MARKER --> WDIR +``` ### **JSON-First Data Model** - **Single Source of Truth**: All workflow states and task definitions stored in structured `.task/impl-*.json` files @@ -36,6 +86,68 @@ CCW automatically adjusts workflow structure based on project complexity: | **Medium** | 5-15 tasks | Two-level task breakdown | Progress tracking, automated documentation | | **Complex** | >15 tasks | Three-level deep hierarchy | Full orchestration, multi-agent coordination | +## Major Enhancements Since v1.0 + +### **🚀 Intelligent Task Saturation Control** +Advanced workflow planning prevents agent overload and optimizes task distribution across the system. + +### **🧠 Gemini Wrapper Intelligence** +Smart wrapper automatically manages token limits and approval modes based on task analysis: +- Analysis keywords → `--approval-mode default` +- Development tasks → `--approval-mode yolo` +- Automatic `--all-files` flag management based on project size + +### **🎯 Path-Specific Analysis System** +New task-specific path management enables precise CLI analysis targeting concrete project paths instead of wildcards. + +### **📝 Unified Template System** +Cross-tool template compatibility with shared template library supporting both Gemini and Codex workflows. + +### **⚡ Enhanced Performance** +- Sub-millisecond JSON query response times +- 10-minute execution timeout for complex operations +- On-demand file creation reduces initialization overhead + +### **Command Execution Flow** + +```mermaid +sequenceDiagram + participant User + participant CLI + participant GeminiWrapper as Gemini Wrapper + participant GeminiCLI as Gemini CLI + participant CodexCLI as Codex CLI + participant Agent + participant TaskSystem as Task System + participant FileSystem as File System + + User->>CLI: Command Request + CLI->>CLI: Parse Command Type + + alt Analysis Task + CLI->>GeminiWrapper: Analysis Request + GeminiWrapper->>GeminiWrapper: Check Token Limit + GeminiWrapper->>GeminiWrapper: Set Approval Mode + GeminiWrapper->>GeminiCLI: Execute Analysis + GeminiCLI->>FileSystem: Read Codebase + GeminiCLI->>Agent: Route to Planning Agent + else Development Task + CLI->>CodexCLI: Development Request + CodexCLI->>Agent: Route to Code Agent + end + + Agent->>TaskSystem: Create/Update Tasks + TaskSystem->>FileSystem: Save task JSON + Agent->>Agent: Execute Task Logic + Agent->>FileSystem: Apply Changes + Agent->>TaskSystem: Update Task Status + TaskSystem->>FileSystem: Regenerate Markdown Views + Agent->>CLI: Return Results + 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). + ## Core Components ### Multi-Agent System diff --git a/README_CN.md b/README_CN.md index 09c51b1b..926fc6f7 100644 --- a/README_CN.md +++ b/README_CN.md @@ -8,11 +8,61 @@ 一个全面的多智能体自动化开发框架，通过智能工作流管理和自主执行协调复杂的软件开发任务。 -> **📦 最新版本 v1.1**: 统一的CLI架构，集成Gemini（分析）和Codex（开发）工作流，共享模板系统和自主开发能力。详见[CHANGELOG.md](CHANGELOG.md)。 +> **📦 最新版本 v1.2**: 增强工作流图表、智能任务饱和控制、路径特定分析系统以及包含详细mermaid可视化的综合文档更新。详见[CHANGELOG.md](CHANGELOG.md)。 ## 架构概览 -Claude Code Workflow (CCW) 建立在三个核心架构原则之上： +Claude Code Workflow (CCW) 建立在三个核心架构原则之上，具备智能工作流编排功能： + +### **系统架构可视化** + +```mermaid +graph TB + subgraph "CLI接口层" + CLI[CLI命令] + GEM[Gemini CLI] + COD[Codex CLI] + WRAPPER[Gemini包装器] + end + + subgraph "会话管理" + MARKER[".active-session 标记"] + SESSION["workflow-session.json"] + WDIR[".workflow/ 目录"] + end + + subgraph "任务系统" + TASK_JSON[".task/impl-*.json"] + HIERARCHY["任务层次结构（最多2级）"] + STATUS["任务状态管理"] + end + + subgraph "智能体编排" + PLAN_AGENT[概念规划智能体] + ACTION_AGENT[行动规划智能体] + CODE_AGENT[代码开发智能体] + REVIEW_AGENT[代码审查智能体] + MEMORY_AGENT[记忆桥接智能体] + end + + CLI --> GEM + CLI --> COD + CLI --> WRAPPER + WRAPPER --> GEM + + GEM --> PLAN_AGENT + COD --> CODE_AGENT + + PLAN_AGENT --> TASK_JSON + ACTION_AGENT --> TASK_JSON + CODE_AGENT --> TASK_JSON + + TASK_JSON --> HIERARCHY + HIERARCHY --> STATUS + + SESSION --> MARKER + MARKER --> WDIR +``` ### **JSON优先数据模型** - **单一数据源**: 所有工作流状态和任务定义存储在结构化的 `.task/impl-*.json` 文件中 @@ -36,6 +86,68 @@ CCW根据项目复杂度自动调整工作流结构： | **中等** | 5-15个任务 | 两级任务分解 | 进度跟踪，自动文档 | | **复杂** | >15个任务 | 三级深度层次结构 | 完全编排，多智能体协调 | +## v1.0以来的主要增强功能 + +### **🚀 智能任务饱和控制** +高级工作流规划防止智能体过载，优化整个系统中的任务分配。 + +### **🧠 Gemini包装器智能** +智能包装器根据任务分析自动管理令牌限制和审批模式： +- 分析关键词 → `--approval-mode default` +- 开发任务 → `--approval-mode yolo` +- 基于项目大小的自动 `--all-files` 标志管理 + +### **🎯 路径特定分析系统** +新的任务特定路径管理系统，实现针对具体项目路径的精确CLI分析，替代通配符。 + +### **📝 统一模板系统** +跨工具模板兼容性，共享模板库支持Gemini和Codex工作流。 + +### **⚡ 性能增强** +- 亚毫秒级JSON查询响应时间 +- 复杂操作10分钟执行超时 +- 按需文件创建减少初始化开销 + +### **命令执行流程** + +```mermaid +sequenceDiagram + participant User as 用户 + participant CLI + participant GeminiWrapper as Gemini包装器 + participant GeminiCLI as Gemini CLI + participant CodexCLI as Codex CLI + participant Agent as 智能体 + participant TaskSystem as 任务系统 + participant FileSystem as 文件系统 + + User->>CLI: 命令请求 + CLI->>CLI: 解析命令类型 + + alt 分析任务 + CLI->>GeminiWrapper: 分析请求 + GeminiWrapper->>GeminiWrapper: 检查令牌限制 + GeminiWrapper->>GeminiWrapper: 设置审批模式 + GeminiWrapper->>GeminiCLI: 执行分析 + GeminiCLI->>FileSystem: 读取代码库 + GeminiCLI->>Agent: 路由到规划智能体 + else 开发任务 + CLI->>CodexCLI: 开发请求 + CodexCLI->>Agent: 路由到代码智能体 + end + + Agent->>TaskSystem: 创建/更新任务 + TaskSystem->>FileSystem: 保存任务JSON + Agent->>Agent: 执行任务逻辑 + Agent->>FileSystem: 应用变更 + Agent->>TaskSystem: 更新任务状态 + TaskSystem->>FileSystem: 重新生成Markdown视图 + Agent->>CLI: 返回结果 + CLI->>User: 显示结果 +``` + +> 📊 **完整工作流图表**: 有关详细的系统架构、智能体协调、会话管理和CLI集成图表，请参见 [WORKFLOW_DIAGRAMS.md](WORKFLOW_DIAGRAMS.md)。 + ## 核心组件 ### 多智能体系统 diff --git a/WORKFLOW_DIAGRAMS.md b/WORKFLOW_DIAGRAMS.md new file mode 100644 index 00000000..796863f7 --- /dev/null +++ b/WORKFLOW_DIAGRAMS.md @@ -0,0 +1,451 @@ +# Claude Code Workflow (CCW) - Enhanced Workflow Diagrams + +Based on comprehensive analysis of changes since v1.0, this document provides detailed mermaid diagrams illustrating the CCW architecture and execution flows. + +## 1. System Architecture Overview + +```mermaid +graph TB + subgraph "CLI Interface Layer" + CLI[CLI Commands] + GEM[Gemini CLI] + COD[Codex CLI] + WRAPPER[Gemini Wrapper] + end + + subgraph "Session Management" + MARKER[".active-session marker"] + SESSION["workflow-session.json"] + WDIR[".workflow/ directories"] + end + + subgraph "Task System" + TASK_JSON[".task/impl-*.json"] + HIERARCHY["Task Hierarchy (max 2 levels)"] + STATUS["Task Status Management"] + end + + subgraph "Agent Orchestration" + PLAN_AGENT[Conceptual Planning Agent] + ACTION_AGENT[Action Planning Agent] + CODE_AGENT[Code Developer] + REVIEW_AGENT[Code Review Agent] + MEMORY_AGENT[Memory Gemini Bridge] + end + + subgraph "Template System" + ANALYSIS_TMPL[Analysis Templates] + DEV_TMPL[Development Templates] + PLAN_TMPL[Planning Templates] + REVIEW_TMPL[Review Templates] + end + + subgraph "Output Generation" + TODO_MD["TODO_LIST.md"] + IMPL_MD["IMPL_PLAN.md"] + SUMMARY[".summaries/"] + CHAT[".chat/ sessions"] + end + + CLI --> GEM + CLI --> COD + CLI --> WRAPPER + WRAPPER --> GEM + + GEM --> PLAN_AGENT + COD --> CODE_AGENT + + PLAN_AGENT --> TASK_JSON + ACTION_AGENT --> TASK_JSON + CODE_AGENT --> TASK_JSON + + TASK_JSON --> HIERARCHY + HIERARCHY --> STATUS + + SESSION --> MARKER + MARKER --> WDIR + + ANALYSIS_TMPL --> GEM + DEV_TMPL --> COD + PLAN_TMPL --> PLAN_AGENT + + TASK_JSON --> TODO_MD + TASK_JSON --> IMPL_MD + STATUS --> SUMMARY + GEM --> CHAT + COD --> CHAT +``` + +## 2. Command Execution Flow + +```mermaid +sequenceDiagram + participant User + participant CLI + participant GeminiWrapper as Gemini Wrapper + participant GeminiCLI as Gemini CLI + participant CodexCLI as Codex CLI + participant Agent + participant TaskSystem as Task System + participant FileSystem as File System + + User->>CLI: Command Request + CLI->>CLI: Parse Command Type + + alt Analysis Task + CLI->>GeminiWrapper: Analysis Request + GeminiWrapper->>GeminiWrapper: Check Token Limit + GeminiWrapper->>GeminiWrapper: Set Approval Mode + GeminiWrapper->>GeminiCLI: Execute Analysis + GeminiCLI->>FileSystem: Read Codebase + GeminiCLI->>Agent: Route to Planning Agent + else Development Task + CLI->>CodexCLI: Development Request + CodexCLI->>Agent: Route to Code Agent + end + + Agent->>TaskSystem: Create/Update Tasks + TaskSystem->>FileSystem: Save task JSON + Agent->>Agent: Execute Task Logic + Agent->>FileSystem: Apply Changes + Agent->>TaskSystem: Update Task Status + TaskSystem->>FileSystem: Regenerate Markdown Views + Agent->>CLI: Return Results + CLI->>User: Display Results +``` + +## 3. Session Management Flow + +```mermaid +stateDiagram-v2 + [*] --> SessionInit: Create New Session + + SessionInit --> CreateStructure: mkdir .workflow/WFS-session-name + CreateStructure --> CreateJSON: Create workflow-session.json + CreateJSON --> CreatePlan: Create IMPL_PLAN.md + CreatePlan --> CreateTasks: Create .task/ directory + CreateTasks --> SetActive: touch .active-session-name + + SetActive --> Active: Session Ready + + Active --> Paused: Switch to Another Session + Active --> Working: Execute Tasks + Active --> Completed: All Tasks Done + + Paused --> Active: Resume Session (set marker) + Working --> Active: Task Complete + Completed --> [*]: Archive Session + + state Working { + [*] --> TaskExecution + TaskExecution --> AgentProcessing + AgentProcessing --> TaskUpdate + TaskUpdate --> [*] + } +``` + +## 4. Task Lifecycle Management + +```mermaid +graph TD + subgraph "Task Creation" + REQ[Requirements] --> ANALYZE{Analysis Needed?} + ANALYZE -->|Yes| GEMINI[Gemini Analysis] + ANALYZE -->|No| DIRECT[Direct Creation] + GEMINI --> CONTEXT[Extract Context] + CONTEXT --> TASK_JSON[Create impl-*.json] + DIRECT --> TASK_JSON + end + + subgraph "Task Hierarchy" + TASK_JSON --> SIMPLE{<5 Tasks?} + SIMPLE -->|Yes| SINGLE[Single Level: impl-N] + SIMPLE -->|No| MULTI[Two Levels: impl-N.M] + + SINGLE --> EXEC1[Direct Execution] + MULTI --> DECOMP[Task Decomposition] + DECOMP --> SUBTASKS[Create Subtasks] + SUBTASKS --> EXEC2[Execute Leaf Tasks] + end + + subgraph "Task Execution" + EXEC1 --> AGENT_SELECT[Select Agent] + EXEC2 --> AGENT_SELECT + AGENT_SELECT --> PLAN_A[Planning Agent] + AGENT_SELECT --> CODE_A[Code Agent] + AGENT_SELECT --> REVIEW_A[Review Agent] + + PLAN_A --> UPDATE_STATUS[Update Status] + CODE_A --> UPDATE_STATUS + REVIEW_A --> UPDATE_STATUS + + UPDATE_STATUS --> COMPLETED{All Done?} + COMPLETED -->|No| NEXT_TASK[Next Task] + COMPLETED -->|Yes| SUMMARY[Generate Summary] + + NEXT_TASK --> AGENT_SELECT + SUMMARY --> REGEN[Regenerate Views] + REGEN --> DONE[Session Complete] + end +``` + +## 5. CLI Tool Integration Architecture + +```mermaid +graph TB + subgraph "User Input Layer" + CMD[User Commands] + INTENT{Task Intent} + end + + subgraph "CLI Routing Layer" + DISPATCHER[Command Dispatcher] + GEMINI_ROUTE[Gemini Route] + CODEX_ROUTE[Codex Route] + end + + subgraph "Gemini Analysis Path" + WRAPPER[Gemini Wrapper] + TOKEN_CHECK{Token Limit Check} + APPROVAL_MODE[Set Approval Mode] + GEMINI_EXEC[Gemini Execution] + + subgraph "Gemini Features" + ALL_FILES[--all-files Mode] + PATTERNS[@{pattern} Mode] + TEMPLATES[Template Integration] + end + end + + subgraph "Codex Development Path" + CODEX_EXEC[Codex --full-auto exec] + AUTO_DISCOVERY[Automatic File Discovery] + CONTEXT_AWARE[Context-Aware Execution] + + subgraph "Codex Features" + EXPLICIT_PATTERNS[@{pattern} Control] + AUTONOMOUS[Full Autonomous Mode] + TEMPLATE_INTEGRATION[Template Support] + end + end + + subgraph "Backend Processing" + FILE_ANALYSIS[File Analysis] + CONTEXT_EXTRACTION[Context Extraction] + CODE_GENERATION[Code Generation] + VALIDATION[Validation & Testing] + end + + subgraph "Output Layer" + RESULTS[Command Results] + ARTIFACTS[Generated Artifacts] + DOCUMENTATION[Updated Documentation] + end + + CMD --> INTENT + INTENT -->|Analyze/Review/Understand| GEMINI_ROUTE + INTENT -->|Implement/Build/Develop| CODEX_ROUTE + + GEMINI_ROUTE --> WRAPPER + WRAPPER --> TOKEN_CHECK + TOKEN_CHECK -->|<2M tokens| ALL_FILES + TOKEN_CHECK -->|>2M tokens| PATTERNS + ALL_FILES --> APPROVAL_MODE + PATTERNS --> APPROVAL_MODE + APPROVAL_MODE --> GEMINI_EXEC + GEMINI_EXEC --> TEMPLATES + + CODEX_ROUTE --> CODEX_EXEC + CODEX_EXEC --> AUTO_DISCOVERY + AUTO_DISCOVERY --> CONTEXT_AWARE + CONTEXT_AWARE --> AUTONOMOUS + AUTONOMOUS --> TEMPLATE_INTEGRATION + + TEMPLATES --> FILE_ANALYSIS + TEMPLATE_INTEGRATION --> FILE_ANALYSIS + + FILE_ANALYSIS --> CONTEXT_EXTRACTION + CONTEXT_EXTRACTION --> CODE_GENERATION + CODE_GENERATION --> VALIDATION + VALIDATION --> RESULTS + + RESULTS --> ARTIFACTS + ARTIFACTS --> DOCUMENTATION +``` + +## 6. Agent Workflow Coordination + +```mermaid +sequenceDiagram + participant TaskSystem as Task System + participant PlanningAgent as Conceptual Planning + participant ActionAgent as Action Planning + participant CodeAgent as Code Developer + participant ReviewAgent as Code Review + participant MemoryAgent as Memory Bridge + + TaskSystem->>PlanningAgent: New Complex Task + PlanningAgent->>PlanningAgent: Strategic Analysis + PlanningAgent->>ActionAgent: High-Level Plan + + ActionAgent->>ActionAgent: Break Down into Tasks + ActionAgent->>TaskSystem: Create Task Hierarchy + TaskSystem->>TaskSystem: Generate impl-*.json files + + loop For Each Implementation Task + TaskSystem->>CodeAgent: Execute Task + CodeAgent->>CodeAgent: Analyze Context + CodeAgent->>CodeAgent: Generate Code + CodeAgent->>TaskSystem: Update Status + + TaskSystem->>ReviewAgent: Review Code + ReviewAgent->>ReviewAgent: Quality Check + ReviewAgent->>ReviewAgent: Test Validation + ReviewAgent->>TaskSystem: Approval/Feedback + + alt Code Needs Revision + TaskSystem->>CodeAgent: Implement Changes + else Code Approved + TaskSystem->>TaskSystem: Mark Complete + end + end + + TaskSystem->>MemoryAgent: Update Documentation + MemoryAgent->>MemoryAgent: Generate Summaries + MemoryAgent->>MemoryAgent: Update README/Docs + MemoryAgent->>TaskSystem: Documentation Complete +``` + +## 7. Template System Architecture + +```mermaid +graph LR + subgraph "Template Categories" + ANALYSIS[Analysis Templates] + DEVELOPMENT[Development Templates] + PLANNING[Planning Templates] + AUTOMATION[Automation Templates] + REVIEW[Review Templates] + INTEGRATION[Integration Templates] + end + + subgraph "Template Files" + ANALYSIS --> PATTERN[pattern.txt] + ANALYSIS --> ARCH[architecture.txt] + ANALYSIS --> SECURITY[security.txt] + + DEVELOPMENT --> FEATURE[feature.txt] + DEVELOPMENT --> COMPONENT[component.txt] + DEVELOPMENT --> REFACTOR[refactor.txt] + + PLANNING --> BREAKDOWN[task-breakdown.txt] + PLANNING --> MIGRATION[migration.txt] + + AUTOMATION --> SCAFFOLD[scaffold.txt] + AUTOMATION --> DEPLOY[deployment.txt] + + REVIEW --> CODE_REVIEW[code-review.txt] + + INTEGRATION --> API[api-design.txt] + INTEGRATION --> DATABASE[database.txt] + end + + subgraph "Usage Integration" + CLI_GEMINI[Gemini CLI] + CLI_CODEX[Codex CLI] + AGENTS[Agent System] + + CLI_GEMINI --> ANALYSIS + CLI_CODEX --> DEVELOPMENT + CLI_CODEX --> AUTOMATION + AGENTS --> PLANNING + AGENTS --> REVIEW + AGENTS --> INTEGRATION + end + + subgraph "Template Resolution" + CAT_CMD["$(cat ~/.claude/workflows/cli-templates/prompts/[category]/[template].txt)"] + MULTI_TMPL[Multi-Template Composition] + HEREDOC[HEREDOC Support] + end + + PATTERN --> CAT_CMD + FEATURE --> CAT_CMD + BREAKDOWN --> CAT_CMD + + CAT_CMD --> MULTI_TMPL + MULTI_TMPL --> HEREDOC + HEREDOC --> CLI_GEMINI + HEREDOC --> CLI_CODEX +``` + +## 8. Complexity Management System + +```mermaid +flowchart TD + INPUT[Task Input] --> ASSESS{Assess Complexity} + + ASSESS -->|<5 tasks| SIMPLE[Simple Workflow] + ASSESS -->|5-15 tasks| MEDIUM[Medium Workflow] + ASSESS -->|>15 tasks| COMPLEX[Complex Workflow] + + subgraph "Simple Workflow" + SIMPLE_STRUCT[Single-Level: impl-N] + SIMPLE_EXEC[Direct Execution] + SIMPLE_MIN[Minimal Overhead] + + SIMPLE --> SIMPLE_STRUCT + SIMPLE_STRUCT --> SIMPLE_EXEC + SIMPLE_EXEC --> SIMPLE_MIN + end + + subgraph "Medium Workflow" + MEDIUM_STRUCT[Two-Level: impl-N.M] + MEDIUM_PROGRESS[Progress Tracking] + MEDIUM_DOCS[Auto Documentation] + + MEDIUM --> MEDIUM_STRUCT + MEDIUM_STRUCT --> MEDIUM_PROGRESS + MEDIUM_PROGRESS --> MEDIUM_DOCS + end + + subgraph "Complex Workflow" + COMPLEX_STRUCT[Deep Hierarchy] + COMPLEX_ORCHESTRATION[Multi-Agent Orchestration] + COMPLEX_COORD[Full Coordination] + + COMPLEX --> COMPLEX_STRUCT + COMPLEX_STRUCT --> COMPLEX_ORCHESTRATION + COMPLEX_ORCHESTRATION --> COMPLEX_COORD + end + + subgraph "Dynamic Adaptation" + RUNTIME_UPGRADE[Runtime Complexity Upgrade] + SATURATION_CONTROL[Task Saturation Control] + INTELLIGENT_DECOMP[Intelligent Decomposition] + end + + SIMPLE_MIN --> RUNTIME_UPGRADE + MEDIUM_DOCS --> RUNTIME_UPGRADE + COMPLEX_COORD --> SATURATION_CONTROL + SATURATION_CONTROL --> INTELLIGENT_DECOMP +``` + +## Key Architectural Changes Since v1.0 + +### Major Enhancements: +1. **Intelligent Task Saturation Control**: Prevents overwhelming agents with too many simultaneous tasks +2. **Gemini Wrapper Intelligence**: Automatic token management and approval mode detection +3. **Path-Specific Analysis**: Task-specific path management for precise CLI analysis +4. **Template System Integration**: Unified template system across all CLI tools +5. **Session Context Passing**: Proper context management for agent coordination +6. **On-Demand File Creation**: Improved performance through lazy initialization +7. **Enhanced Error Handling**: Comprehensive error logging and recovery +8. **Codex Full-Auto Mode**: Maximum autonomous development capabilities +9. **Cross-Tool Template Compatibility**: Seamless template sharing between Gemini and Codex + +### Performance Improvements: +- 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