tomevault-io 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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.