한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
개발·오픈소스 · 판정 관망
그림을 글로 풀면
책상과 브랜치를 함께 나누기
다른 worktree에서 쓰는 브랜치는 기본적으로 다시 체크아웃할 수 없습니다.
- 대상
- AI 코딩 작업을 별도 폴더에서 검토하는 개발자
- 무엇이 바뀜
- 폴더와 함께 브랜치 사용 상태도 확인합니다.
- 왜 중요한가
- 폴더 이름만 바꾸면 작업 분리가 막힐 수 있습니다.
- 지금 할 일
- worktree 목록에서 사용 중인 브랜치를 확인하세요.
- 한계·미확인
- 개념 비유. 생성·충돌·병합 시험 없음.
- 확인일
- 2026-10-18
폴더를 나누기 전에 붙어 있는 이름부터 보기
가상의 AI 코딩 검토에서 원래 수정 작업은 그대로 두고 별도 폴더에서 다른 변경을 준비한다고 가정합니다. 그림 속 두 책상처럼 위치를 나눴어도 같은 브랜치 이름을 붙이려 하면 추가가 거절될 수 있습니다. AINOW는 새 작업의 목적과 시작 커밋, 사용할 브랜치를 먼저 적어 두는 방법을 제안합니다.
기본 보호는 이미 사용 중인 브랜치도 확인합니다
Git 공식 매뉴얼은 worktree add에 지정한 브랜치가 다른 worktree에서 이미 체크아웃되어 있으면 기본적으로 생성을 거절한다고 설명합니다. git worktree list는 각 작업 위치와 체크아웃한 브랜치 또는 detached HEAD 상태를 보여 줍니다. 폴더 경로만 보고 판단하지 말고 이 연결을 함께 대조하세요.
별도 브랜치와 임시 검토의 목적 구분하기
계속 수정하고 커밋할 작업이면 별도의 새 브랜치를 준비할 수 있습니다. 브랜치에 연결하지 않는 임시 검토에는 detached HEAD 방식도 있으므로 두 용도를 구분해야 합니다. 공식 문서에는 기본 보호를 무시하는 강제 옵션도 있지만 단순 오류 해결책으로 적용하지 마세요. worktree끼리는 저장소 정보를 일부 공유하므로 완전히 독립된 저장소나 보안 격리로 보아서는 안 됩니다. 이번 글은 명령 실행·병합·충돌 시험 결과가 아닙니다.
참고 원문: Git 공식 매뉴얼 — git-worktree · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-18
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- git-worktree 매뉴얼2.56.0(2026-09-28 갱신 표시), 2026-10-18 열람. add 기본 보호와 list. 별도 worktree 재현 시험 없음
- 확인일
- 2026-10-18
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. 생성·충돌·병합 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.