Agentes en paralelo y worktrees

Antes de lanzar varios agentes, una pregunta clave: ¿quién coordina, necesitan hablar entre sí, y tocan los mismos ficheros? La respuesta elige la técnica. Y casi siempre, el ingrediente de seguridad es el mismo: worktrees.

Las formas de paralelizar

Hay cuatro enfoques, según quién sostiene el plan:

La regla de decisión, por quién coordina: tú dentro de una conversación → subagentes. Tú despachando y revisando → agent view. Claude planificando y supervisando turno a turno → agent teams. Un script (no Claude turno a turno) sostiene el plan → dynamic workflows. Y transversal: ¿tocan los mismos ficheros? Aíslalos con worktrees.

Dynamic workflows, en breve

Es lo más nuevo y el techo de la orquestación (research preview, v2.1.154+). En vez de coordinar Claude turno a turno, escribe un script que lanza muchos subagentes en background y contrasta sus hallazgos (revisión adversarial, votación), dejando en tu contexto solo el resultado final. Lo disparas pidiéndolo en lenguaje natural o con la palabra ultracode en el prompt (o /effort ultracode para que Claude decida solo en cada tarea); hay uno de serie, /deep-research. Sigues su progreso —fases, agentes, tokens— con /workflows, y puedes guardar un run como comando propio.

/batch no es un quinto enfoque, es un uso empaquetado de subagentes + worktrees: una skill que parte un cambio grande en 5-30 subagentes aislados en worktree, cada uno con su PR. Cómodo para una migración mecánica, pero por debajo son las piezas que ya conoces.

Worktrees: el aislamiento

Un git worktree es un directorio de trabajo separado, con sus ficheros y su rama, que comparte el historial del repo. Cada sesión en su worktree significa que las ediciones de una nunca tocan los ficheros de otra. Es lo que hace seguro tener varios agentes a la vez.

Arranca Claude en un worktree aislado:

claude --worktree feature-auth

Crea el worktree bajo .claude/worktrees/feature-auth/ en una rama nueva worktree-feature-auth. Lánzalo otra vez con otro nombre en otra terminal y tienes dos sesiones que no se pisan. Si omites el nombre, te genera uno. También puedes pedírselo a Claude en sesión ("trabaja en un worktree") y usa la tool EnterWorktree.

Añade .claude/worktrees/ a tu .gitignore para que su contenido no aparezca como ficheros sin trackear en tu checkout principal.

Copiar ficheros gitignored: .worktreeinclude

Un worktree es un checkout limpio, así que tu .env no está ahí. Para copiarlo automáticamente, un fichero .worktreeinclude en la raíz (sintaxis de .gitignore):

.env
.env.local
config/secrets.json

Solo se copian ficheros que casan y están gitignored, así que nunca duplica ficheros trackeados.

Aislar subagentes en worktrees

Los subagentes del curso anterior también pueden correr en su propio worktree, para que sus ediciones en paralelo no choquen. Pídeselo ("usa worktrees para tus agentes") o ponlo fijo en el frontmatter del subagente:

---
name: refactor-worker
description: Refactoriza un módulo de forma aislada
isolation: worktree
---

Al terminar sin cambios, su worktree temporal se borra solo.

Qué llevas hasta aquí

• Hay cuatro enfoques (subagentes, agent view, agent teams, dynamic workflows); eliges por quién coordina y si tocan los mismos ficheros. /batch es un uso empaquetado, no un quinto.
• Los worktrees (--worktree) aíslan ediciones: varias sesiones sin pisarse.
• .worktreeinclude copia los gitignored necesarios; isolation: worktree aísla subagentes.

En la siguiente lección, el caso más sofisticado: un equipo de agentes coordinado por un lead.

Fuente oficial: Run agents in parallel · Dynamic workflows · Worktrees