Skip to content
using-git-worktrees logo

using-git-worktrees

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - creates isolated git worktrees with smart directory selection and safety verification

SKILL.md

Full skill instructions

Using Git Worktrees

Overview

Git worktrees create isolated workspaces sharing the same repository, allowing work on multiple branches simultaneously without switching.

Core principle: Systematic directory selection + safety verification = reliable isolation.

Announce at start: "I'm using the using-git-worktrees skill to set up an isolated workspace."

Directory Selection Process

Follow this priority order:

🧠 Knowledge Modules (Fractal Skills)

1. 1. Check Existing Directories

2. 2. Check CLAUDE.md

3. 3. Ask User

4. For Project-Local Directories (.worktrees or worktrees)

5. For Global Directory (~/​.config/​superpowers/​worktrees)

6. 1. Detect Project Name

7. 2. Create Worktree

8. 3. Run Project Setup

9. 4. Verify Clean Baseline

10. 5. Report Location

11. Skipping ignore verification

12. Assuming directory location

13. Proceeding with failing tests

14. Hardcoding setup commands