using-git-worktrees

Git worktrees isolate feature development by creating linked workspaces sharing the same repository. This allows simultaneous multi-branch development without disrupting your current workspace or requiring constant checkout switching.

Creating a git worktree involves directory discovery, safety verification, worktree creation, project setup, and baseline test validation. The process detects your project name, runs setup steps like dependency installation, and executes standard test suites to verify cleanliness.

Git check-ignore safety verification enforces ignore rules on the project-local directory during worktree setup. It automatically adds the worktree directory to .gitignore when needed, ensuring isolated workspaces remain untracked by the main repository.

Git worktrees support both project-local and global configurations. Priority-based directory selection checks hidden .worktrees folders, visible worktrees directories, and user direction via AGENTS.md, applying safe fallbacks for either local or global worktree creation.

Git worktrees provide the best approach for parallel feature branches and experiment isolation in local projects. They create isolated workspaces sharing the same repository, enabling safe integration planning and simultaneous development without affecting your primary working directory.