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 várias personas de agente (arquivos markdown) e quer escolher quais usar para uma tarefa
• Você quer compor uma equipe ad-hoc de diferentes domínios (por exemplo, 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 # Heading é usado como nome do agente e o primeiro parágrafo como descrição.

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

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

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

Layout plano — o domínio é inferido de prefixos compartilhados de nomes de arquivo. Um prefixo conta como um domínio quando 2 ou mais arquivos o compartilham. Arquivos com prefixos únicos vão para "Geral". Observação: o algoritmo divide no primeiro -, portanto, domínios com várias palavras (por exemplo, product-management) devem usar o layout de subdiretório em vez disso:

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 de agente:

1. Comando claude agents (primário) — execute claude agents para obter todos os agentes conhecidos pela CLI, incluindo agentes do usuário, agentes de plugin (por exemplo, ecc:architect) e agentes integrados. Isso cobre automaticamente as instalações do mercado ECC sem nenhuma configuração de caminho.
2. Glob de arquivo (fallback, para leitura de conteúdo de agente) — os arquivos markdown de 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 os nomes colidem: agentes do usuário > agentes de plugin > agentes integrados. Um caminho personalizado pode ser usado em vez disso 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 plugin-name: (por exemplo, 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 integrados (por exemplo, Explore, Plan) são ignorados, a menos que o usuário explicitamente peça para incluí-los.

Para agentes do 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 nomes de arquivo (texto antes do primeiro -). Um prefixo se qualifica como domínio apenas se aparecer em 2 ou mais nomes de arquivo (por exemplo, engineering-security-engineer.md e engineering-software-architect.md ambos começam com engineering → domínio Engenharia). Arquivos com prefixos únicos (por exemplo, code-reviewer.md, tdd-guide.md) são agrupados sob "Geral"
• Extraia o nome do agente do primeiro # Heading. Se nenhum cabeçalho for encontrado, derive o nome do nome do arquivo (remova .md, substitua hifens 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 a execução de claude agents e a sondagem dos locais de arquivo, informe o usuário: "Nenhum agente encontrado. Execute claude agents para verificar sua configuração." Em seguida, pare.

Etapa 2: Apresentar Menu de Domínio

Available agent domains:
1. Engineering — Software Architect, Security Engineer
2. Marketing — SEO Specialist
3. Sales — Discovery Coach, Outbound Strategist

Pick domains or name specific agents (e.g., "1,3" or "security + seo"):

• Ignorar domínios com zero agentes (diretórios vazios)
• Mostrar contagem de agentes por domínio

Etapa 3: Lidar com a Seleção

Aceitar entrada flexível:

• Números: "1,3" seleciona todos os agentes de Engenharia e Vendas
• Nomes: "segurança + seo" corresponde de forma aproximada aos agentes descobertos
• "todos de engenharia" seleciona todos os agentes nesse domínio

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

Confirmar seleção: ```