Do download ao primeiro squad em produção.
Roteiro estruturado de 90 dias. Saída do iniciante (1 agente fabricado) ao avançado (squad completo entregue pra cliente). Cada fase com objetivo, entregável e métrica de sucesso.
Fase 01 · Primeiros 30 dias
Objetivo: dominar a fábrica
Fabricar pelo menos 5 agentes pra escolas diferentes (atendimento, vendas, conteúdo, suporte, automação). Aprender o pipeline na prática.
SEMANA 01
Setup + primeiro agente
Instalar a fábrica, ler o quickstart, fabricar o primeiro agente seguindo o passo-a-passo. Objetivo: ter 1 agente rodando localmente, mesmo que simples. Métrica: /agent-factory status mostra 1 agente fabricado + score >= 80.
SEMANA 02
3 agentes diferentes
Fabricar 3 agentes em domínios diferentes (ex: atendimento, copywriting, qualificação de lead). Comparar diferenças entre os pipelines. Identificar onde a fábrica te corrige briefing raso. Métrica: 3 agentes com QA aprovado.
SEMANA 03
1 skill standalone + integração
Fabricar 1 skill (ex: "extrair dados de PDF de nota fiscal", "gerar headline AIDA", "validar formato de email"). Integrar a 1 dos agentes da semana 02. Aprender quando skill > agente. Métrica: skill instalada em ~/.claude/skills/ e funcionando.
SEMANA 04
Validar 1 agente existente seu
Pegar 1 agente que você já tinha (de outro squad, outro projeto) e rodar /agent-factory validate-agent. Ler o relatório do @qa-sentinel. Aplicar correções. Reaproveitar o trabalho. Métrica: agente legado com score >= 80.
Fase 02 · Dias 31-60
Objetivo: fabricar squad multi-agente
Sair da fabricação pontual (1 agente) e ir pra coordenação (squad com 3-5 agentes que se conversam). Aprender routing, handoff, shared state.
SEMANA 05-06
Squad de 3 agentes (mini-squad)
Usar /agent-factory create-squad pra fabricar squad com 3 agentes (orchestrator + 2 especialistas). Tema sugerido: squad de atendimento (orchestrator + closer + escalation). Métrica: squad rodando com handoff funcional.
SEMANA 07-08
Squad de 5+ agentes (squad completo)
Subir pra squad maior (orchestrator + 3 especialistas + 1 validador). Tema sugerido: squad de produção de conteúdo (orchestrator + pesquisador + copywriter + designer-prompt + revisor). Métrica: squad com routing matrix documentada e workflow rodando end-to-end.
Fase 03 · Dias 61-90
Objetivo: entregar squad pra cliente real
Sair do laboratório e ir pra produção. Fabricar squad pra cliente da sua agência ou pra um caso de uso da sua empresa. Validar fora do ambiente controlado.
SEMANA 09-10
Briefing real + research aprofundado
Cliente real = briefing real. Coletar input/output reais, edge cases observados em produção, persona do usuário final. Rodar pipeline com dados reais — não exemplo de aula. Métrica: briefing completo aprovado pelo cliente antes de fabricar.
SEMANA 11
Fabricação + iteração
Rodar o pipeline. Apresentar primeira versão pro cliente. Coletar feedback. Refinar persona com /agent-factory refine-persona. Refinar arquitetura com /agent-factory refine-architecture. Métrica: 2-3 iterações até aprovação.
SEMANA 12
Deploy + handoff pro cliente
Empacotar o squad (zip), entregar instruções de instalação, documentar workflow do cliente, treinar quem vai operar. Métrica: cliente operando o squad sozinho 7 dias depois sem te chamar.
Métricas de progresso
| Marco | Quando | Sinal de que tá no caminho |
|---|---|---|
| Primeiro agente fabricado | Dia 1-7 | Score >= 80 no QA |
| 5 agentes fabricados | Dia 30 | Pipeline conhecido sem consulta |
| Primeiro squad multi-agente | Dia 45 | Handoff funcionando entre 3 agentes |
| Squad completo (5+ agentes) | Dia 60 | Routing matrix documentada e validada |
| Primeiro squad pra cliente real | Dia 90 | Cliente operando autônomo |
Erros comuns por fase
⚠️ Fase 01 — pular o briefing
Sintoma: agentes saem genéricos. Causa: briefing raso ("agente de vendas"). Correção: invista 5 minutos no briefing pra economizar 2 horas de retrabalho.
⚠️ Fase 02 — squad sem routing matrix
Sintoma: agentes do squad pisam um na chamada do outro. Causa: routing matrix vaga ou ausente. Correção: documentar explicitamente quem entra primeiro pra cada tipo de pedido.
⚠️ Fase 03 — entregar sem treinar cliente
Sintoma: cliente abandona o squad em 2 semanas. Causa: handoff técnico sem capacitação. Correção: 1 hora de treinamento + documentação de operação cliente-amigável.
Pra continuar evoluindo (Dia 90+)
Os papers originais
Ler o ReAct paper (Shunyu Yao), os blogs do Andrew Ng e da Anthropic, e o livro do Simon Willison. Entender PORQUÊS, não só COMOs.
Padrões avançados
Multi-agent communication, evaluator-optimizer loops, tool use planejado, reflection autônoma. A fábrica suporta — você precisa pedir explicitamente no briefing.
Compartilhar no grupo
Trazer seus agentes/squads pro grupo da mentoria. Receber feedback. Auditar agente de outro membro. Aprender pela revisão.