Symphony Service Specification ↗

Editorial Notes

This is the definitive reference for building a Symphony-compatible orchestrator. The spec defines six layers (Policy, Configuration, Coordination, Execution, Integration, Observability) and a detailed state machine for issue lifecycle management. Pay close attention to the workspace isolation model — per-issue directories with lifecycle hooks (after_create, before_run, after_run, before_remove) — and the agent runner contract using JSON-RPC over stdio. The retry semantics with exponential backoff and the concurrency controls (global + per-state limits) are patterns worth adopting in any long-running agent system.