Cómo enviar mensajes a Claude Agent Teams (principal, compañero o difusión)

La forma más rápida de que Claude Agent Teams parezca inútil es enviar una y otra vez mensajes al destino equivocado.

Es sutil.

Crees que le has dicho al compañero que ejecute los tests, pero se lo has dicho al principal.

Crees que has difundido una restricción global, pero se la has enviado a un solo compañero.

Y acabas haciendo justo lo que los equipos debían evitar:

volver a explicar el contexto
repetirte
dudar de si alguien te ha oído

Esta guía es un manual de enrutamiento: principal, compañero o difusión, y los pequeños hábitos que hacen que los mensajes lleguen a donde quieres.

En resumen

En Claude Agent Teams, decide siempre a quién hablas antes de decidir qué dices.
Usa:
- Principal (Lead) para la coordinación y las decisiones finales
- Compañero para trabajo concreto
- Difusión para restricciones globales
Prioriza mensajes que se puedan verificar:
- pide un acuse de una línea ("recibido + paso actual")
- pide un resumen de punto de control antes de una acción arriesgada
Si quieres una interfaz que haga explícito el enrutamiento, Happier es una opción que ayuda porque tiene un selector Enviar a (Send to) y muestra los mensajes enrutados como tarjetas con destinatario.

El problema

El enrutamiento es el impuesto oculto de los equipos.

En una sesión de un solo hilo, cada mensaje va a un único sitio.

En un equipo, un mensaje es una acción con destino.

Si no haces explícito ese destino, obtienes:

trabajo duplicado
restricciones que se pierden
la confusión de "¿por qué este compañero está haciendo lo que no es?"

Enfoques habituales y sus contrapartidas

Hablar siempre con el principal: seguro, pero el equipo se reduce a un solo agente.
Hablar solo con los compañeros: parece rápido, pero pierdes la capa de coordinación.
Difundirlo todo: genera ruido y responsabilidades difusas.

Un mapa de enrutamiento que funciona

Principal (coordinación)

Usa el principal cuando quieras:

un plan
un resumen
resolver conflictos entre los resultados de los compañeros
una decisión final

Buen patrón de mensaje al principal:

Resume lo que ha encontrado cada compañero, enumera los desacuerdos y propón una decisión.

Compañero (ejecución)

Usa un compañero cuando:

la tarea es clara y acotada
la entrada y la salida se pueden describir con claridad

Buen patrón de mensaje a un compañero:

Haz X. Para cuando termines. Responde con: (1) qué has cambiado, (2) qué no has cambiado, (3) qué necesitas de mí.

Difusión (restricciones globales)

Usa la difusión cuando:

el mensaje es una restricción que se aplica a todos
el mensaje es de coordinación ("pausa", "punto de control", "para después del siguiente paso")

Buenos mensajes de difusión:

"No toques las migraciones."
"Para después del siguiente paso y resume."
"Si vas a instalar dependencias, pregunta antes."

Malos mensajes de difusión:

"Refactoriza este archivo" (responsable poco claro)
"Arregla estos tests" (¿quién se encarga?)

Ejemplos prácticos (para copiar y pegar)

Ejemplo 1: difunde una restricción de seguridad

No toques migraciones ni autenticación. Si crees que lo necesitas, para y pregunta.

Ejemplo 2: envía una tarea de tests a un compañero

Ejecuta el plan de tests mínimo para este cambio.

Responde con:

los comandos exactos que has ejecutado

los fallos (texto de error completo)

un arreglo sugerido (si lo hay)

Ejemplo 3: envía el arbitraje al principal

Dos compañeros no están de acuerdo. Resume ambas posturas en 5 viñetas y luego recomienda una.

Cómo demostrar adónde fue tu mensaje

La clave es poder verificar el enrutamiento a posteriori.

Si tu interfaz no muestra el enrutamiento, acabas adivinando.

En Happier, los envíos enrutados se guardan como mensajes de participantes estructurados y se muestran como tarjetas con una etiqueta clara de destinatario ("A: …").

Ese es el nivel de claridad que quieres cuando el equipo tiene más de 2 miembros.