Claude + Codex Multi-AI Collaboration Framework
SU-CCB is an open-source framework that treats AI collaboration as an engineering management problem, not just "smart autocomplete." It establishes design-execution separation, approval gates, multi-round consultation, and structured contracts between Claude and Codex.
| Repository | Description |
|---|---|
| su-ccb-claude-plugin | Claude Code Plugin — /su:init /su:plan /su:dispatch /su:review /su:archive /su:resume |
| su-ccb-codex-skills | Codex Skill Pack — ccb-execute(3 modes) + ccb-doc |
| Document | Description |
|---|---|
| Command Reference | All /su:* commands with detailed capabilities, approval gates, and SC integration |
| Architecture & Design | Complete design overview: architecture, workflow, consultation protocol, publishing |
| Industry Evaluation | Viability assessment: industry fit, SWOT, competitor comparison, adoption barriers |
# Claude side
/plugin marketplace add SU-CCB/su-ccb-claude-plugin
/plugin install su-ccb@SU-CCB
# Codex side
$skill-installer install https://github.com/SU-CCB/su-ccb-codex-skills/tree/main/skills/ccb-execute
$skill-installer install https://github.com/SU-CCB/su-ccb-codex-skills/tree/main/skills/ccb-doc
# Initialize in your project
/su:initUser -> /su:plan -> Claude designs + consults Codex -> /su:dispatch -> Codex executes
|
User <- /su:archive <- Claude reviews <---- completion hook <---- receipt <--+
- Role Separation: Claude decides, Codex executes. No role confusion.
- Approval Gates: Red (must approve) / Yellow (can wave through) / Green (automatic).
- Multi-Round Consultation: Claude automatically discusses with Codex before finalizing designs.
- Structured Contracts: Ask contract, receipt contract (<2k), consult contract, bounceback rules.
- Graceful Degradation: SuperClaude/Superpowers optional -- core workflow never blocked.
Solo developers and small teams (1-5) working on backend, platform, API-heavy, or integration-intensive projects where wrong decisions are more expensive than slower starts.
SU-CCB builds on top of excellent open-source projects. The framework requires CCB (Claude Code Bridge) for Claude-Codex communication, and optionally integrates with SuperClaude and Superpowers for enhanced depth of analysis and execution.
| Project | Role in SU-CCB | Author |
|---|---|---|
| Claude Code Bridge (CCB) | Core communication layer between Claude and Codex. Provides ask, pend, mounted, cping -- the transport infrastructure that makes async dispatch and completion hooks possible. |
bfly123 |
| Project | Role in SU-CCB | Author |
|---|---|---|
| SuperClaude Framework | Enhances Claude's depth during consultation and review phases. SU-CCB's consultation rounds can auto-trigger /sc:design, /sc:brainstorm, /sc:analyze, /sc:spec-panel and other commands for deeper reasoning. |
SuperClaude-Org |
| Superpowers | Enhances Codex's execution quality with structured agentic workflows: systematic-debugging, verification-before-completion, executing-plans, and more. Composable skills that push coding agents through disciplined implementation. |
Jesse Vincent (obra) |
All optional dependencies follow a graceful degradation model -- SU-CCB runs its full workflow without them, they simply add depth when present.
SU-CCB would not exist without the pioneering work of these projects and their authors:
-
bfly123 -- for creating Claude Code Bridge, the foundational transport layer that makes multi-AI collaboration possible. CCB's async dispatch, completion hooks, and provider routing are the infrastructure backbone that SU-CCB's entire workflow depends on.
-
SuperClaude-Org -- for building the SuperClaude Framework, a comprehensive command system that gives Claude Code structured depth for design, analysis, brainstorming, and review. SU-CCB's consultation-triggered
/sc:*integration directly leverages this work. -
Jesse Vincent (obra) -- for creating Superpowers, the composable skill methodology that brings disciplined execution workflows to coding agents. The concept of structured verification-before-completion and systematic debugging directly influenced SU-CCB's execution-mode design.
-
Anthropic and OpenAI -- for building Claude Code and Codex CLI with open plugin/skill ecosystems that make projects like this possible.
Author: Sue | TG: @Sue_muyu