Saltar al contenido principal

Varios agentes de programación en un equipo pequeño: tareas, worktrees y revisión

Empieza con tareas que puedan terminar por separado y una persona que decida qué se acepta. Cada agente escribe en su propio directorio; la combinación se prueba antes de incorporarla a la rama principal.

LaoZhang AI TeamPublicadoActualizado 15 min de lectura
En esta página
Tareas independientes, directorios propios y una integración común para un equipo pequeño

Para trabajar con varios agentes de programación en un equipo pequeño, separa encargos que puedan terminar por sí solos, da a cada agente un directorio propio y reserva una única vía de integración. La persona responsable fija el comportamiento compartido, revisa lo entregado y acepta una combinación concreta después de probarla. Dos tareas terminadas no equivalen todavía a una funcionalidad terminada.

Puedes empezar con un agente que implemente y otro que examine el resultado. Si ya hay dos cambios independientes, puedes desarrollarlos en paralelo y revisarlos cuando estén completos. El número adecuado depende del trabajo y del tiempo disponible para revisarlo: añadir agentes tiene sentido cuando aumenta lo que el equipo acepta sin disparar las correcciones o la espera.

Esta guía propone un flujo para un equipo que ya utiliza un asistente de programación. Los comandos de Git se pueden adaptar al repositorio; el ejemplo de reservas es ficticio y sus comprobaciones se han ensayado localmente, sin ejecutar agentes ni medir su rendimiento.

Decide qué puedes repartir antes de abrir más sesiones

Una tarea es buena candidata si puedes explicar su entrada, su salida y cómo comprobarla sin depender del código a medio escribir de otra. Dividir por nombres de especialidad —«interfaz» y «servidor»— no basta cuando ambos deben inventar la respuesta de una misma API.

Imagina una aplicación de reservas que ya devuelve una lista con los estados pendiente, confirmada y cancelada. Quieres añadir un resumen de las reservas confirmadas y un mensaje para cuando no haya ninguna. Puedes asignar el cálculo a un agente y el mensaje a otro si ambos conocen de antemano el significado de «confirmada» y el formato del resumen. Si todavía hay que decidir qué estados existen, esa decisión debe llegar primero.

Situación del próximo cambioForma de trabajar
Un error localizado o varias decisiones todavía abiertasUna persona supervisa un agente hasta obtener un cambio completo
Una implementación terminada que necesita contrasteOtro agente revisa el cambio y reproduce las pruebas; después se resuelven los hallazgos
Dos módulos con entradas y salidas acordadasDos encargos en directorios distintos, con revisión e integración comunes
Dos soluciones propuestas para el mismo problemaSe comparan alternativas y se elige una; no se fusionan ambas por defecto

Las alternativas y las piezas complementarias requieren decisiones distintas. Dos agentes pueden investigar por qué falla una búsqueda, pero sus dos correcciones quizá sean incompatibles. En cambio, un contador y un mensaje que consumen el mismo resumen pueden formar una sola entrega. Etiqueta esa relación al repartir el trabajo.

Cuando un agente necesite cambiar el acuerdo compartido, que devuelva la decisión pendiente a la persona responsable. Esta puede actualizar el encargo de ambos o hacer primero el cambio común. Es preferible esperar por una decisión real que seguir produciendo código sobre dos supuestos diferentes.

Asigna responsabilidades que una persona pueda sostener

En un equipo de dos personas no hace falta crear cinco cargos. Una persona puede definir el alcance e integrar; la otra puede revisar el comportamiento. Los agentes realizan encargos concretos dentro de ese reparto.

ResponsabilidadResultado que debe dejar
CoordinarEncargos, comportamiento compartido y orden de integración claros
ImplementarCambios limitados, pruebas y explicación de lo que queda pendiente
VerificarResultados reproducibles sobre una revisión concreta y hallazgos localizables
Aceptar e integrarDecisión sobre el comportamiento del producto y combinación final probada

El verificador necesita una implementación estable para revisarla. Puede preparar casos a partir de un acuerdo previo, pero no debería adivinar la solución mientras el implementador la cambia. Si descubre un fallo, lo comunica con un caso que lo reproduce; corregirlo corresponde a un encargo explícito. Así evitas que ambos reescriban el mismo módulo sin saberlo.

La revisión humana se centra en si el cambio resuelve el problema, respeta el diseño y trata los datos como corresponde. Un agente puede ayudar a buscar errores o repetir pruebas; su aprobación por sí sola no decide qué comportamiento acepta el equipo.

Escribe un encargo que permita terminar y entregar

