Claude Agent Teams suele "encajar" y volverse caótico en el mismo momento.

Lanzas unos cuantos compañeros, el trabajo empieza a avanzar en paralelo… y te das cuenta de que no tienes una respuesta sencilla a:

• ¿quién está trabajando en qué?
• ¿quién te está esperando?
• ¿adónde debería ir el siguiente mensaje?

Si no resuelves eso, los equipos no se sienten como una ventaja. Se sienten como hacer scroll.

Esta guía explica un flujo que hace que Claude Agent Teams sea claro y predecible: enrutado claro, revisiones predecibles y un "ciclo de atención" ajustado.

En resumen

1. Trata Claude Agent Teams como un problema de enrutado de mensajes, no de transcripciones.
2. Ten en mente tres "destinos":
   • Principal (Lead, por defecto)
   • un compañero concreto
   • Broadcast (un mensaje para todo el equipo)
3. No adivines adónde ha ido tu mensaje: haz explícitos los envíos enrutados.
4. Si quieres una forma cómoda desde el móvil de seguir a los compañeros y enviar mensajes enrutados, Happier es una opción: muestra un selector de destinatario "Enviar a" (Send to) (Principal / Broadcast / compañero) y mantiene una lista de Agentes dedicada.

El problema

Claude Teams no es difícil porque Claude no pueda hacer el trabajo.

Es difícil porque las personas perdemos el hilo.

En cuanto tienes varios compañeros:

• la transcripción del principal ya no cuenta toda la historia
• se te puede escapar el compañero que está bloqueado
• "enviar una corrección rápida" se vuelve ambiguo (¿a quién?)

Así que el problema real es la atención y el enrutado.

Enfoques habituales y sus contrapartidas

• Hablar solo con el principal: seguro, pero pierdes la mayor parte de la ventaja de los compañeros.
• Subir con el scroll y buscar la salida del compañero correcto: funciona, pero no escala.
• Usar ventanas o pestañas separadas para cada compañero: mejor, pero sigue siendo fácil enviar la siguiente instrucción al sitio equivocado.

Si Happier es nuevo para ti

Si no conocías Happier: es una app complementaria de código abierto (móvil/web/escritorio) para sesiones de programación.

En esta guía, lo relevante es sencillo: te da una interfaz para Claude Agent Teams donde:

• los compañeros se ven como una lista ("Agentes" (Agents))
• el compositor tiene un selector de destinatario "Enviar a" (Send to) (Principal / Broadcast / compañero)
• los envíos enrutados se muestran como tarjetas (para que veas adónde enviaste el mensaje)

Para empezar:

• Cómo usar Happier desde el móvil
• GitHub: https://github.com/happier-dev/happier
• Instalación/descarga: https://github.com/happier-dev/happier#how-it-works
• Discord (comunidad y soporte): https://discord.gg/W6Pb8KuHfg

Un modelo mental de Claude Teams que mantiene las cosas claras

Principal

El principal es la conversación por defecto.

Si envías un mensaje sin enrutado, va al principal.

Compañero

Un compañero es un miembro concreto del equipo de Claude. Los mensajes a un compañero deben ser explícitos.

Broadcast

Broadcast es el canal de "díselo a todo el equipo".

En la implementación de Happier, Broadcast se deriva del id de tu equipo de Claude y aparece como destino de enrutado cuando hay un equipo.

Un flujo que funciona

1) Elige 2 o 3 "roles" de compañero que reutilices siempre

Los equipos se desordenan cuando cada compañero es un caso único.

Ten un conjunto pequeño de roles reutilizables y usa las mismas instrucciones cada vez.

Valores por defecto sensatos:

• Revisor (centrado en el diff, prudente)
• Tester (ejecuta pruebas, intenta romper suposiciones)
• Refactorizador (hace el movimiento mecánico de código)

Puedes añadir más roles (documentación, triaje, notas de versión), pero empezar con pocos hace que los equipos sean más fáciles de gestionar.

2) Crea compañeros con instrucciones para copiar y pegar (para que su comportamiento sea predecible)

Al lanzar un compañero, dale:

• un rol
• un ámbito
• una regla para parar
• y un formato de punto de control

Estas instrucciones aguantan bien cuando se reutilizan.

Instrucciones del compañero: Revisor

Eres mi revisor. Tu trabajo es encontrar riesgos e incoherencias.

Reglas:

• No hagas cambios. Solo revisa.
• Empieza siempre resumiendo cuál crees que es el objetivo.
• Luego enumera: (1) riesgos, (2) pruebas que faltan, (3) mejoras sugeridas para el diff.
• Si no estás seguro, haz una pregunta de aclaración.

Instrucciones del compañero: Tester

Eres mi tester.

Reglas:

• No refactorices. Céntrate en los modos de fallo.
• Propón primero un plan de pruebas mínimo.
• Luego ejecuta el plan (o explica exactamente qué ejecutarías).
• Si algo falla, pega el comando exacto que falla y el error.

Instrucciones del compañero: Refactorizador

Eres mi refactorizador.

Reglas:

