superpowers-ccg

Superpowers-CCG

Multi-model orchestration plugin for Claude Code. The host Coordinator (Claude) plans, routes, reviews, and handles simple edits. Heavier work is dispatched to codex for backend work or Antigravity / agy for frontend work through one MCP tool.

CCG = Claude + Codex + Gemini

Workflow

Three gates: Plan → Execute → Review. Route each phase by side. Cross-Validation advises unclear or high-impact routing, but never owns implementation.

flowchart TD
    A([Request]) --> B{Fuzzy idea or<br/>clear task?}
    B -->|"fuzzy idea"| BR["/brainstorm<br/>design doc"]
    BR --> WP["/write-plan<br/>PLAN.md + phases"]
    B -->|"clear task"| WP
    WP --> P["Gate 1 - Plan<br/>frame phase, emit # ROUTE"]
    P --> R{Route by side}
    R -->|simple| CO["Coordinator edits directly"]
    R -->|backend| CX["codex via MCP"]
    R -->|frontend| GM["agy via MCP"]
    R -->|"full-stack / unclear / high-impact"| CV["Cross-Validation<br/>ask both, reconcile"]
    CV --> R
    CO --> EX["Gate 2 - Execute<br/>uncommitted work + notes + journal"]
    CX --> EX
    GM --> EX
    EX --> RV{"Gate 3 - Review"}
    RV -->|FAIL| P
    RV -->|"PASS"| SQ["Phase commit<br/>update .handover.md"]
    SQ --> NX{More phases?}
    NX -->|yes| P
    NX -->|no| V(["verifying-before-completion"])

The canonical spec is skills/coordinating-multi-model-work/SKILL.md — gates, routing table, review semantics, worker contract, and resume artifacts all live there. Everything else in this repo points to it.

User overrides ("use codex", "skip cross-validation", "no external models") always win.

Install

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

Prerequisites

• Claude Code — claude --version
• codex CLI — codex --version
• Antigravity CLI — agy --version
• uv / uvx

MCP setup

A single unified server — openmcp — exposes one tool, mcp__plugin_superpowers-ccg_openmcp__run, with a backend field ("codex" or "agy"). It is launched from .mcp.json through uvx at a pinned revision.

Optional defaults pass through from user environment variables. Unset values defer to OpenMCP or backend defaults. Named codex profiles are optional.

Variable	Purpose
OPENMCP_AGY_MODEL_DEFAULT	Default model for backend="agy"
OPENMCP_CODEX_MODEL_DEFAULT	Default model for backend="codex"
OPENMCP_CODEX_PROFILE_DEFAULT	Default codex profile
OPENMCP_AGY_REASONING_MODEL	Model used for agy reasoning-mode calls
OPENMCP_CODEX_REASONING_MODEL	Model used for codex reasoning-mode calls
OPENMCP_LOG_FILE	OpenMCP log file path (default ~/.openmcp/openmcp.log)
OPENMCP_LOG_LEVEL	OpenMCP log level (default INFO)

Commands & Skills

Slash commands (each loads its shared skill before acting):

• /brainstorm — explore intent, requirements, and design via dialogue.
• /write-plan — turn a confirmed design into a phase-based plan.
• /execute-plan — run the active phase under the three gates.

Shared skills (namespace superpowers-ccg:):

• coordinating-multi-model-work — canonical 3-gate workflow, routing, review, resume artifacts.
• brainstorming, writing-plans, executing-plans — phase-stage skills loaded by the slash commands.
• test-driven-development — failing test first, then minimal code (feature/bugfix phases).
• systematic-debugging — root-cause investigation before any fix.
• verifying-before-completion — fresh verification evidence before reporting done.

Plan artifacts

Every executable plan lives in docs/plans/<slug>/ (PLAN.md + .handover.md; phase-NN/ folders created lazily). .handover.md is the resume pointer — a new session reads it first, then only the files it lists. Flat plans are documentation only. Bundled worker contracts are read directly from the installed plugin and never copied into consuming repositories.

Update

claude plugin update superpowers-ccg

Development

tests/run.sh

The suite checks hook safety, contract invariants, JSON configuration, version consistency, and plugin validation when Claude Code is installed. Update the OpenMCP revision in .mcp.json deliberately, then rerun this suite.

Support

Issues: https://github.com/sitien173/superpowers-ccg/issues

Acknowledgments