team-builder

Team Builder (Constructor de Equipos)

Menú interactivo para explorar y componer equipos de agentes sobre la marcha. Funciona con colecciones de agentes planas o en subdirectorios de dominio.

Cuándo Usarlo

• Tienes múltiples personas de agente (archivos markdown) y quieres elegir cuáles usar para una tarea
• Quieres formar un equipo ad-hoc a partir de diferentes dominios (p. ej., Seguridad + SEO + Arquitectura)
• Quieres explorar qué agentes están disponibles antes de decidir

Requisitos Previos

Los archivos de agente deben ser markdown que contengan un prompt de personalidad (identidad, reglas, flujo de trabajo, entregables). El primer # Título se usa como nombre del agente y el primer párrafo como descripción.

Se admiten tanto diseños planos como con subdirectorios:

Diseño con subdirectorios — el dominio se infiere del nombre de la carpeta:

agents/
├── engineering/
│   ├── security-engineer.md
│   └── software-architect.md
├── marketing/
│   └── seo-specialist.md
└── sales/
    └── discovery-coach.md

Diseño plano — el dominio se infiere de prefijos de nombre de archivo compartidos. Un prefijo cuenta como dominio cuando aparece en 2 o más archivos. Los archivos con prefijos únicos van a "General". Nota: el algoritmo divide en el primer -, por lo que los dominios con varias palabras (p. ej., product-management) deben usar el diseño de subdirectorios en su lugar:

agents/
├── engineering-security-engineer.md
├── engineering-software-architect.md
├── marketing-seo-specialist.md
├── marketing-content-strategist.md
├── sales-discovery-coach.md
└── sales-outbound-strategist.md

Configuración

Los agentes se descubren mediante dos métodos, fusionados y deduplicados por nombre de agente:

