parallel-worktrees

SKILL.md

Parallel Worktrees

Productivity pattern for running multiple Claude Code sessions on the same repository.

See ../../rules/12-context-management.md for detailed documentation.

Quick Reference

Setup

# Create worktree for a feature branch
git worktree add ../feature-name feature/branch-name

# Launch Claude in the worktree
cd ../feature-name && claude

Writer/Reviewer Pattern

Terminal Role Command
Terminal 1 Writer cd ../feature-auth && claude "Implement feature"
Terminal 2 Reviewer cd ../review-auth && claude "Review the code"

Best Practices

  • 3-5 worktrees maximum
  • One worktree = one task
  • Remove completed worktrees: git worktree remove ../feature-name
  • Never share sessions between worktrees

Cleanup

# List all worktrees
git worktree list

# Remove a worktree
git worktree remove ../feature-name

# Prune stale worktree entries
git worktree prune
Weekly Installs
4
GitHub Stars
94
First Seen
10 days ago
Installed on
github-copilot4
codex4
kimi-cli4
gemini-cli4
cursor4
amp4