Git worktree로 나눠도 충돌하는 이유: 병렬 코딩의 통합 문제

여러 AI 세션을 동시에 실행할 때 작업 폴더를 분리하면 파일이 뒤섞이는 문제를 줄일 수 있습니다. 하지만 폴더가 나뉘었다고 설계와 요구사항까지 독립적인 것은 아닙니다. 병렬 개발에서는 격리와 통합을 함께 설계해야 합니다.

worktree가 해결하는 범위

Boris Cherny가 공개한 병렬 작업 팁에서도 별도 작업 공간을 활용하는 방식이 등장합니다. Git worktree는 한 저장소의 서로 다른 작업 트리를 두고 작업하는 데 쓰입니다. Claude Code 공식 문서에도 병렬 작업과 격리 관련 안내가 있습니다.

각 작업 공간이 분리되어 있어도 같은 API의 입출력 규칙을 서로 다르게 바꾸면 병합 후 오류가 발생할 수 있습니다. 파일 충돌이 없다는 사실은 기능 충돌이 없다는 뜻이 아닙니다.

함께 실행하기 좋은 작업과 어려운 작업

가상의 예약 서비스라면 도움말 수정과 로그 분석은 나눌 수 있습니다. 예약 상태 값 변경과 알림 기능 구현은 상태 정의를 합의한 뒤 시작하는 편이 낫습니다.

시작할 때 정해야 하는 것

첫째, 각 작업의 기준 브랜치와 수정 범위를 적습니다. 둘째, 공유 인터페이스를 먼저 합의합니다. 셋째, 작업별 확인 결과를 남기는 형식을 통일합니다. 넷째, 통합 순서를 정합니다.

작업이 끝나면 변경 파일 목록만 받지 말고 기대 동작, 실행한 검사, 아직 확인하지 못한 조건을 받으세요. 앞선 변경을 병합한 뒤 후속 작업의 검사를 다시 해야 하는지도 판단합니다.

세션 수를 늘리는 기준

대기 시간이 줄어드는지와 검토 시간이 늘어나는지를 함께 기록합니다. 작성은 빨라졌지만 사람이 차이를 이해하는 데 두 배의 시간이 들면 전체 흐름은 느려질 수 있습니다. 동시에 끝난 결과를 검토할 여유가 없다면 실행 수를 줄이는 것이 합리적입니다.

git init -b main
git add api.py app.py
git commit -m "initial demo"
git worktree add -b api-change ../api-work
git worktree add -b app-change ../app-work

def payload():
    return {"status": "ready"}

def payload():
    return {"state": "ready"}

from api import payload
print(payload()["status"])

from api import payload
print("Current:", payload()["status"])

git merge api-change
git merge app-change
python3 app.py
# KeyError: 'status'

자주 묻는 질문

worktree는 저장소 복사와 같나요? 별도 작업 공간을 제공하지만 Git 저장소와 연결되어 관리됩니다. 환경 설정과 외부 서비스까지 자동으로 분리되는 것은 아닙니다.

테스트 데이터베이스도 분리해야 하나요? 병렬 작업이 같은 데이터를 수정한다면 별도 데이터나 격리 전략이 필요합니다. 파일만 나눠서는 해결되지 않습니다.

병합 충돌이 없으면 끝인가요? 함께 실행했을 때의 사용자 동작을 확인해야 합니다. 특히 API·스키마·환경 변수 변경은 통합 시 다시 살펴보세요.

참고 자료

• 공식 자료·원저자 글
• 분석한 소개·토론 글

자료 확인일: 2026년 9월 28일. 기존 도구 소개는 공개 문서 기준입니다. 2026-10-12에 추가한 Git·Python 데모만 별도 환경에서 직접 실행했습니다. AI 도구 설치나 성능 실험은 하지 않았습니다.