AI agent skill · by @TheBeardedBearSAS

Parallel Worktrees

Parallel git worktrees for concurrent Claude Code sessions. Use when working on multiple features or writer/reviewer workflows.

Archived 2026-10-23 · Source updated 2026-09-14 · License: MIT. Check the original repository for the latest version.

SKILL.md instructions

# Parallel Worktrees

This skill provides guidance for running multiple Claude Code sessions concurrently using git worktrees.

See ../../rules/12-context-management.md for detailed documentation.

## Quick Reference

### Setup

```bash
git worktree add ../feature-name feature/branch-name
cd ../feature-name && claude
```

### Writer/Reviewer Pattern

| Terminal | Role | Command |
|----------|------|---------|
| Terminal 1 | Writer | `cd ../feature-auth && claude "Implement feature"` |
| Terminal 2 | Reviewer | `cd ../review-auth && claude "Review the code"` |

### Best Practices

- 3-5 worktrees maximum
- One worktree = one task
- Remove completed worktrees
- Never share sessions between worktrees