Claude-Code-Workflow

---

✨ Key Features

📖 New? See Workflow Guide for complete workflow documentation.

---

🚀 Quick Start

Install CCW

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

Codex Configuration (Required for .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

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.

Workflow Skills vs Commands

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

Choose Your Workflow Skill

Workflow Examples

# 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

---

🛠️ CLI Tool Installation

---

🎭 Semantic CLI Invocation

Users can semantically specify CLI tools in prompts - the system automatically invokes the corresponding CLI.

Basic Invocation

Multi-CLI Orchestration

---

🔍 ACE Tool Configuration

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

---

📚 CodexLens Local Search

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

---

💻 CCW CLI Commands

🌟 Recommended Commands

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"

Session Management 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

Issue Workflow Commands

/issue/new       # Create new issue
/issue/plan      # Plan issue resolution
/issue/queue     # Form execution queue
/issue/execute   # Execute issue queue

Other CLI Commands

ccw install           # Install workflow files
ccw view              # Open dashboard
ccw cli -p "..."      # Execute CLI tools (Gemini/Qwen/Codex)
ccw upgrade -a        # Upgrade all installations

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                     Workflow Skills                              │
│  📝 workflow-lite-plan / workflow-multi-cli-plan (lightweight)  │
│  📊 workflow-plan / workflow-tdd-plan (session-based)           │
│  🧪 workflow-test-fix / workflow-test-fix         │
│  🧠 brainstorm (multi-role analysis)                            │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                   Team Architecture v2                          │
│  🤖 team-worker agents with role-spec based execution           │
│  🔄 Inner loop framework for sequential task processing         │
│  📢 Message bus protocol with team coordination                 │
│  🧠 Wisdom accumulation (learnings/decisions/conventions)       │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                   Queue Scheduler Service                       │
│  ⚙️ Background execution service with API endpoints             │
│  📊 Queue management and unified CLI execution settings         │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│                   Terminal Dashboard & Orchestrator             │
│  🖥️ Multi-terminal grid with execution monitor                  │
│  🎨 Template-based workflow editor with slash commands          │
│  📡 Real-time agent communication via A2UI                      │
└─────────────────────────────────────────────────────────────────┘

---

📦 Project Structure

Claude-Code-Workflow/
├── .claude/
│   ├── agents/          # 22 specialized agents (team-worker, cli-discuss, etc.)
│   ├── commands/        # Slash commands (5 categories)
│   │   ├── ccw.md       # Main orchestrator
│   │   ├── ccw-coordinator.md
│   │   ├── cli/         # CLI commands (cli-init, codex-review)
│   │   ├── issue/       # Issue management (plan, execute, queue)
│   │   ├── memory/      # Memory commands (prepare, style-skill-memory)
│   │   └── workflow/    # Workflow commands (session, ui-design, etc.)
│   └── skills/          # 37 modular skills
│       ├── workflow-lite-plan/
│       ├── workflow-plan/
│       ├── workflow-tdd-plan/
│       ├── workflow-test-fix/
│       ├── brainstorm/
│       ├── team-*/      # Team coordination skills
│       └── ...
├── ccw/
│   ├── src/             # TypeScript source code
│   │   ├── commands/    # CLI command implementations
│   │   ├── core/        # Core services (a2ui, auth, hooks, routes)
│   │   ├── mcp-server/  # MCP server implementation
│   │   └── tools/       # Tool implementations
│   └── frontend/        # React frontend (Terminal Dashboard, Orchestrator)
├── codex-lens/          # Local semantic code search engine
└── docs/                # Documentation

---

🎼 Team Cadence Control (Beat Model)

The v2 team architecture introduces an event-driven beat model for efficient orchestration:

Beat Cycle (single beat)
======================================================================
  Event                   Coordinator              Workers
----------------------------------------------------------------------
  callback/resume --> +- handleCallback -+
                      |  mark completed   |
                      |  check pipeline   |
                      +- handleSpawnNext -+
                      |  find ready tasks |
                      |  spawn workers ---+--> [team-worker A] Phase 1-5
                      |  (parallel OK)  --+--> [team-worker B] Phase 1-5
                      +- STOP (idle) -----+         |
                                                     |
  callback <-----------------------------------------+
  (next beat)              SendMessage + TaskUpdate(completed)
======================================================================

Key Benefits:

• 🎯 Event-driven: Coordinator only wakes when needed (callback/resume)
• ⚡ Fast-advance: Simple successors spawn directly without coordinator roundtrip
• 🔄 Dynamic pipelines: Generated per-task from dependency graph
• 📊 Parallel execution: Independent tasks run concurrently

---

🖥️ Frontend Highlights

Terminal Dashboard

Multi-terminal grid layout with real-time execution monitoring.

Features:

• 🖥️ Multi-terminal grid with resizable panes
• 📊 Execution monitor with agent list
• 📁 File sidebar for project navigation
• 🎯 Session grouping by project tags
• 🌙 Fullscreen/immersive mode

Orchestrator Editor

Visual workflow template editor with drag-drop.

Features:

• 🎨 React Flow-based visual editing
• 📦 Template library with pre-built workflows
• 🔧 Property panel for node configuration
• ⚡ Slash command integration

---

🙏 Acknowledgments

• Impeccable — Design audit methodology, OKLCH color system, anti-AI-slop detection patterns, editorial typography standards, motion/animation token architecture, and vanilla JS interaction patterns. The UI team skills (team-ui-polish, team-interactive-craft, team-motion-design, team-visual-a11y, team-uidesign, team-ux-improve) draw heavily from Impeccable's design knowledge.

• gstack — Systematic debugging methodology, security audit frameworks, and release pipeline patterns. The skills investigate (Iron Law debugging), security-audit (OWASP Top 10 + STRIDE), and ship (gated release pipeline) are inspired by gstack's workflow designs.

---

🤝 Contributing

---

📄 License

---

🔗 Links