Do squad instalado ao software 10x melhor.
Roteiro de 90 dias para sair de "instalei o squad" para "código de produção entregue com quality gate aprovado, security audit OK, performance dentro dos SLOs". Cada fase com objetivo, métrica e entregável.
Fase 01 · Primeiros 30 dias
Objetivo: dominar o pipeline padrão
Cada feature passar pelo @engineering-chief. Cada PR ser revisada pelo @code-reviewer. Cada deploy ser checado pelo /deploy-check. Sem exceção.
SEMANA 01
Setup + primeira feature
Instalar global em ~/.claude/. Confirmar 42 agentes carregados. Implementar 1 feature simples (CRUD endpoint, página com form, etc). Métrica: feature mergeada com /code-quality-gate aprovado.
SEMANA 02
3 features + primeiros hooks ativados
3 features de complexidade crescente. Ativar hooks: secret-scanner, type-check, auto-test. Observar quanta dor evitam (commits bloqueados por hooks são commits salvos). Métrica: 0 secrets em git history.
SEMANA 03
Primeiro security audit + perf audit
Rodar /security-audit e /perf-audit em código existente. Ler relatórios. Aplicar 3 correções de cada relatório. Aprender a calibrar severidade. Métrica: 0 vulnerabilidades CRITICAL/HIGH abertas.
SEMANA 04
Primeira simulação de incidente
Simular incidente (force erro em staging). Rodar /incident-triage. Mitigar, escrever RCA, postmortem blameless. Métrica: documento postmortem salvo em docs/incidents/ com ação corretiva clara.
Fase 02 · Dias 31-60
Objetivo: eficiência operacional
Sair do "uso o squad pra cada coisa" pra "uso o squad onde gera ROI alto". Aprender a identificar quando vale skip ceremony e quando vale full pipeline.
SEMANA 05-06
Multi-agent paralelo
Tarefa grande com 3+ partes independentes. Usar @multi-agent-coordinator pra orquestrar paralelo. Aprender file ownership boundaries (zero conflito de merge). Métrica: 1 feature complexa entregue em metade do tempo via paralelo.
SEMANA 07-08
Custom rules + custom skills
Criar 1-2 rules customizadas pro seu projeto (ex: "todo endpoint /api/* tem rate limit", "toda migration tem comentário explicando o porquê"). Adicionar em ~/.claude/rules/. Métrica: rules ativas e enforcadas pelo @code-reviewer.
Fase 03 · Dias 61-90
Objetivo: autonomia + ensinar o squad
Você não consulta mais documentação do squad — você ensina alguém. Adiciona contexto que deveria estar e não está. Customiza pro seu domínio.
SEMANA 09-10
Adicionar contextos customizados
Criar 2-3 contextos pré-loaded para áreas frequentes do seu produto (ex: "checkout flow", "auth system", "billing"). Específicos pro seu domínio. Métrica: novo agente entra no projeto e tem contexto em < 5 min.
SEMANA 11
Workflow customizado
Documentar workflow específico do seu time (ex: "incident em horário comercial vs fora", "feature flag rollout protocol"). Adicionar em workflows/. Métrica: workflow rodável por novo membro do time sem treinamento.
SEMANA 12
Operação contínua + métricas
Painel de métricas: quantas features passaram pelo quality gate, quantos incidentes evitados pelo security-scan, quantas queries otimizadas. ROI mensurável da operação. Métrica: relatório mensal de impacto do squad.
Métricas de progresso
| Marco | Quando | Sinal de que tá no caminho |
|---|---|---|
| Primeira feature com pipeline completo | Dia 1-7 | /code-quality-gate aprovado |
| Hooks ativos em projeto real | Dia 14 | 0 secrets em git, 100% commits conventional |
| Primeiro security audit fechado | Dia 21 | 0 vulnerabilidades CRITICAL/HIGH |
| Primeiro postmortem blameless | Dia 30 | Doc com root cause + action items |
| Multi-agent paralelo dominado | Dia 45 | 1 feature grande entregue em metade do tempo |
| Rules e contextos customizados | Dia 75 | 2+ rules customizadas enforcadas |
| Operação autônoma | Dia 90 | Time inteiro usando squad sem te chamar |
Erros comuns por fase
⚠️ Fase 01 — chamar specialist sem chief
Sintoma: code review reprovando entregas. Causa: pulou quality gate ao chamar @nextjs-developer direto. Correção: SEMPRE @engineering-chief primeiro.
⚠️ Fase 02 — paralelizar tudo
Sintoma: race conditions, conflitos de merge, output inconsistente. Causa: paralelizou tarefas com dependência. Correção: paralelizar SÓ tarefas independentes (file ownership boundaries claros).
⚠️ Fase 03 — over-customizar
Sintoma: rules contraditórias, agentes em loop, performance degrada. Causa: adicionou rules sem testar interação com as existentes. Correção: testar cada rule isolada antes de combinar.
Pra continuar evoluindo (Dia 90+)
Frameworks aplicados
Building Effective Agents (Anthropic), Agentic Patterns (Andrew Ng), papers de AI engineering. Entender PORQUÊS dos workflows.
Multi-LLM strategy
Usar Opus pra triagem complexa, Sonnet pra implementação, Haiku pra checks rápidos. Otimizar custo/qualidade.
Compartilhar customizações
Trazer rules/skills/workflows customizados pro grupo da mentoria. Receber feedback. Auditar squad de outro membro.