GitHub - qudent/parallel-working-made-simple

# Source the skill
source ~/.claude/skills/parallel-worktrees/worktrees.sh

# Create worktree for first bug (this cd's into it)
worktree_create fix-auth-bug
# we are now in <repo-name>.worktrees/fix-auth-bug in a new branch.
# macOS: osascript -e 'tell app "Terminal" to do script "cd '"$(pwd)"' && claude \"fix the authentication timeout bug\""'
# Linux: xterm -e "cd $(pwd) && claude 'fix the authentication timeout bug'" &

# Return to parent repo, create another worktree
worktree_cd_to_parent
worktree_create fix-button-styling
# macOS: osascript -e 'tell app "Terminal" to do script "cd '"$(pwd)"' && claude \"fix the submit button styling\""'
# Linux: xterm -e "cd $(pwd) && claude 'fix the submit button styling'" &

# When each agent finishes, in its terminal:
worktree_finish  # merges to parent and cleans up

source ~/.claude/skills/parallel-worktrees/worktrees.sh

# Try three different agents on the same problem
worktree_create approach-claude
# macOS: osascript -e 'tell app "Terminal" to do script "cd '"$(pwd)"' && claude \"implement the caching layer\""'
# Linux: xterm -e "cd $(pwd) && claude 'implement the caching layer'" &

worktree_cd_to_parent
worktree_create approach-codex
# macOS: osascript -e 'tell app "Terminal" to do script "cd '"$(pwd)"' && codex \"implement the caching layer\""'
# Linux: xterm -e "cd $(pwd) && codex 'implement the caching layer'" &

worktree_cd_to_parent
worktree_create approach-gemini
# macOS: osascript -e 'tell app "Terminal" to do script "cd '"$(pwd)"' && gemini \"implement the caching layer\""'
# Linux: xterm -e "cd $(pwd) && gemini 'implement the caching layer'" &

# Compare results across worktrees (from approach-gemini, siblings are at ../):
# diff -r ../approach-claude/src ../approach-codex/src

# Keep the best one:
cd ../approach-claude
worktree_finish  # now back in repo

# Discard the others (worktrees are at <repo>.worktrees/, alongside the repo):
cd "$(git rev-parse --show-toplevel).worktrees/approach-codex" && worktree_abort
cd "$(git rev-parse --show-toplevel).worktrees/approach-gemini" && worktree_abort

source ~/.claude/skills/parallel-worktrees/worktrees.sh

# Main feature branch
worktree_create new-dashboard

# Spawn subtasks from within the feature branch
worktree_create dashboard-api      # creates new-dashboard.worktrees/dashboard-api
worktree_cd_to_parent              # back to new-dashboard
worktree_create dashboard-ui       # creates new-dashboard.worktrees/dashboard-ui

# Each subtask merges up to the feature branch
worktree_finish  # dashboard-ui -> new-dashboard

# Back in new-dashboard, finish dashboard-api too
cd ../new-dashboard.worktrees/dashboard-api
worktree_finish  # dashboard-api -> new-dashboard

# Feature branch merges up to main
worktree_finish  # new-dashboard -> main

git clone https://github.com/qudent/parallel-working-made-simple.git
cd parallel-working-made-simple

# Personal (all projects)
cp -r parallel-worktrees ~/.claude/skills/

# Or project-level
cp -r parallel-worktrees /path/to/your/repo/.claude/skills/