Do download ao primeiro agente validado
Instale a Agent Factory no seu Claude Code e fabrique o primeiro agente com quality gate aprovado. Tudo 100% local — nada sobe pra cloud.
Pré-requisitos
Claude Code CLI instalado (claude.ai/code) e acesso ao seu projeto local.
cd ~/meus-projetos/
unzip agent-factory.zip -d agent-factory/
cd agent-factory/
Dentro vêm os 10 agentes (6 de criação/orquestração + a pasta brains/ com os
4 cérebros de domínio), templates, checklists, 21 workflows, 67 tasks e o slash command.
claude
# o Claude detecta .claude/ e carrega o /agent-factory
/agent-factory status
Resposta esperada: 10 agentes ativos, templates carregados, pipeline de 7 etapas e quality gate executável pronto.
/agent-factory create-agent
O @factory-chief pergunta: qual o objetivo do agente, qual o input típico e qual o output esperado. Instrução vaga ("cria um agente legal") é devolvida — sem briefing, sem fabricação.
Briefing raso = agente raso. Invista 5 minutos no briefing pra economizar 2 horas de retrabalho: vende pra quem? B2B ou B2C? Que objeção é a mais comum?
Depois do briefing, as 7 etapas rodam: research dos frameworks, arquitetura 6-level,
persona com voice DNA, SKILL.md + commands, quality gate executável e delivery. Sai uma pasta
com agente.md preenchido nos 6 níveis, skill no formato Anthropic e checklist de
validação aprovado.
/agent-factory create-skill
O @skillforger entra direto, pula arquitetura e persona, e entrega o SKILL.md com frontmatter completo em 4 minutos.
/agent-factory create-squad
O @squad-chief define a composição e a routing matrix, os cérebros de domínio entram conforme a necessidade — inclusive o staff-engineer pra squads técnicos de engenharia — e o @qa-sentinel fecha com o gate. Tempo: 25 a 40 minutos.
Prova real: o squad api-forge (constrói APIs backend), gerado pela própria fábrica, passou no gate com score A+ (9,43/10).
/agent-factory validate-agent caminho/do/agente.md
O @qa-sentinel roda o gate no seu agente legado e devolve relatório com score e correções priorizadas.
Problemas comuns
Verifique se você está dentro da pasta agent-factory/ ao rodar claude — a .claude/ precisa estar na raiz do projeto aberto. Alternativa: instalar global em ~/.claude/.
Sintoma de briefing raso. Descreva persona específica, exemplos reais de input e edge cases. A fábrica entrega o que você pede.
Normal nas primeiras fabricações. O relatório aponta o que falhou: examples ausentes, dependência não declarada, acentuação incorreta, voice DNA inconsistente. Itere o briefing com base no feedback.
Baixe a nova versão e substitua .claude/, agents/, templates/ e workflows/. Seus agentes fabricados ficam em pastas separadas e são preservados.