by catlog22
JSON-driven multi-agent cadence-team development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution
# Add to your Claude Code skills
git clone https://github.com/catlog22/Claude-Code-WorkflowFrom lite-plan (lightweight) to brainstorm (multi-role analysis)
Gemini, Qwen, Codex, Claude - auto-select or manual
Role-based agents with inner loop execution
Background queue execution service
start/resume/complete/sync workflow sessions
Multi-terminal grid with execution monitor
Template-based workflow visual editing
Agent-to-User interactive interface
📖 New? See Workflow Guide for complete workflow documentation.
npm install -g claude-code-workflow
ccw install -m Global
.codex/skills/)If you use Codex CLI with the .codex/skills/ workflow skills, add these required features to your ~/.codex/config.toml:
[features]
default_mode_request_user_input = true # Enable request_user_input tool for interactive confirmations
multi_agent = true # Enable multi-agent coordination (spawn_agent, wait, etc.)
multi_agent_v2 = true # Enable v4 agent API (fork_context, task_name, send_message, assign_task, list_agents)
enable_fanout = true # Enable spawn_agents_on_csv for parallel wave execution
No comments yet. Be the first to share your thoughts!
These features are required for workflow skills to function properly. Without them, interactive confirmation gates (
request_user_input), subagent orchestration, and CSV-driven parallel execution will not work.
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 |
# 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
Users can semantically specify CLI tools in prompts - the system automatically invokes the corresponding CLI.
| 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 |
| 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 (Augment Context Engine) provides powerful semantic code search.
| Method | Link | |--------|------| | Official | Augment MCP Documentation | | Proxy | ace-tool (GitHub) |
⚠️ In Development: CodexLens is under iterative optimization. Some features may be unstable.
Quick Examples:
# /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"
/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/new # Create new issue
/issue/plan # Plan issue resolution
/issue/queue # Form execution queue
/issue/execute # Execute issue queue
ccw install # Install workflow files
ccw view # Open dashboard
ccw cli -p "..." # Execute CLI tools (Gemini/Qwen/Codex)
ccw upgrade -a # Upgrade all installations
┌─────────────────────────────────────────────────────────────────┐
│ Workflow Skills │
│ 📝 workflow-lite-plan / workflow-multi-cli-plan (lightweight) │
│ 📊 workflow-plan / workflow-tdd-plan (session-based) │
│ 🧪 workflow-test-fix /