Construtor de Equipes

O que Construtor de Equipes faz?

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

Quando Usar

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

Pré-requisitos

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

Ambas as estruturas plana e subdiretórios são suportadas:

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

agents/
├── engenharia/
│   ├── engenheiro-de-seguranca.md
│   └── arquiteto-de-software.md
├── marketing/
│   └── especialista-em-seo.md
└── vendas/
    └── coach-de-descoberta.md

Estrutura plana — o domínio é inferido a partir de prefixos de nomes 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.: gestao-de-produtos) devem usar a estrutura de subdiretórios:

agents/
├── engenharia-engenheiro-de-seguranca.md
├── engenharia-arquiteto-de-software.md
├── marketing-especialista-em-seo.md
├── marketing-estrategista-de-conteudo.md
├── vendas-coach-de-descoberta.md
└── vendas-estrategista-de-outbound.md

Configuração

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

1. Comando claude agents (principal) — execute claude agents para obter todos os agentes conhecidos pela CLI, incluindo agentes do usuário, agentes de plugin (ex.: ecc:architect) e agentes internos. Isso cobre automaticamente instalações do ECC Marketplace sem necessidade de configuração de caminho.
2. Glob de arquivos (fallback, para ler o conteúdo do agente) — os arquivos markdown dos agentes 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 em caso de colisão de nomes: agentes do usuário > agentes de plugin > agentes internos. Um caminho personalizado pode ser usado se o usuário especificar um.

Como Funciona

Etapa 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 do 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 internos (ex.: Explore, Plan) são ignorados, a menos que o usuário peça explicitamente para incluí-los.

Para agentes do usuário carregados de arquivos markdown:

• Estrutura de subdiretórios: extraia o domínio do nome da pasta pai
• Estrutura plana: colete todos os prefixos de nomes de arquivo (texto antes do primeiro -). Um prefixo qualifica-se como domínio apenas se aparecer em 2 ou mais nomes de arquivo (ex.: engenharia-engenheiro-de-seguranca.md e engenharia-arquiteto-de-software.md ambos começam com engenharia → domínio Engenharia). Arquivos com prefixos únicos (ex.: revisor-de-codigo.md, guia-tdd.md) são agrupados em "Geral"
• Extraia o nome do agente do primeiro # Título. Se não houver título, 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 título

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

Etapa 2: Apresentar Menu de Domínios

Domínios de agente disponíveis:
1. Engenharia — Arquiteto de Software, Engenheiro de Segurança
2. Marketing — Especialista em SEO
3. Vendas — Coach de Descoberta, Estrategista de Outbound

Escolha domínios ou nomeie agentes específicos (ex.: "1,3" ou "segurança + seo"):

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

Etapa 3: Lidar com a Seleção

Aceite entrada flexível:

• Números: "1,3" seleciona todos os agentes de Engenharia e Vendas
• Nomes: "segurança + seo" faz correspondência difusa com agentes descobertos
• "todos de engenharia" seleciona todos os agentes desse 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: Engenheiro de Segurança + Especialista em SEO
No que devem trabalhar? (descreva a tarefa):

Etapa 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 independentemente — não é necessária comunicação entre agentes
4. Se um agente falhar (erro, tempo limite ou saída vazia), anote a falha inline (ex.: "Engenheiro de Segurança: falhou — [motivo]") e continue com os resultados dos agentes que tiveram sucesso

Etapa 5: Sintetizar Resultados

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

• Resultados agrupados por agente
• Seção de síntese destacando:
  • Convergê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áximo de 5 agentes por equipe. Mais de 5 produz retornos decrescentes e uso excessivo de tokens. Imponha 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 multiagente) é necessária apenas quando os agentes precisam debater ou responder uns aos outros.

Exemplos

Usuário: construtor de equipes

Claude:
Domínios de agente disponíveis:
1. Engenharia (2) — Arquiteto de Software, Engenheiro de Segurança
2. Marketing (1) — Especialista em SEO
3. Vendas (4) — Coach de Descoberta, Estrategista de Outbound, Estrategista de Propostas, Engenheiro de Vendas
4. Suporte (1) — Resumo Executivo

Escolha domínios ou nomeie agentes específicos:

Usuário: segurança + seo

Claude:
Selecionados: Engenheiro de Segurança + Especialista em SEO
No que devem trabalhar?

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

[Ambos os agentes iniciam em paralelo, cada um aplicando sua especialidade ao código]

Claude:
## Descobertas do Engenheiro de Segurança
- [descobertas...]

## Descobertas do Especialista em SEO
- [descobertas...]

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