> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Worktrees

> Ordered parallel feature work with git worktrees for maintainers and agents.

# Worktrees

This repository prefers separate worktrees over stacked unrelated changes in one checkout.

That matters for humans and agents:

* less accidental overlap
* cleaner review boundaries
* lower risk of reverting unrelated work
* easier parallel validation

## Default pattern

Use one worktree per coherent feature or fix.

Example:

```bash theme={null}
pnpm worktree:new feat/webhook-durability
pnpm worktree:new docs/contributor-versioning
```

The helper creates a sibling worktree directory under `../worktrees` by default.

## When to use a worktree

* a feature will take more than one commit
* you want to keep release or docs work isolated from runtime work
* multiple agents or contributors are working in parallel
* you need to compare two approaches without polluting the main checkout

## Rules

* one branch per worktree
* one main concern per branch
* do not mix broad dependency churn into feature branches
* do not use worktrees to hide unrelated unfinished work in a PR

## Read next

* [Contribution Workflow](/contributing/workflow)
* [Versioning](/contributing/versioning)