catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-05 01:50:27 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: Release v1.2 - Enhanced workflow diagrams and comprehensive documentation updates

Browse Source 
- Add detailed mermaid workflow diagrams in WORKFLOW_DIAGRAMS.md
- Update README.md and README_CN.md with v1.2 features and architecture visualization
- Enhance system architecture diagrams with CLI routing and agent coordination flows
- Document major enhancements since v1.0: task saturation control, Gemini wrapper intelligence
- Add command execution flow diagrams and comprehensive workflow visualizations
- Update CLI guidelines in codex-unified.md and gemini-unified.md with bash() syntax

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
catlog22
2025-09-14 11:13:17 +08:00
parent 3536411419
commit 89fadb5708
5 changed files with 681 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
.claude/workflows/codex-unified.md
View File

@@ -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.

2
.claude/workflows/gemini-unified.md
View File

@@ -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"`

116
README.md
View File

@@ -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

116
README_CN.md
View File

@@ -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)。
## 核心组件
### 多智能体系统

451
WORKFLOW_DIAGRAMS.md Normal file
View File

@@ -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