orchestra

orchestra-plugin

A packaged Claude Code plugin for /orchestra — multi-agent, test-driven development orchestration. The main Claude session acts as a conductor, delegating:

• planning & review to Claude subagents (orchestra-planner, orchestra-reviewer)
• implementation to ChatGPT Codex via the codex CLI (orchestra-codex-implementer)

through a Plan → Implement → Review → Commit cycle with mandatory human pause points.

This repo is also its own marketplace, so installing it is two commands.

Install on a new machine

# 1. Register this repo as a marketplace (pick the form that matches where it lives)
/plugin marketplace add <github-user>/orchestra-plugin       # if pushed to GitHub
#   or, from a local clone / extracted tarball:
/plugin marketplace add /path/to/orchestra-plugin

# 2. Install the plugin
/plugin install orchestra@orchestra-marketplace

Restart the session (or /exit and relaunch) so the skill and agents load. Then run /orchestra <request> in any project.

Prerequisites (must exist on every target machine)

/orchestra is not self-sufficient — it depends on two external pieces that the plugin cannot bundle:

1. codex CLI (ChatGPT Codex) — the implementer shells out to codex exec.

   codex --version    # verify installed
   codex login        # one-time browser auth
   

2. claude-code-setup plugin — the conductor mandatorily invokes its claude-automation-recommender skill during pre-flight to detect the project's test/lint/format commands. Install it from the official marketplace:

   /plugin install claude-code-setup@claude-plugins-official
   

   If it's missing, /orchestra stops and tells you to install it before proceeding.

There is no auto-install of these dependencies — install them manually on each machine.

What's in the package

orchestra-plugin/                         <- git repo = marketplace
├── .claude-plugin/marketplace.json       <- marketplace listing
└── plugins/orchestra/
    ├── .claude-plugin/plugin.json        <- plugin manifest
    ├── skills/orchestra/
    │   ├── SKILL.md                       <- the /orchestra conductor
    │   └── README.md                      <- full workflow docs
    └── agents/
        ├── orchestra-planner.md           <- research subagent (Claude)
        ├── orchestra-codex-implementer.md <- Codex bridge (Claude → codex CLI)
        └── orchestra-reviewer.md          <- review subagent (Claude)

See plugins/orchestra/skills/orchestra/README.md for the full architecture, usage, and customization notes.

Updating

After editing any plugin file, bump version in plugins/orchestra/.claude-plugin/plugin.json, commit, push, then on each machine:

/plugin marketplace update orchestra-marketplace
/plugin update orchestra