Meta Agent Expert: Gerador de Agents Especialistas

Proposito

Este skill cria agents experts que tem dominio profundo sobre partes especificas da codebase. Cada agent gerado:

1. Conhece sua area: Tem um knowledge base com os arquivos que domina
2. Tem sub-comandos: Operacoes especializadas que pode executar
3. Pode chamar outros agents: Integra com outros experts quando necessario
4. Usa /question: Explora a codebase para responder perguntas da sua area

Estrutura Gerada

.claude/commands/experts/
  <nome-do-agent>/
    <nome-do-agent>.md       # Comando principal do agent
    question.md              # [OBRIGATORIO] Question especializado para esta area
    sync.md                  # [OBRIGATORIO] Auto-atualizacao do knowledge base
    sub-comando-1.md         # Sub-comandos especializados
    sub-comando-2.md
    KNOWLEDGE.md             # Base de conhecimento do agent

Arquivos Obrigatorios

Todo agent expert DEVE ter:

1. <nome>.md: Comando principal
2. question.md: Responde perguntas focando apenas nos arquivos do knowledge base
3. sync.md: Atualiza o knowledge base quando o codigo muda
4. KNOWLEDGE.md: Lista de arquivos que o agent domina

Quando Usar

Use este skill quando:

• Precisar criar um novo agent expert para uma area da codebase
• Quiser automatizar operacoes especificas de um dominio
• Precisar de um "especialista" que conheca profundamente certos arquivos
• Quiser delegar tarefas complexas para agents focados

Workflow de Criacao

Passo 1: Coleta de Informacoes

Quando o usuario solicitar criar um agent, colete:

1. Nome do agent: kebab-case (ex: kanban-workflow, git-operations)
2. Area de dominio: Qual parte da codebase ele domina
3. Responsabilidades: O que esse agent deve saber fazer
4. Sub-comandos desejados: Operacoes especificas (opcional - pode sugerir)

Passo 2: Discovery do Knowledge Base

Use o comando /question ou Task com subagent_type=Explore para descobrir:

1. Arquivos principais: Quais arquivos sao core para essa area
2. Padroes de codigo: Como o codigo esta organizado nessa area
3. Dependencias: Quais outros modulos essa area usa
4. Tipos e interfaces: Types relevantes para o dominio

Exemplo de discovery:

Prompt para Task/Explore: "Liste todos os arquivos relacionados a [AREA].
Inclua: models, routes, services, components, hooks, types.
Identifique os arquivos mais importantes e suas responsabilidades."

Passo 3: Geracao dos Arquivos

Gere os arquivos na seguinte ordem:

1. KNOWLEDGE.md: Base de conhecimento com paths e descricoes
2. <nome>.md: Comando principal do agent
3. question.md: [OBRIGATORIO] Question especializado para a area do agent
4. sync.md: [OBRIGATORIO] Auto-atualizacao do knowledge base
5. Sub-comandos: Arquivos .md para cada operacao especializada

Passo 4: Validacao

Apos gerar, valide:

• Frontmatter YAML valido em todos os arquivos
• Knowledge base com paths corretos
• question.md criado com foco nos arquivos do KNOWLEDGE.md
• sync.md criado com paths corretos para detectar mudancas
• Sub-comandos referenciados no comando principal
• Instrucoes claras de quando chamar cada sub-comando

Instrucoes de Geracao

Question Especializado (question.md) - OBRIGATORIO

Cada agent DEVE ter um question.md que:

1. Foca apenas nos arquivos do KNOWLEDGE.md
2. Nao modifica arquivos - apenas le e responde
3. Referencia o codigo real nas respostas
4. Diferente do /question global que consulta toda a codebase

Beneficio: Quando o usuario quer entender algo especifico da area do agent, o /[agent]/question da respostas mais precisas e focadas.

Sync/Auto-Atualizacao (sync.md) - OBRIGATORIO

Cada agent DEVE ter um sync.md que:

1. Detecta mudancas nos arquivos do knowledge base
2. Atualiza KNOWLEDGE.md quando arquivos sao criados/removidos/renomeados
3. Atualiza sub-comandos se paths mudaram
4. Mantem o agent sincronizado com a codebase atual

Beneficio: Quando o codigo evolui, o agent nao fica desatualizado. O usuario pode rodar /[agent]/sync para atualizar o knowledge base.

Comando Principal do Agent

O comando principal deve:

1. Ser o ponto de entrada para qualquer pergunta/tarefa da area
2. Ter acesso ao KNOWLEDGE.md para saber quais arquivos consultar
3. Decidir quando delegar para sub-comandos
4. Poder chamar /question para explorar a codebase
5. Poder chamar outros agents quando necessario

Sub-comandos

Cada sub-comando deve:

1. Ser focado em UMA operacao especifica
2. Poder ser chamado diretamente pelo usuario OU pelo agent principal
3. Ter seu proprio knowledge base subset (opcional)
4. Retornar resultado claro para o agent principal

Knowledge Base

O KNOWLEDGE.md deve conter:

1. Arquivos Core: Lista dos arquivos mais importantes
2. Estrutura: Como os arquivos se relacionam
3. Padroes: Convencoes de codigo da area
4. Dependencias: Outros modulos/agents relacionados

Exemplo de Uso

Solicitacao: "Crie um agent expert para o sistema de Kanban workflow"

Discovery:

Task(Explore): "Liste todos os arquivos relacionados ao Kanban workflow.
Inclua: componentes de board, cards, colunas, drag-drop, hooks de automacao,
API routes, models, services. Identifique responsabilidades de cada arquivo."

Arquivos Gerados:

.claude/commands/experts/kanban-workflow/
  kanban-workflow.md        # Comando principal
  validate-transition.md    # Valida transicoes entre colunas
  card-lifecycle.md         # Gerencia ciclo de vida dos cards
  automation-triggers.md    # Triggers de automacao por coluna
  KNOWLEDGE.md              # Knowledge base

Templates

Consulte o arquivo TEMPLATES.md para templates prontos de:

• Comando principal de agent
• Sub-comandos especializados
• Knowledge base
• Integracao entre agents

Integracao com Outros Agents

Quando um agent precisar de funcionalidade de outra area:

## Quando Chamar Outros Agents

- `/git-operations`: Quando precisar criar worktree ou fazer merge
- `/ai-execution`: Quando precisar executar comandos do Claude SDK
- `/metrics`: Quando precisar coletar ou consultar metricas

Checklist de Validacao

Antes de finalizar o agent:

• Nome segue padrao kebab-case
• KNOWLEDGE.md tem paths validos
• Comando principal referencia KNOWLEDGE.md
• question.md criado com allowed-tools: Read, Glob, Grep
• sync.md criado com processo de deteccao de mudancas
• Sub-comandos estao listados no comando principal
• Instrucoes de "quando chamar" estao claras
• Integracao com outros agents esta documentada (se aplicavel)