@nst173/superpowers-ccg
v1.3.1
Published
Superpowers CCG workflows for Claude Code, Cursor, and Antigravity.
Maintainers
Readme
Superpowers-CCG
Superpowers-CCG is a fork/enhanced variant of obra/superpowers. It keeps the same skills-driven workflow and adds CCG multi-model orchestration: Claude is the pure orchestrator (never writes code), routing implementation to Codex MCP (backend and systems) and Gemini MCP (frontend), with Claude CP4 final spec review and Haiku for trivial tasks and fast exploration.
CCG = Claude + Codex + Gemini
What You Get
- Claude as pure orchestrator: Claude routes, coordinates, and integrates. It never writes implementation code.
- Multi-model routing (CCG): route tasks to Codex (backend and systems) or Gemini (frontend). Use CROSS_VALIDATION for full-stack or critical tasks.
- Final spec review: CP4 performs a pure spec check against the original request and CP1 success criteria.
- MCP tool integration: external calls go through
mcp__codex__codexandmcp__gemini__gemini. - Collaboration checkpoints: CP0/CP1/CP2/CP3/CP4 checkpoints are embedded in the main skills.
- Smart context sharing: CP0 produces reusable context artifacts, CP1 builds task-scoped bundles, and same-task follow-ups send deltas only.
- Fail-closed gate: if a required external model call cannot complete, the workflow stops with
BLOCKED.
Quick Start (Claude Code)
Prerequisites
- Claude Code installed (
claude --version) - Gemini CLI installed and authenticated (
gemini --version) - Codex CLI installed and authenticated (
codex --version) uv/uvxavailable
Install
claude plugin marketplace add https://github.com/sitien173/superpowers-ccg
claude plugin install superpowers-ccgMCP Setup
# Backend and systems 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 geminimcpUsing External Models
You normally do not call MCP tools manually. Tell Claude what you want, and the workflow decides when to invoke external models.
- Backend or systems: "Use Codex MCP for the API/database/CI parts and return the final files directly."
- Frontend: "Use Gemini MCP for UI/components/styles and return the final files directly."
- Cross-validation: "Do CROSS_VALIDATION for this design and reconcile conflicts."
- CP4 final spec review runs automatically at the end of the workflow.
Model Selection
| Task type | Routing | MCP Tool |
|---|---|---|
| Backend, systems, scripts, CI/CD, Docker, infrastructure | CODEX | mcp__codex__codex |
| Frontend (UI/components/styles) | GEMINI | mcp__gemini__gemini |
| Full-stack / unclear / high impact | CROSS_VALIDATION | multiple |
| Orchestration only (docs, coordination) | CLAUDE | none |
The routing and checkpoint rules live in skills/coordinating-multi-model-work/.
Checkpoint Protocol
| Checkpoint | When | Purpose | |---|---|---| | CP0 | Before CP1 | Context acquisition with Auggie for local code context and Grok Search for external research | | CP1 | Immediately after CP0, before first Task call | Task assessment and routing using the CP1 routing matrix | | CP2 | After CP1 when routed externally | External execution via Gemini/Codex/Cross-Validation with final file output | | CP3 | After CP2 when reconciliation is needed | Resolve external-model conflicts, gaps, and clarifications before CP4 | | CP4 | Final step of every workflow | Pure spec review against the original request and CP1 success criteria |
Differences vs Superpowers (obra/superpowers)
- Claude as orchestrator-only: Claude never writes implementation code.
- Built-in multi-model routing via MCP tools (Codex, Gemini).
- Codex covers systems work: scripts, CI/CD, Dockerfiles, and infrastructure route to Codex.
- CP4 final spec review is spec-only: no automatic style, redundancy, or best-practice review is part of the checkpoint flow.
- CP checkpoints enforce evidence-driven collaboration.
- Skill set changes align the plugin with the CCG workflow.
Update
claude plugin update superpowers-ccgTesting
See tests/claude-code/README.md for the Claude Code skills test suite.
./tests/claude-code/run-skill-tests.shSupport
- Issues: https://github.com/sitien173/superpowers-ccg/issues
Acknowledgments
- obra/superpowers - Original Superpowers project
- BryanHoo/superpowers-ccg - CCG collaboration fork
- fengshao1227/ccg-workflow - CCG workflow
- Danau5tin/multi-agent-coding-system - Smart context-sharing inspiration
- GuDaStudio/geminimcp - Gemini MCP
- GuDaStudio/codexmcp - Codex MCP
