Git Worktrees Changed How I Run Parallel AI Agents

Context

복수의 AI 코딩 에이전트(Claude Code, Codex, Aider 등)가 동일 저장소의 같은 파일을 동시에 편집하면서 2시간 이상의 병합 충돌 해결 시간이 발생했다. 에이전트가 같은 파일에 동시 쓰기를 수행할 때 한쪽 작업이 완전히 덮어써져 손실되거나 복잡한 충돌이 발생하는 문제가 있었다.

Technical Solution

• Git Worktree 생성: 각 에이전트마다 독립적인 워킹 디렉토리를 생성하되, 동일한 .git 디렉토리를 공유하도록 구성 (git worktree add ./agent-1 -b agent-1/task-42)
• 파일시스템 수준 격리: 각 워킹트리가 서로 다른 브랜치에서 작동하므로 agent-1의 src/main.rs와 agent-2의 src/main.rs는 물리적으로 다른 파일이 됨
• 디스크 효율성: 전체 저장소를 복제하는 대신 .git 디렉토리만 공유하여 node_modules/, target/ 같은 대용량 디렉토리 복사 없음
• 지속적 워킹트리 운영: 작업마다 워킹트리를 생성·삭제하지 않고 에이전트당 고정 워킹트리를 유지한 후 git checkout main && git pull && git checkout -b eng-1/task-43 방식으로 브랜치만 교체
• 순차 병합 제어: 에이전트 작업 완료 후 테스트 실행, 통과 시 60초 락 타임아웃을 가진 순차 병합 프로세스 적용

Impact

아티클에 정량적 성능 수치가 명시되지 않음. 기존에 "2시간의 병합 충돌 해결"이 필요했던 시나리오가 구조적으로 제거됨.

Key Takeaway

병렬 멀티 에이전트 작업 환경에서는 런타임 격리만으로는 부족하고 파일시스템 수준에서 각 에이전트가 독립적인 저장소 복사본을 보유해야 하며, Git Worktree는 복제 오버헤드 없이 이를 달성할 수 있는 기본 원시 도구다.