4 cosas que necesita tu orquestador de Claude Code para ser útil

Si estás construyendo agentes orquestadores (agentes que gestionan otros agentes) con Claude Code, cuatro componentes separan uno útil de uno caótico. Esto es lo que he aprendido tras meses construyéndolos.

1. Un Documento de Misión

No dejes que tu orquestador dependa de la inteligencia predeterminada del modelo. Escribe un "documento de misión" — una descripción del trabajo que defina qué hacer, cómo hacerlo y cuándo escalar. Para un orquestador de informes de errores, podría ser:

• Revisar el correo electrónico en busca de mensajes con "comentarios de clientes" en el asunto
• Registrar un ticket localmente
• Crear un agente hijo para reproducir el error e implementar una solución utilizando ingeniería compuesta (u otro plugin como superpowers o GSD)
• Notificarme cuando esté listo para QA

No lo toques hasta el paso 4. En el mejor de los casos, te ahorra tiempo; en el peor, el código se desecha.

2. Un Latido (Bucle)

Un orquestador sin bucle es solo un script de un solo uso. El verdadero poder está en la cadencia: vuelve a leer el documento de misión en un horario (cada 10 minutos, cada hora, lo que corresponda). La mayoría de los CLI de agentes ofrecen un bucle o primitiva cron. En cada tick, el orquestador verifica si hay nuevo trabajo, monitorea el progreso de las tareas existentes y actúa según lo que indique la misión.

3. Comunicación entre Agentes

Tu orquestador tiene contexto que no cargaste en los hijos. Puede responder sus preguntas, coordinar enfoques entre ellos o realizar revisiones adversariales donde un agente verifica el trabajo de otro. La implementación puede ser simple: un archivo markdown compartido con reglas estructuradas, una herramienta de paso de mensajes o un sistema de canal secundario. El mecanismo importa menos que asegurarse de que el canal exista.

4. Control Auditado

Construye tu orquestador para que genere registros: qué decidió, qué creó, qué produjeron los hijos. Debes poder saltar a cualquier agente hijo, revisar su trabajo e interrumpirlo en cualquier punto. La visibilidad total es la única forma de confiar en el resultado — eres responsable de todo.

Estos principios aplican sin importar si usas la herramienta mostrada en el video original o cualquier otra herramienta de agentes. Puedes construir un orquestador con lo que ya estés usando.