tmux와 마크다운 스펙으로 4~8개의 AI 코딩 에이전트를 병렬 실행하는 방법

AI 에이전트 병렬 개발의 실전 워크플로우

개발자 Manuel Schipper가 수개월간 실제 프로젝트에서 운용해온 AI 코딩 에이전트 병렬 실행 방법을 공유해 해커뉴스에서 113점을 기록했습니다. 오케스트레이터 없이 tmux와 마크다운 파일만으로 4~8개의 에이전트를 효과적으로 운영할 수 있다는 점이 주목받고 있습니다.

세 가지 에이전트 역할

tmux 윈도우마다 역할 명명 규칙을 사용합니다:

Planner: 새로운 기능이나 버그 수정을 위한 마크다운 스펙 작성

Worker: 완성된 스펙을 바탕으로 실제 구현

PM: 백로그 관리 및 아이디어 정리

Feature Design 파일의 핵심

시스템의 핵심은 Feature Design(FD) 마크다운 파일입니다. FD에는 해결할 문제, 검토한 모든 해결책(장단점 포함), 최종 솔루션과 구현 계획, 수정 파일 목록, 검증 단계가 포함됩니다. 각 FD는 번호가 붙어 Planned부터 Complete까지 8단계 라이프사이클로 추적 관리됩니다.

현실적인 한계와 팁

8개 이상의 에이전트를 동시에 운영하면 의사결정의 질이 저하됩니다. /fd-init 슬래시 명령어로 새 프로젝트에 이 시스템을 빠르게 적용할 수 있습니다. 이 접근법은 AI 에이전트 시대에 복잡한 인프라 없이 생산성을 극대화하는 구체적인 모델을 제시합니다.