team-builder

Team Builder

Menú interactivo para explorar y componer equipos de agentes bajo demanda. Funciona con colecciones de agentes planas o en subdirectorios de dominio.

Cuándo usarlo

• Tienes múltiples personajes de agente (archivos markdown) y quieres seleccionar cuáles usar para una tarea
• Quieres componer un equipo ad-hoc de diferentes dominios (por ejemplo, Seguridad + SEO + Arquitectura)
• Quieres explorar qué agentes están disponibles antes de decidir

Prerrequisitos

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

Se admiten diseños planos y de subdirectorio:

Diseño de subdirectorio — 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 2 o más archivos lo comparten. Los archivos con prefijos únicos van a "General". Nota: el algoritmo divide en el primer -, por lo que dominios de varias palabras (por ejemplo, product-management) deberían usar el diseño de subdirectorio 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 desduplicados 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 plugin (por ejemplo, ecc:architect) y agentes integrados. Esto cubre automáticamente las instalaciones del marketplace de ECC sin necesidad de configuración de ruta.
2. Glob de archivos (alternativa, para leer el contenido del agente) — los archivos markdown del agente se leen desde:
   • ./agents/**/*.md + ./agents/*.md — agentes locales del proyecto
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — agentes globales de usuario

Las fuentes anteriores tienen prioridad cuando los nombres colisionan: agentes de usuario > agentes de plugin > agentes integrados. Se puede usar una ruta personalizada en su lugar 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 plugin tienen el prefijo nombre-del-plugin: (por ejemplo, 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 de ~/.claude/agents/ o ./agents/ para extraer el nombre y la descripción.
• Agentes integrados (por ejemplo, Explore, Plan) se omiten a menos que el usuario solicite explícitamente incluirlos.

Para agentes de usuario cargados desde archivos markdown:

• Diseño de subdirectorio: extrae el dominio del nombre de la carpeta padre
• Diseño plano: recopila 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 (por ejemplo, engineering-security-engineer.md y engineering-software-architect.md ambos comienzan con engineering → dominio Engineering). Los archivos con prefijos únicos (por ejemplo, code-reviewer.md, tdd-guide.md) se agrupan bajo "General"
• Extrae el nombre del agente del primer # Encabezado. Si no se encuentra ningún encabezado, deriva el nombre del nombre del archivo (elimina .md, reemplaza guiones con espacios, convierte a título)
• Extrae un resumen de una línea del primer párrafo después del encabezado

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

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

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

Paso 3: Manejar la selección

Acepta entrada flexible:

• Números: "1,3" selecciona todos los agentes de Engineering y Sales
• Nombres: "security + seo" coincide difusamente con los agentes descubiertos
• "all from engineering" selecciona cada agente en ese dominio

Si se seleccionan más de 5 agentes, enuméralos alfabéticamente y pide al usuario que acote: "Seleccionaste N agentes (máx. 5). Elige cuáles conservar o di 'first 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: Generar agentes en paralelo

1. Lee el archivo markdown de cada agente seleccionado
2. Solicita la descripción de la tarea si aún no se ha proporcionado
3. Genera 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 el fallo en línea (por ejemplo, "Security Engineer: falló — [motivo]") y continúa con los resultados de los agentes que tuvieron éxito

Paso 5: Sintetizar resultados

Recopila 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

• Solo descubrimiento dinámico. Nunca codifiques listas de agentes. Los nuevos archivos en el directorio aparecen automáticamente en el menú.
• Máximo 5 agentes por equipo. Más de 5 produce rendimientos decrecientes y uso excesivo de tokens. Aplica en el momento de la selección.
• Despacho en paralelo. Todos los agentes se ejecutan simultáneamente — usa el patrón de invocación en paralelo de la herramienta Agent.
• Llamadas paralelas de Agent, no TeamCreate. Esta habilidad usa llamadas paralelas de 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

Selecciona dominios o nombra agentes específicos:

Usuario: security + seo

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

Usuario: Revisa mi sitio de comercio electrónico en Next.js antes del lanzamiento

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

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

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

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