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.
n1n.ai — Global LLM API Gateway. One API Key to access 500+ top AI models (GPT-5, Claude 4.5, Gemini 3 Pro, and more).
CCG is a workflow engine for Claude Code that orchestrates multiple AI models (Codex, Gemini, Claude) with hook-based state tracking, automatic strategy selection, and Agent Teams parallel execution.
v3.0 is a ground-up rewrite. One command replaces 29.
/ccg:go— Describe what you want in plain language. The engine analyzes your intent, picks the right strategy, and executes it.- Hook engine — Per-turn state injection keeps Claude on track even after context compaction. Session-start hooks inject full project context on every new session.
- Task persistence — Medium+ complexity tasks create
.ccg/tasks/with persistent state. Phase gates enforce HARD STOP checkpoints. - Agent Teams — Large tasks spawn parallel Builder teammates via TeamCreate. Each Builder gets isolated file ownership.
- Quality gates —
verify-security,verify-quality,verify-changerun as Skill invocations inside strategy verification phases. - Domain knowledge hooks — When your message mentions security, caching, RAG, etc., the relevant knowledge file is auto-injected into context.
- Codex-Led Mode — Use Codex CLI as the lead orchestrator. Codex writes code directly and dispatches analysis/review to Gemini + Claude via codeagent-wrapper. Install via menu option
X.
npx ccg-workflowRequires Node.js 20+ and Claude Code CLI. Codex CLI and Gemini CLI are optional (enable multi-model features).
The installer walks through 4 steps: API config, model routing, MCP tools, performance mode. New users get a streamlined 2-step flow with sensible defaults.
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
Next: Layer 1 Builders executing
</ccg-state>
The engine picks a strategy based on task type and complexity:
| Strategy | When | External models | Teams |
|---|---|---|---|
| direct-fix | Simple bug, single file | No | No |
| quick-implement | Small feature, clear scope | No | No |
| guided-develop | Medium feature, needs planning | Single model | No |
| full-collaborate | Complex feature, multi-module | Dual model parallel | Yes |
| debug-investigate | Complex bug, unknown cause | Dual model diagnosis | No |
| refactor-safely | Code restructuring | Dual model review | No |
| deep-research | Technical research, comparison | Dual model exploration | No |
| optimize-measure | Performance optimization | Optional | No |
| review-audit | Code review | Dual model cross-review | No |
| git-action | commit, rollback, branches | No | No |
Simple tasks run fast with no overhead. Complex tasks get the full engine.
v3.0 default install: 13 commands. Legacy mode adds 18 more.
| Command | Description |
|---|---|
/ccg:go |
Smart entry — describe what you want, engine handles the rest |
| Command | Description |
|---|---|
/ccg:commit |
Smart conventional commit |
/ccg:rollback |
Interactive rollback |
/ccg:clean-branches |
Clean merged branches |
/ccg:worktree |
Worktree management |
| Command | Description |
|---|---|
/ccg:init |
Initialize project CLAUDE.md |
/ccg:context |
Project context management |
| 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 |
CCG installs 4 hooks into ~/.claude/settings.json:
| Hook | Event | Purpose |
|---|---|---|
| workflow-state.js | UserPromptSubmit | Injects task state breadcrumb every turn |
| session-start.js | SessionStart | Injects full project context on session start/clear/compact |
| subagent-context.js | PreToolUse (Bash/Agent) | Injects spec + task context into codeagent-wrapper calls and Team member spawns |
| skill-router.js | UserPromptSubmit | Auto-injects domain knowledge when keywords detected |
Hooks are JavaScript, zero dependencies, silent on failure.
Medium+ complexity tasks create a persistent task directory:
.ccg/tasks/add-jwt-auth/
├── task.json # Status, strategy, current phase, gate
├── requirements.md # Enhanced requirements (full-collaborate)
├── plan.md # Approved implementation plan
├── context.jsonl # Spec files for sub-agent injection
├── review.md # Review results
└── research/ # Persisted research findings
The workflow-state hook reads task.json every turn and injects the current state. If context gets compacted, session-start re-injects the full task context. No state is lost.
Project-level coding standards in .ccg/spec/:
.ccg/spec/
├── backend/index.md # Backend conventions
├── frontend/index.md # Frontend conventions
└── guides/index.md # Cross-module guidelines
The subagent-context hook reads context.jsonl and injects relevant spec files into every codeagent-wrapper call and Agent Team spawn. Sub-agents follow your project's standards without being told.
~/.claude/
├── commands/ccg/ # Slash commands
├── hooks/ccg/ # Hook scripts (4 files)
├── .ccg/
│ ├── config.toml # Model routing, MCP, performance
│ ├── engine/ # Strategy files + model router
│ └── prompts/ # Expert prompts (codex/gemini/claude)
├── skills/ccg/ # Quality gates + domain knowledge
└── bin/codeagent-wrapper # Multi-model execution bridge
Set in ~/.claude/settings.json under "env":
| Variable | Default | Description |
|---|---|---|
CODEX_TIMEOUT |
7200 |
Wrapper timeout (seconds) |
CODEAGENT_POST_MESSAGE_DELAY |
5 |
Post-completion delay (seconds) |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS |
unset | Set to 1 to enable Agent Teams parallel execution |
npx ccg-workflow@latest # Update
npx ccg-workflow # Select "Uninstall" from menu- cexll/myclaude — codeagent-wrapper inspiration
- UfoMiao/zcf — Git tools reference
- mindfold-ai/Trellis — Hook-based workflow state patterns
- ace-tool — MCP code retrieval
 fengshao1227 |
 SXP-Simon |
 RebornQ |
 Sakuranda |
 Mriris |
 23q3 |
 MrNine-666 |
 GGzili |
- X (Twitter): @CCG_Workflow
- Email: fengshao1227@gmail.com
- Issues: GitHub Issues
- Community: Linux.do
MIT
v3.0.4 | Issues | Contributing