Git Worktree

Git Worktree Workflow

Multi-step workflow for parallel development using git worktrees.

Overview

Git worktree allows working on multiple branches simultaneously. Each worktree is an independent working directory with its own branch.

Setup Workflow

1. Create Feature Worktree

git worktree add ../ccswarm-feature-<name> feature/<description>

2. Create Bug Fix Worktree

git worktree add ../ccswarm-bugfix-<name> hotfix/<description>

3. Create Experiment Worktree

git worktree add ../ccswarm-experiment-<name> experiment/<description>

Recommended Structure

github.com/nwiizo/
├── ccswarm/                  # Main repository (master)
├── ccswarm-feature-*/        # Feature worktrees
├── ccswarm-bugfix-*/         # Bug fix worktrees
├── ccswarm-hotfix-*/         # Hotfix worktrees
└── ccswarm-experiment-*/     # Experimental worktrees

Management Commands

# List all worktrees
git worktree list

# Remove worktree after merging
git worktree remove ../ccswarm-feature-<name>

# Prune stale worktree information
git worktree prune

Agent Integration

Each agent can work in its own worktree:

# Frontend agent
git worktree add ../ccswarm-frontend feature/ui-redesign

# Backend agent
git worktree add ../ccswarm-backend feature/api-enhancement

# DevOps agent
git worktree add ../ccswarm-devops feature/ci-cd-improvement

Best Practices

1. One worktree per feature/bug
2. Use naming convention: ccswarm-<type>-<description>
3. Clean up after merging
4. Run git worktree prune periodically
5. Run tests in different worktrees simultaneously