~/VibeHandbook
PDF grátis

Ferramentas de agente

docs.claude.com

Subagentes

O que é

Pense em um gerente que passa uma tarefa específica para um assistente temporário: o assistente a executa, reporta o resultado e vai embora. Um subagente é esse assistente temporário — um agente de IA separado que seu agente principal pode criar para cuidar de uma parte específica do trabalho. Ele roda no próprio contexto (seu próprio espaço de trabalho e memória, separados) com suas próprias instruções, faz o trabalho e reporta um resultado. Como cada subagente começa do zero, a conversa principal permanece limpa — os detalhes de uma tarefa secundária não atrapalham o trabalho que realmente importa.

Pontos fortes

  • Mantém o contexto principal desimpedido ao transferir tarefas secundárias cheias de detalhes.
  • Permite rodar trabalhos independentes em paralelo, o que pode ser muito mais rápido.
  • Cada subagente pode ser especializado — um revisor, um pesquisador, um testador — com seu próprio focado.
  • As falhas ficam contidas: um subagente que dá errado não desvia a sessão inteira.

Contrapartidas

  • Um subagente só sabe o que você passa a ele; contexto faltando leva a resultados fora do alvo.
  • Criar muitos agentes custa mais tokens (os pedaços de texto que os modelos leem e pelos quais são cobrados) e pode ficar caro.
  • Você só recebe o resumo de volta, então nuances da tarefa secundária podem se perder.
  • Coordenar vários ao mesmo tempo adiciona sua própria complexidade.

Quando usar

Use subagentes quando uma tarefa é autocontida e, de outra forma, sobrecarregaria a conversa principal — pesquisar em uma base de código grande, revisar um diff, ou rodar várias investigações independentes ao mesmo tempo.

Encaixe no vibe coding

Subagentes são como você escala a atenção de um agente. Passe o trabalho barulhento e exploratório — "encontre todos os lugares onde isso é usado", "revise isso em busca de bugs" — para um subagente e mantenha o agente principal focado no plano. Seja explícito sobre o que cada subagente deve retornar, já que você recebe a conclusão dele, não a transcrição completa.

Spawn a review subagent:
  task: "Review the diff in src/auth for security issues."
  return: "A short list of concrete problems, or 'no issues found'."