O que vocĂŞ vai aprender
De "nunca criei um subagente" a "monto e orquestro meu prĂłprio sistema de especialistas". Sete resultados concretos:
Explicar a diferença entre agente, subagente e skill e escolher a primitiva certa.
Articular o motivo real dos subagentes (proteção de contexto) e aplicar a "pergunta que decide".
Criar um subagente custom do zero: frontmatter + corpo, com descrição que dispara sozinha.
Restringir ferramentas (read-only) e escolher entre projeto Ă— global.
Casar modelo com tarefa (Haiku/Sonnet/Opus) e montar o padrĂŁo "chefe inteligente + trabalhadores baratos".
Orquestrar encadeamentos, revisor imparcial e workflows dinâmicos — com noção de custo.
Levar o conceito para outros ambientes/modelos (Codex, cross-runtime) e montar sua própria biblioteca de especialistas com segurança.
As 4 trilhas
Cada trilha tem 6 mĂłdulos com desenho, exemplo .md, prompts prontos e exercĂcio. Siga em ordem ou pule pra onde precisa.
🌱 Fundamentos
Entender antes de criar
- M1.1 · O que é um subagente
- M1.2 · O verdadeiro motivo: contexto limpo
- M1.3 · Agente × Subagente × Skill
- M1.4 · Built-in × Custom
- M1.5 · A pergunta que decide
- M1.6 · Anatomia de um subagente
🛠️ Criando na prática
Do .md ao especialista
- M2.1 · O frontmatter completo
- M2.2 · A descrição é o gatilho
- M2.3 · O corpo é o cérebro
- M2.4 · Ferramentas e permissões
- M2.5 · Projeto × Global
- M2.6 · Criando com /agents
⚙️ Modelo, custo e orquestração
Chefe inteligente, trabalhadores baratos
- M3.1 · Modelo por tarefa
- M3.2 · A economia real
- M3.3 · Encadeando subagentes
- M3.4 · O revisor imparcial
- M3.5 · Workflows dinâmicos
- M3.6 · Padrões de orquestração
🚀 Avançado & cross-ambiente
Além do Claude Code
- M4.1 · Arquitetura multiagente em escala
- M4.2 · Subagentes no Codex e outros
- M4.3 · Comparando modelos por papel
- M4.4 · Segurança
- M4.5 · Bibliotecas e reuso
- M4.6 · Montando seu sistema
🧠Resumo em uma tela
A decisão inteira sobre subagentes, condensada. Guarde isto — é o curso em nove bullets.
Uma coisa rápida → faça direto no chat.
Tarefa pesada ou barulhenta → subagente.
Compartilhar com a equipe → .claude/agents/ no repo.
Manter só para você → ~/.claude/agents/ na home.
Economizar dinheiro → trabalhadores baratos, um lĂder inteligente.
Melhores resultados → deixe um agente novo revisar seu trabalho.
Tarefa gigante em paralelo → workflow dinâmico (cuidado com a conta).
Não tem certeza? → "É uma pilha que eu nunca vou reler?" Se sim, subagente.
Crie seu primeiro em segundos: digite /agents.