Symphony: AI 코딩 에이전트를 오케스트레이션하는 프로젝트 자동화 시스템

AI 코딩 에이전트가 점점 발전하면서 개발자의 역할도 바뀌고 있습니다.
이제 개발자가 **직접 코드를 작성하기보다 “작업을 관리하는 역할”**에 가까워지고 있습니다.

이러한 흐름 속에서 OpenAI가 공개한 프로젝트가 바로 Symphony입니다.

Symphony는 프로젝트 관리 도구의 티켓을 읽고, 각 작업을 **독립적인 AI 구현 실행(run)**으로 변환하여 자동으로 코드를 작성하고 PR까지 생성하는 AI 에이전트 오케스트레이션 시스템입니다. (GitHub)

이 글에서는 Symphony가 어떤 프로젝트인지, 어떤 구조로 동작하는지, 그리고 실제로 개발 환경에서 어떻게 활용할 수 있는지 살펴보겠습니다.

---

프로젝트 소개

Symphony는 OpenAI에서 공개한 오픈소스 프로젝트로,
프로젝트 관리 시스템의 작업을 AI 코딩 에이전트 실행 단위로 자동 변환하는 오케스트레이션 서비스입니다.

핵심 아이디어는 다음과 같습니다.

프로젝트 작업 → 자동 에이전트 실행 → 코드 구현 → PR 생성

Symphony는 다음과 같은 역할을 합니다.

• 프로젝트 보드 (예: Linear)에서 작업을 읽음
• 각 작업마다 독립적인 workspace 생성
• AI 코딩 에이전트를 실행
• 구현 완료 후 PR / CI 결과 / 리뷰 정보 제공

즉 개발자는 다음과 같은 방식으로 일하게 됩니다.

기존 개발 방식

이슈 생성 → 개발자가 코드 작성 → PR → 리뷰

Symphony 방식

이슈 생성 → Symphony가 에이전트 실행 → 코드 구현 → PR 생성

결과적으로 개발자는 코딩 에이전트를 직접 감독하지 않고 작업 단위만 관리하면 됩니다. (GitHub)

현재는 Engineering Preview 형태로 공개되어 있으며, 실험적 프로젝트입니다.

---

왜 이 프로젝트가 등장했을까

최근 AI 기반 개발 방식은 다음 단계로 발전하고 있습니다.

1️⃣ Copilot 시대

개발자가 코드 작성
AI는 코드 자동완성

대표 도구

• Copilot
• Codeium
• Cursor

---

2️⃣ Agent Coding 시대

개발자가 작업 설명
AI가 코드 구현

대표 도구

• Devin
• Codex CLI
• SWE-agent

하지만 여기서 문제가 하나 발생합니다.

문제: 에이전트를 관리하는 비용

개발자는 다음을 계속 확인해야 합니다.

• 에이전트 실행 상태
• 작업 결과
• 코드 변경
• 실패한 작업 재시도

즉 AI를 관리하는 또 다른 작업이 생깁니다.

---

Symphony가 해결하려는 문제

Symphony는 이 문제를 해결하기 위해 등장했습니다.

핵심 철학

"코딩 에이전트를 관리하지 말고, 작업을 관리하라"

이를 위해 다음 구조를 제공합니다.

• 작업 → 자동 실행
• 실행 → isolated workspace
• 결과 → PR + CI

즉 개발자는 단순히 프로젝트 보드만 관리하면 됩니다.

---

핵심 기능

Symphony는 크게 5가지 핵심 기능을 제공합니다.

---

1. Issue 기반 작업 자동 실행

Symphony는 Issue Tracker를 주기적으로 폴링합니다.

예:

• Linear
• GitHub Issues
• Jira (추후 확장 가능)

예시 흐름

Linear에 새 이슈 생성
↓
Symphony 감지
↓
에이전트 실행
↓
코드 작성
↓
PR 생성

---

2. 작업별 독립 Workspace

각 작업은 완전히 독립된 workspace에서 실행됩니다.

예

workspace/
   issue-101/
   issue-102/
   issue-103/

이 구조의 장점

• 작업 간 충돌 방지
• 재실행 가능
• 디버깅 용이

---

3. Workflow 기반 실행 정책

Symphony는 실행 정책을 코드 저장소 안에서 관리합니다.

파일

