trax/.claude/commands/parallel-setup.md

74 lines
1.5 KiB
Markdown

# 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
```bash
# 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:**
```bash
cd /Users/enias/projects/my-ai-projects/apps/trax
claude
```
**Terminal 2 - Test Development:**
```bash
cd ../trax-tests
claude
```
**Terminal 3 - Documentation:**
```bash
cd ../trax-docs
claude
```
### 3. Worktree Management
```bash
# List all worktrees
git worktree list
# Remove a worktree when done
git worktree remove ../trax-tests
# Prune stale worktrees
git worktree prune
```
## Best Practices:
1. **Main worktree**: Core implementation
2. **Test worktree**: TDD and test coverage
3. **Docs worktree**: Documentation updates
4. **Feature worktrees**: Isolated feature development
## Context Sharing:
All worktrees share `.claude/context/session.md` via symlinks:
```bash
# In each worktree
ln -s /Users/enias/projects/my-ai-projects/apps/trax/.claude/context ../trax-tests/.claude/
```
Ready to set up parallel development?