Zed Parallel Agents: cómo usar varios agentes sin convertir tu repo en un caos

Los agentes paralelos de Zed son potentes si divides bien el trabajo. Si no, solo multiplican cambios que luego tienes que deshacer.

Zed Parallel Agents permite ejecutar varios hilos de agente al mismo tiempo, cada uno con su contexto y conversación. La promesa es atractiva: mientras un agente escribe tests, otro investiga un bug y otro prepara una refactorización.

Ejemplos que sí tienen sentido

• Agente A: reproduce el bug y localiza causa probable sin editar archivos.
• Agente B: añade tests en un directorio concreto.
• Agente C: actualiza documentación de uso después de que el cambio esté claro.
• Agente D: explora una alternativa en worktree separado.

Ejemplos que evitaría

• Dos agentes refactorizando el mismo componente.
• Un agente cambiando API pública mientras otro actualiza consumidores sin contrato previo.
• Varios agentes ejecutando formateadores o cambios globales.
• Agentes generando arquitectura nueva sin que una persona haya decidido el diseño.

Regla práctica

Usa paralelismo para tareas independientes, investigación y trabajo auxiliar. Usa un único agente, o trabajo manual, para cambios de arquitectura, APIs centrales y migraciones delicadas.

Cómo revisar resultados

Revisa cada hilo como si fuera una rama de trabajo distinta. Primero intención: qué intentaba hacer. Después diff: qué cambió. Después pruebas: qué evidencia trae. Si un agente no puede explicar su propio resultado de forma concreta, no mezcles su trabajo con el resto.

No aceptes cambios de varios agentes en un único commit gigante. La promesa de velocidad desaparece si luego nadie puede aislar qué agente introdujo qué decisión.

Patrones de coordinación

• Un agente investigador no edita archivos.
• Un agente de tests solo toca tests.
• Un agente de implementación solo toca el módulo asignado.
• Un agente de documentación espera a que el comportamiento esté cerrado.
• El humano integra, no delega la integración.

Un protocolo de uso que sí aplicaría

Antes de lanzar agentes, escribe una mini tabla en una nota: agente, objetivo, archivos permitidos, salida esperada y criterio de aceptación. Parece burocrático, pero tarda dos minutos y evita que cada hilo improvise su propio alcance.