• Antes de cambiar nada, propón un plan de 3 pasos.
• Después de cada paso, resume qué ha cambiado.
• No toques migraciones ni autenticación salvo que yo lo diga explícitamente.
• Si necesitas un cambio arriesgado, para y pregunta.

3) Usa Broadcast para restricciones globales (un mensaje, todos lo oyen)

Broadcast va muy bien para restricciones que deben aplicarse a todo el equipo:

• "No toquéis las migraciones."
• "Parad después del siguiente paso y resumid."
• "Si vais a lanzar una instalación, preguntad antes."

Broadcast no va bien para tareas detalladas ("cambia el archivo X y luego Y") porque mezcla responsabilidades.

4) Enruta las tareas detalladas a un compañero cada vez

Cuando quieras que un compañero haga algo concreto, envíaselo directamente.

Un pequeño hábito que ayuda: termina el mensaje pidiendo una confirmación obligatoria.

Ejemplo:

Confirma con: qué estás haciendo ahora + qué harás a continuación.

Así es evidente si el mensaje llegó al destino equivocado.

5) Usa la barra lateral de Agentes como tu lista (de esto se trata)

Esta es la parte propia de Happier que hace Claude Teams más fácil de gestionar.

En una sesión de equipo de Claude, Happier muestra una lista de Agentes (Agents) en la interfaz de la sesión.

Te da:

• Iniciar (Launch): lanza un compañero nuevo
• Activos (Active): en ejecución ahora
• Recientes (Recent): terminados o inactivos

Y cada entrada de agente es algo real "que puedes abrir", no solo una línea de una transcripción.

Eso significa que tu flujo no empieza con scroll. Empieza con una lista.

El hábito: al abrir la sesión, abre primero la barra lateral o el panel de Agentes.

6) Abre un compañero para ver qué está haciendo (sin perder el contexto)

Desde la lista de Agentes:

• toca o haz clic en un compañero

Happier abre la vista de ese compañero para que veas:

• su transcripción
• su actividad con herramientas
• si te está esperando

Esto es lo que evita que Claude Teams se convierta en "buscar el mensaje correcto en un historial larguísimo".

7) Envía un mensaje a un compañero concreto (no al principal)

En el compositor de mensajes, Happier tiene un selector de destinatario Enviar a (Send to).

Puedes enrutar el siguiente mensaje a:

• Principal (Lead, por defecto)
• un compañero concreto
• Broadcast (a todo el equipo)

En cuanto seleccionas un compañero, el mensaje va a ese compañero.

Es una gran ventaja de la experiencia de equipos en Happier: el enrutado es explícito.

8) Usa un ciclo de "revisión de 2 minutos" (sobre todo en el móvil)

Un flujo móvil que funciona es sencillo a propósito:

1. Abre la sesión.
2. Abre la lista de Agentes.
3. Busca el que necesita atención.
4. Enruta un mensaje (o haz Broadcast de una restricción).
5. Cierra la app.

Intentar hacer más que eso en el móvil lleva a decisiones de baja calidad.

9) Aprende a verificar el enrutado después

Quieres poder demostrar adónde fue tu mensaje.

En Happier, los envíos enrutados se muestran como tarjetas de mensaje con una etiqueta de destinatario clara (por ejemplo, "A: Principal", "A: Broadcast …", "A: reviewer").

Ese pequeño detalle de la interfaz es lo que evita la confusión de "creo que se lo dije al revisor…".

Solución de problemas

Un compañero está en silencio

Causas habituales:

• sigue trabajando (pide un punto de control)
• está bloqueado esperando un permiso o una entrada
• se ha metido en un laberinto (envía un "para y resume")

Un buen mensaje de rescate:

Para. Resume lo que has hecho, lo que ibas a hacer a continuación y lo que necesitas de mí.

Dos compañeros están haciendo el mismo trabajo

Suele pasar cuando:

• las tareas se enviaron por Broadcast en lugar de con enrutado dirigido
• el principal reenvió una tarea de forma ambigua

Solución:

• asigna un responsable ("la revisión es del revisor, los cambios del refactorizador")
• haz Broadcast de la regla de responsabilidad una vez

Broadcast resulta ruidoso

Broadcast debe servir para restricciones y coordinación, no para asignar tareas.

Si te encuentras metiendo "haz X" en un Broadcast, devuélvelo a mensajes dirigidos a un compañero.

Preguntas frecuentes

¿Debería usar siempre tres compañeros?

No. Empieza con uno.

Gran parte del valor viene de:

• un compañero revisor que detecta riesgos, o
• un compañero tester que evita cambios frágiles.

¿Qué debería hacer el principal?

El principal va bien para:

• coordinar
• resolver conflictos entre las salidas de los compañeros
• escribir la instrucción final de "haz esto" para el hilo principal de implementación

Errores habituales

• enviar una tarea dirigida por Broadcast
• enviar una restricción global a un solo compañero
• no pedir nunca resúmenes de punto de control

Guías relacionadas

• Cómo saber qué sesión de Claude Code, Codex u OpenCode está atascada (sin revisar 10 terminales)