> ## 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

> Trabalho paralelo e ordenado em funcionalidades com git worktrees para maintainers e agentes.

# Worktrees

Este repositório prefere worktrees separados em vez de mudanças não relacionadas empilhadas em um único checkout.

Isso importa tanto para humanos quanto para agentes:

* menos sobreposição acidental
* limites de review mais limpos
* menor risco de reverter trabalho não relacionado
* validação paralela mais fácil

## Padrão default

Use um worktree por funcionalidade ou correção coerente.

Exemplo:

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

O helper cria por padrão um diretório de worktree irmão sob `../worktrees`.

## Quando usar um worktree

* uma funcionalidade vai exigir mais de um commit
* você quer manter o trabalho de release ou documentação isolado do trabalho de runtime
* múltiplos agentes ou contribuidores estão trabalhando em paralelo
* você precisa comparar duas abordagens sem poluir o checkout principal

## Regras

* uma branch por worktree
* um concern principal por branch
* não misture mudanças amplas de dependências em branches de funcionalidade
* não use worktrees para esconder trabalho inacabado e não relacionado em um PR

## Leia a seguir

* [Fluxo de contribuição](/pt-BR/contributing/workflow)
* [Versionamento](/pt-BR/contributing/versioning)