Git Worktree Workflow
Overview
Git worktrees allow you to have multiple working directories from a single repository, enabling parallel development workflows with Claude Code. This is essential for running multiple Claude instances on different tasks simultaneously.
Quick Start
# 1. Create worktree for new feature branch
git worktree add -b feature-api ../project-api main
# 2. Run Claude in worktree
cd ../project-api && claude "Implement the feature"
# 3. After completion, merge and cleanup
cd ../project
git merge feature-api
git worktree remove ../project-api
git branch -d feature-api
When to Use
- Running multiple Claude agents on different features
- Testing changes while continuing development
- Code review with live comparison
- Parallel bug fixes across branches
- Subagent verification workflows
- A/B implementation comparisons
- CI/CD parallel job execution
Related Skills
- repo-sync - Manage multiple repositories
- sparc-workflow - Systematic development process
- agent-orchestration - Multi-agent coordination
Version History
- 1.1.0 (2026-01-02): Added Quick Start, Error Handling table, Metrics, Execution Checklist, Best Practices Do/Don't, updated frontmatter with version/category/related_skills
- 1.0.0 (2025-12-30): Initial release based on Claude Code best practices
Sub-Skills
- Best Practices
- Error Handling
- Execution Checklist
- Metrics
Sub-Skills
- What is a Worktree?
- Create a Worktree (+2)
- Pattern 1: Feature + Review (+3)
- CLAUDE.md Configuration
- Headless Mode in Worktrees
- GitHub Actions Parallel Jobs