Una ficha breve debe decir qué se quiere conseguir, qué puede cambiar el agente y qué hará cuando no pueda cumplirlo. No necesita contener toda la conversación anterior.

Este encargo pertenece al agente que calcula el resumen del ejemplo. Supone que el proyecto ficticio ya tiene los ficheros y pruebas indicados:

Encargo: resumen de reservas confirmadas
Responsable de implementación: agente de cálculo
Directorio: ../reservas-calculo
Rama: codex/reservas-calculo
Revisión inicial: SHA acordado y anotado por la persona coordinadora

Resultado: contar las reservas cuyo estado sea exactamente "confirmada".
Entrada: una lista de reservas con id y estado.
Salida: { confirmadas: número entero no negativo }.
La lista vacía produce { confirmadas: 0 }.
No modificar la lista recibida ni reinterpretar otros estados.

Puedes editar:
- src/reservas/resumen.mjs
- tests/reservas/resumen.test.mjs

Mantén sin cambios el contrato compartido, las dependencias,
la configuración y el módulo que presenta el mensaje.
Si hace falta cambiar alguno, entrega el motivo y espera la decisión.

Comprueba: node --test tests/reservas/resumen.test.mjs
Entrega: commit final, diff, casos cubiertos, comando y resultado,
problemas pendientes y material necesario para reproducirlos.

El segundo agente recibe su propia ficha: presentar «Sin reservas confirmadas» cuando confirmadas sea cero y un mensaje con la cantidad cuando sea mayor. Sus ficheros son src/reservas/mensaje.mjs y tests/reservas/mensaje.test.mjs; consume el mismo objeto, sin renombrar sus campos. La persona coordinadora conserva la responsabilidad sobre ese acuerdo y sobre la prueba que conecta ambos módulos.

La lista de rutas reduce solapamientos y permite revisar el alcance. Es una instrucción de cooperación, no un bloqueo de acceso al disco. Si necesitas impedir una operación, debes comprobar los permisos y controles efectivos de la herramienta, además de escribir el encargo.

Encargo y entrega con revisiones, contrato y pruebas reproducibles

Crea un worktree por agente, con una base conocida

Una rama identifica una línea de cambios; un worktree aporta otro directorio con sus propios ficheros de trabajo, índice y HEAD. Cambiar de rama dentro de la misma carpeta que utilizan dos sesiones no crea dos espacios: ambos agentes siguen encontrándose con los ficheros que haya en esa carpeta. La documentación de Git worktree explica qué partes son propias y cuáles se comparten.

Para el ejemplo manual, sitúate en la raíz de un repositorio preparado, con una rama main cuya revisión haya aceptado el equipo. Las rutas y ramas siguientes deben estar libres; no hace falta actualizar la rama remota para ejecutar estos pasos. En una sesión de Bash:

bash
BASE=$(git rev-parse 'main^{commit}')
git worktree add -b codex/reservas-calculo ../reservas-calculo "$BASE"
git worktree add -b codex/reservas-mensaje ../reservas-mensaje "$BASE"
git worktree list

git -C ../reservas-calculo rev-parse HEAD
git -C ../reservas-mensaje rev-parse HEAD

Las dos últimas salidas deben coincidir con BASE; la lista debe mostrar dos rutas distintas y sus respectivas ramas. Escribe esa revisión en ambas fichas. Al iniciar cada sesión, comprueba que su directorio es el asignado. Si el agente trabaja en una máquina remota, debe poder acceder a las rutas de esa máquina: crear una carpeta en tu portátil no la hace aparecer en otro equipo.

Git normalmente impide sacar la misma rama en dos worktrees. Si aparece ese error, utiliza una rama distinta o mueve el trabajo mediante el procedimiento de la herramienta; no anules la protección como paso rutinario. Para una rama ya existente, usa git worktree add <ruta> <rama> en vez de intentar crearla otra vez con -b. Opciones y protecciones de Git.

Prepara también los recursos que no viven en el checkout

Los worktrees comparten los objetos de Git, muchas referencias y, por defecto, la configuración del repositorio. Una operación que mueva una referencia compartida puede afectar a lo que otro agente ve. Tampoco aíslan procesos, red, directorio personal, credenciales ni una base de datos externa. Referencias y configuración compartidas.

Antes de ejecutar la aplicación, reparte los recursos que realmente usa: un puerto por servidor, una base de datos de prueba por tarea cuando sea necesaria y un directorio propio para salidas o cachés que puedan modificarse. Los cambios de dependencias y del fichero de bloqueo pueden tener un único responsable. No compartas mediante enlaces simbólicos una carpeta mutable de compilación entre dos pruebas concurrentes.

