claude-code-workflow

English | 中文

---

✨ Key Features

🎯 4-Level Workflows

From lite-lite-lite (instant) to brainstorm (multi-role analysis)

🔄 Multi-CLI Orchestration

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

⚡ Dependency-Aware Parallelism

Agent parallel execution without worktree complexity

🔧 Issue Workflow

Post-development maintenance with optional worktree isolation

📦 JSON-First State

.task/IMPL-*.json as single source of truth

🖥️ Dashboard

Visual session management, CodexLens search, graph explorer

📖 New? See Workflow Guide for the complete 4-level workflow system.

---

🚀 Quick Start

Install CCW

npm install -g claude-code-workflow
ccw install -m Global

Choose Your Workflow Level

Workflow Examples

# Level 1: Instant execution
/workflow:lite-lite-lite "Fix typo in README"

# Level 2: Lightweight planning
/workflow:lite-plan "Add JWT authentication"
/workflow:lite-fix "User upload fails with 413 error"

# Level 3: Standard planning with session
/workflow:plan "Implement payment gateway integration"
/workflow:execute

# Level 4: Multi-role brainstorming
/workflow:brainstorm:auto-parallel "Design real-time collaboration system" --count 5
/workflow:plan --session WFS-xxx
/workflow:execute

---

🛠️ CLI Tool Installation

---

🎭 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" |

# Single CLI invocation
User: "Use Gemini to analyze the database query performance"
→ System auto-calls: gemini CLI with analysis task

# Collaborative analysis
User: "Use Gemini and Codex to collaboratively review the authentication flow"
→ System auto-calls: gemini + codex CLIs, synthesizes results

# Parallel multi-perspective
User: "Have all available CLIs analyze this architecture design in parallel"
→ System auto-calls: gemini, codex, qwen in parallel → merged report

# Sequential pipeline
User: "Use Gemini to plan the refactoring, then Codex to implement it"
→ System auto-calls: gemini (plan) → codex (implement) sequentially

Custom CLI Registration

Register any API as a custom CLI via Dashboard interface:

ccw view  # Open Dashboard → Status → API Settings → Add Custom CLI

| Field | Example | |-------|---------| | Name | deepseek | | Endpoint | https://api.deepseek.com/v1/chat | | API Key | your-api-key |

⚙️ Register once, invoke semantically forever - no code changes needed.

---

🔍 ACE Tool Configuration

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

| Method | Link | |--------|------| | Official | Augment MCP Documentation | | Proxy | ace-tool (GitHub) |

---

📚 CodexLens Local Search

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

# Enter codex-lens directory
cd codex-lens

# Install dependencies
pip install -e .

# Initialize index
codexlens index /path/to/project

Open Dashboard via ccw view, manage indexes and execute searches in CodexLens Manager.

---

💻 CCW CLI Commands

🌟 Recommended Commands (Main Features)

Quick Examples:

# /ccw - Auto workflow selection (Main Process)
/ccw "Add user authentication"              # Auto-selects workflow based on intent
/ccw "Fix memory leak in WebSocket"         # Detects bugfix workflow
/ccw "Implement with TDD"                   # Routes to TDD workflow

# /ccw-coordinator - Manual chain orchestration (External CLI)
/ccw-coordinator "Implement OAuth2 system"  # Analyzes → Recommends chain → User confirms → Executes

Key Differences:

| Aspect | /ccw | /ccw-coordinator | |--------|------|------------------| | Execution | Main proc