Workflows agênticos — Maestria6 / 8
Subagentes — Delegando Trabalho que Escala
Um contexto gigante fica lento e vago. Subagentes deixam o agente principal delegar trabalho focado para especialistas com seu próprio contexto e ferramentas — e executá-los em paralelo.
Uma única conversa que faz tudo eventualmente faz nada bem: o contexto se enche de exploração, e o agente fica mais lento e mais vago. Subagentes resolvem isso por delegação.
O que é um subagente
Um subagente é uma instância Claude separada com sua própria janela de contexto, prompt de sistema e lista de permissão de ferramentas. O agente principal lhe entrega uma tarefa; ele trabalha isoladamente e retorna apenas seu resultado — não seus passos intermediários.
Dois ganhos: isolamento de contexto (uma imersão profunda e pesada de leitura não polui sua linha principal) e paralelismo (subagentes independentes executam ao mesmo tempo).
Criando um
Execute /agents, ou coloque um arquivo em .claude/agents/:
---
name: code-reviewer
description: Reviews diffs for bugs and security issues. Use after writing code.
tools: Read, Grep, Glob, Bash
model: sonnet
---
You are a meticulous senior reviewer. Cite file and line, explain the
failure, propose a fix. Prefer fewer high-confidence findings.
O campo description é o gatilho
Claude lê description para decidir quando delegar automaticamente. Escreva como um gatilho:
- Vago:
"Reviews code."→ raramente auto-invocado. - Preciso:
"Use PROACTIVELY after any code change to review for bugs."→ invocado no momento certo.
Quando delegar — e quando não
- Delegue quando o trabalho é independente e paralelizável (N arquivos, N verificações), precisa isolamento de contexto, ou se beneficia de uma persona especializada.
- Não delegue quando a tarefa é pequena e sequencial, ou precisa da conversa completa que o subagente não terá — subagentes começam do zero.
Agora temos todos os quatro blocos de construção. Próximo: a configuração para uso diário que os junta — configurações, permissões, e uma linha de status que você realmente lê.
Série — Workflows agênticos — Maestria
- Parte 01A Mentalidade do Fluxo de Trabalho AgenticA maioria dos desenvolvedores trata IA como um autocomplete mais inteligente. Os que saem na frente a tratam como um colega de trabalho que age. Aqui está o modelo mental.
- Parte 02MCP Servers 101 — Dê Ferramentas Reais ao Seu AgentO Model Context Protocol é como seu agent para de adivinhar e começa a consultar seu banco de dados, seus issues, seu navegador. Aqui está o modelo mental e a primeira conexão.
- Parte 03Build Your First Custom MCP ServerOff-the-shelf servers cover GitHub and Postgres. The high-leverage one is the server only you can write — the bridge to your own system.
- Parte 04Hooks — Make the Agent Obey Your RulesA prompt asks the model to remember. A hook makes it happen — deterministically, every time, outside the model's control.
- Parte 05Custom Slash Commands as Team WorkflowsA custom slash command is a reusable prompt you commit to the repo — so the whole team runs the same high-quality instruction instead of re-typing it.
- Parte 06Subagentes — Delegando Trabalho que Escala — você está aquiUm contexto gigante fica lento e vago. Subagentes deixam o agente principal delegar trabalho focado para especialistas com seu próprio contexto e ferramentas — e executá-los em paralelo.
- Parte 07The Daily-Driver Setup — Settings, Permissions, Status LineA diferença entre lutar contra o agent e fluir com ele é vinte minutos de configuração que você faz uma vez. Aqui está o setup.
- Parte 08Multi-Tool Pipelines — Ticket to Reviewed BranchThe payoff: chain MCP, hooks, commands and subagents into one flow that takes a ticket to a reviewed branch — with you in the loop only where it counts.