Para este ejemplo basta con datos ficticios y pruebas locales; no necesita credenciales ni servicios. En tu proyecto, instala las dependencias con su mecanismo habitual dentro de cada directorio y prepara solo los datos autorizados que hagan falta. Si la primera duda es qué herramienta accede a qué carpeta y en qué ordenador, consulta ChatGPT Work, Codex y Claude Code con archivos locales.

Lleva el mismo reparto a Codex o Claude Code

Comprueba por separado la conversación que recibe cada agente, el directorio donde escribe y los permisos con los que actúa. Son tres decisiones diferentes. Un nuevo contexto no crea automáticamente un worktree; un nombre como «revisor» tampoco convierte una sesión con permisos amplios en una sesión confinada.

En las versiones locales actuales de Codex, pide expresamente que delegue los encargos independientes, o utiliza las instrucciones aplicables del proyecto. Los subagentes heredan la política de permisos; los ajustes efectivos de la sesión principal pueden prevalecer sobre los valores de una definición personalizada. Si vas a crear una definición, consulta el formato actual de los ficheros TOML independientes: exige name, description y developer_instructions. No reutilices sin comprobar un ejemplo antiguo de configuración. Subagentes de Codex.

La aplicación también permite iniciar conversaciones en worktrees de proyectos Git. Su flujo documentado empieza por defecto en detached HEAD; puedes usar Create branch here para conservar el trabajo en una rama o Hand off para moverlo al checkout local. La selección de cambios locales en ese flujo y los comandos manuales anteriores tienen reglas distintas. .worktreeinclude solo copia los ficheros ignorados que coincidan en worktrees locales gestionados; no copia cualquier fichero sin seguimiento ni cubre los worktrees manuales o remotos. Worktrees de Codex.

En Claude Code, isolation: worktree es opcional para subagentes y, según la documentación actual, parte por defecto de la rama predeterminada, no del HEAD de la sesión principal. Comprueba la base. Los subagentes definidos y los forks reciben contextos distintos: el fork hereda la conversación; su modo está activado por defecto en sesiones interactivas desde v2.1.232, con otro valor predeterminado en modo no interactivo. Los controles de comandos también dependen de la versión y del intérprete; no equivalen a un aislamiento del sistema operativo. Subagentes de Claude Code.

Los agent teams de Claude Code siguen siendo experimentales y están desactivados por defecto; sus compañeros son sesiones interactivas que se coordinan mediante mensajes y tareas. El bloqueo para reclamar una tarea no bloquea los ficheros del proyecto. Los compañeros heredan el modo de permisos del coordinador, salvo dontAsk; tampoco puedes elegir un modo diferente por compañero al crearlo. Hay limitaciones de reanudación y no admiten equipos anidados. Úsalos cuando necesites esa coordinación, después de comprobar las condiciones actuales. Equipos de Claude Code.

Pide una entrega que se pueda revisar sin reconstruir el chat

Al terminar, cada agente debe señalar qué revisión entrega y qué revisión comprobó. «Las pruebas pasan» resulta insuficiente si después hubo otro cambio.

Para el cálculo de reservas, una entrega útil puede ocupar estas líneas; los valores entre corchetes se rellenan con los resultados reales:

Resultado: contador de reservas confirmadas, sin modificar la entrada.
Base: [SHA inicial]. Final: [SHA del commit entregado].
Ficheros: resumen.mjs y su prueba.
Comprobación: node --test tests/reservas/resumen.test.mjs
Ejecutada en: [directorio y SHA]. Resultado: [salida y código de salida].
Casos: lista vacía, estados mezclados y conservación de la entrada.
Pendiente: falta probar el contador junto con el mensaje.
Revisar: que solo "confirmada" incremente el total.
Material adicional: [ruta de datos o logs necesarios, o ninguno].
Siguiente paso: revisión y combinación por la persona integradora.

El agente del mensaje deja su propio resultado. Ninguno debe declarar que toda la funcionalidad funciona si solo ha probado su parte. La persona revisora compara el diff con la ficha, reproduce los casos relevantes y examina las decisiones que las pruebas no cubren.

Si una revisión descubre que faltaba un caso, añádelo al encargo adecuado y vuelve a comprobar el nuevo commit. Conserva el fallo original y su explicación: sirven para distinguir una corrección real de una ejecución que simplemente omitió el caso problemático.

Prueba la combinación y fusiona en serie

