SquadraHQ English

Ejemplos: departamentos de agentes de Claude Code que trabajan juntos

Cada ejemplo es una organización completa montada con SquadraHQ: sus equipos (un coordinador y sus workers), la persona que sigue cada agente, los enlaces entre equipos y el primer mensaje para cada coordinador. Copia el que más se parezca al tuyo y adáptalo.

El organigrama de SquadraHQ: los equipos de Desarrollo, QA y Contenidos, cada coordinador con sus workers

El organigrama: cada equipo es una tarjeta con su coordinador y sus workers; los equipos enlazados se unen con una línea. Cada ejemplo de abajo lista sus equipos de la misma forma.

Cómo encajan las piezas. Cada agente es una sesión de Claude Code en su propia carpeta, con una persona: una skill (.claude/skills/<nombre>/SKILL.md) o un agente (.claude/agents/<nombre>.md) de esa carpeta. Los workers solo hablan con su coordinador; los coordinadores enlazados se piden trabajo entre ellos, y cada uno pasa lo que asume a sus propios workers. El objetivo del equipo se le dice a su coordinador, que pone ahí su esfuerzo.

Agencia de marketing

Para una agencia, o un equipo de marketing, que convierte cada brief de un cliente en una campaña: estrategia, contenido y publicidad de pago, con el responsable de cuenta como único interlocutor.

Cuentas
Convertir cada brief en un plan de campaña, y entregarlo a tiempo
  • accounts-lead account-director
  • strategist brand-strategist
  • research market-researcher
Contenido
Escribir y diseñar todo lo que publica una campaña
  • content-lead creative-director
  • copy copywriter
  • design designer
  • video video-scripts
Rendimiento
Llevar las campañas de pago y el SEO, y medir qué funciona
  • perf-lead growth-lead
  • ads ads-analyst
  • seo seo-specialist
  • reports data-analyst

Carpetas

~/agencia/
  accounts/      # briefs, planes, informes de cliente
  content/       # textos, diseños, guiones
  performance/   # planes de anuncios, auditorías SEO, cifras
  clients/acme/  # una carpeta por cliente: brief.md, brand.md, assets/

La carpeta de cada equipo tiene sus personas en .claude/skills/<nombre>/SKILL.md.

Primer mensaje a accounts-lead

Cliente nuevo: Acme (lee clients/acme/brief.md y brand.md). Campaña de lanzamiento
de su nueva app en 4 semanas, presupuesto 8.000 €. Que el strategist escriba el plan
y research analice tres competidores. Cuando el plan esté, pide a Contenido la
landing, 3 emails y 10 posts, y a Rendimiento el plan de anuncios dentro del
presupuesto. Enséñame el plan antes de encargar nada, y todo antes de que llegue
al cliente.

Marca personal en redes sociales

Para un fundador, consultor o creador que quiere un post al día en LinkedIn, X y YouTube, una newsletter semanal, y saber qué le pregunta su audiencia.

Estudio de contenido
Un post al día y una newsletter a la semana, con mi voz
  • editor editor-in-chief
  • writer ghostwriter
  • video video-scripts
  • visuals carousel-designer
Audiencia
Saber qué quiere la audiencia, y hacerla crecer
  • audience-lead growth-lead
  • community community-manager
  • analytics social-analyst

Carpetas

~/marca/
  voice.md      # quién soy, cómo escribo, temas que trato y evito, posts que me gustaron
  calendar.md   # el plan de las dos próximas semanas (lo lleva el editor)
  studio/       # drafts/ y approved/
  audience/     # exports/ (comentarios, CSV de analíticas) e insights.md

studio/ y audience/ tienen las personas de su equipo en .claude/skills/.

Primer mensaje al editor

Planifica las dos próximas semanas en calendar.md: un post de LinkedIn al día, dos
hilos de X y un short de YouTube a la semana, y la newsletter del viernes. Pregunta
a Audiencia qué temas elegir. Writer escribe los posts y la newsletter en drafts/
siguiendo voice.md, video el guion del short y visuals el carrusel del martes.
Enséñame los borradores de cada día juntos; yo los apruebo, y solo los aprobados
van a approved/.
Los agentes escriben borradores en archivos. Publicar es cosa tuya, o de una herramienta que les des (un servidor MCP o una CLI de tu programador de publicaciones): el coordinador de SquadraHQ te pregunta antes de publicar nada, y los agentes solo ven las analíticas que exportes a audience/exports/.

Empresa de software

Para un equipo con varios repositorios (API, web, móvil) que quiere desarrollar funcionalidades en paralelo, que cada pull request se pruebe y se revise, y que las releases sean aburridas.

Producto
Desarrollar las funcionalidades del roadmap en API, web y móvil
  • tech-lead tech-lead
  • api backend
  • web frontend
  • mobile mobile
Calidad
Ninguna pull request se mergea sin tests, revisión y documentación
  • qa-lead qa-lead
  • tests test-engineer
  • review code-reviewer
  • docs tech-writer
