Claude-Code-Workflow

Name: Claude-Code-Workflow
Author: catlog22

Warning

JSON-driven multi-agent cadence-team development framework with intelligent CLI orchestration (Gemini/Qwen/Codex), context-first architecture, and automated workflow execution

2,047stars

162forks

TypeScript

Added 12/27/2025

View on GitHub Download ZIP

AI Agentsclaudeclaude-codecli-toolscodexcontext-management

Installation

# Add to your Claude Code skills
git clone https://github.com/catlog22/Claude-Code-Workflow

Getting Started

Guides for using ai agents skills like Claude-Code-Workflow.

Security ReportWarning

Last scanned: 4/25/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@hono/node-server: @hono/node-server has authorization bypass for protected static paths via encoded slashes in Serve Static Middleware",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "@modelcontextprotocol/sdk: Anthropic's MCP TypeScript SDK has a ReDoS vulnerability",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "@vitest/coverage-v8: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@vitest/mocker: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@vitest/ui: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "ajv: ajv has ReDoS when using `$data` option",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "brace-expansion: brace-expansion: Zero-step sequence causes process hang and memory exhaustion",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "esbuild: esbuild enables any website to send any requests to the development server and read the response",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "flatted: flatted vulnerable to unbounded recursion DoS in parse() revive phase",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "hono: Hono JWK Auth Middleware has JWT algorithm confusion when JWK lacks \"alg\" (untrusted header.alg fallback)",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "lodash: lodash vulnerable to Code Injection via `_.template` imports key names",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "minimatch: minimatch has a ReDoS via repeated wildcards with non-matching literal in pattern",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "path-to-regexp: path-to-regexp vulnerable to Denial of Service via sequential optional groups",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "picomatch: Picomatch: Method Injection in POSIX Character Classes causes incorrect Glob Matching",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "qs: qs's arrayLimit bypass in comma parsing allows denial of service",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "rollup: Rollup 4 has Arbitrary File Write via Path Traversal",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "vite: Vite Vulnerable to Path Traversal in Optimized Deps `.map` Handling",
      "severity": "high"
    },
    {
      "type": "npm-audit",
      "message": "vite-node: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "vitest: Vulnerability found",
      "severity": "medium"
    }
  ],
  "status": "WARNING",
  "scannedAt": "2026-04-25T05:50:54.245Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

194,955

awesome-autoresearch headroom

English | 中文

✨ Key Features

🎯 Skill-based Workflows

From lite-plan (lightweight) to brainstorm (multi-role analysis)

🔄 Multi-CLI Orchestration

Gemini, Qwen, Codex, Claude - auto-select or manual

⚡ Team Architecture v2

Role-based agents with inner loop execution

🔧 Queue Scheduler

Background queue execution service

📦 Session Lifecycle

start/resume/complete/sync workflow sessions

🖥️ Terminal Dashboard

Multi-terminal grid with execution monitor

🎨 Orchestrator Editor

Template-based workflow visual editing

💬 A2UI

Agent-to-User interactive interface

📖 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

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

Multi-CLI Orchestration

| 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 Tool Configuration

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

| Method | Link | |--------|------| | Official | Augment MCP Documentation | | Proxy | ace-tool (GitHub) |

📚 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 /