enable-symphony

skill-enable-symphony

A Claude Code plugin that helps teams adopt the Symphony pattern — continuous, automated coding agent orchestration driven by issue trackers.

Works with Codex, Claude Code, or any AI coding agent.

Install

npx skills add ferrants/skill-enable-symphony

Or for a specific project only:

npx skills add ferrants/skill-enable-symphony --scope project

Customize it

Clone the repo and ask your AI coding tool to tailor the skill to your specific workflows:

git clone https://github.com/ferrants/skill-enable-symphony.git

What it does

Symphony is an open specification from OpenAI for a service that polls an issue tracker (Linear, GitHub Issues, etc.), creates isolated workspaces per issue, and runs a coding agent session for each. This skill helps you adopt that pattern in your own repos.

Once installed, Claude gains the /enable-symphony skill with two modes:

Audit mode

Scores your repo's Symphony readiness across 10 dimensions (workflow file, tracker config, workspace safety, agent integration, security, etc.) and produces a gap report with prioritized recommendations.

Implement mode

Generates the files needed to run Symphony-pattern automation:

• WORKFLOW.md — the in-repo contract (YAML config + prompt template)
• Agent configuration — .claude/settings.json for Claude Code, or Codex config
• Workspace hooks — scripts for git clone, branch creation, dependency install
• Orchestrator script — a starter script to poll and dispatch issues

Agent support

Agent	How it integrates
OpenAI Codex	codex app-server subprocess with JSON-RPC over stdio (reference implementation)
Claude Code	claude -p invocations with --output-format json, --max-turns, session management
Other agents	Any agent that can run non-interactively in a workspace directory

Bundled reference

The skill includes the complete Symphony specification (split into a condensed overview and two detailed reference files), implementation guides for both Codex and Claude Code, an audit checklist with scoring rubric, and a starter WORKFLOW.md template.

Usage

Invoke the skill directly:

/enable-symphony

Or Claude will invoke it automatically when the conversation involves symphony, coding agent automation, WORKFLOW.md, issue-to-PR automation, or agent orchestration.

Requirements

• Claude Code

License

MIT