Git worktree para agentes de IA: trabajo paralelo sin pisar tu repositorio

Description and use

Using git worktree enables parallel execution of AI agents by isolating their worktrees, preventing conflicting changes and simplifying integration.

Problem

Los agentes de IA que trabajan en paralelo comparten el mismo árbol de archivos, lo que provoca que se sobrescriban builds, lockfiles y otros artefactos, dificultando la trazabilidad y la integración continua.

Outcome

El uso de worktrees permite ejecutar agentes de IA en paralelo sin interferir entre sí, manteniendo la integridad del repositorio y facilitando la revisión y merge de cambios.

Workflow

• 1. Crear rama de agente con git worktree add -b <branch> <path> origin/main
• 2. Configurar sparse‑checkout si es necesario con git sparse-checkout set
• 3. Ejecutar setup y tests dentro del worktree: make setup && make test
• 4. Validar cambios con git diff --check y git diff --stat
• 5. Revisar diff y mergear la rama una vez aprobada
• 6. Eliminar worktree con git worktree remove <path>

Evidence

Un worktree es aislamiento de checkout, no aislamiento de ejecución.

Source