¿Qué es un git worktree y por qué es importante para la orquestación?

Un worktree es una copia de trabajo del repositorio en un directorio separado, vinculada a una branch diferente. Permite que múltiples instancias de Claude trabajen en el mismo proyecto sin interferirse — cada una en su propio espacio, en su propia branch. Al final, haces merge del trabajo. Sin worktrees, los agentes paralelos se pisarían los ficheros entre sí.

¿Cuántas instancias paralelas son óptimas?

El punto de rendimientos decrecientes llega generalmente entre 2–3 instancias paralelas. Más de 3 instancias simultáneas aumenta el coste de coordinación (tuyo y de los tokens) sin incremento proporcional de productividad. La excepción son proyectos con workstreams genuinamente independientes — frontend, backend, tests — donde 3–4 agentes sí producen ganancias claras.

¿Cómo divido las tareas entre agentes de forma efectiva?

La regla básica: cada agente necesita un objetivo claro, contexto suficiente para trabajar de forma autónoma, y acceso solo a los ficheros que le corresponden. Las mejores divisiones son por capa (frontend/backend), por funcionalidad (auth/pagos/notificaciones) o por fase (implementar/testear/documentar). Evita divisiones donde los agentes necesiten editar los mismos ficheros.

¿Agent Teams está listo para producción?

Agent Teams es experimental a fecha de publicación de este artículo. Funciona bien para casos de uso de investigación y desarrollo donde el overhead de coordinación es aceptable. Para proyectos de producción con fechas, la recomendación es el subnivel 2 (worktrees gestionados manualmente) hasta que la funcionalidad madure.

¿El Nivel 6 requiere conocimientos avanzados de git?

Requiere comodidad con los conceptos básicos de git (branches, merge, conflictos) y la capacidad de resolver conflictos de merge. No requiere ser un experto en git. El comando --worktree es sencillo; lo más complejo suele ser gestionar el merge final cuando varios agentes han trabajado en áreas adyacentes.

Nivel 6 — El Orquestador

13 de marzo de 2026

Mentalidad: «No eres un programador — eres un manager»

El Nivel 6 es la cima del programa. El cambio de mentalidad es radical: dejas de ejecutar y empiezas a gestionar. No eres la persona que hace el trabajo — eres la persona que decide qué trabajo se hace, quién lo hace y cuándo se integra.

Gestionas sub-agentes como gestionarías a un equipo real. Les asignas tareas específicas, les das contexto suficiente para trabajar de forma autónoma, y supervisas la integración del resultado. La IA no es tu herramienta — es tu equipo.

Dónde estás ahora

Ejecutas múltiples sesiones de Claude en paralelo sobre el mismo proyecto
Usas worktrees para espacios de trabajo aislados y sin conflictos
Decides QUÉ se hace — no CÓMO se hace
Gestionas sub-agentes y equipos de agentes como un team lead real
Haces merge del trabajo paralelo al final de cada ciclo

Habilidades a dominar

División de tareas + planificación de workstreams paralelos (auth / frontend / pagos simultáneamente)
Git worktrees (flag --worktree / -w) — cada agente tiene su propio «escritorio», merge al final
Gestión de sesiones multi-terminal y switching de contexto
Agent Teams (experimental) — sub-agentes que se comunican entre sí + un supervisor que coordina y te reporta

Los 4 subniveles de orquestación

Subnivel 1 — Múltiples terminales, misma branch: Varias instancias de Claude Code en el mismo proyecto. Simple, pero con riesgo de conflictos si ambas editan los mismos ficheros simultáneamente.
Subnivel 2 — Git worktrees: Cada instancia trabaja en su propia branch/worktree. Sin conflictos. Merge al final. Más técnico, más limpio. Empieza con: claude --worktree frontend, claude --worktree backend.
Subnivel 3 — Sub-agentes vía worktrees: Pides a Claude que lance sub-agentes en worktrees separados automáticamente. Menos visible, más abstraído — Claude gestiona la coordinación por ti.
Subnivel 4 — Agent Teams (experimental): Sub-agentes que se comunican entre sí + un agente supervisor. Activar vía settings.json. Mayor coste de tokens por overhead de coordinación. Ideal para: funcionalidades paralelas, trabajo cross-layer, investigación, debugging.

La trampa: Saltarse los fundamentos

Sin los Niveles 1–5 dominados, obtienes cinco agentes produciendo cinco versiones de slop simultáneamente. Cada nivel anterior alimenta este. No hay atajos. Los rendimientos decrecientes también aparecen más allá de 2–3 instancias paralelas — más terminales no equivale a más productividad.

La orquestación amplifica lo que ya tienes, para bien o para mal. Si tus habilidades de contexto (Nivel 3), selección de herramientas (Nivel 4) y skills (Nivel 5) son sólidos, la orquestación los multiplica. Si son débiles, la orquestación multiplica esa debilidad.

El viaje completo

Pasaste de dar comandos a una herramienta → colaborar con un socio → curar contexto → equipar a un experto → codificar tus workflows → gestionar un equipo que se gestiona a sí mismo.

Nivel 1: Comando → Output
Nivel 2: Planificar → Colaborar
Nivel 3: Curar → Contexto
Nivel 4: Equipar → Herramientas
Nivel 5: Codificar → Workflows
Nivel 6: Orquestar → Escalar

Próximos pasos

Llegar al Nivel 6 con un equipo requiere que los Niveles 1–5 estén sólidos. Si quieres acelerar ese camino y asegurarte de que la fundación es robusta, podemos diseñar el programa de formación completo para tu equipo.

Preguntas frecuentes

¿Qué es un git worktree y por qué es importante para la orquestación?: Un worktree es una copia de trabajo del repositorio en un directorio separado, vinculada a una branch diferente. Permite que múltiples instancias de Claude trabajen en el mismo proyecto sin interferirse — cada una en su propio espacio, en su propia branch. Al final, haces merge del trabajo. Sin worktrees, los agentes paralelos se pisarían los ficheros entre sí.
¿Cuántas instancias paralelas son óptimas?: El punto de rendimientos decrecientes llega generalmente entre 2–3 instancias paralelas. Más de 3 instancias simultáneas aumenta el coste de coordinación (tuyo y de los tokens) sin incremento proporcional de productividad. La excepción son proyectos con workstreams genuinamente independientes — frontend, backend, tests — donde 3–4 agentes sí producen ganancias claras.
¿Cómo divido las tareas entre agentes de forma efectiva?: La regla básica: cada agente necesita un objetivo claro, contexto suficiente para trabajar de forma autónoma, y acceso solo a los ficheros que le corresponden. Las mejores divisiones son por capa (frontend/backend), por funcionalidad (auth/pagos/notificaciones) o por fase (implementar/testear/documentar). Evita divisiones donde los agentes necesiten editar los mismos ficheros.
¿Agent Teams está listo para producción?: Agent Teams es experimental a fecha de publicación de este artículo. Funciona bien para casos de uso de investigación y desarrollo donde el overhead de coordinación es aceptable. Para proyectos de producción con fechas, la recomendación es el subnivel 2 (worktrees gestionados manualmente) hasta que la funcionalidad madure.
¿El Nivel 6 requiere conocimientos avanzados de git?: Requiere comodidad con los conceptos básicos de git (branches, merge, conflictos) y la capacidad de resolver conflictos de merge. No requiere ser un experto en git. El comando --worktree es sencillo; lo más complejo suele ser gestionar el merge final cuando varios agentes han trabajado en áreas adyacentes.