git:worktrees

Git worktrees enable checking out multiple branches simultaneously in separate directories, all sharing the same repository. Create a worktree instead of stashing changes or cloning separately.

Core principle: One worktree per active branch. Switch contexts by changing directories, not branches.

| Main worktree | Original working directory from git clone or git init | | Linked worktree | Additional directories created with git worktree add | | Shared .git | All worktrees share same Git object database (no duplication) | | Branch lock | Each branch can only be checked out in ONE worktree at a time |

여러 브랜치에서 동시에 작업할 때, 스태싱 없이 컨텍스트 전환, 개발 중 PR 검토, 개별적으로 테스트 또는 브랜치 간 구현 비교 시 사용합니다. 여러 작업 디렉터리를 사용한 병렬 개발을 위한 git worktree 명령과 워크플로 패턴을 제공합니다. 출처: neolabhq/context-engineering-kit.