What It Does
Claude-Code-Workflow (CCW) is a command-line orchestrator that coordinates multiple Claude Code agents to handle complex development tasks. Instead of manually managing different Claude Code sessions for planning, implementation, and testing, CCW provides a unified interface with semantic commands that automatically invoke the right CLI tools and agents for each phase of your workflow.
Setup & Installation
Install globally via npm:
npm install -g claude-code-workflow
ccw install -m Global
This creates workflow files in your .claude/ directory and sets up 22 specialized agents including team-worker and CLI dispatch agents. The system uses two types of invocations: skill triggers (plain English descriptions) and slash commands for session management.
How To Use It
Skill Triggers (Semantic Commands)
Instead of remembering specific CLI flags, describe what you want:
workflow-lite-plan "Add JWT authentication"
workflow-plan "Implement payment gateway integration"
workflow-execute
brainstorm "Design real-time collaboration system"
The system automatically maps your semantic description to the appropriate CLI tools and agents. This is particularly useful for complex tasks that require multiple steps or specialized knowledge.
Slash Commands for Session Management
CCW provides robust session management through slash commands:
/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
This integrates with Claude Code's native session recovery features (claude --resume and claude --continue) but adds workflow-specific context and coordination.
Quick Examples
Use /ccw for auto workflow selection:
/ccw "Add user authentication"
/ccw "Fix memory leak in WebSocket"
/ccw "Implement with TDD"
For more control, use /ccw-coordinator for manual chain orchestration:
/ccw-coordinator "Implement OAuth2 system"
Issue Management
CCW includes integrated issue tracking:
/issue/new # Create new issue
/issue/plan # Plan issue resolution
/issue/queue # Form execution queue
/issue/execute # Execute issue queue
Architecture
The system follows a layered architecture:
- Workflow Skills Layer - Lightweight and session-based planning tools
- Team Architecture v2 - Team-worker agents with role-specific execution
- Queue Scheduler Service - Background execution with API endpoints
- Terminal Dashboard & Orchestrator - Multi-terminal grid with execution monitor
Key components include:
- ACE (Augment Context Engine) - Powerful semantic code search
- Inner loop framework - Sequential task processing
- Message bus protocol - Team coordination between agents
- Wisdom accumulation - Learns from decisions and conventions
Advanced Features
ccw view # Open dashboard
ccw cli -p "..." # Execute CLI tools (supports Gemini/Qwen/Codex)
ccw upgrade -a # Upgrade all installations
Important Notes
⚠️ CodexLens is under iterative optimization - Some features may be unstable as this is actively developed.
The project structure includes:
Claude-Code-Workflow/
├── .claude/
│ ├── agents/ # 22 specialized agents
│ ├── workflows/ # Template-based workflows
│ └── sessions/ # Session management
└── ...
When To Use It
Use CCW when:
- You're tackling complex, multi-step projects
- You need coordination between different types of tasks (planning, implementation, testing)
- You want to maintain context across multiple Claude Code sessions
- You're working with teams or need role-specific agent coordination
For simple, single-file changes, vanilla Claude Code might be sufficient. But for system-level changes, architectural decisions, or complex feature implementations, CCW's orchestration capabilities can significantly streamline your workflow.
