$ man how-to/orchestrating-multi-agent-workflows

Tú eres el orquestador. Claude es la fuerza de trabajo. Tu trabajo no es escribir código. Tu trabajo es planificar el trabajo, asignar los agentes, proveer el contexto y verificar la salida. Piensa en ti mismo como un gerente de proyecto que resulta tener una oferta infinita de trabajadores capaces disponibles instantáneamente. El cuello de botella no es la mano de obra. Es la planificación. Un flujo de trabajo multi-agente bien planificado termina en minutos. Uno mal planificado termina en horas (o nunca) porque los agentes se pisan entre sí, producen salida conflictiva o pierden requisitos que no estaban en sus instrucciones.

PATTERN

Comienza cada flujo de trabajo multi-agente en modo de planificación. Pídele a Claude que analice la tarea, identifique todos los archivos que necesitan ser creados o modificados, mapee las dependencias entre ellos y agrupe las tareas independientes en oleadas paralelas. El plan debe incluir: archivos a crear (con rutas completas), archivos a modificar (con cambios específicos), la estructura de oleadas (qué tareas se ejecutan en paralelo, cuáles secuencialmente), recomendaciones de modelo por agente y pasos de verificación. Revisa el plan antes de ejecutar. Si una dependencia está mal, corrígela ahora. Si una agrupación de tareas no tiene sentido, ajústala ahora. Los cambios al plan no cuestan nada. Los cambios después de que los agentes han comenzado cuestan tiempo y contexto.

PATTERN

Cada agente recibe su propio prompt con su propio contexto. Los agentes no comparten contexto entre sí. El Agente B no sabe qué está haciendo el Agente A. Eso es una característica, no un bug. Significa que tienes control total sobre lo que cada agente ve y hace. Un buen prompt de agente incluye: la tarea específica ("Crea el archivo website/packages/shared/data/how-to-wiki.ts"), el patrón a seguir ("Replica la estructura de clay-wiki.ts"), los datos o contenido específico a incluir, referencias a archivos que debe leer para contexto, y los criterios de éxito ("El archivo debe exportar un array tipado de 17 entradas con contenido completo de WikiSection"). Los prompts de agente malos son vagos. "Construye la wiki." Los prompts de agente buenos son específicos. "Crea how-to-wiki.ts con la interfaz HowToWikiEntry, 6 categorías, 17 entradas y funciones auxiliares siguiendo el patrón exacto de context-wiki.ts."

FORMULA

Lanza los agentes de la Oleada 1 en paralelo. Monitorea su progreso. Cuando todos los agentes de la Oleada 1 completen, verifica su salida antes de lanzar la Oleada 2. La verificación entre oleadas atrapa errores temprano. Lista de verificación por oleada: - ¿Los archivos creados existen en las rutas esperadas? - ¿Los tipos e interfaces coinciden con lo que los consumidores posteriores esperan? - ¿El build sigue pasando después de los cambios de la oleada? - ¿Hay errores de TypeScript o linting? Solo después de que la verificación pasa lanzas la siguiente oleada. Si un agente produjo mala salida, corrígela antes de proceder. Una mala base de la Oleada 1 significa que cada agente de la Oleada 2 construye sobre suposiciones rotas. Verificación final después de todas las oleadas: compila el proyecto entero, verifica que todas las rutas rendericen, confirma que los enlaces cruzados resuelvan, confirma que los metadatos SEO sean correctos. Esta es la última puerta de calidad antes de que la característica se lance.

PRO TIP

Cuando construí el Clay Wiki, la orquestación fue: Oleada 1 - un agente escribió el archivo de datos (todas las 17 entradas, tipos, helpers). Oleada 2 - tres agentes ejecutaron en paralelo: componente de página hub, componente de página de detalle y configuración de ruta en ShawnOS. Oleada 3 - dos agentes ejecutaron en paralelo: actualizaciones de navegación y llenado de enlaces cruzados. Oleada 4 - un agente ejecutó el build y verificó todas las rutas. Tiempo total: menos de 15 minutos. Estimación de tiempo secuencial: más de 45 minutos. La diferencia de velocidad vino de la planificación. Identificar qué tareas eran independientes. Agruparlas en oleadas. Darle a cada agente exactamente el contexto que necesitaba. La ejecución en sí fue rápida. La planificación es lo que hizo posible la ejecución.