superpowers-cccg

Superpowers-CCCG

Superpowers-CCCG is a fork/enhanced variant of obra/superpowers. It keeps the same skills-driven workflow, and adds CCCG multi-model orchestration: Claude is the pure orchestrator (never writes code), routing implementation to Codex MCP (backend), Gemini MCP (frontend), and Cursor MCP (DevOps), with Opus as the reviewer for every code-changing path.

CCCG = Claude + Codex + Cursor + Gemini

What You Get

• Claude as pure orchestrator: Claude routes, coordinates, and integrates — it never writes implementation code.
• Multi-model routing (CCCG): route tasks to Codex (backend), Gemini (frontend), or Cursor (DevOps: CI/CD, scripts, infrastructure). Use CROSS_VALIDATION for full-stack/critical tasks.
• Opus reviewer: Opus reviews all code-changing paths directly — no intermediate review assistant step.
• MCP tool integration: external calls go through MCP tools: mcp__codex__codex, mcp__gemini__gemini, mcp__cursor__cursor.
• Collaboration checkpoints: CP1/CP2/CP3 checkpoints embedded in key skills to decide when to call external models.
• Fail-closed gate: if a required external model call cannot complete, the workflow stops with BLOCKED rather than guessing. All coding tasks are BLOCKED if no external models are available.

Quick Start (Claude Code)

Prerequisites

• Claude Code installed (claude --version)
• Gemini CLI installed and authenticated (gemini --version)
• Codex CLI installed and authenticated (codex --version)
• Cursor Agent CLI — agent binary available in PATH (or %LOCALAPPDATA%\cursor-agent\agent.cmd on Windows)
• uv / uvx available — install via:
  • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • macOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh

Install

1. Add marketplace

claude plugin marketplace add https://github.com/sitien173/superpowers-cccg

2. Install plugin

claude plugin install superpowers-cccg

MCP Setup (required)

After installation, configure the MCP servers so the orchestrator can route work to them.

# Backend specialist
claude mcp add codex -s user --transport stdio -- uvx --from git+https://github.com/GuDaStudio/codexmcp.git codexmcp

# Frontend specialist
claude mcp add gemini -s user --transport stdio -- uvx --from git+https://github.com/GuDaStudio/geminimcp.git geminimcp

# DevOps specialist
claude mcp add cursor -s user --transport stdio -- uvx --from git+https://github.com/sitien173/cursormcp.git cursormcp

Using External Models

You typically do not call MCP tools manually. Tell Claude what you want, and the workflow decides when to invoke external models.

• Ask for backend help: "Use Codex MCP for the API/database parts, return a patch only."
• Ask for frontend help: "Use Gemini MCP for UI/components/styles, return a patch only."
• Ask for DevOps help: "Fix the CI pipeline" or "Update the Dockerfile" — routes to Cursor.
• Ask for extra confidence: "Do CROSS_VALIDATION (Codex + Gemini) for this design, and reconcile conflicts."
• Code review runs automatically after implementation — Opus reviews all code-changing paths directly.

Note: prompts sent to external models are expected to be English for consistency (you can still chat with Claude in any language).

Model Selection

Task type	Routing	MCP Tool
Backend (APIs, DB, auth, perf)	CODEX	mcp__codex__codex
Frontend (UI/components/styles)	GEMINI	mcp__gemini__gemini
DevOps (CI/CD, scripts, Dockerfiles, infrastructure)	CURSOR	mcp__cursor__cursor
Full-stack / unclear / high impact	CROSS_VALIDATION	multiple
Orchestration only (docs, coordination)	CLAUDE	none

The routing/checkpoint rules live in skills/coordinating-multi-model-work/.

Cursor model policy:

• DevOps implementation via Cursor MCP uses claude-4.6-sonnet-medium-thinking.
• Optional Cursor cross-validation uses claude-4.5-opus-high-thinking.

Checkpoint Protocol

Checkpoint	When	Purpose
CP1	Before first Task call	Assess routing, invoke external model early
CP2	Mid-execution	Triggered by uncertainty, stalled debugging, 2+ failures
CP3	Before claiming completion	Final domain + code quality review

Differences vs Superpowers (obra/superpowers)