Guía paso a paso para configurar y usar Git worktrees cuando varios agentes de programación trabajan en paralelo sobre el mismo repo. Cubre naming convention, comandos seguros, estrategia de ramas, revisión cruzada, resolución de conflictos y errores comunes.

Crear, usar y limpiar Git worktrees para que varios agentes de programación trabajen en paralelo sobre el mismo repo sin chocar entre sí.

Configurar y usar Git worktrees con agentes de programación

Crear el primer worktree para un agente

Desde la raíz del repo principal corré `git worktree add ../repo.agent-bugfix -b agent/bugfix/typo`. Esto crea el directorio `../repo.agent-bugfix`, registra el worktree y deja la branch `agent/bugfix/typo` checkeada ahí. Tu repo principal queda intacto.

Trabajar dentro del worktree del agente

Cambiá al directorio con `cd ../repo.agent-bugfix` y trabajá normal: edits, builds, tests, `git add`, `git commit`. Todo lo que el agente haga queda aislado a su worktree; el repo principal sigue en la rama que tenía checkeada.

Pushear y abrir el Pull Request

Cuando el agente termine: `git push -u origin agent/bugfix/typo`. Abrí el PR desde GitHub o GitLab como con cualquier branch. El reviewer ve el diff, aprueba y mergea sin enterarse de que vino de un worktree.

Limpiar el worktree después del merge

Una vez mergeado el PR, desde el repo principal corré `git worktree remove ../repo.agent-bugfix`. Esto borra el directorio y desregistra el worktree. La branch queda hasta que la borres con `git branch -d agent/bugfix/typo`.

Listar y podar worktrees viejos

Periódicamente: `git worktree list` para ver los worktrees activos, y `git worktree prune` para limpiar referencias a directorios que ya no existen (por ejemplo, si borraste manualmente la carpeta de un worktree).

Artículos sobre Worktrees

Cómo usar Git Worktrees con agentes de programación