using-git-worktrees

Create isolated git worktrees to separate feature work by discovering project-local directories, verifying gitignore status, and generating branch-based paths. This prevents accidental commits of worktree contents while keeping your main workspace clean during concurrent task development.

Use git worktrees when starting long-running feature branches or working concurrently on multiple tasks that require separate dependency installations. Workspace isolation prevents environment conflicts and allows baseline test validation in a clean directory without disrupting your primary working branch.

Git worktree directory discovery prefers existing project-local folders like .worktrees or worktrees, honors AGENTS.md preference checks, and prompts the user when placement is ambiguous. This ensures predictable path creation aligned with your project's established conventions.

Git worktrees can optionally bootstrap the repository by running the project's discoverable setup command and executing baseline tests after creating the branch-based path. This validates a clean starting point before you begin implementation work in the isolated environment.

Project-local git worktree directories need gitignore verification to prevent accidental tracking. This skill checks if directories like .worktrees are ignored, adds entries to .gitignore, and commits the changes when necessary to ensure worktree contents stay excluded from version control.