Do download ao primeiro agente
em 5 minutos.

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/                         # 10 agentes da fábrica
│   ├── factory-chief.md            # entry point / orquestração
│   ├── squad-chief.md              # orquestração de squad
│   ├── architect.md
│   ├── promptsmith.md
│   ├── skillforger.md
│   ├── qa-sentinel.md              # quality gate executável
│   └── brains/                     # 4 cérebros de domínio
│       ├── mind-extractor.md
│       ├── process-designer.md
│       ├── growth-strategist.md
│       └── staff-engineer.md       # engenharia de software real (NOVO)
├── templates/                      # moldes de referência
├── checklists/                     # validações do quality gate
├── workflows/                      # 21 workflows encadeados
├── tasks/                          # 67 tasks executáveis
├── data/                           # frameworks + minds destilados
└── 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: 10 agentes ativos (6 de criação/orquestração + 4 cérebros de domínio) + templates carregados + pipeline 7 etapas + quality gate executável 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").

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 (skills reais nos squads técnicos)
6. @qa-sentinel — Quality gate executável (naming, deps, segurança, qualidade, acentuação, score)
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 (marketing ou engenharia)

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, @squad-chief define a composição e a routing matrix, @architect desenha a estrutura, @promptsmith escreve persona de cada um (com os cérebros de domínio injetados conforme a necessidade), @skillforger cria as skills — incluindo as 11 skills de engenharia reais nos squads técnicos — e o @qa-sentinel roda o quality gate. Agora dá pra criar squad técnico de engenharia premium, não só de marketing/conteúdo. 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 o quality gate executável (naming, dependências, segurança, qualidade, acentuação PT, score) + identifica lacunas. Output: relatório de qualidade + lista de correções priorizadas.

Comandos essenciais

Próximos passos

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).

"O quality gate bloqueia meu agente direto"

Normal nas primeiras 2-3 fabricações. Leia o relatório do @qa-sentinel: aponta exatamente o que falhou no gate (ex: "examples ausentes", "dependência não declarada", "acentuação PT incorreta", "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.