Git Worktrees를 사용한 Claude 코드용 병렬 에이전트 오케스트레이터

r/ClaudeAI의 한 개발자가 Claude Code 사용 시 흔히 발생하는 문제에 대한 해결책을 공유했습니다: AI 에이전트가 개발자가 브라우저에서 테스트하는 동안 공유 작업 디렉터리의 파일을 수정하여 애플리케이션 손상과 혼란스러운 깃 상태 보고를 초래하는 문제입니다. 이 개발자는 이를 프롬프트 문제가 아닌 아키텍처 문제로 파악했습니다.

해결책: 격리된 환경으로서의 깃 워크트리

이 해결책은 깃 워크트리를 사용하여 개발 중인 각 기능에 대해 별도의 격리된 환경을 생성합니다. 각 워크트리는 자체적으로 실행되는 애플리케이션과 URL을 가지므로, 개발자의 수동 테스트와 AI 에이전트의 파일 수정 간 충돌을 방지합니다.

병렬 오케스트레이터 구현

깃 워크트리 기반 위에, 이 개발자는 각 워크트리마다 동시에 하나의 Claude 에이전트를 생성하는 병렬 오케스트레이터를 구축했습니다. 이를 통해 개발자는 여러 에이전트가 서로 다른 기능을 동시에 작업하는 동안 자리를 비울 수 있습니다. 개발자가 돌아왔을 때는 변경 사항을 검토하고 필요에 따라 병합할 수 있습니다.

이 접근 방식은 소스에서 설명한 핵심 문제를 해결합니다: "당신은 당신의 두뇌, 브라우저, 그리고 당신이 눈을 돌릴 때 멈추지 않는 에이전트 사이에 하나의 작업 디렉터리를 공유하고 있습니다." 각 에이전트의 작업을 별도의 깃 워크트리로 격리함으로써, 개발자는 개발 과정 전반에 걸쳐 깨끗한 깃 상태와 정상 작동하는 애플리케이션을 유지합니다.