WORKFLOW.md

여기에는 다음이 정의됩니다.

• 에이전트 프롬프트
• 실행 규칙
• 승인 정책
• CI 요구사항

예시

---
agent: codex
max_attempts: 3
review_required: true
---
You are an AI engineer implementing GitHub issues.
Follow repository conventions and write production-quality code.

이 방식의 장점

• 워크플로우 버전 관리 가능
• 팀별 정책 관리 가능
• 재현성 확보

---

4. 자동 PR 생성 및 검증

에이전트는 작업을 완료하면 다음 결과를 생성합니다.

예

• Pull Request
• CI 상태
• 코드 리뷰 피드백
• 복잡도 분석
• 실행 과정 기록

팀은 이를 확인하고 승인하면 됩니다.

---

5. Orchestrator 기반 멀티 작업 처리

Symphony는 동시에 여러 작업을 실행할 수 있습니다.

핵심 기능

• concurrency control
• retry
• failure recovery
• observability

즉 일종의 AI 개발 작업 스케줄러라고 볼 수 있습니다.

---

프로젝트 구조

Symphony는 명확한 레이어 기반 아키텍처로 설계되어 있습니다.

각 구성 요소를 살펴보겠습니다.

---

1. Workflow Loader

워크플로우 설정을 로딩합니다.

역할

• WORKFLOW.md 파싱
• 프롬프트 템플릿 생성
• 설정 값 검증

예

config + prompt_template

---

2. Issue Tracker Client

프로젝트 관리 시스템과 연결됩니다.

예

• Linear API
• GitHub Issues

역할

• 작업 목록 조회
• 상태 변경 확인
• 실행 대상 필터링

---

3. Orchestrator

Symphony의 핵심입니다.

역할

• 작업 스케줄링
• 실행 상태 관리
• 재시도 관리
• 동시 실행 제한

쉽게 말하면 AI 작업 스케줄러입니다.

---

4. Workspace Manager

각 작업의 실행 환경을 준비합니다.

기능

• workspace 생성
• repository checkout
• 실행 환경 설정

예

/workspace/issue-123

---

5. Agent Runner

실제로 코딩 에이전트를 실행하는 컴포넌트입니다.

역할

• 프롬프트 생성
• agent 실행
• 로그 스트리밍
• 결과 수집

---

실행 흐름

전체 실행 흐름을 정리하면 다음과 같습니다.

---

간단한 사용 흐름

현재 Symphony는 두 가지 방식으로 사용할 수 있습니다.

방법 1 — 직접 구현

Symphony는 SPEC 기반 프로젝트입니다.

즉 다음 문장을 AI에게 입력하면 됩니다.

Implement Symphony according to the spec:
https://github.com/openai/symphony/blob/main/SPEC.md

즉 AI가 Symphony를 구현하도록 만드는 구조입니다.

---

방법 2 — Elixir 레퍼런스 구현

레포에는 Elixir 기반 구현체가 포함되어 있습니다.

Elixir가 선택된 이유

• Erlang VM 기반
• 장시간 프로세스 안정성
• 높은 동시성
• hot reload 지원 (Elixir Programming Language Forum)

---

이 프로젝트가 중요한 이유

Symphony는 단순한 툴이 아니라 개발 패러다임 변화를 보여주는 프로젝트입니다.

기존 개발

Developer → Code

AI 개발

Developer → Prompt → Code

Symphony 시대

Developer → Task → AI system → Code

즉 개발자는

• 코드를 작성하는 사람이 아니라
• 작업을 설계하고 관리하는 사람

이 되는 방향입니다.

---

정리

Symphony는 다음과 같은 특징을 가진 프로젝트입니다.

핵심 특징

• AI 코딩 에이전트 orchestration
• Issue 기반 자동 개발 실행
• 작업별 isolated workspace
• Workflow 기반 정책 관리
• 자동 PR 생성

한 줄 요약

Symphony는 "AI 개발자를 운영하는 CI 시스템"이다.

---

원하시면 제가 추가로 다음 내용도 깊게 설명해 드릴게요.

• Symphony vs Devin vs SWE-agent 차이
• AI 회사들이 왜 "Agent Orchestrator"를 만들기 시작했는지
• 앞으로 개발팀 구조가 어떻게 바뀔지 (매우 중요한 변화)