using-worktrees

What problem does it solve?

This Skill automates the secure creation of isolated Git worktrees for feature development, preventing main workspace changes and providing deterministic contexts.

Core Features & Use Cases

• Detect and respect existing worktree indicators to avoid conflicts.
• Honor CLAUDE.md preferences when selecting a worktree location.
• Create a new worktree on a dedicated branch and verify a clean baseline.
• Set up project environments (devenv, npm/yarn/pip toolchains, etc.) as needed.
• Produce a final, absolute path report and readiness for implementation.

Quick Start

• Step 1: Check existing directories: ls -d .worktrees 2>/dev/null; ls -d worktrees 2>/dev/null
• Step 2: Check CLAUDE.md preference: grep -i "worktree" CLAUDE.md 2>/dev/null
• Step 3: If no preference, use AskUserQuestion tool to gather location
• Step 4: Verify directory is gitignored for project-local worktrees
• Step 5: Create worktree on a new branch using git worktree add
• Step 6: Run environment setup detection and installation if applicable
• Step 7: Verify a clean baseline by running project tests
• Step 8: Report the absolute path, branch, test status, and environment, and prepare to implement the feature