Git worktrees para agentes de IA en paralelo

El problema sin worktrees

Normalmente, un repositorio Git solo tiene una rama activa a la vez. Si haces que un agente de codificación trabaje en la Feature A y quieres poner en paralelo un segundo agente en la Feature B, ambos se estorban en la misma carpeta: si cambias de rama, de repente todos los archivos bajo el agente en ejecución cambian.

Qué resuelven los worktrees

Un git worktree es una carpeta de trabajo adicional e independiente que tiene activa otra rama del mismo repositorio: todos los worktrees comparten el mismo historial de Git y la misma base de datos de objetos, pero no necesitan un segundo clon completo. Cada carpeta tiene su propio estado de archivos.

Por qué es práctico para agentes de IA

Así, cada agente puede trabajar en su propia carpeta, en su propia rama, independientemente de los demás: sin sobrescrituras mutuas de archivos, diffs limpios y separados, y al final fusiones (merges) normales de Git. La documentación oficial de Claude Code describe exactamente este patrón como una forma de ejecutar varias sesiones de Claude Code en paralelo para distintas tareas.

Comandos básicos

git worktree add <ruta> <rama> crea un nuevo worktree, git worktree list muestra todos los activos, git worktree remove <ruta> elimina uno.