team-builder

Construtor de Equipes

Menu interativo para navegar e compor equipes de agentes sob demanda. Funciona com coleções de agentes em formato plano ou em subdiretórios de domínio.

Quando Usar

• Você tem múltiplas personas de agente (arquivos markdown) e deseja escolher quais usar para uma tarefa
• Você quer compor uma equipe ad-hoc de diferentes domínios (ex: Segurança + SEO + Arquitetura)
• Você quer navegar pelos agentes disponíveis antes de decidir

Pré-requisitos

Os arquivos de agente devem ser arquivos markdown contendo um prompt de persona (identidade, regras, fluxo de trabalho, entregáveis). O primeiro # Cabeçalho é usado como nome do agente e o primeiro parágrafo como descrição.

Ambos os layouts, plano e subdiretório, são suportados:

Layout de subdiretório — o domínio é inferido a partir do nome da pasta:

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

Layout plano — domínio inferido a partir de prefixos de nome de arquivo compartilhados. Um prefixo conta como domínio quando 2+ arquivos o compartilham. Arquivos com prefixos únicos vão para "Geral". Nota: o algoritmo divide no primeiro -, então domínios com várias palavras (ex: product-management) devem usar o layout de subdiretório:

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

Configuração

Os agentes são descobertos por dois métodos, mesclados e deduplicados por nome:

1. Comando claude agents (primário) — execute claude agents para obter todos os agentes conhecidos pela CLI, incluindo agentes de usuário, agentes de plugin (ex: ecc:architect) e agentes nativos. Isso cobre automaticamente instalações do marketplace ECC sem necessidade de configuração de caminho.
2. Glob de arquivos (fallback, para leitura do conteúdo do agente) — os arquivos markdown do agente são lidos de:
   • ./agents/**/*.md + ./agents/*.md — agentes locais do projeto
   • ~/.claude/agents/**/*.md + ~/.claude/agents/*.md — agentes globais do usuário

Fontes anteriores têm precedência quando nomes colidem: agentes de usuário > agentes de plugin > agentes nativos. Um caminho personalizado pode ser usado se o usuário especificar um.

Como Funciona

Passo 1: Descobrir Agentes Disponíveis

Execute claude agents para obter a lista completa de agentes. Analise cada linha:

• Agentes de plugin são prefixados com nome-do-plugin: (ex: ecc:security-reviewer). Use a parte após : como nome do agente e o nome do plugin como domínio.
• Agentes de usuário não têm prefixo. Leia o arquivo markdown correspondente de ~/.claude/agents/ ou ./agents/ para extrair o nome e a descrição.
• Agentes nativos (ex: Explore, Plan) são ignorados, a menos que o usuário peça explicitamente para incluí-los.

Para agentes de usuário carregados de arquivos markdown:

• Layout de subdiretório: extraia o domínio do nome da pasta pai
• Layout plano: colete todos os prefixos de nome de arquivo (texto antes do primeiro -). Um prefixo se qualifica como domínio apenas se aparecer em 2 ou mais nomes de arquivo (ex: engineering-security-engineer.md e engineering-software-architect.md ambos começam com engineering → domínio Engineering). Arquivos com prefixos únicos (ex: code-reviewer.md, tdd-guide.md) são agrupados em "General"
• Extraia o nome do agente do primeiro # Cabeçalho. Se nenhum cabeçalho for encontrado, derive o nome do nome do arquivo (remova .md, substitua hífens por espaços, capitalize)
• Extraia um resumo de uma linha do primeiro parágrafo após o cabeçalho

Se nenhum agente for encontrado após executar claude agents e sondar locais de arquivos, informe ao usuário: "Nenhum agente encontrado. Execute claude agents para verificar sua configuração." Então pare.

Passo 2: Apresentar Menu de Domínios

Domínios de agentes disponíveis:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

Escolha domínios ou nomeie agentes específicos (ex: "1,3" ou "security + seo"):

• Pule domínios com zero agentes (diretórios vazios)
• Mostre a contagem de agentes por domínio

Passo 3: Gerenciar Seleção

Aceite entrada flexível:

• Números: "1,3" seleciona todos os agentes de Engineering e Sales
• Nomes: "security + seo" faz correspondência difusa com os agentes descobertos
• "todos de engineering" seleciona cada agente naquele domínio

Se mais de 5 agentes forem selecionados, liste-os em ordem alfabética e peça ao usuário para reduzir: "Você selecionou N agentes (máx 5). Escolha quais manter, ou diga 'primeiros 5' para usar os cinco primeiros em ordem alfabética."

Confirme a seleção:

Selecionados: Security Engineer + SEO Specialist
No que eles devem trabalhar? (descreva a tarefa):

Passo 4: Despachar Agentes em Paralelo

1. Leia o arquivo markdown de cada agente selecionado
2. Solicite a descrição da tarefa, se ainda não fornecida
3. Despache todos os agentes em paralelo usando a ferramenta Agent:
   • subagent_type: "general-purpose"
   • prompt: "{conteúdo do arquivo do agente}\n\nTarefa: {descrição da tarefa}"
   • Cada agente é executado de forma independente — nenhuma comunicação entre agentes é necessária
4. Se um agente falhar (erro, tempo limite ou saída vazia), anote a falha inline (ex: "Security Engineer: falhou — [motivo]") e continue com os resultados dos agentes que tiveram sucesso

Passo 5: Sintetizar Resultados

Colete todas as saídas e apresente um relatório unificado:

• Resultados agrupados por agente
• Seção de síntese destacando:
  • Concordâncias entre agentes
  • Conflitos ou tensões entre recomendações
  • Próximos passos recomendados

Se apenas 1 agente foi selecionado, pule a síntese e apresente a saída diretamente.

Regras

• Descoberta dinâmica apenas. Nunca codifique listas de agentes. Novos arquivos no diretório aparecem automaticamente no menu.
• Máx. 5 agentes por equipe. Mais de 5 produz retornos decrescentes e uso excessivo de tokens. Aplique no momento da seleção.
• Despacho paralelo. Todos os agentes são executados simultaneamente — use o padrão de invocação paralela da ferramenta Agent.
• Chamadas paralelas de Agent, não TeamCreate. Esta skill usa chamadas paralelas da ferramenta Agent para trabalho independente. TeamCreate (uma ferramenta do Claude Code para diálogo multi-agente) só é necessário quando os agentes precisam debater ou responder uns aos outros.

Exemplos

Usuário: team builder

Claude:
Domínios de agentes disponíveis:
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

Escolha domínios ou nomeie agentes específicos:

Usuário: security + seo

Claude:
Selecionados: Security Engineer + SEO Specialist
No que eles devem trabalhar?

Usuário: Revise meu site e-commerce Next.js antes do lançamento

[Ambos os agentes são ativados em paralelo, cada um aplicando sua especialidade ao código]

Claude:
## Descobertas do Security Engineer
- [descobertas...]

## Descobertas do SEO Specialist
- [descobertas...]

## Síntese
Ambos os agentes concordam em: [...]
Tensão: Security recomenda CSP que bloqueia estilos inline, SEO precisa de marcação schema inline. Resolução: [...]
Próximos passos: [...]