1.5 KiB

Raw Blame History

Parallel Development Setup

Set up Git worktrees for parallel development with multiple Claude Code sessions.

Why Parallel Worktrees?

Work on multiple features simultaneously
Separate Claude sessions for different concerns
No context switching overhead
Clean separation of work

Setup Commands:

1. Create Feature Worktrees

# For tests development
git worktree add ../trax-tests feature/tests

# For documentation
git worktree add ../trax-docs feature/docs

# For database work
git worktree add ../trax-db feature/database

# For API development
git worktree add ../trax-api feature/api

2. Launch Parallel Claude Sessions

Open separate terminals:

Terminal 1 - Main Implementation:

cd /Users/enias/projects/my-ai-projects/apps/trax
claude

Terminal 2 - Test Development:

cd ../trax-tests
claude

Terminal 3 - Documentation:

cd ../trax-docs
claude

3. Worktree Management

# List all worktrees
git worktree list

# Remove a worktree when done
git worktree remove ../trax-tests

# Prune stale worktrees
git worktree prune

Best Practices:

Main worktree: Core implementation
Test worktree: TDD and test coverage
Docs worktree: Documentation updates
Feature worktrees: Isolated feature development

All worktrees share .claude/context/session.md via symlinks:

# In each worktree
ln -s /Users/enias/projects/my-ai-projects/apps/trax/.claude/context ../trax-tests/.claude/

Ready to set up parallel development?

1.5 KiB Raw Blame History