git-worktrees

Git Worktrees

Ensure work happens in an isolated workspace without disturbing the current checkout. Detect first. Consent only when the user invoked this skill directly; execute-plan skips the consent question, not this skill.

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

Step 1: Detect existing isolation

GIT_DIR=$(cd "$(git rev-parse --git-dir)" && pwd -P)
GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" && pwd -P)
git worktree list

• GIT_DIR != GIT_COMMON → already in a linked worktree. Report path + branch, skip to Step 3. Exception: if git rev-parse --show-superproject-working-tree prints a path, you are in a submodule, not a worktree — treat as normal repo.
• git worktree list already shows a worktree for this ticket → cd into it and skip to Step 3. Never create a second one for the same ticket.
• Current branch already matches this ticket (git branch --show-current contains the ticket key) → this checkout is the venue. Skip Step 2. Go to Step 3.
• GIT_DIR == GIT_COMMON and no ticket worktree → normal checkout, continue.

Step 2: Create the worktree

Consent: ask once, unless the user already told you their preference —

"Set up an isolated worktree? It protects your current branch and uncommitted work."

If declined, stop. Do not execute in the current checkout. Invoked from execute-plan, consent is implied and this question is skipped: execute-plan only reaches this skill when the checkout is not already on the ticket branch.

Path is .worktrees/<branch-name>; branch name follows repo conventions — ticket key first, e.g. PROJ-123-short-description.

If your harness offers a native worktree tool, use it and skip the manual steps. Otherwise:

# .worktrees/ must be ignored — check before creating
git check-ignore -q .worktrees || echo ".worktrees/" >> .gitignore

Then pick the mode by what the branch already is — a branch can be checked out in only one worktree at a time, so this is a git constraint, not a preference: