{
  "markdown": "> [!IMPORTANT]\n> ## This project has evolved into [Maestro Flow](https://github.com/catlog22/maestro-flow)\n>\n> **Claude Code Workflow is now archived.** All active development continues at:\n>\n> **https://github.com/catlog22/maestro-flow**\n>\n> ```bash\n> npm install -g maestro-flow\n> ```\n>\n> Maestro Flow includes everything from CCW plus: Knowledge Graph, adaptive lifecycle engine (Ralph), hook system, team collaboration, and more.\n\n---\n\n<div align=\"center\">\n\n<!-- Animated Header -->\n<img src=\"https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=180&section=header&text=Claude%20Code%20Workflow&fontSize=42&fontColor=fff&animation=twinkling&fontAlignY=32&desc=Multi-Agent%20AI%20Development%20Framework&descAlignY=52&descSize=18\"/>\n\n<!-- Badges -->\n<p>\n  <a href=\"https://github.com/catlog22/Claude-Code-Workflow/releases\"><img src=\"https://img.shields.io/badge/version-v7.0.0-6366F1?style=flat-square\" alt=\"Version\"/></a>\n  <a href=\"https://www.npmjs.com/package/claude-code-workflow\"><img src=\"https://img.shields.io/npm/v/claude-code-workflow?style=flat-square&color=cb3837\" alt=\"npm\"/></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-10B981?style=flat-square\" alt=\"License\"/></a>\n  <a href=\"https://github.com/catlog22/Claude-Code-Workflow/stargazers\"><img src=\"https://img.shields.io/github/stars/catlog22/Claude-Code-Workflow?style=flat-square&color=F59E0B\" alt=\"Stars\"/></a>\n  <a href=\"https://github.com/catlog22/Claude-Code-Workflow/issues\"><img src=\"https://img.shields.io/github/issues/catlog22/Claude-Code-Workflow?style=flat-square&color=EF4444\" alt=\"Issues\"/></a>\n</p>\n\n**[English](README.md) | [中文](README_CN.md)**\n\n<br/>\n\n<!-- Typing Animation -->\n<a href=\"https://git.io/typing-svg\"><img src=\"https://readme-typing-svg.demolab.com?font=Fira+Code&weight=600&size=22&pause=1000&color=6366F1&center=true&vCenter=true&random=false&width=600&lines=JSON-Driven+Multi-Agent+Framework;Skill-based+Workflow+System;Semantic+CLI+Orchestration;Gemini+%7C+Codex+%7C+OpenCode+%7C+Qwen+%7C+Claude\" alt=\"Typing SVG\" /></a>\n\n</div>\n\n<br/>\n\n<!-- Quick Links -->\n<div align=\"center\">\n  <a href=\"#-quick-start\"><img src=\"https://img.shields.io/badge/🚀_Quick_Start-4285F4?style=flat-square\" alt=\"Quick Start\"/></a>\n  <a href=\"WORKFLOW_GUIDE.md\"><img src=\"https://img.shields.io/badge/📖_Workflow_Guide-34A853?style=flat-square\" alt=\"Guide\"/></a>\n  <a href=\"#-cli-tool-installation\"><img src=\"https://img.shields.io/badge/🛠️_CLI_Tools-EA4335?style=flat-square\" alt=\"CLI Tools\"/></a>\n  <a href=\"#-architecture\"><img src=\"https://img.shields.io/badge/🏗️_Architecture-FBBC05?style=flat-square\" alt=\"Architecture\"/></a>\n</div>\n\n<br/>\n\n---\n\n## ✨ Key Features\n\n<div align=\"center\">\n<table>\n<tr>\n<td width=\"50%\">\n\n### 🎯 Skill-based Workflows\nFrom `lite-plan` (lightweight) to `brainstorm` (multi-role analysis)\n\n### 🔄 Multi-CLI Orchestration\nGemini, Qwen, Codex, Claude - auto-select or manual\n\n### ⚡ Team Architecture v2\nRole-based agents with inner loop execution\n\n### 🔧 Queue Scheduler\nBackground queue execution service\n\n</td>\n<td width=\"50%\">\n\n### 📦 Session Lifecycle\nstart/resume/complete/sync workflow sessions\n\n### 🖥️ Terminal Dashboard\nMulti-terminal grid with execution monitor\n\n### 🎨 Orchestrator Editor\nTemplate-based workflow visual editing\n\n### 💬 A2UI\nAgent-to-User interactive interface\n\n</td>\n</tr>\n</table>\n</div>\n\n> 📖 **New?** See [Workflow Guide](WORKFLOW_GUIDE.md) for complete workflow documentation.\n\n---\n\n## 🚀 Quick Start\n\n### Install CCW\n\n```bash\nnpm install -g claude-code-workflow\nccw install -m Global\n```\n\n### Codex Configuration (Required for `.codex/skills/`)\n\nIf you use **Codex CLI** with the `.codex/skills/` workflow skills, add these required features to your `~/.codex/config.toml`:\n\n```toml\n[features]\ndefault_mode_request_user_input = true   # Enable request_user_input tool for interactive confirmations\nmulti_agent = true                       # Enable multi-agent coordination (spawn_agent, wait, etc.)\nmulti_agent_v2 = true                    # Enable v4 agent API (fork_context, task_name, send_message, assign_task, list_agents)\nenable_fanout = true                     # Enable spawn_agents_on_csv for parallel wave execution\n```\n\n> 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.\n\n### Workflow Skills vs Commands\n\nCCW uses two types of invocations:\n\n| Type | Format | Examples |\n|------|--------|----------|\n| **Skills** | Trigger phrase (no slash) | `workflow-lite-plan`, `brainstorm`, `workflow-plan` |\n| **Commands** | Slash command | `/ccw`, `/workflow/session:start`, `/issue/new` |\n\n### Choose Your Workflow Skill\n\n<div align=\"center\">\n<table>\n<tr><th>Skill Trigger</th><th>Use Case</th></tr>\n<tr><td><code>workflow-lite-plan</code></td><td>Lightweight planning, single-module features (hands off to lite-execute)</td></tr>\n<tr><td><code>workflow-multi-cli-plan</code></td><td>Multi-CLI collaborative analysis</td></tr>\n<tr><td><code>workflow-plan</code></td><td>Full planning with session persistence</td></tr>\n<tr><td><code>workflow-tdd-plan</code></td><td>Test-driven development</td></tr>\n<tr><td><code>workflow-test-fix</code></td><td>Test generation and fix cycles</td></tr>\n<tr><td><code>brainstorm</code></td><td>Multi-role brainstorming analysis</td></tr>\n</table>\n</div>\n\n### Workflow Examples\n\n```bash\n# Skill triggers (no slash - just describe what you want)\nworkflow-lite-plan \"Add JWT authentication\"\nworkflow-plan \"Implement payment gateway integration\"\nworkflow-execute\n\n# Brainstorming\nbrainstorm \"Design real-time collaboration system\"\n\n# Slash commands for session management\n/workflow/session:start\n/workflow/session:resume\n/workflow/session:complete\n```\n\n---\n\n## 🛠️ CLI Tool Installation\n\n<div align=\"center\">\n<table>\n<tr><th>CLI</th><th>Description</th><th>Official Docs</th></tr>\n<tr><td><b>Gemini</b></td><td>Google AI analysis</td><td><a href=\"https://github.com/google-gemini/gemini-cli\">google-gemini/gemini-cli</a></td></tr>\n<tr><td><b>Codex</b></td><td>OpenAI autonomous coding</td><td><a href=\"https://github.com/openai/codex\">openai/codex</a></td></tr>\n<tr><td><b>OpenCode</b></td><td>Open-source multi-model</td><td><a href=\"https://github.com/opencode-ai/opencode\">opencode-ai/opencode</a></td></tr>\n<tr><td><b>Qwen</b></td><td>Alibaba Qwen-Code</td><td><a href=\"https://github.com/QwenLM\">QwenLM/Qwen</a></td></tr>\n</table>\n</div>\n\n---\n\n## 🎭 Semantic CLI Invocation\n\n<div align=\"center\">\n<img src=\"https://img.shields.io/badge/Just_Describe-What_You_Want-6366F1?style=flat-square\"/>\n<img src=\"https://img.shields.io/badge/CCW_Handles-The_Rest-10B981?style=flat-square\"/>\n</div>\n\n<br/>\n\nUsers can **semantically specify CLI tools** in prompts - the system automatically invokes the corresponding CLI.\n\n### Basic Invocation\n\n<div align=\"center\">\n\n| User Prompt | System Action |\n|-------------|---------------|\n| \"Use Gemini to analyze the auth module\" | Auto-invoke `gemini` CLI for analysis |\n| \"Let Codex review this code\" | Auto-invoke `codex` CLI for review |\n| \"Ask Qwen about performance optimization\" | Auto-invoke `qwen` CLI for consultation |\n\n</div>\n\n### Multi-CLI Orchestration\n\n<div align=\"center\">\n\n| Pattern | User Prompt Example |\n|---------|---------------------|\n| **Collaborative** | \"Use Gemini and Codex to collaboratively analyze security vulnerabilities\" |\n| **Parallel** | \"Have Gemini, Codex, and Qwen analyze the architecture in parallel\" |\n| **Iterative** | \"Use Gemini to diagnose, then Codex to fix, iterate until resolved\" |\n| **Pipeline** | \"Gemini designs the solution, Codex implements, Claude reviews\" |\n\n</div>\n\n---\n\n## 🔍 ACE Tool Configuration\n\nACE (Augment Context Engine) provides powerful semantic code search.\n\n<div align=\"center\">\n\n| Method | Link |\n|--------|------|\n| **Official** | [Augment MCP Documentation](https://docs.augmentcode.com/context-services/mcp/overview) |\n| **Proxy** | [ace-tool (GitHub)](https://github.com/eastxiaodong/ace-tool) |\n\n</div>\n\n---\n\n## 📚 CodexLens Local Search\n\n> ⚠️ **In Development**: CodexLens is under iterative optimization. Some features may be unstable.\n\n<div align=\"center\">\n<table>\n<tr><th>Search Mode</th><th>Description</th></tr>\n<tr><td><b>FTS</b></td><td>Full-text search, based on SQLite FTS5</td></tr>\n<tr><td><b>Semantic</b></td><td>Semantic search, using local embedding models</td></tr>\n<tr><td><b>Hybrid</b></td><td>Hybrid search, combining FTS + Semantic + Reranking</td></tr>\n</table>\n</div>\n\n---\n\n## 💻 CCW CLI Commands\n\n### 🌟 Recommended Commands\n\n<div align=\"center\">\n<table>\n<tr><th>Command</th><th>Description</th><th>When to Use</th></tr>\n<tr>\n  <td><b>/ccw</b></td>\n  <td>Auto workflow orchestrator - analyzes intent, selects workflow, executes</td>\n  <td>✅ General tasks, auto workflow selection</td>\n</tr>\n<tr>\n  <td><b>/ccw-coordinator</b></td>\n  <td>Smart orchestrator - recommends command chains, allows manual adjustment</td>\n  <td>🔧 Complex multi-step workflows</td>\n</tr>\n</table>\n</div>\n\n**Quick Examples**:\n\n```bash\n# /ccw - Auto workflow selection\n/ccw \"Add user authentication\"\n/ccw \"Fix memory leak in WebSocket\"\n/ccw \"Implement with TDD\"\n\n# /ccw-coordinator - Manual chain orchestration\n/ccw-coordinator \"Implement OAuth2 system\"\n```\n\n### Session Management Commands\n\n```bash\n/workflow:session:start     # Start new workflow session\n/workflow:session:resume    # Resume paused session\n/workflow:session:list      # List all sessions\n/workflow:session:sync      # Sync session work\n/workflow:session:complete  # Complete session\n```\n\n### Issue Workflow Commands\n\n```bash\n/issue/new       # Create new issue\n/issue/plan      # Plan issue resolution\n/issue/queue     # Form execution queue\n/issue/execute   # Execute issue queue\n```\n\n### Other CLI Commands\n\n```bash\nccw install           # Install workflow files\nccw view              # Open dashboard\nccw cli -p \"...\"      # Execute CLI tools (Gemini/Qwen/Codex)\nccw upgrade -a        # Upgrade all installations\n```\n\n---\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│                     Workflow Skills                              │\n│  📝 workflow-lite-plan / workflow-multi-cli-plan (lightweight)  │\n│  📊 workflow-plan / workflow-tdd-plan (session-based)           │\n│  🧪 workflow-test-fix / workflow-test-fix         │\n│  🧠 brainstorm (multi-role analysis)                            │\n└─────────────────────────────────────────────────────────────────┘\n                              ↓\n┌─────────────────────────────────────────────────────────────────┐\n│                   Team Architecture v2                          │\n│  🤖 team-worker agents with role-spec based execution           │\n│  🔄 Inner loop framework for sequential task processing         │\n│  📢 Message bus protocol with team coordination                 │\n│  🧠 Wisdom accumulation (learnings/decisions/conventions)       │\n└─────────────────────────────────────────────────────────────────┘\n                              ↓\n┌─────────────────────────────────────────────────────────────────┐\n│                   Queue Scheduler Service                       │\n│  ⚙️ Background execution service with API endpoints             │\n│  📊 Queue management and unified CLI execution settings         │\n└─────────────────────────────────────────────────────────────────┘\n                              ↓\n┌─────────────────────────────────────────────────────────────────┐\n│                   Terminal Dashboard & Orchestrator             │\n│  🖥️ Multi-terminal grid with execution monitor                  │\n│  🎨 Template-based workflow editor with slash commands          │\n│  📡 Real-time agent communication via A2UI                      │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 📦 Project Structure\n\n```\nClaude-Code-Workflow/\n├── .claude/\n│   ├── agents/          # 22 specialized agents (team-worker, cli-discuss, etc.)\n│   ├── commands/        # Slash commands (5 categories)\n│   │   ├── ccw.md       # Main orchestrator\n│   │   ├── ccw-coordinator.md\n│   │   ├── cli/         # CLI commands (cli-init, codex-review)\n│   │   ├── issue/       # Issue management (plan, execute, queue)\n│   │   ├── memory/      # Memory commands (prepare, style-skill-memory)\n│   │   └── workflow/    # Workflow commands (session, ui-design, etc.)\n│   └── skills/          # 37 modular skills\n│       ├── workflow-lite-plan/\n│       ├── workflow-plan/\n│       ├── workflow-tdd-plan/\n│       ├── workflow-test-fix/\n│       ├── brainstorm/\n│       ├── team-*/      # Team coordination skills\n│       └── ...\n├── ccw/\n│   ├── src/             # TypeScript source code\n│   │   ├── commands/    # CLI command implementations\n│   │   ├── core/        # Core services (a2ui, auth, hooks, routes)\n│   │   ├── mcp-server/  # MCP server implementation\n│   │   └── tools/       # Tool implementations\n│   └── frontend/        # React frontend (Terminal Dashboard, Orchestrator)\n├── codex-lens/          # Local semantic code search engine\n└── docs/                # Documentation\n```\n\n---\n\n## 🎼 Team Cadence Control (Beat Model)\n\nThe v2 team architecture introduces an **event-driven beat model** for efficient orchestration:\n\n```\nBeat Cycle (single beat)\n======================================================================\n  Event                   Coordinator              Workers\n----------------------------------------------------------------------\n  callback/resume --> +- handleCallback -+\n                      |  mark completed   |\n                      |  check pipeline   |\n                      +- handleSpawnNext -+\n                      |  find ready tasks |\n                      |  spawn workers ---+--> [team-worker A] Phase 1-5\n                      |  (parallel OK)  --+--> [team-worker B] Phase 1-5\n                      +- STOP (idle) -----+         |\n                                                     |\n  callback <-----------------------------------------+\n  (next beat)              SendMessage + TaskUpdate(completed)\n======================================================================\n```\n\n**Key Benefits:**\n- 🎯 **Event-driven**: Coordinator only wakes when needed (callback/resume)\n- ⚡ **Fast-advance**: Simple successors spawn directly without coordinator roundtrip\n- 🔄 **Dynamic pipelines**: Generated per-task from dependency graph\n- 📊 **Parallel execution**: Independent tasks run concurrently\n\n---\n\n## 🖥️ Frontend Highlights\n\n### Terminal Dashboard\n\nMulti-terminal grid layout with real-time execution monitoring.\n\n**Features:**\n- 🖥️ Multi-terminal grid with resizable panes\n- 📊 Execution monitor with agent list\n- 📁 File sidebar for project navigation\n- 🎯 Session grouping by project tags\n- 🌙 Fullscreen/immersive mode\n\n### Orchestrator Editor\n\nVisual workflow template editor with drag-drop.\n\n**Features:**\n- 🎨 React Flow-based visual editing\n- 📦 Template library with pre-built workflows\n- 🔧 Property panel for node configuration\n- ⚡ Slash command integration\n\n---\n\n## 🙏 Acknowledgments\n\n- **[Impeccable](https://github.com/pbakaus/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.\n\n- **[gstack](https://github.com/garrytan/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.\n\n---\n\n## 🤝 Contributing\n\n<div align=\"center\">\n  <a href=\"https://github.com/catlog22/Claude-Code-Workflow\"><img src=\"https://img.shields.io/badge/GitHub-Repository-181717?style=flat-square\" alt=\"GitHub\"/></a>\n  <a href=\"https://github.com/catlog22/Claude-Code-Workflow/issues\"><img src=\"https://img.shields.io/badge/Issues-Report_Bug-EF4444?style=flat-square\" alt=\"Issues\"/></a>\n</div>\n\n---\n\n## 📄 License\n\n<div align=\"center\">\n\nMIT License - see [LICENSE](LICENSE)\n\n</div>\n\n---\n\n## 💬 Community\n\n<div align=\"center\">\n\nJoin the CCW WeChat group to discuss tips and share experiences with other developers!\n\n<img src=\"assets/wechat-group-qr.jpg\" width=\"300\" alt=\"CCW WeChat Group\"/>\n\n<sub>Scan to join the WeChat group (if the QR code has expired, please open an Issue for the latest one)</sub>\n\n</div>\n\n---\n\n## ☕ Buy Me a Coffee\n\n<div align=\"center\">\n\nYour support is the greatest motivation for updates!\n\n<img src=\"assets/7e9099a5e71b02b0db581563d51a0439.png\" width=\"300\" alt=\"WeChat Appreciation QR Code\"/>\n\n<sub>\"您的支持是更新的最大动力\"</sub>\n\n</div>\n\n---\n\n## 🔗 Links\n\n<div align=\"center\">\n  <a href=\"https://linux.do/\"><img src=\"https://img.shields.io/badge/LINUX_DO-Learn_AI,_Go_L!-6366F1?style=flat-square\" alt=\"LINUX DO\"/></a>\n</div>\n\n<div align=\"center\">\n\n<br/>\n\n<!-- Footer -->\n<img src=\"https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=100&section=footer\"/>\n\n</div>\n",
  "bytes": 17343,
  "sha": "5e13212f1ec4cb7dee2c4c9ec2d6780d965256b11f1f90bd93368b1f81b5fb2a",
  "repo_slug": "catlog22/claude-code-workflow",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_catlog22_claude_code_workflow_claude_ski_c77137fe/readme"
}