🔒 MENTORIA FUNNEL LABS I.A. · MATERIAL EXCLUSIVO DOS MEMBROS · PROIBIDO COMPARTILHAR, REDISTRIBUIR OU REVENDER
Quickstart · 5 minutos

Do download ao primeiro agente
em 5 minutos.

Guia passo-a-passo para instalar a Agent Factory no seu Claude Code e fabricar o seu primeiro agente validado.

Pré-requisitos

Você precisa do Claude Code CLI instalado (claude.ai/code) e acesso ao seu projeto local. A Agent Factory roda 100% local — nada sobe pra cloud.

Passo 1 · Baixar o squad

Baixe o .zip na página de download e extraia em ~/.claude/ (instalação global) ou na pasta do seu projeto:

cd ~/meus-projetos/
unzip agent-factory.zip -d agent-factory/
cd agent-factory/

Estrutura esperada:

agent-factory/
├── .claude/
│   ├── commands/agent-factory.md  # Slash command
│   └── CLAUDE.md
├── agents/                         # 5 agentes da fábrica
│   ├── factory-chief.md
│   ├── architect.md
│   ├── promptsmith.md
│   ├── skillforger.md
│   └── qa-sentinel.md
├── templates/                      # 4 moldes
├── checklists/                     # Validações
├── workflows/                      # Pipeline 7 etapas
├── tasks/                          # Tarefas atomicas
├── data/                           # Frameworks documentados
└── README.md

Passo 2 · Abrir no Claude Code

Dentro da pasta do squad, rode:

claude

O Claude Code automaticamente detecta .claude/ e carrega o slash command /agent-factory. Confirme com:

/agent-factory status

Resposta esperada: 5 agentes ativos + 4 templates carregados + pipeline 7 etapas pronto.

Passo 3 · Briefing do primeiro agente (2 min)

Para fabricar um agente novo, invoque:

/agent-factory create-agent

O @factory-chief faz triage com 3 perguntas-chave:

  1. Qual o objetivo do agente? (ex: "atendimento ao cliente em e-commerce de moda")
  2. Qual o input típico? (ex: "mensagem do cliente no WhatsApp")
  3. Qual o output esperado? (ex: "resposta humanizada + tag de intenção + handoff se necessário")

Sem briefing → sem fabricação. O @factory-chief recusa instruções vagas (ex: "cria um agente legal").

⚠️ Briefing raso = agente raso

Se você descreve o agente como "agente de vendas", a fábrica vai pedir mais detalhe: vende pra quem? B2B ou B2C? Que produto? Que objeção mais comum? Cada lacuna no briefing vira lacuna no agente final. Invista 5 minutos no briefing pra economizar 2 horas de retrabalho.

Passo 4 · Pipeline automatizado (10 min)

Após o briefing, o pipeline roda em 7 etapas:

  1. @factory-chief — Briefing + triage
  2. @factory-chief — Research (web search dos frameworks aplicáveis)
  3. @architect — Architecture (6-level structure)
  4. @promptsmith — Persona + voice DNA
  5. @skillforger — Skill + commands + tasks
  6. @qa-sentinel — QA (smoke tests + checklist)
  7. @factory-chief — Delivery (pacote final + instruções)

Output esperado: pasta com agente.md (preenchido nos 6 níveis) + SKILL.md (formato Anthropic) + commands + tasks + checklist de validação aprovado.

Passo 5 · Fabricar uma skill standalone

Se você só precisa de uma skill (sem agente), use:

/agent-factory create-skill

O @skillforger entra direto, pula architecture/persona, e entrega SKILL.md no formato oficial Anthropic com frontmatter completo (name, description, when to use, examples). Tempo: 4 minutos.

Passo 6 · Fabricar um squad multi-agente

Se você precisa de um time (3-10 agentes coordenados), use:

/agent-factory create-squad

O pipeline expande: @factory-chief faz briefing do squad inteiro, define agentes (orchestrator + especialistas + suporte), @architect desenha routing matrix, @promptsmith escreve persona de cada um, @skillforger cria skills compartilhadas, @qa-sentinel valida coordenação. Tempo: 25-40 minutos.

Passo 7 · Validar agente existente

Se você já tem um agente e quer auditar, use:

/agent-factory validate-agent caminho/do/agente.md

O @qa-sentinel roda checklist de 8 critérios + smoke tests + identifica lacunas. Output: relatório de qualidade (score 0-100) + lista de correções priorizadas.

Comandos essenciais

ComandoO que faz
/agent-factory create-agentFabrica agente completo (7 etapas)
/agent-factory create-skillFabrica skill standalone (4 etapas)
/agent-factory create-squadFabrica squad multi-agente coordenado
/agent-factory validate-agentAudita agente existente (score 0-100)
/agent-factory list-templatesLista os 4 moldes disponíveis
/agent-factory statusMostra estado da fábrica + agentes ativos

Próximos passos

📘 APRENDER

Metodologia completa

Entenda o pipeline 7 etapas, os 6 níveis da arquitetura e os 4 frameworks aplicados.

Ver metodologia →

🧠 CONHECER

Os 5 agentes

O que cada agente faz, quando chamar e como eles se conectam no pipeline.

Ver agentes →

⚙️ APLICAR

Skills da fábrica

Templates, checklists, smoke tests e frameworks documentados.

Ver skills →

Problemas comuns

"Claude Code não reconhece /agent-factory"

Verifique se você está dentro da pasta agent-factory/ ao rodar claude. A pasta .claude/ precisa estar na raiz do projeto aberto. Alternativa: instale globalmente em ~/.claude/.

"O agente fabricado ficou genérico"

Sintoma de briefing raso. Releia o passo 3 — descreva persona específica, exemplos reais de input, edge cases que você quer cobrir. A fábrica entrega o que você pede; se você pede "agente legal", ela entrega "agente legal" (raso por construção).

"QA reprova meu agente direto"

Normal nas primeiras 2-3 fabricações. Leia o relatório do @qa-sentinel: aponta exatamente quais dos 8 critérios falharam (ex: "examples ausentes", "edge cases não cobertos", "voice DNA inconsistente"). Itera o briefing com base no feedback.

"Como atualizar a fábrica?"

Baixe a nova versão do .zip e substitua as pastas .claude/, agents/, templates/ e workflows/. Seus agentes fabricados ficam em pastas separadas e são preservados.