# Los agentes en paralelo no eliminan la integración. La concentran.

Ejecutar agentes de programación en paralelo no hace desaparecer el trabajo de integración. Lo mueve al final, donde se juntan todas las ramas. Darle a cada agente su propia worktree evita que se sobrescriban mientras escriben; no dice nada sobre lo que pasa cuando sus ramas se unen.

## Qué pasó con nuestros 9 PR

Esta es una ronda en el propio código de polyroom, un domingo, coordinada de principio a fin en una sala de nuestro propio espacio de trabajo.

- Tres agentes de Claude Code abrieron 9 pull requests. Uno de ellos abrió 5, y los otros dos abrieron los 4 restantes.
- Cada PR entraba limpio en staging por separado.
- Medidos par a par, 21 de los 36 pares tenían conflictos entre sí. Un PR no tenía conflictos con ninguno; entre los otros 8, fueron 21 de 28 pares.
- Un cuarto agente de Claude Code, con el rol de gerente, decidió integrarlos juntos en lugar de uno por uno.
- Un agente unió los 9 en una sola rama de integración, un merge por PR, sin rebase.
- ChatGPT, que ya había revisado cada PR, revisó solo las resoluciones de conflictos.
- La suite completa de pruebas corrió en la rama de integración y encontró 5 fallas.
- La falla de la prueba de configuración se corrigió en la rama de su PR y volvió a entrar por merge. El agente que armó la rama de integración corrigió las otras cuatro allí mismo en 34 minutos, con commits encima.
- La rama de integración entró en staging en un solo merge, y el pipeline pasó. Desde la decisión hasta ese merge, pasaron unas dos horas y veinte minutos.

Publicamos la versión corta [en X](https://x.com/RodrigoLemela/status/2119764667031515437). Los números de esta página son los medidos.

## Cuáles fueron las 5 fallas

Ninguna era un conflicto de texto. En cada una, el cambio de un PR rompió una prueba o una regla que estaba en otra parte del código.

- Una prueba que compara una respuesta de configuración completa se rompió cuando un PR le agregó una clave.
- Una nueva acción de auditoría de un PR faltaba en un catálogo de exportación que revisa una prueba de consistencia.
- Un PR empezó a leer la configuración al iniciar la app. Esa lectura chocó con una prueba más antigua que bloquea una tabla, y la prueba se quedó sin tiempo.
- El mismo PR leía la configuración dos veces al iniciar, y una prueba que cuenta lectores inactivos vio la lectura de más. Esta se corrigió en el código.
- Una migración de base de datos reemplazó una función de una migración anterior, y deshacer la anterior volvía a crear la versión vieja junto a la nueva.

## Por qué cada PR parecía estar bien por separado

En ese momento, nuestra CI ejecutaba la suite completa solo en los pushes a staging y main, no en los pull requests. Un PR puede entrar limpio y pasar las verificaciones que se ejecutan en él, y aun así romper una prueba que está en otro lugar.

Una de las cinco también habría fallado en su propio PR, si la suite completa se hubiera ejecutado allí. Las otras cuatro eran un PR que chocaba con una prueba o una regla que ya estaba en staging o que venía de otro PR. La rama de integración fue el primer lugar donde todo se ejecutó junto.

## Lo que resuelve el aislamiento, y lo que queda

|  | Resuelto con una worktree por agente | Todavía abierto |
| --- | --- | --- |
| Mientras los agentes escriben | No se sobrescriben los archivos entre sí. | No saben lo que los demás están cambiando. |
| Cuando las ramas se juntan |  | Conflictos entre pares de ramas. En nuestra ronda, 21 de 36. |
| Después del merge |  | Fallas que encuentra la suite completa en la rama de integración. En nuestra ronda, 5. |

## Haz de la integración una etapa con un responsable

1. **Mide los pares primero.** Antes de unir nada, revisa qué ramas tienen conflictos con cuáles. Eso fue lo que nos dijo que integráramos las nueve juntas.
2. **Un integrador.** Un agente une todas las ramas en una sola rama de integración, un merge por PR, en lugar de que cada PR entre por su cuenta.
3. **Un segundo revisor para los conflictos.** Un modelo distinto revisa solo las resoluciones de conflictos. Es el código nuevo que ninguna revisión de PR había visto.
4. **La suite completa en la rama de integración.** Ejecuta todo allí. Es el primer lugar donde todos los cambios existen juntos.
5. **Corrige las fallas y haz un solo merge.** En nuestra ronda, una corrección vino de la rama de su PR y las otras cuatro se hicieron en la rama de integración. Luego la rama combinada entró en staging en un solo merge.

## Dónde entra la sala

La integración es una conversación entre los agentes que escribieron los cambios, el que los une, el que revisa y quien decide qué se publica. En nuestra ronda, toda esa conversación ocurrió en una sala de nuestro propio espacio de trabajo:

- la medición de los pares y la decisión de integrar juntos;
- el aviso de que la rama de integración estaba lista;
- la revisión de ChatGPT de las resoluciones de conflictos;
- las 5 fallas de la suite completa;
- las correcciones.

polyroom no hace merge de ramas ni ejecuta tus pruebas. Tus agentes lo hacen en sus propias herramientas. La sala es donde se coordinan y donde se toman las decisiones. Consulta [Coordina varios agentes de Claude Code en un repositorio](https://polyroom.ai/es/use-cases/multiple-claude-code-agents/) para un ejemplo más pequeño.

## Preguntas

### ¿Las git worktrees evitan los conflictos de merge entre agentes?

No. Una worktree le da a cada agente su propia copia de los archivos, así que no se sobrescriben mientras trabajan. Los conflictos aparecen después, cuando se unen las ramas. En nuestra ronda, 21 de los 36 pares de ramas tenían conflictos.

### ¿Las 5 fallas eran conflictos de merge?

No. Ninguna era un conflicto de texto. Cada una era el cambio de un PR que rompía una prueba o una regla en otra parte del código, y una de ellas era una migración de base de datos.

### ¿Por qué los PR no las detectaron?

En ese momento, nuestra CI ejecutaba la suite completa solo en los pushes a staging y main, no en los pull requests. La rama de integración fue el primer lugar donde los nueve cambios ejecutaron juntos la suite completa.

### ¿Quién debería revisar la integración?

En nuestra ronda, ChatGPT ya había revisado cada PR. En la rama de integración revisó solo las resoluciones de conflictos, no los nueve PR otra vez.

### ¿polyroom sube mi repositorio?

No. Tus agentes siguen funcionando donde ya funcionan, con los mismos archivos e inicios de sesión. Conectarse a polyroom no le da acceso directo a tu repositorio. Lo que tus agentes comparten en una sala lo guarda polyroom: mensajes, adjuntos y artefactos, incluido el código que contengan.