El lugar donde se aceptan los cambios debe ser único. Para un equipo pequeño, una persona integradora puede reservar la rama destino mientras prepara y revisa el candidato; si hay otros escritores automáticos o humanos, utiliza una cola que serialice de verdad la integración.

Crea una rama de integración desde el main actual y fusiona las revisiones entregadas, no los nombres de rama sin comprobar. En la misma sesión de Bash del ejemplo, desde la raíz del repositorio:

bash
DESTINO=$(git rev-parse 'main^{commit}')
CALCULO=$(git rev-parse 'codex/reservas-calculo^{commit}')
MENSAJE=$(git rev-parse 'codex/reservas-mensaje^{commit}')
git worktree add -b codex/reservas-integracion ../reservas-integracion "$DESTINO"
git -C ../reservas-integracion merge --no-ff "$CALCULO" -m "Integrar cálculo"
git -C ../reservas-integracion merge --no-ff "$MENSAJE" -m "Integrar mensaje"

Ejecuta cada fusión solo si la anterior termina bien. Si hay un conflicto, detén la integración y resuelve la decisión con quienes llevan los módulos; después vuelve a probar. Si las ramas son alternativas para un mismo problema, en este punto incorpora únicamente la elegida.

En el proyecto ficticio, una prueba de integración conecta el contador con el mensaje y comprueba el resultado para cero y dos reservas confirmadas. Es importante porque el cálculo puede devolver confirmadas y el mensaje esperar por error total: las pruebas aisladas podrían pasar con objetos simulados distintos. Sobre el directorio combinado:

