AI 시대에 단일 브랜치만으로는 충분하지 않다 — git worktree Pockode
Source: Dev.to
Background
지난 글에서 저는 Pockode를 만들어 집에 있는 PC에서 휴대폰으로 Claude Code를 제어하는 방법을 소개했습니다. 사용해 보면서 새로운 불편함이 드러났습니다: 병렬 작업.
The Problem with Parallel Work
Claude Code를 사용할 때 대기 시간이 낭비처럼 느껴지기 시작합니다. Claude Code가 하나의 기능을 작업하는 동안 다른 아이디어가 계속 떠오릅니다:
- 다른 기능을 진행하기
- 버그 조사하기
- PR 리뷰 백로그 정리하기
직접 코드를 작성할 때는 한 번에 하나의 작업만 하면 되었지만, Claude Code와 함께라면 “여러 일을 동시에 시키고 싶다”는 욕구가 자연스럽게 생깁니다. 같은 작업 디렉터리를 공유하는 여러 Claude Code 인스턴스를 실행하면 곧 다음과 같은 문제가 발생합니다:
- 한 작업이 만든 파일이 다른 작업에 의해 덮어쓰기됨
- 한 작업의 변경 사항이 다른 작업의 전제를 깨뜨림
- 상태가 계속 변해서 실제로 무엇이 완료됐는지 추적하기 어려워짐
극히 조심한다면 동작하게 할 수 있지만, 병렬 작업이 일반적인 상황이라면 보다 견고한 해결책이 필요합니다.
Introducing git worktree Management
이를 해결하기 위해 Pockode에 git worktree 관리를 추가했습니다. 사이드바에서 몇 번만 탭하면 다음을 할 수 있습니다:
- 새 작업 트리를 생성하여 별도 작업을 진행
- 작업 트리 간을 즉시 전환
Pockode는 모바일 우선으로 설계되었지만, 동일한 워크플로우가 데스크톱에서도 부드럽게 동작합니다. 모바일에서 “가능한 한 쉽게 전환”하도록 집중한 덕분에 PC에서도 가장 매끄러운 워크플로우를 경험하게 되었습니다.
How It Works in Pockode
- 사이드바 열기 → “Add Worktree” 탭하기.
- 브랜치를 선택하거나 새 브랜치를 생성.
- Pockode가 내부적으로
git worktree add를 실행해 동일한 저장소 객체를 공유하는 격리된 디렉터리를 만듭니다. - 병렬 작업을 시작하고 싶을 때마다 새로운 작업 트리로 전환.
- 작업이 끝나면 같은 UI에서 작업 트리를 삭제할 수 있으며, 이는
git worktree remove를 실행합니다.
각 작업 트리는 자체 작업 디렉터리를 가지므로 Claude Code 인스턴스 간에 더 이상 충돌이 발생하지 않습니다.
Benefits
- 격리: 각 작업이 자체 디렉터리에서 이루어져 파일 덮어쓰기를 방지합니다.
- 속도: 작업 트리 전환이 즉시 이루어져 무거운
git checkout작업을 피합니다. - 일관성: 모든 작업 트리가 동일한 객체 데이터베이스를 공유해 저장소 크기를 작게 유지합니다.
- 모바일 친화적: UI가 몇 번의 탭으로 최적화돼 휴대폰에서도 병렬 작업이 가능해집니다.
Conclusion
git worktree 관리를 통합함으로써 Pockode는 이제 Claude Code와 함께 진정한 병렬 개발을 지원합니다. 여러 기능, 버그 조사, PR 리뷰를 공유 상태의 혼란 없이 동시에 진행할 수 있습니다.