Você chegou ao final da trilha — e do curso. Agora não é hora de aprender mais conceitos: é hora de montar o seu sistema. Neste módulo você vai construir sua biblioteca pessoal de subagentes, partir de um pacote inicial pronto, aprender os templates que economizam horas e revisar em uma tela tudo que o curso ensinou. No fim, um projeto final: criar sua própria suíte de agentes do zero.
Conteúdo detalhado
🗄️ Sua biblioteca de especialistas
Agentes são arquivos. Arquivos se organizam. Organização vira poder.
O que é
Uma biblioteca de especialistas é um conjunto de arquivos .md com definições de subagentes que você mantém e evolui. Cada arquivo é um "funcionário" com nome, escopo, ferramentas e restrições bem definidos. A biblioteca fica em dois lugares: ~/.claude/agents/ (disponível em todos os projetos) e .claude/agents/ dentro de cada projeto (específica do repositório).
Por que montar sua biblioteca
- ▸Evita reescrever o mesmo sistema prompt toda vez — chame o agente pelo nome
- ▸Agentes bem definidos cometem menos erros de escopo — sabem o que não devem fazer
- ▸Evolui com o tempo: corrija um agente ruim uma vez e todos os projetos se beneficiam
- ▸Equipes podem compartilhar a biblioteca via git — padrão organizacional emergente
Conceitos-chave
📦 Pacote inicial — 5 agentes para começar hoje
security-auditor · test-runner · doc-writer · db-expert · plan-roaster
O que é
Um conjunto de cinco agentes que cobre os casos de uso mais comuns em desenvolvimento de software. Eles são genéricos o suficiente para qualquer stack, mas específicos o suficiente para serem úteis sem personalização. Copie, ajuste os detalhes do seu projeto (nomes de banco, frameworks, convenções de teste) e você tem uma suíte funcional em minutos.
Por que esses cinco
Conceitos-chave
- ✓Ferramentas mínimas (só o necessário)
- ✓Restrições explícitas ("nunca executa X")
- ✓Escopo bem delimitado por agente
- ✓Formato de saída especificado
- ✗Agentes que fazem tudo (sem foco)
- ✗Permissões de escrita sem motivo
- ✗System prompts com mais de 200 linhas
- ✗Dependências circulares entre agentes
📐 Templates prontos para sua suíte
Frontmatter + corpo em minutos, não horas.
O que é
Um template de agente tem três partes: o frontmatter YAML (metadados que o Claude Code lê), o system prompt (como o agente deve se comportar) e os exemplos de uso (opcionais mas muito úteis). Um bom template é um atalho para novos agentes — você preenche as partes variáveis e tem um agente funcional em 5 minutos.
Por que usar templates
- ▸Consistência: todos os agentes da suíte têm a mesma estrutura de saída
- ▸Velocidade: novo agente em 5 min sem pensar na estrutura
- ▸Onboarding: colaborador novo entende a convenção sem documentação extra
Conceitos-chave — anatomia do template
✅ Checklist de produção
Antes de colocar um agente em uso real, passe por esta lista.
O que é
Um checklist é o último filtro antes de um agente virar parte da sua biblioteca permanente. Cobre segurança (ferramentas mínimas, sem permissões desnecessárias), qualidade (system prompt claro, formato de saída definido) e operação (quem chama, quando, o que acontece se falhar).
Por que usar um checklist
Bash sem restrição de subprocessos podem criar loops ou consumir recursos inesperadamente. Sempre teste em ambiente isolado primeiro.Conceitos-chave — o checklist resumido
🔀 Projeto × Global na prática
O que vai para ~/.claude/ e o que fica em .claude/?
O que é
O Claude Code resolve agentes em dois escopos: global (~/.claude/agents/) e local (.claude/agents/ do projeto). Se um agente existe nos dois lugares com o mesmo nome, o local sobrescreve o global — permitindo "sobrescrever" especialistas genéricos com versões adaptadas ao projeto sem remover o global.
Por que isso importa na prática
- • security-auditor genérico
- • doc-writer universal
- • plan-roaster padrão
- • Agentes de uso pessoal constante
- • db-expert da stack do projeto
- • test-runner com o framework certo
- • style-reviewer do guia do time
- • Agentes específicos do domínio
Conceitos-chave
🧠 Recap geral — o curso em uma tela
Tudo que importa, em frases de uma linha.
O que é
Este é o slide 18 — a tela de encerramento do curso. Cada regra abaixo resume um conceito inteiro que você estudou. Se uma delas soar estranha, é sinal de qual módulo revisitar. Se todas fizeram sentido imediato, você terminou o curso com o mapa mental certo.
🤖 Subagentes: o que fica
.claude/agents/
~/.claude/agents/
— fim do curso · AutomationsAI/subagentes —
Por que recap em uma tela funciona
- ▸Mapa mental compacto — quando em dúvida no trabalho real, releia as 8 regras
- ▸Cada regra aponta para módulos do curso para aprofundamento
- ▸Facilita compartilhar o aprendizado com um colega em minutos
🚀 Próximos passos
O que fazer depois que o curso terminar.
O que é
O curso deu o mapa. Os próximos passos são o território. A prática real com subagentes acontece em projetos reais — com erros reais, iterações e descobertas que nenhum curso pode simular. Esta seção aponta onde ir a partir daqui.
Por que agir imediatamente importa
O conhecimento de subagentes decai rápido se não for aplicado. A janela de melhor assimilação é as primeiras 48h após o curso. Use esse momentum.
Conceitos-chave — onde continuar
📄 Exemplo real — pacote de 5 agentes (.md)
Cinco arquivos prontos para copiar para ~/.claude/agents/ ou .claude/agents/:
# ~/.claude/agents/security-auditor.md --- name: security-auditor description: Audita código em busca de vulnerabilidades de segurança. Use para revisar PRs críticos, módulos de autenticação, inputs de usuário. NÃO use para refatoração. tools: - Read - Bash # somente leitura — sem escrita de arquivo disallowedTools: - Write - Edit --- # Security Auditor Você é um especialista em segurança de aplicações. Sua única função é revisar código e apontar vulnerabilidades. ## O que você faz - Identifica SQL injection, XSS, CSRF, secrets expostos, dependências com CVE - Classifica cada achado: CRÍTICO / ALTO / MÉDIO / BAIXO - Sugere correção específica para cada achado ## O que você NÃO faz - Não modifica arquivos - Não sugere refatoração fora do escopo de segurança - Não executa código de produção ## Formato de saída ```markdown ## Relatório de Segurança — [arquivo/PR] ### Achados | Severidade | Linha | Descrição | Correção sugerida | ```
# ~/.claude/agents/test-runner.md --- name: test-runner description: Roda suítes de teste, interpreta falhas e sugere correções. Ideal para CI debug e TDD. Use ANTES de mergear. tools: - Bash - Read disallowedTools: - Write - Edit --- # Test Runner Roda testes, lê a saída e explica cada falha em linguagem humana. Sugere correção mas não aplica. ## Regras - Rode sempre com `--no-coverage` para velocidade na primeira passagem - Agrupe falhas por módulo (não por arquivo) - Priorize: build breaks > falhas de lógica > warnings
# ~/.claude/agents/doc-writer.md --- name: doc-writer description: Gera documentação técnica (JSDoc, docstrings, README, CHANGELOG). Use após implementação. NÃO faz refatoração. tools: - Read - Write # só para arquivos de documentação (.md, comentários) --- # Doc Writer Especialista em documentação técnica. Lê código e gera docs claros, concisos e atualizados. ## Convenções - JSDoc para funções públicas - Docstrings para funções com lógica não-óbvia - README: instalação, uso, exemplos mínimos - CHANGELOG: formato Keep a Changelog
# .claude/agents/db-expert.md (local — adapte ao projeto) --- name: db-expert description: Especialista em banco de dados do projeto. Revisa queries, migrations e índices. NÃO executa DDL/DML. tools: - Read - Bash # apenas queries SELECT em banco de dev disallowedTools: - Write --- # DB Expert — [nome do projeto] Stack: PostgreSQL 15, Prisma ORM, ambiente dev em localhost:5432. ## O que faço - Analiso N+1, missing indexes, cartesian products - Reviso migrations antes do deploy - Explico planos de execução (EXPLAIN ANALYZE) ## Formato de resposta Para cada problema: impacto estimado + query corrigida + índice sugerido.
# ~/.claude/agents/plan-roaster.md --- name: plan-roaster description: Critica planos de implementação com ceticismo construtivo. Use antes de qualquer tarefa complexa. NÃO modifica código. tools: - Read disallowedTools: - Write - Edit - Bash --- # Plan Roaster Você é o advogado do diabo técnico. Lê planos e aponta o que vai dar errado. ## Como você opera 1. Lê o plano completo 2. Lista suposições implícitas (as mais perigosas) 3. Aponta pontos de falha: edge cases, dependências externas, rollback difícil 4. Sugere perguntas que o autor deveria responder antes de começar ## Tom Direto e útil. Não pessimista por natureza — só realista.
💬 Prompts prontos
Analise este projeto e crie para mim 5 subagentes personalizados para .claude/agents/. Para cada um: identifique o papel que mais falta, defina ferramentas mínimas e restrições explícitas. Formato: um bloco de código por arquivo .md, pronto para copiar. Comece pelo mais impactante.
Leia o arquivo .claude/agents/[nome].md e aplique o checklist de produção: ferramentas são mínimas? restrições explícitas? escopo claro em 30s? formato de saída definido? Aponte problemas e sugira versão corrigida.
Usando os subagentes disponíveis (security-auditor, test-runner, doc-writer, db-expert, plan-roaster), monte um workflow para revisão completa antes de PR: rode os agentes relevantes em paralelo, colete resultados e gere um relatório unificado com ações prioritárias. Comece pelo plano antes de executar.
Projeto Final
Desenhe e crie sua própria suíte de subagentes
O que fazer
- Escolha um projeto real que você tem ou está desenvolvendo.
- Identifique os 3 gargalos recorrentes no seu workflow (exemplos: "reviso segurança manualmente", "testo na mão", "demouro muito para documentar").
- Para cada gargalo, projete um subagente: nome, ferramentas, restrições, formato de saída.
- Crie os arquivos
.mdem.claude/agents/do projeto. - Teste cada agente em um caso real e documente o que funcionou e o que ajustou.
- Escreva um parágrafo: "Minha suíte faz X. Antes eu demorava Y. Agora levo Z."
✓ Critérios de conclusão
- ✓≥ 3 arquivos .md criados e funcionais
- ✓Cada agente passou pelo checklist de produção
- ✓Cada agente testado em caso real (não simulado)
- ✓Parágrafo de impacto escrito e honesto
- ✓Pelo menos 1 agente commitado no repositório
✗ O exercício não vale se
- ✗Os agentes foram apenas imaginados, não criados
- ✗Nenhum foi testado com tarefa real
- ✗O "projeto" é um hello world criado só para o exercício
- ✗O parágrafo de impacto foi gerado por IA sem revisão honesta
Você concluiu o curso Subagentes!
Você foi de "o que é um subagente" até montar sua própria fábrica de especialistas. Esse é um dos conjuntos de habilidades mais valiosos do desenvolvimento com IA em 2026 — e você tem o mapa completo.
"Um subagente bem feito é um colega que nunca esquece, nunca cansa e nunca ultrapassa seu escopo."
— Princípio central do curso