What problem does it solve?
Prevents workspace contamination and accidental commits by creating isolated git worktrees with a systematic directory selection and safety verification process that ensures project-local worktrees are ignored and baselined before implementation begins.
Core Features & Use Cases
- Priority-based directory selection: prefers a hidden .worktrees directory, then worktrees, then CLAUDE.md preference, and finally prompts the user for location.
- Safety verification and remediation: verifies project-local directories are covered by .gitignore and instructs adding and committing the ignore entry if missing to avoid committing worktree contents.
- Automated creation and project setup: creates a new worktree branch, runs dependency installation for common ecosystems (Node, Rust, Python, Go), and executes tests to verify a clean baseline before work starts.
- Use case: Start a feature branch without switching the main workspace, verify tests pass, and proceed with implementation confidently.
Quick Start
Use the using-git-worktrees skill to create an ignored project-local worktree for branch feature/auth, run the project's dependency setup, and verify tests before implementing changes.