용어 사전
워크트리 격리란?
워크트리 격리는 AI 에이전트마다 별도 브랜치와 폴더에 코드 사본을 주는 방식입니다. 모든 에이전트가 동시에 작업해도 서로 덮어쓰지 않습니다.
문제
에이전트 A에게 로그인 페이지를 다시 만들라고 합니다. 에이전트 B에게 회원 가입 흐름을 추가하라고 합니다. 둘 다 같은 파일을 수정해야 합니다. 같은 폴더에서 작업하면 에이전트 B가 자체 버전의 auth.ts을 저장하며 에이전트 A의 변경 사항을 덮어씁니다. 에이전트 A는 이 사실조차 모릅니다.
그래서 여러 에이전트를 같은 디렉터리에서 실행하면 위험합니다. 가끔은 잘 되지만 결국 무언가 덮어써지고 작업을 잃습니다.
해결 방법
에이전트마다 자체 git worktree를 주세요. 별도 브랜치가 있는 별도 폴더입니다. 에이전트 A는 한 worktree에서, 에이전트 B는 다른 worktree에서 작업합니다. 서로 다른 사본을 수정하므로 둘 다 auth.ts을 동시에 바꿀 수 있습니다.
my-project/ ← main branch (untouched)
../login-rewrite/ ← Agent A's worktree (feature/login)
../signup-flow/ ← Agent B's worktree (feature/signup)격리되는 것
| 격리됨 | 공유됨 |
|---|---|
| 파일과 커밋하지 않은 변경 사항 | git 기록과 커밋 |
| 브랜치 | 원격 저장소(origin) |
| 셸 상태와 환경 변수 | git 설정 |
| 작업 디렉터리 | 객체 저장소(디스크 공간 절약) |
Pane의 처리 방식
Pane에서 새 pane을 만들면 워크트리와 브랜치를 설정하고 .env와 node_modules를 복사한 뒤 에이전트를 시작합니다. pane을 보관하면 워크트리를 정리합니다. 직접 git worktree add을 실행할 필요가 없습니다.
관련 문서
마지막 업데이트 2026년 6월 24일