Use git worktrees

Location

All worktrees live in ~/worktrees/<project>/<worktree>, where <project> is the repo's directory name and <worktree> matches the branch name:

git worktree add ~/worktrees/course-platform/milestone-4-auth -b milestone-4-auth <target-branch>

Never create worktrees inside the repository or scattered elsewhere. git worktree list shows what exists.

Setup after creating

• Follow the repository's setup instructions and install dependencies in the worktree; generated or ignored dependency directories are not shared between checkouts.
• Give deployments from concurrent worktrees a dedicated stage/environment. Never let parallel checkouts mutate the same deployment state.
• For delegated work, also follow use-subagents; the parent agent owns all worktree creation, integration, and cleanup.

Working in the worktree