https://github.com/catlog22/Claude-Code-Workflow

JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution
https://github.com/catlog22/Claude-Code-Workflow

claude claude-code cli-tools codex context-management gemini-cli json-driven qwen-code task-orchestration workflow-automation

Last synced: 12 days ago
JSON representation

JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution

• Host: GitHub
• URL: https://github.com/catlog22/Claude-Code-Workflow
• Owner: catlog22
• License: mit
• Created: 2025-09-07T09:40:18.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2026-02-23T16:13:53.000Z (17 days ago)
• Last Synced: 2026-02-24T00:14:03.435Z (17 days ago)
• Topics: claude, claude-code, cli-tools, codex, context-management, gemini-cli, json-driven, qwen-code, task-orchestration, workflow-automation
• Language: TypeScript
• Homepage:
• Size: 27.8 MB
• Stars: 1,320
• Watchers: 9
• Forks: 111
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          






  

  

  

  

  



**[English](README.md) | [中文](README_CN.md)**













  

  

  

  






---

## ✨ Key Features



### 🎯 Skill-based Workflows

From `lite-plan` (lightweight) to `brainstorm` (multi-role analysis)

### 🔄 Multi-CLI Orchestration

Gemini, Qwen, Codex, Claude - auto-select or manual

### ⚡ Team Architecture v2

Role-based agents with inner loop execution

### 🔧 Queue Scheduler

Background queue execution service

### 📦 Session Lifecycle

start/resume/complete/sync workflow sessions

### 🖥️ Terminal Dashboard

Multi-terminal grid with execution monitor

### 🎨 Orchestrator Editor

Template-based workflow visual editing

### 💬 A2UI

Agent-to-User interactive interface



> 📖 **New?** See [Workflow Guide](WORKFLOW_GUIDE.md) for complete workflow documentation.

---

## 🚀 Quick Start

### Install CCW

```bash

npm install -g claude-code-workflow

ccw install -m Global

```

### Workflow Skills vs Commands

CCW uses two types of invocations:

| Type | Format | Examples |

|------|--------|----------|

| **Skills** | Trigger phrase (no slash) | `workflow-lite-plan`, `brainstorm`, `workflow-plan` |

| **Commands** | Slash command | `/ccw`, `/workflow/session:start`, `/issue/new` |

### Choose Your Workflow Skill



Skill TriggerUse Case

workflow-lite-planLightweight planning, single-module features

workflow-multi-cli-planMulti-CLI collaborative analysis

workflow-planFull planning with session persistence

workflow-tdd-planTest-driven development

workflow-test-fixTest generation and fix cycles

brainstormMulti-role brainstorming analysis



### Workflow Examples

```bash

# Skill triggers (no slash - just describe what you want)

workflow-lite-plan "Add JWT authentication"

workflow-plan "Implement payment gateway integration"

workflow-execute

# Brainstorming

brainstorm "Design real-time collaboration system"

# Slash commands for session management

/workflow/session:start

/workflow/session:resume

/workflow/session:complete

```

---

## 🛠️ CLI Tool Installation



CLIDescriptionOfficial Docs

GeminiGoogle AI analysisgoogle-gemini/gemini-cli

CodexOpenAI autonomous codingopenai/codex

OpenCodeOpen-source multi-modelopencode-ai/opencode

QwenAlibaba Qwen-CodeQwenLM/Qwen



---

## 🎭 Semantic CLI Invocation












Users can **semantically specify CLI tools** in prompts - the system automatically invokes the corresponding CLI.

### Basic Invocation



| User Prompt | System Action |

|-------------|---------------|

| "Use Gemini to analyze the auth module" | Auto-invoke `gemini` CLI for analysis |

| "Let Codex review this code" | Auto-invoke `codex` CLI for review |

| "Ask Qwen about performance optimization" | Auto-invoke `qwen` CLI for consultation |



### Multi-CLI Orchestration



| Pattern | User Prompt Example |

|---------|---------------------|

| **Collaborative** | "Use Gemini and Codex to collaboratively analyze security vulnerabilities" |

| **Parallel** | "Have Gemini, Codex, and Qwen analyze the architecture in parallel" |

| **Iterative** | "Use Gemini to diagnose, then Codex to fix, iterate until resolved" |

| **Pipeline** | "Gemini designs the solution, Codex implements, Claude reviews" |



---

## 🔍 ACE Tool Configuration

ACE (Augment Context Engine) provides powerful semantic code search.



| Method | Link |

|--------|------|