1. Comando claude agents (principal) — ejecuta claude agents para obtener todos los agentes conocidos por la CLI, incluidos agentes de usuario, agentes de plugins (p. ej. ecc:architect) y agentes integrados. Esto cubre automáticamente las instalaciones del marketplace de ECC sin necesidad de configuración de rutas.
2. Glob de archivos (alternativa, para leer el contenido del agente) — los archivos markdown de agente se leen desde:
   • ./agents/**/*.md + ./agents/*.md — agentes del proyecto local
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — agentes globales del usuario

Las fuentes anteriores tienen prioridad cuando los nombres chocan: agentes de usuario > agentes de plugins > agentes integrados. Se puede usar una ruta personalizada si el usuario lo especifica.

Cómo Funciona

Paso 1: Descubrir Agentes Disponibles

Ejecuta claude agents para obtener la lista completa de agentes. Analiza cada línea:

• Agentes de plugins tienen el prefijo nombre-del-plugin: (p. ej., ecc:security-reviewer). Usa la parte después de : como nombre del agente y el nombre del plugin como dominio.
• Agentes de usuario no tienen prefijo. Lee el archivo markdown correspondiente desde ~/.claude/agents/ o ./agents/ para extraer el nombre y la descripción.
• Agentes integrados (p. ej., Explore, Plan) se omiten a menos que el usuario pida explícitamente incluirlos.

Para agentes de usuario cargados desde archivos markdown:

• Diseño con subdirectorios: extrae el dominio del nombre de la carpeta padre
• Diseño plano: recoge todos los prefijos de nombre de archivo (texto antes del primer -). Un prefijo califica como dominio solo si aparece en 2 o más nombres de archivo (p. ej., engineering-security-engineer.md y engineering-software-architect.md ambos empiezan con engineering → dominio Engineering). Los archivos con prefijos únicos (p. ej., code-reviewer.md, tdd-guide.md) se agrupan bajo "General"
• Extrae el nombre del agente del primer # Título. Si no se encuentra ningún título, deriva el nombre del nombre del archivo (elimina .md, reemplaza guiones con espacios, escribe con mayúsculas iniciales)
• Extrae un resumen de una línea del primer párrafo después del título

Si no se encuentran agentes después de ejecutar claude agents y sondear las ubicaciones de archivos, informa al usuario: "No se encontraron agentes. Ejecuta claude agents para verificar tu configuración." Luego detente.

Paso 2: Presentar el Menú de Dominios

Dominios de agente disponibles:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

Elige dominios o nombra agentes específicos (p. ej., "1,3" o "security + seo"):

• Omite dominios sin agentes (directorios vacíos)
• Muestra el número de agentes por dominio

Paso 3: Gestionar la Selección

Acepta entrada flexible:

• Números: "1,3" selecciona todos los agentes de Engineering y Sales
• Nombres: "security + seo" busca coincidencias aproximadas entre los agentes descubiertos
• "todos de engineering" selecciona cada agente en ese dominio

Si se seleccionan más de 5 agentes, enuméralos alfabéticamente y pide al usuario que reduzca: "Seleccionaste N agentes (máx. 5). Elige cuáles conservar, o di 'primeros 5' para usar los primeros cinco alfabéticamente."

Confirma la selección:

Seleccionados: Security Engineer + SEO Specialist
¿En qué deberían trabajar? (describe la tarea):

Paso 4: Lanzar Agentes en Paralelo

1. Lee el archivo markdown de cada agente seleccionado
2. Solicita la descripción de la tarea si no se ha proporcionado ya
3. Lanza todos los agentes en paralelo usando la herramienta Agent:
   • subagent_type: "general-purpose"
   • prompt: "{contenido del archivo del agente}\n\nTarea: {descripción de la tarea}"
   • Cada agente se ejecuta de forma independiente — no se necesita comunicación entre agentes
4. Si un agente falla (error, tiempo de espera o salida vacía), anota la falla en línea (p. ej., "Security Engineer: falló — [razón]") y continúa con los resultados de los agentes exitosos

Paso 5: Sintetizar Resultados

Recoge todas las salidas y presenta un informe unificado:

• Resultados agrupados por agente
• Sección de síntesis que destaca:
  • Acuerdos entre agentes
  • Conflictos o tensiones entre recomendaciones
  • Próximos pasos recomendados

Si solo se seleccionó 1 agente, omite la síntesis y presenta la salida directamente.

Reglas

• Descubrimiento dinámico únicamente. Nunca codifiques listas de agentes. Los archivos nuevos en el directorio aparecen automáticamente en el menú.
• Máx. 5 agentes por equipo. Más de 5 produce rendimientos decrecientes y uso excesivo de tokens. Aplica en el momento de la selección.
• Envío en paralelo. Todos los agentes se ejecutan simultáneamente — usa el patrón de invocación paralela de la herramienta Agent.
• Llamadas a Agent en paralelo, no TeamCreate. Este skill usa llamadas paralelas a la herramienta Agent para trabajo independiente. TeamCreate (una herramienta de Claude Code para diálogo multiagente) solo es necesaria cuando los agentes deben debatir o responderse entre sí.

Ejemplos

Usuario: team builder

Claude:
Dominios de agente disponibles:
1. Engineering (2) — Software Architect, Security Engineer
2. Marketing (1) — SEO Specialist
3. Sales (4) — Discovery Coach, Outbound Strategist, Proposal Strategist, Sales Engineer
4. Support (1) — Executive Summary

Elige dominios o nombra agentes específicos:

Usuario: security + seo

Claude:
Seleccionados: Security Engineer + SEO Specialist
¿En qué deberían trabajar?

Usuario: Revisa mi sitio e-commerce en Next.js antes del lanzamiento

[Ambos agentes se lanzan en paralelo, cada uno aplicando su especialidad al código]

Claude:
## Hallazgos de Security Engineer
- [hallazgos...]

## Hallazgos de SEO Specialist
- [hallazgos...]

## Síntesis
Ambos agentes coinciden en: [...]
Tensión: Security recomienda CSP que bloquea estilos en línea, SEO necesita marcado schema en línea. Resolución: [...]
Próximos pasos: [...]