bash
git -C ../reservas-integracion diff --check
(cd ../reservas-integracion && node --test tests/reservas/*.test.mjs)
git -C ../reservas-integracion rev-parse HEAD
git -C ../reservas-integracion status --short

diff --check detecta problemas de espacios, no errores de comportamiento. Lo que acepta la funcionalidad es el conjunto de pruebas apropiado para tu proyecto y la revisión del resultado. En este ejemplo deben pasar las pruebas de cálculo, mensaje e integración, y el árbol de trabajo debe quedar limpio. Si añades o corriges la prueba de integración, haz commit y prueba esa nueva revisión antes de aceptarla.

Candidato combinado probado sobre el main actual antes de la integración en serie

Anota el SHA del candidato probado. Para incorporarlo sin cambiar su contenido, utiliza un avance rápido desde un checkout limpio de main, manteniendo la exclusividad de la persona integradora:

bash
CANDIDATO=$(git -C ../reservas-integracion rev-parse HEAD)
git switch main
if [ "$(git rev-parse HEAD)" = "$DESTINO" ]; then
  git merge --ff-only "$CANDIDATO"
else
  printf '%s\n' 'main ha cambiado: prepara y prueba un nuevo candidato.'
fi

La comparación detecta que la base ya cambió; no bloquea por sí sola a otro escritor entre dos comandos. Por eso depende de la vía exclusiva de integración. Si no puedes reservarla, la cola debe comprobar y aceptar la revisión bajo su propio control. Cuando avance la rama destino, vuelve a combinar sobre la nueva base y repite las pruebas pertinentes. No fuerces una rama antigua para conseguir que el resultado coincida.

Los encargos pendientes pueden incorporar el nuevo main mediante la política de merge o rebase del equipo, después de guardar su trabajo. Una nueva base puede cambiar el comportamiento aunque no cause conflictos de texto. La aceptación local tampoco publica ni despliega el cambio: aplica después el procedimiento habitual del proyecto.

Conserva los fallos antes de retirar un worktree

Si una prueba falla, deja la rama y el directorio disponibles hasta guardar lo necesario para reproducirla. Un commit conserva los ficheros seguidos que hayas incluido; un parche no conserva por sí solo los ficheros nuevos sin seguimiento ni los ignorados.

Antes de limpiar, inspecciona el estado, las diferencias y los ficheros locales pertinentes:

bash
git -C ../reservas-calculo status --short --untracked-files=all
git -C ../reservas-calculo diff
git -C ../reservas-calculo diff --cached
git -C ../reservas-calculo ls-files --others --exclude-standard
git -C ../reservas-calculo ls-files --others --ignored --exclude-standard

Guarda los commits y, por separado, los datos ficticios, resultados o logs necesarios en el destino acordado. Revisa qué contienen antes de adjuntarlos a un repositorio o una solicitud de cambios; pueden existir ficheros privados que no deban salir del equipo. El material que no esté en Git requiere su propia copia y comprobación de recuperación.

Cuando el resultado esté conservado y la combinación aceptada, elimina el worktree limpio con git worktree remove ../reservas-calculo. Si Git rechaza la retirada, investiga qué queda; no uses --force como rutina. prune limpia referencias administrativas de worktrees que ya faltan, no es el procedimiento para borrar uno activo. Retirada y conservación de worktrees.

Decide si ampliar con trabajo aceptado, no con agentes ocupados

Prueba el reparto en unas pocas tareas comparables a las que normalmente haces con un agente. Una semana puede servir como periodo inicial si produces suficientes cambios para comparar; es una propuesta ajustable, no un umbral demostrado.

Registra lo que terminó aceptado, el tiempo humano dedicado a revisar y corregir, la espera para integrar y el consumo real. Compara tareas de alcance semejante. Contar líneas o commits premiaría entregas grandes aunque nadie pueda revisarlas.

Lo que observasDecisión práctica
Se acepta más trabajo con un tiempo humano similarMantén el reparto y prueba otra tarea independiente
Se acumulan cambios terminados esperando revisiónReduce tareas simultáneas o reserva tiempo de revisión antes de añadir agentes
Se repiten cambios del mismo acuerdo o ficheroReúne ese trabajo bajo un responsable y divídelo después de decidir
Hay más consumo sin más cambios aceptadosReduce el reparto y compara de nuevo con el flujo de un agente

Si pagas mediante API, calcula el coste de todas las peticiones y reintentos, incluidas las revisiones. Si utilizas capacidad de una suscripción, registra ese uso con su propia unidad. La guía de estimación del gasto de API de Codex CLI explica cómo preparar escenarios; una estimación no sustituye al consumo observado.

Ampliar puede significar incorporar un especialista para un encargo concreto, no mantener una plantilla fija de agentes. Conserva la forma de trabajar que deje cambios comprensibles, pruebas reproducibles y menos tiempo humano perdido en rehacer decisiones.

Preguntas frecuentes

¿Sirve tener dos agentes en ramas distintas dentro de la misma carpeta?

Para escribir a la vez, necesitas directorios distintos. Dos nombres de rama en una carpeta no proporcionan dos copias de los ficheros de trabajo. Utiliza worktrees separados o checkouts realmente separados y define cómo integrarás sus resultados. Git worktree.

¿Un agente verificador puede trabajar al mismo tiempo que el implementador?

Puede preparar casos a partir de un comportamiento acordado o investigar aspectos independientes. Para revisar la implementación final necesita una revisión estable identificada por su commit. Si examina cambios mientras siguen moviéndose, debe volver a comprobar la revisión que se vaya a aceptar.

¿Por qué hay que repetir pruebas si ambas ramas ya pasan?

Porque cada rama se probó con una combinación distinta de ficheros. Una interfaz mal interpretada, una dependencia o un cambio de la rama destino puede romper el resultado combinado. Prepara y comprueba el candidato completo; si cambia su contenido o su base de integración, revisa qué pruebas debes repetir.

¿Un rol de solo lectura impide cualquier modificación?

La etiqueta o el encargo no bastan. Hay que comprobar las herramientas disponibles y los permisos efectivos. En Codex, los subagentes heredan la política y los ajustes activos de la sesión principal pueden prevalecer sobre los valores personalizados. Permisos de subagentes de Codex.

¿Cuántos agentes debería probar un equipo pequeño?

Empieza por el reparto que puedas revisar: una implementación seguida de verificación, o dos implementaciones realmente independientes. Son puntos de partida propuestos, no un máximo seguro ni una garantía de rapidez. Añade otro encargo cuando los resultados aceptados y el tiempo de revisión justifiquen hacerlo.

Fuentes5

Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 8 oct 2026.

  1. 1.documentación de Git worktreegit-scm.com/docs/git-worktree
  2. 2.Subagentes de Codexlearn.chatgpt.com/docs/agent-configuration/subagents
  3. 3.Worktrees de Codexlearn.chatgpt.com/docs/environments/git-worktrees
  4. 4.Subagentes de Claude Codecode.claude.com/docs/en/sub-agents
  5. 5.Equipos de Claude Codecode.claude.com/docs/en/agent-teams
Archivos de trabajo, copias autorizadas y permisos de los agentes locales
Herramientas y agentes

ChatGPT Agent y archivos locales: Work, Codex y Claude Code

Un adjunto basta para analizar una copia. Para trabajar con la carpeta actual necesitas una tarea con acceso al ordenador que la contiene: Work local, Codex o Claude Code. Comprueba el equipo, la ruta y los permisos antes de editar.

16 min