| **Official** | [Augment MCP Documentation](https://docs.augmentcode.com/context-services/mcp/overview) |

| **Proxy** | [ace-tool (GitHub)](https://github.com/eastxiaodong/ace-tool) |



---

## 📚 CodexLens Local Search

> ⚠️ **In Development**: CodexLens is under iterative optimization. Some features may be unstable.



Search ModeDescription

FTSFull-text search, based on SQLite FTS5

SemanticSemantic search, using local embedding models

HybridHybrid search, combining FTS + Semantic + Reranking



---

## 💻 CCW CLI Commands

### 🌟 Recommended Commands



CommandDescriptionWhen to Use

  /ccw

  Auto workflow orchestrator - analyzes intent, selects workflow, executes

  ✅ General tasks, auto workflow selection

  /ccw-coordinator

  Smart orchestrator - recommends command chains, allows manual adjustment

  🔧 Complex multi-step workflows



**Quick Examples**:

```bash

# /ccw - Auto workflow selection

/ccw "Add user authentication"

/ccw "Fix memory leak in WebSocket"

/ccw "Implement with TDD"

# /ccw-coordinator - Manual chain orchestration

/ccw-coordinator "Implement OAuth2 system"

```

### Session Management Commands

```bash

/workflow:session:start     # Start new workflow session

/workflow:session:resume    # Resume paused session

/workflow:session:list      # List all sessions

/workflow:session:sync      # Sync session work

/workflow:session:complete  # Complete session

```

### Issue Workflow Commands

```bash

/issue/new       # Create new issue

/issue/plan      # Plan issue resolution

/issue/queue     # Form execution queue

/issue/execute   # Execute issue queue

```

### Other CLI Commands

```bash

ccw install           # Install workflow files

ccw view              # Open dashboard

ccw cli -p "..."      # Execute CLI tools (Gemini/Qwen/Codex)

ccw upgrade -a        # Upgrade all installations

```

---

## 🏗️ Architecture

```

┌─────────────────────────────────────────────────────────────────┐

│                     Workflow Skills                              │

│  📝 workflow-lite-plan / workflow-multi-cli-plan (lightweight)  │

│  📊 workflow-plan / workflow-tdd-plan (session-based)           │

│  🧪 workflow-test-fix / workflow-test-fix         │

│  🧠 brainstorm (multi-role analysis)                            │

└─────────────────────────────────────────────────────────────────┘

                              ↓

┌─────────────────────────────────────────────────────────────────┐

│                   Team Architecture v2                          │

│  🤖 team-worker agents with role-spec based execution           │

│  🔄 Inner loop framework for sequential task processing         │

│  📢 Message bus protocol with team coordination                 │

│  🧠 Wisdom accumulation (learnings/decisions/conventions)       │

└─────────────────────────────────────────────────────────────────┘

                              ↓

┌─────────────────────────────────────────────────────────────────┐

│                   Queue Scheduler Service                       │

│  ⚙️ Background execution service with API endpoints             │

│  📊 Queue management and unified CLI execution settings         │

└─────────────────────────────────────────────────────────────────┘

                              ↓

┌─────────────────────────────────────────────────────────────────┐

│                   Terminal Dashboard & Orchestrator             │

│  🖥️ Multi-terminal grid with execution monitor                  │

│  🎨 Template-based workflow editor with slash commands          │

│  📡 Real-time agent communication via A2UI                      │

└─────────────────────────────────────────────────────────────────┘

```

---

## 📦 Project Structure

```

Claude-Code-Workflow/

├── .claude/

│   ├── agents/          # 22 specialized agents (team-worker, cli-discuss, etc.)

│   ├── commands/        # Slash commands (5 categories)

│   │   ├── ccw.md       # Main orchestrator

│   │   ├── ccw-coordinator.md

│   │   ├── cli/         # CLI commands (cli-init, codex-review)

│   │   ├── issue/       # Issue management (plan, execute, queue)

│   │   ├── memory/      # Memory commands (prepare, style-skill-memory)

│   │   └── workflow/    # Workflow commands (session, ui-design, etc.)

│   └── skills/          # 37 modular skills

│       ├── workflow-lite-plan/

│       ├── workflow-plan/

│       ├── workflow-tdd-plan/

│       ├── workflow-test-fix/

│       ├── brainstorm/

│       ├── team-*/      # Team coordination skills

│       └── ...

├── ccw/

│   ├── src/             # TypeScript source code

│   │   ├── commands/    # CLI command implementations

│   │   ├── core/        # Core services (a2ui, auth, hooks, routes)

│   │   ├── mcp-server/  # MCP server implementation

│   │   └── tools/       # Tool implementations

│   └── frontend/        # React frontend (Terminal Dashboard, Orchestrator)

├── codex-lens/          # Local semantic code search engine

└── docs/                # Documentation

```

---

## 🎼 Team Cadence Control (Beat Model)

The v2 team architecture introduces an **event-driven beat model** for efficient orchestration:

```

Beat Cycle (single beat)

======================================================================

  Event                   Coordinator              Workers

----------------------------------------------------------------------

  callback/resume --> +- handleCallback -+

                      |  mark completed   |

                      |  check pipeline   |

                      +- handleSpawnNext -+

                      |  find ready tasks |

                      |  spawn workers ---+--> [team-worker A] Phase 1-5

                      |  (parallel OK)  --+--> [team-worker B] Phase 1-5

                      +- STOP (idle) -----+         |

                                                     |

  callback <-----------------------------------------+

  (next beat)              SendMessage + TaskUpdate(completed)

======================================================================

```

**Key Benefits:**

- 🎯 **Event-driven**: Coordinator only wakes when needed (callback/resume)

- ⚡ **Fast-advance**: Simple successors spawn directly without coordinator roundtrip

- 🔄 **Dynamic pipelines**: Generated per-task from dependency graph

- 📊 **Parallel execution**: Independent tasks run concurrently

---

## 🖥️ Frontend Highlights

### Terminal Dashboard

Multi-terminal grid layout with real-time execution monitoring.

**Features:**

- 🖥️ Multi-terminal grid with resizable panes

- 📊 Execution monitor with agent list

- 📁 File sidebar for project navigation

- 🎯 Session grouping by project tags

- 🌙 Fullscreen/immersive mode

### Orchestrator Editor

Visual workflow template editor with drag-drop.

**Features:**

- 🎨 React Flow-based visual editing

- 📦 Template library with pre-built workflows

- 🔧 Property panel for node configuration

- ⚡ Slash command integration

---

## 🤝 Contributing



  

  



---

## 📄 License



MIT License - see [LICENSE](LICENSE)