Plataforma
CI, entornos y releases
  • platform-lead devops
  • ci ci-engineer
  • release release-manager

Carpetas

~/empresa/
  api/  web/  mobile/  # un repositorio y un worker cada uno
  quality/             # planes de pruebas, checklists de revisión
  platform/            # repositorio de infraestructura

¿Dos workers en un repositorio? Dale a cada uno su propio git worktree.

Primer mensaje a tech-lead

Lo siguiente del roadmap: invitaciones al equipo (docs/roadmap.md, punto 3).
Repártelo: api añade los endpoints y los emails, web la pantalla de ajustes y
mobile la pantalla de aceptar. Una rama y una pull request por repositorio,
enlazadas a la issue #142. Cuando cada pull request esté lista, mándala a Calidad
con qué probar. Pregúntame antes de cambiar el esquema de la base de datos o
cualquier cosa de facturación.
Pon las reglas fijas (nombres de ramas, cómo se lanzan los tests, qué cuenta como terminado) en el CLAUDE.md de cada repositorio o en la persona, no en cada tarea: se leen una vez por sesión en vez de repetirse en cada mensaje.

Lanzamiento de un producto: producto, marketing y marca personal

Para una empresa pequeña que lanza un producto: el equipo de producto lo desarrolla, marketing lleva la campaña y la marca personal del fundador cuenta la historia. Es el organigrama de la captura de arriba.

Personal brand
Hacer crecer la audiencia del fundador en LinkedIn, X y YouTube, un post al día
  • brand-lead editor-in-chief
  • writer writer
  • video video-scripts
  • community community
Marketing
Planificar y llevar la campaña de lanzamiento: landing, emails y anuncios
  • mkt-lead campaign-lead
  • copy copywriter
  • design designer
  • ads ads-analyst
Product
Desarrollar la app que vende la campaña: front end web, API y tests
  • product-lead tech-lead
  • frontend frontend
  • backend backend
  • qa qa

Primeros mensajes

A mkt-lead:     El lanzamiento es el día 15. Planifica la campaña en launch/plan.md:
                landing, 3 emails y anuncios para dos públicos. Pregunta a Product
                qué sale y pídele capturas, y cuéntale a Personal brand los
                mensajes clave y las fechas.

A product-lead: El lanzamiento es el día 15, con las invitaciones y el nuevo panel.
                Dile a Marketing qué está listo y cuándo, y desarrolla en web/ la
                landing que te manden.

A brand-lead:   Dos semanas de posts hasta el lanzamiento del día 15: la historia
                detrás del producto, con mi voz (voice.md). Pide los mensajes clave
                a Marketing.

Cómo montar uno en SquadraHQ

  1. Escribe las personas en cada carpeta, una skill por rol (abajo). El panel las lista en el diálogo de la sesión.
  2. 🏢 Organigrama → + Equipo por cada equipo: el equipo y la carpeta, el nombre del coordinador, el nombre y el objetivo del equipo, y su persona.
  3. + Agente en la tarjeta de cada equipo, una vez por worker, cada uno con su persona.
  4. Enlaza los equipos que se necesitan: arrastra el punto del borde derecho de una tarjeta hasta la otra.
  5. Guarda cada equipo como plantilla (en su menú ⋯), para volver a abrirla de un clic desde 🖥️ Máquinas → Plantillas.
  6. Habla con cada coordinador en su terminal, con los primeros mensajes de arriba.

El paso a paso con capturas está en el README, y todas las opciones en la referencia.

Una persona: content/.claude/skills/copywriter/SKILL.md
---
name: copywriter
description: Escribe landings, emails y textos de anuncios con la voz del cliente
---

Eres el copywriter de la agencia.

- Antes de escribir, lee el brand.md del cliente y el plan de campaña que te pasen.
- Escribe con la voz y en el idioma del cliente. Frases cortas, una idea cada una.
- Entrega cada pieza como un archivo Markdown en la carpeta de la campaña, con dos
  opciones de titular y la llamada a la acción.
- Nunca inventes cifras, precios ni citas de clientes: pregúntale a tu coordinador.
La persona de un coordinador: accounts/.claude/skills/account-director/SKILL.md
---
name: account-director
description: Lleva cada cuenta de cliente: planifica, encarga el trabajo y lo revisa
---

Llevas las cuentas de los clientes.

- Cada campaña empieza con un plan en clients/<cliente>/plan.md, que el usuario
  revisa antes de encargar nada.
- Pide a los equipos de Contenido y Rendimiento lo que necesite el plan, con el
  brief, la fecha de entrega y dónde dejarlo. Comprueba lo que vuelve contra el plan.
- Pregunta al usuario antes de enviar nada a un cliente, publicar o gastar
  presupuesto.
Mantenlo ligero. Cada mensaje despierta al agente que lo recibe, y cada vez que despierta relee su contexto. Pocos equipos con objetivos claros, las reglas fijas en la persona o en el CLAUDE.md, y los resultados agrupados en un solo mensaje gastan muchos menos tokens que muchos saltos pequeños.