A JSON-driven multi-agent development framework featuring a 4-level workflow system, intelligent multi-CLI orchestration, and dependency-aware parallel execution for automated feature development, bug fixing, and TDD.
Claude Code Workflow (CCW)#
Overview#
Claude Code Workflow (CCW) is an intelligent development orchestration framework built on TypeScript and Python, developed by dyw (catlog22). It addresses context management and tool fragmentation in AI-assisted development through a 4-level workflow system ranging from instant execution to full automation.
Key Facts:
- Current Version: v6.3.54
- License: MIT License
- NPM Package: claude-code-workflow
- Runtime: Node.js >= 18.0.0
- Languages: TypeScript (70%), Python (24.3%)
Core Capabilities#
4-Level Workflow System#
| Level | Command Example | Characteristics |
|---|---|---|
| Level 1 | /workflow:lite-lite-lite | Instant execution, no artifacts |
| Level 2 | /workflow:lite-plan, /workflow:lite-fix | Lightweight planning |
| Level 3 | /workflow:plan, /workflow:tdd-plan | Standard planning with session persistence |
| Level 4 | /workflow:brainstorm:auto-parallel | Multi-role brainstorming → planning → execution |
| Level 5 | /ccw, /ccw-coordinator | Full automatic intelligent orchestration |
Multi-CLI Orchestration#
Semantic invocation of external CLI tools: Gemini CLI, Qwen Code, OpenAI Codex, OpenCode.
Collaboration Modes: Collaborative, Parallel, Iterative, Pipeline
Dependency-Aware Parallel Execution#
Automatic dependency analysis during planning phase, identifying task dependencies and critical paths, partitioning into parallel groups and serial chains without requiring worktree.
CodexLens Code Search#
- FTS: Full-text search based on SQLite FTS5
- Semantic: Semantic search using local embedding models
- Hybrid: FTS + Semantic + Reranking combined search
Dashboard Visualization#
Session Overview, CodexLens search interface, Graph Explorer (code relationship visualization), CLI Manager (execution history and session recovery).
Installation & Quick Start#
# Global installation
npm install -g claude-code-workflow
# Initialize
ccw install -m Global
5-Minute Quick Start:
- Create plan:
/workflow:plan "Create a simple Express API" - Execute plan:
/workflow:execute - Check status:
/workflow:status
Typical Use Cases#
- Rapid Feature Development:
/workflow:plan "Implement JWT-based login" - Bug Diagnosis & Fixing:
/workflow:lite-fix "Incorrect success message" - Multi-role Brainstorming:
/workflow:brainstorm:auto-parallel "Design real-time collaborative editor" --count 5 - TDD Development:
/workflow:tdd-plan "Implement payment gateway" - UI Design Exploration:
/workflow:ui-design:explore-auto --prompt "Modern admin dashboard"
Architecture#
Layered architecture with multi-level workflow system at the top,调度 external CLI tools via MCP protocol and pseudo-terminal technology at the bottom.
Core Modules:
ccw/- TypeScript core backendccw/frontend/- Dashboard frontendcodex-lens/- Python code search module.claude/- Claude configuration (agents, commands, skills)
Key Commands#
| Command | Description |
|---|---|
ccw install | Install workflow files |
ccw view | Open Dashboard |
ccw cli -p "..." | Execute CLI tool |
/ccw | Auto workflow orchestrator |
/ccw-coordinator | Intelligent orchestration entry |
Customization#
Register any API as a custom CLI tool through Dashboard by configuring Name, Endpoint, and API Key.
CLAUDE.md Memory Management: /memory:update-full (full index rebuild), /memory:load (load task context), /memory:update-related (incremental update)