Git worktree는 코딩 에이전트의 병렬 편집을 어디까지 격리할까?

같은 폴더와 작업별 Git worktree에서 서로 다른 파일과 같은 줄을 고쳐 스테이징, 덮어쓰기, 병합 충돌을 비교했습니다.

Git worktree를 작업별로 만들면 각 작업이 자기 폴더와 스테이징 영역을 씁니다. 같은 줄을 수정해도 각자 변경을 커밋할 수 있고, 두 버전을 합칠 때 충돌이 날 수 있습니다. 같은 폴더를 공유한 재현에서는 한 작업의 저장이 다른 작업의 변경을 커밋 전에 덮었습니다.

같은 조건에서 네 번 고쳐 봤습니다

A의 요구는 지원 포맷 목록에 csv 추가, B의 요구는 json 추가입니다. 서로 다른 파일을 고칠 때는 A가 csv.json, B가 json.json에 항목을 추가했습니다. 같은 줄을 고칠 때는 둘 다 formats.json의 한 줄짜리 배열을 편집했습니다.

모든 경우 같은 초기 커밋에서 시작했습니다. 두 작업이 먼저 파일을 읽고 A, B 순서로 저장한 뒤 A부터 차례로 git add -- <파일>과 git commit을 실행했습니다. 코딩 에이전트가 파일을 편집하는 상황을 스크립트로 모사했습니다. 2026년 11월 19일에 macOS의 Git 2.39.5 (Apple Git-154)로 재현했습니다.

작업 폴더와 편집 위치 스테이징·커밋 결과 병합 최종 테스트 A / B
공유 폴더 · 다른 파일 각 파일이 자기 작업의 커밋에 들어감 같은 브랜치에 순차 커밋 통과 / 통과
공유 폴더 · 같은 줄 A가 B의 내용을 커밋. B는 커밋할 변경이 없음 같은 브랜치에서 작업 실패 / 통과
작업별 worktree · 다른 파일 두 작업 브랜치에 각각 커밋 자동 병합 통과 / 통과
작업별 worktree · 같은 줄 두 작업 브랜치에 각각 커밋 같은 줄 충돌, 두 항목을 합쳐 해결 해결 후 통과 / 통과

같은 줄을 고쳤을 때 덮어쓰기와 충돌은 언제 생겼나

공유 폴더에서 A가 formats.json을 ["txt", "csv"]로 저장했습니다. B는 처음 읽은 버전에 json을 추가해 같은 파일에 저장했습니다. 그 뒤 A가 파일을 스테이징했을 때 Git이 읽은 내용에는 json만 추가돼 있었습니다. A 이름으로 커밋됐지만 A의 요구는 빠졌고, 작업 폴더 상태는 깨끗했습니다.

작업별 worktree에서는 A와 B가 각자의 변경을 커밋했습니다. 통합 브랜치에 A를 먼저 반영하고 B를 병합하자 Git이 두 버전을 보여 주고 멈췄습니다.

Auto-merging formats.json
CONFLICT (content): Merge conflict in formats.json

충돌을 ["txt", "csv", "json"]으로 해결하고 테스트했습니다. 세 파일에서 합친 목록에 csv가 있는지, json이 있는지 각각 출력하고 둘 다 있어야 성공하는 테스트입니다. 병합 전 개별 브랜치에서는 각자가 추가한 항목만 통과했고, 해결 커밋에서는 두 항목이 모두 통과했습니다. Git 공식 병합 충돌 설명

파일이 달라도 git add -A는 두 변경을 담았습니다

공유 폴더에서 서로 다른 파일을 고친 경우를 반복하면서 A만 git add -A로 바꿨습니다. A의 커밋에 csv.json과 json.json이 함께 들어갔습니다. B가 뒤이어 커밋을 시도하자 nothing to commit이 나왔습니다. 이때도 최종 테스트는 둘 다 통과했습니다.

git add -- <파일>은 지정한 경로의 스테이징만 갱신합니다. 다른 작업이 이미 스테이징한 변경이 있으면 일반 git commit에 함께 들어갈 수 있습니다. 공유 폴더에서 커밋할 내용을 확인하려면 git diff --cached로 현재 스테이징된 변경을 봅니다. 연결된 worktree는 작업 폴더와 index를 각각 두고 Git 저장소는 공유합니다. Git 공식 add 문서 · Git 공식 commit 문서 · Git 공식 worktree 문서

정리

  • 두 에이전트가 같은 폴더에서 같은 파일을 고치면, 뒤에 저장한 쪽이 앞의 변경을 커밋 전에 덮을 수 있습니다. 작업 폴더 상태가 깨끗해도 요구가 빠질 수 있으니 요구별 테스트로 확인합니다.
  • 작업별 worktree는 편집과 스테이징을 나눕니다. 같은 줄의 변경은 병합할 때 충돌로 드러나며, 충돌 자체를 없애 주지는 않습니다.
  • 같은 폴더를 계속 쓴다면 git add -A 대신 경로를 지정하고, 커밋 전에 git diff --cached로 내 변경만 담겼는지 봅니다.

이번 재현은 임시 Git 저장소의 작은 JSON 배열에서 편집 순서를 고정해 실행했습니다. 사람 작업 시간과 토큰 절감은 측정하지 않았습니다.