using-git-worktrees

To isolate feature development, create a dedicated Git worktree to manage a separate branch in an isolated directory. This keeps your primary workspace stable while allowing you to work on features independently without switching branches.

Directory discovery prefers `.worktrees`, then `worktrees`, using `CLAUDE.md` as a fallback. Ignore validation checks `.gitignore` to ensure worktree directories are ignored before creation, preventing accidental commits of nested working directories.

Yes, after creating a Git worktree, the workflow runs per-project setup commands to ready the environment. This automates environment preparation, ensuring the isolated branch has all dependencies configured immediately.

Using Git worktrees is the best way to manage multiple branches without stashing. Worktrees provide isolated directories for each branch, allowing simultaneous branch work without disrupting your primary workspace or stashing uncommitted changes.

If no preferred directory is found during worktree creation, the guided workflow prompts you to choose a location. It enforces a discovery order based on priority and interactively asks for input when no configuration preference exists.