챕터별 상세
Symphony의 개념과 패러다임의 전환
Symphony는 OpenAI가 공개한 오픈소스 리포지토리로, 코딩 에이전트를 관리하는 오케스트레이터이다. 기존에는 개발자가 에이전트와 직접 대화하며 세션을 관리했으나, Symphony는 Linear와 같은 티켓 트래커를 컨트롤 플레인으로 사용한다. 에이전트가 티켓 시스템에서 직접 작업을 가져오고(Pull), 완료 후 티켓에 직접 보고하는 방식으로 인간의 인지적 부하를 줄인다. 이는 에이전트의 능력을 모델 성능이 아닌 인간의 주의력 한계가 결정하던 문제를 해결하기 위한 접근이다.
기존의 대화형 인터페이스에서 작업 단위(Ticket) 중심의 비동기적 워크플로우로 전환되는 개념을 이해해야 한다.
Symphony의 작동 원리와 3대 구성 요소
Symphony 시스템은 스케줄러(Scheduler), WORKFLOW.md, 상태 머신(State Machine)의 세 가지 핵심 요소로 구성된다. 스케줄러는 30초마다 Linear 보드를 확인하여 'To Do' 상태의 티켓이 있는지 폴링(Polling)한다. 티켓이 발견되면 격리된 워크스페이스를 생성하고 에이전트를 실행한다. Linear 보드 자체가 시스템의 상태를 저장하는 내구성이 있는 상태 머신 역할을 수행하며, 에이전트는 티켓의 상태를 'In Progress'에서 'Human Review'로 변경하며 작업을 진행한다.
상태 머신은 시스템의 상태를 정의하고 전이(Transition)를 관리하는 설계 패턴을 의미한다.
WORKFLOW.md를 통한 에이전트 제어
WORKFLOW.md 파일은 에이전트의 행동 지침과 시스템 설정을 담은 핵심 문서이다. 상단의 YAML Frontmatter 영역에는 Linear API 키, 프로젝트 슬러그, 폴링 간격, 최대 병렬 에이전트 수 등을 정의한다. 하단의 Markdown 영역은 에이전트가 매 턴마다 수신하는 시스템 프롬프트 역할을 하며, 티켓 정보를 렌더링하여 전달한다. 이 파일은 코드 저장소 내에 위치하므로 Pull Request를 통해 에이전트의 작업 규칙을 버전 관리하고 수정할 수 있다.
YAML Frontmatter는 파일 최상단에 메타데이터를 정의하는 형식이다.
코드베이스 하네스(Harness) 구축과 자동 검증
에이전트가 자율적으로 작업을 완수하려면 적절한 환경인 '하네스'가 필요하다. 하네스는 에이전트가 실행할 수 있는 부팅 스크립트, 문서 구조, 그리고 스스로 결과를 확인하는 셀프 검증 도구를 포함한다. 특히 Playwright-cli를 활용하면 에이전트가 브라우저에서 작업을 수행하고 그 과정을 비디오로 녹화하여 Linear 티켓에 증거로 첨부할 수 있다. 이를 통해 인간은 에이전트가 작성한 코드뿐만 아니라 실제 동작 화면까지 비동기적으로 검토할 수 있게 된다.
하네스(Harness)는 소프트웨어나 에이전트가 특정 환경에서 원활하게 동작하도록 돕는 테스트 및 실행 환경을 뜻한다.
Symphony 설치 및 실전 설정 방법
Symphony는 Elixir 언어로 구현되어 있으며, 설치 후 `symphony` 명령어를 WORKFLOW.md 경로와 함께 실행하여 활성화한다. 사용자는 Linear 설정에서 프로젝트 슬러그와 개인 API 키를 발급받아 환경 변수로 등록해야 한다. Linear 보드에서 'Human Review', 'Merging' 등의 상태(Status)를 추가하여 Symphony가 인식할 수 있는 워크플로우를 구성한다. 설정이 완료되면 에이전트는 티켓을 인식하고 자동으로 브랜치를 생성하며, 작업 완료 후 PR 링크와 테스트 영상을 티켓 댓글로 남긴다.
Elixir는 병렬 처리에 강점이 있는 프로그래밍 언어이며, Symphony의 기본 구현체로 사용되었다.
언급된 리소스
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 05. 02.수집 2026. 05. 02.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
