CCG - Claude + Codex + Gemini Multi-Model Collaboration

♥️ Sponsor

Gamma Remover — Free browser-local Gamma watermark remover for PDF & PPTX. No signup, instant results, 100% private. Your files never leave your device.

302.AI is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.

What is CCG?

CCG is a workflow engine for Claude Code. It turns Claude into a multi-model orchestrator — Claude stays in control while dispatching specialized work to Codex (OpenAI) and Gemini (Google) through a Go binary bridge.

One command. Describe what you want. The engine handles the rest.

npx ccg-workflow    # Install in 60 seconds

Architecture

Claude Code is the lead orchestrator. It analyzes your intent, selects a strategy, and manages the entire workflow. The Hook Engine injects state every turn so Claude never loses context — even after compaction. The codeagent-wrapper (a compiled Go binary) bridges Claude to external models for parallel analysis and review.

How It Works

You: /ccg:go add JWT authentication to this API

CCG Engine:
  1. Reads project context (git status, tech stack, file structure)
  2. Classifies: feature / L complexity / backend / high risk
  3. Selects strategy: full-collaborate
  4. Creates .ccg/tasks/add-jwt-auth/task.json
  5. Launches dual-model analysis (Codex + Gemini in parallel)
  6. Produces plan → HARD STOP for your approval
  7. Spawns Agent Teams Builders for parallel implementation
  8. Runs quality gates + dual-model cross-review
  9. Reports results

Every turn, a hook injects:
  <ccg-state>
  Task: add-jwt-auth (in_progress)
  Strategy: full-collaborate
  Phase: 4-implementation
  </ccg-state>

10 Built-in Strategies

The engine auto-selects the right strategy based on task type and complexity:

Strategy	When	External Models	Agent Teams
`direct-fix`	Simple bug, single file	—	—
`quick-implement`	Small feature, clear scope	—	—
`guided-develop`	Medium feature, needs planning	Single	—
`full-collaborate`	Complex feature, multi-module	Dual parallel	✓
`debug-investigate`	Complex bug, unknown cause	Dual diagnosis	—
`refactor-safely`	Code restructuring	Dual review	—
`deep-research`	Technical research	Dual exploration	—
`optimize-measure`	Performance optimization	Optional	—
`review-audit`	Code review	Dual cross-review	—
`git-action`	commit, rollback, branches	—	—

Simple tasks run fast with zero overhead. Complex tasks get the full engine.

Core Features

Hook Engine — Never Lose Context

4 JavaScript hooks inject state into every Claude Code session:

Hook	Event	What it does
`workflow-state.js`	Every turn	Injects current task state as breadcrumb
`session-start.js`	Session start/compact	Re-injects full project context
`subagent-context.js`	Agent/Bash spawn	Injects spec directly into subagent prompts
`skill-router.js`	Every turn	Auto-injects domain knowledge by keyword

Context survives compaction. Sub-agents born with spec in their prompt. Zero state loss.

Task System — Persistent Lifecycle

Medium+ complexity tasks get a persistent directory:

.ccg/tasks/add-jwt-auth/
├── task.json         # Status, strategy, phase, gate
├── requirements.md   # Enhanced requirements
├── plan.md           # Approved implementation plan
├── context.jsonl     # Spec files for sub-agent injection
├── review.md         # Review results
└── research/         # Persisted research findings

Quality Gates — Built-in Security & Quality

Gate	Trigger
`/ccg:verify-security`	New modules, security changes
`/ccg:verify-quality`	Changes > 30 lines
`/ccg:verify-change`	Doc sync check
`/ccg:verify-module`	Module structure check
`/ccg:gen-docs`	Auto-generate README + DESIGN

100+ Domain Knowledge Files

When your message mentions security, caching, RAG, Kubernetes, etc., the relevant knowledge file is auto-injected. 10 domains, 61 files:

Security · Architecture · DevOps · AI/MLOps · Development · Frontend Design · Infrastructure · Mobile · Data Engineering · Orchestration

Commands

Core (v3.0 default: 13 commands)

Command	Description
`/ccg:go`	Smart entry — describe what you want, engine handles the rest
`/ccg:commit`	Smart conventional commit
`/ccg:rollback`	Interactive rollback
`/ccg:clean-branches`	Clean merged branches
`/ccg:worktree`	Worktree management
`/ccg:init`	Initialize project CLAUDE.md
`/ccg:context`	Project context management

OpenSpec Integration

Command	Description
`/ccg:spec-init`	Initialize OPSX environment
`/ccg:spec-research`	Requirements → constraints
`/ccg:spec-plan`	Constraints → zero-decision plan
`/ccg:spec-impl`	Execute plan + archive
`/ccg:spec-review`	Dual-model cross-review

Legacy Mode (18 additional commands)

Includes /ccg:workflow, /ccg:plan, /ccg:execute, /ccg:frontend, /ccg:backend, /ccg:analyze, /ccg:debug, /ccg:optimize, /ccg:test, /ccg:review, /ccg:team, and more.

Quick Start

# Install (interactive 4-step wizard)
npx ccg-workflow

# Or non-interactive with defaults
npx ccg-workflow init --skip-prompt

Requires Node.js 20+ and Claude Code CLI. Codex CLI and Gemini CLI are optional (enable multi-model features).

CLI Commands

npx ccg-workflow                          # Interactive menu
npx ccg-workflow init                     # 4-step install wizard
npx ccg-workflow doctor                   # Environment health check
npx ccg-workflow status                   # Installation overview
npx ccg-workflow codex-mode install       # Install Codex-Led mode
npx ccg-workflow codex-mode uninstall     # Uninstall Codex-Led mode
npx ccg-workflow uninstall                # Uninstall CCG
npx ccg-workflow config mcp               # Configure MCP tokens
npx ccg-workflow diagnose-mcp             # Diagnose MCP issues

Configuration

~/.claude/
├── commands/ccg/          # Slash commands
├── hooks/ccg/             # Hook scripts (5 files)
├── skills/ccg/            # Quality gates + 100+ domain knowledge
├── rules/                 # Auto-trigger rules
├── .ccg/
│   ├── config.toml        # Model routing, MCP, performance
│   ├── engine/            # 10 strategy files + model router
│   └── prompts/           # Expert prompts (codex/gemini/claude)
└── bin/codeagent-wrapper  # Multi-model bridge (Go binary)

Environment Variables

Set in ~/.claude/settings.json under "env":

Variable	Default	Description
`CODEX_TIMEOUT`	`7200`	Wrapper timeout (seconds)
`CODEAGENT_POST_MESSAGE_DELAY`	`5`	Post-completion delay
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	unset	Set `1` for parallel Agent Teams

Update / Uninstall

npx ccg-workflow@latest     # Update to latest
npx ccg-workflow doctor     # Check health after update
npx ccg-workflow uninstall  # Clean uninstall

Credits

cexll/myclaude — codeagent-wrapper inspiration
UfoMiao/zcf — Git tools reference
mindfold-ai/Trellis — Hook-based workflow state patterns
ace-tool — MCP code retrieval

Contributors

Contact

X (Twitter): @CCG_Workflow
Email: [email protected]
Issues: GitHub Issues
Community: Linux.do

Star History

License

MIT

v3.1.11 | Issues | Contributing

Ccg Workflow

README