Factory Droid 실전 튜토리얼: 멀티 에이전트 개발팀 구축법

단순한 버그 하나를 수정하는 작업은 이제 대부분의 AI 코딩 도구가 무리 없이 해냅니다. 하지만 수십 개 파일에 걸친 인증 모듈 개편이나 대규모 마이그레이션 같은 작업을 맡기면, 대화형 에이전트는 맥락을 놓치고 엉뚱한 코드를 만들어내기 일쑤였습니다.

Factory는 자사 코딩 에이전트인 Droid의 방향을 단일 코드 편집기에서 다중 전문 에이전트를 조율하는 엔지니어링 오케스트레이션 플랫폼으로 전환했습니다.

코드 수정 전에 기획서부터 검토받는 방식

복잡한 작업에서 코딩 에이전트가 실패하는 주된 이유는 코드를 너무 일찍 수정하기 시작하거나, 저장소를 얕게 파악한 뒤 막연한 계획을 세우기 때문입니다.

Droid의 핵심 기능인 Spec Mode는 코드를 건드리기 전에 저장소를 먼저 조사하고 기술 설계, 예상 변경 파일, 테스트 전략을 담은 구현 계획을 도출합니다. 변경 비용이 가장 저렴한 계획 단계에서 개발자가 가정과 롤백 방안을 점검하고 승인해야만 실제 구현이 시작됩니다.

승인된 사양은 마크다운 문서로 저장되어 팀원과 다른 에이전트가 참고할 수 있는 아키텍처 기록으로 남습니다. 또한 빈 프롬프트에서 느낌표를 누르면 즉시 Bash 모드로 전환되어 Git 상태를 확인하고, Escape를 누르면 대화 맥락 낭비 없이 에이전트로 복귀할 수 있습니다.

워크트리 격리와 단계별 컨텍스트 제어

복잡한 저장소를 다루기 위해 Droid는 계층화된 컨텍스트 구조를 사용합니다. 저장소 전반의 규칙은 AGENTS.md에 정의하고, 배포 체크리스트처럼 특정 상황에만 필요한 절차는 Skills 형태로 패키징해 필요할 때만 불러옵니다.

외부 도구 연동을 위해 MCP를 지원하며, CI 파이프라인이나 자동화 스크립트에서 백그라운드로 실행할 수 있는 droid exec 명령어도 제공합니다.

특히 대형 프로젝트를 마일스톤 단위의 Missions로 나누고, 서로 다른 모델과 권한을 가진 커스텀 Droid에 작업을 분배합니다. 이때 Git Worktree를 네이티브로 활용해 여러 에이전트가 서로의 코드를 덮어쓰지 않고 독립된 작업 공간에서 병렬로 구현과 테스트를 수행합니다.

왜 중요한가

우리는 최신 파운데이션 모델의 성능이 평준화되면서, 코딩 도구의 성패가 모델을 둘러싼 엔지니어링 실행 환경에 달려 있다고 봅니다.

개발자 입장에서 Droid는 작업 단위가 단순 코드 수정을 넘어설 때 가장 강력합니다. 가벼운 스타일 수정이나 함수 추가는 기존 도구로도 충분하지만, 설계와 검증, 리뷰 기록이 모두 필요한 대규모 리팩터링에서는 Spec Mode와 병렬 워크트리가 확실한 통제력을 제공합니다.

무작정 코드를 작성하는 대신 인간의 검토 지점을 강제하고 변경 사항을 격리한 접근 방식은 매우 영리합니다. 다만 AGENTS.md를 정교하게 유지하고, 과도한 MCP 도구 확장을 경계하며, 테스트 파이프라인을 갖춰야 하는 등 초기 세팅 비용이 높다는 점은 도입 전 고려해야 할 요소입니다.