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:../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