claude-code-workflow
v6.3.54
JSON-driven multi-agent development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution
0/weekUpdated 1 weeks agoMITUnpacked: 23.8 MB
Published by dyw
npm install claude-code-workflow
---
β¨ Key Features
$3From lite-lite-lite (instant) to brainstorm (multi-role analysis)
$3Gemini, Qwen, Codex, Claude - auto-select or manual $3Agent parallel execution without worktree complexity |
$3Post-development maintenance with optional worktree isolation $3.task/IMPL-*.json as single source of truth
$3Visual session management, CodexLens search, graph explorer |
> π New? See Workflow Guide for the complete 4-level workflow system.
---
π Quick Start
$3
``
bash
npm install -g claude-code-workflow
ccw install -m Global
`
$3
Level Command Use Case
1 /workflow:lite-lite-liteQuick fixes, config changes
2 /workflow:lite-planClear single-module features
2 /workflow:lite-fixBug diagnosis and fix
2 /workflow:multi-cli-planMulti-perspective analysis
3 /workflow:planMulti-module development
3 /workflow:tdd-planTest-driven development
4 /workflow:brainstorm:auto-parallelNew features, architecture design
$3
`bash
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
CLI Description Official Docs
Gemini Google AI analysis google-gemini/gemini-cli
Codex OpenAI autonomous coding openai/codex
OpenCode Open-source multi-model opencode-ai/opencode
Qwen Alibaba Qwen-Code QwenLM/Qwen
---
π Semantic CLI Invocation
Users can semantically specify CLI tools in prompts - the system automatically invokes the corresponding CLI.
$3
| 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 |
$3
| 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" |
π More Examples
`text
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
`
$3
Register any API as a custom CLI via Dashboard interface:
`bash
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.
Search Mode Description
FTS Full-text search, based on SQLite FTS5
Semantic Semantic search, using local embedding models
Hybrid Hybrid search, combining FTS + Semantic + Reranking
π¦ Installation
`bash
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
$3
Command Description When to Use
/ccw
Auto workflow orchestrator - analyzes intent, selects workflow level, executes command chain in main process
β
General tasks, auto workflow selection, quick development
/ccw-coordinator
Smart orchestrator - intelligently recommends command chains, allows manual adjustment, executes via external CLI with state persistence
π§ Complex multi-step workflows, customizable chains, resumable sessions
Quick Examples:
`bash
/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 process (SlashCommand) | External CLI (background tasks) |
| Selection | Auto intent-based | Smart recommendation + optional adjustment |
| State | TodoWrite tracking | Persistent state.json |
| Use Case | General tasks, quick dev | Complex chains, resumable |
---
$3
`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
`
$3
Feature Description
Session Overview Track workflow sessions and progress
CodexLens FTS + Semantic + Hybrid code search
Graph Explorer Interactive code relationship visualization
CLI Manager Execution history with session resume
---
π Documentation
| Document | Description |
|----------|-------------|
| Workflow Guide | 4-level workflow system (recommended) |
| Getting Started | 5-minute quick start |
| Dashboard Guide | Dashboard user guide |
| FAQ | Common questions |
| Changelog | Version history |
---
ποΈ Architecture
`
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Main Workflow (4 Levels) β
β β‘ Level 1: lite-lite-lite (instant, no artifacts) β
β π Level 2: lite-plan / lite-fix / multi-cli-plan (β execute) β
β π Level 3: plan / tdd-plan / test-fix-gen (session persist) β
β π§ Level 4: brainstorm:auto-parallel β plan β execute β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Issue Workflow (Supplement) β
β π discover β π plan β π¦ queue β βΆοΈ execute (worktree) β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
``
Core Principles:
- β‘ Dependency Analysis solves parallelism - no worktree needed for main workflow
- π§ Issue Workflow supplements main workflow for post-development maintenance
- π― Select workflow level based on complexity - avoid over-engineering
---
π€ Contributing
---