Multi-Agent Workflows & Git Worktrees

멀티에이전트 & Git Worktree — 개인 개발팀을 구성한다

같은 레포에서 Claude 여러 개를 병렬로 실행하는 Git Worktree 패턴과, 서브에이전트에게 연구·리뷰를 위임하는 멀티에이전트 워크플로를 마스터한다.

🍌 NANO BANANA CHEATSHEET · CH 08

Overview

개관

2026년 Claude Code 고수들이 가장 자주 언급하는 패턴: Git Worktree + 멀티 Claude = 개인 개발팀.

아이디어: Feature A를 왼쪽 터미널의 Claude가 구현하는 동안, 오른쪽 터미널의 Claude는 별도 브랜치에서 버그 픽스를 진행하고, 세 번째 Claude는 문서를 업데이트한다. 세 작업이 서로 충돌하지 않는다.

서브에이전트의 다른 용도: 복잡한 연구나 코드 리뷰를 서브에이전트에게 위임. 연구 결과물이 메인 컨텍스트를 오염시키지 않는다. 메인 Claude는 핵심 작업에만 집중한다.

🎯 Learning Goals

git worktree add로 새 작업 공간을 만들고 별도 Claude를 실행하는 방법을 안다
연구/리뷰 작업을 서브에이전트에게 위임해 메인 컨텍스트를 보호한다
/dispatching-parallel-agents 스킬의 작동 방식을 이해한다
어떤 작업이 병렬화에 적합하고 어떤 것은 직렬이어야 하는지 판단한다

Sections

본문

Git Worktree 실전 패턴

git worktree는 같은 레포의 다른 브랜치를 별도 디렉토리에 체크아웃한다. git stash 없이, 브랜치 전환 없이 여러 컨텍스트를 동시에 유지한다.

각 worktree 디렉토리에서 별도 Claude Code 세션을 실행하면 완전히 독립적인 작업이 가능하다. 같은 파일을 동시에 수정할 위험이 없다.

서브에이전트 위임 원칙

메인 컨텍스트에서 직접 하면 안 되는 작업들:

대규모 코드베이스 탐색 (결과가 컨텍스트를 가득 채움)
경쟁적 분석 (독립적 관점이 필요)
긴 문서 요약 (원문이 컨텍스트를 낭비)

이런 작업은 서브에이전트에게 위임하고 결과 요약만 받는다.

/dispatching-parallel-agents 스킬

이 스킬이 트리거되면 Claude는 작업을 분해해 여러 서브에이전트에게 병렬로 위임한다.

'이 PR 리뷰해줘'라고 하면 — 버그 탐지 에이전트, 보안 검토 에이전트, 성능 분석 에이전트가 독립적으로 실행되고 결과가 통합된다. 단일 에이전트 리뷰보다 훨씬 포괄적이다.

💡 Analogy · 비유

지휘자와 오케스트라

위대한 지휘자는 모든 악기를 직접 연주하지 않는다. 각 파트의 전문 연주자들을 조율해 조화로운 전체를 만든다. 멀티에이전트 패턴에서 메인 Claude는 지휘자다. 복잡한 연구, 코드 리뷰, 병렬 구현을 서브에이전트들에게 위임하고, 결과를 통합해 최종 산출물을 만든다.

Git Worktree로 Claude 병렬 실행 패턴

bash

# 현재 작업 중인 feature 브랜치에서
git worktree add ../my-project-bugfix bugfix/login-issue
git worktree add ../my-project-docs docs/update-api-reference

# 터미널 1 — 메인 feature 작업
cd ~/projects/my-project
claude  # Feature A 구현 중

# 터미널 2 — 버그 픽스 (별도 브랜치)
cd ~/projects/my-project-bugfix
claude  # 로그인 버그 수정 중 (독립적)

# 터미널 3 — 문서 업데이트 (별도 브랜치)
cd ~/projects/my-project-docs
claude  # API 문서 업데이트 중 (독립적)

# 작업 완료 후 정리
git worktree remove ../my-project-bugfix
git worktree remove ../my-project-docs

# 현재 worktree 목록 확인
git worktree list

각 worktree는 독립된 working directory다. 같은 git 레포를 공유하지만 서로 다른 브랜치를 체크아웃한다. 각 디렉토리에서 별도 Claude 세션을 실행하면 완전한 병렬 개발이 가능하다.

🏭 현업에서의 평가

멀티에이전트를 쓰는 팀과 단일 에이전트만 쓰는 팀의 차이는 단순히 속도가 아니다. 독립적 관점으로 검토된 코드 품질, 컨텍스트 오염 없는 메인 작업 집중 — 이것이 멀티에이전트가 진짜로 주는 가치다.

✅ 시니어가 보는 것

독립적으로 처리 가능한 작업을 서브에이전트로 올바르게 분리하는가
Git Worktree로 브랜치 간 작업을 효율적으로 관리하는가
서브에이전트 결과를 통합하는 방법을 이해하는가

Key Takeaways

핵심 정리

Git Worktree = 컨텍스트 전환 없는 병렬 개발

git stash, 브랜치 전환 없이 여러 작업을 동시에 진행한다.

연구·리뷰는 서브에이전트 위임

메인 Claude가 핵심에 집중할 수 있도록 무거운 작업은 위임한다.

병렬 = 독립성

의존 관계가 있는 작업은 직렬로. 병렬화는 독립적 작업에만 적용한다.

← Ch07 · Hooks System — From Advisory to Guaranteed Ch09 · 25 Expert Tips — The Power User Playbook →