| name | ring:creating-worktrees |
| description | Creating an isolated git worktree for parallel branch work: selects the directory by priority order, verifies/adds .gitignore safety, auto-installs the detected toolchain's dependencies, runs a baseline test, and reports readiness. Use before a feature that needs isolation from the main workspace or before executing an implementation plan. Skip for a quick fix on the current branch or when already in the feature's worktree. |
Using Git Worktrees
When to use
- Starting feature that needs isolation from main workspace
- Before executing implementation plan
- Working on multiple features simultaneously
Skip when
- Quick fix in current branch → stay in place
- Already in isolated worktree for this feature → continue
- Repository doesn't use worktrees → use standard branch workflow
Sequence
Runs before: ring:writing-plans
Git worktrees create isolated workspaces sharing the same repository for parallel branch work.
Announce at start: "Using ring:creating-worktrees skill to set up isolated workspace."
Directory Selection (priority order)
- Existing
.worktrees/ or worktrees/ directory
- CLAUDE.md preference (
grep -i "worktree.*director" CLAUDE.md)
- Ask user:
.worktrees/ (project-local, hidden) OR ~/.config/ring/worktrees/<project>/ (global)
ls -d .worktrees worktrees 2>/dev/null
Safety Verification
Project-local directories only: Verify .gitignore before creating:
grep -q .gitignore
