Subagentes na prática e o que vem além

Subagentes úteis do dia a dia

Alguns subagentes aparecem no dia a dia de quase todo mundo, e são bons primeiros ajudantes para montar. O revisor de código é um clássico: um subagente com instruções para procurar bugs, problemas de segurança ou de qualidade, acionado após mudanças, que devolve os achados como um par de olhos extra. O pesquisador é outro: um subagente que explora uma parte do projeto ou levanta informações e devolve um resumo, isolando o ruído da pesquisa. O escritor de testes é um terceiro: um subagente especializado em gerar testes no formato do projeto. Cada um resolve uma tarefa recorrente com um especialista dedicado.

Repare como esses exemplos combinam os benefícios que você aprendeu. O revisor especializa o comportamento e pode ter só ferramentas de leitura, por segurança. O pesquisador preserva contexto, empurrando o volume da leitura para o contexto dele. O escritor de testes especializa e garante consistência de formato. Você não precisa criar todos de uma vez; comece pela sua tarefa mais repetida e crie o ajudante para ela. Com um ou dois subagentes bem escolhidos, você já sente o ganho, e a sua equipe cresce naturalmente conforme você identifica novas tarefas que mereçam um especialista de plantão.

Subagente do projeto ou pessoal

A escolha de onde guardar um subagente segue a mesma lógica de escopo da memória e dos comandos, que você já domina. Se o subagente é útil para o time daquele projeto, como um revisor que conhece as regras específicas do projeto, ele vai para a pasta de agentes do projeto e viaja pelo controle de versão, ficando disponível para todos os colegas. Se é um ajudante seu, que você quer em qualquer projeto, como um pesquisador genérico, ele vai para a sua área pessoal. A pergunta é a de sempre: quem mais se beneficia disto? Colocar cada subagente no escopo certo mantém a sua equipe organizada e evita espalhar ajudantes onde eles não se aplicam.

Uma vantagem dos subagentes de projeto, como a dos comandos de projeto, é espalhar boas práticas pelo time. Se você cria um revisor de segurança com as instruções que a sua equipe considera importantes, qualquer colega que abrir o projeto ganha esse revisor e delega a ele nas mesmas condições. O subagente vira uma forma de codificar o conhecimento do time num ajudante compartilhado, garantindo que todos revisem, pesquisem ou testem no mesmo padrão. É o mesmo poder dos comandos de projeto, agora com a força extra do contexto isolado e da especialização. A sua equipe humana ganha uma equipe de agentes que trabalha do jeito combinado.

Vale um lembrete de moderação: assim como o CLAUDE.md não deve virar um calhamaço, a sua coleção de subagentes não deve inchar sem necessidade. Muitos subagentes com descrições parecidas confundem a delegação, porque o Claude Code fica em dúvida sobre qual usar. Prefira poucos subagentes bem definidos, cada um com um propósito claro e uma descrição distinta, a uma legião de ajudantes sobrepostos. Qualidade e clareza acima de quantidade: uma equipe pequena e afiada rende mais que uma multidão confusa. Comece enxuto e adicione um subagente novo só quando uma tarefa recorrente realmente pedir um especialista que ainda não existe.

O horizonte: vários agentes em conjunto

Os subagentes são a porta de entrada de um mundo maior de trabalho com vários agentes, que vale conhecer no horizonte. Além do subagente clássico, que trabalha dentro da sua sessão, existem formas de rodar vários agentes independentes em paralelo, monitorando todos de um lugar, e até formas de agentes que se comunicam entre si para coordenar um trabalho maior. Esses recursos são mais avançados e nem todo mundo precisa deles, mas mostram para onde a coisa caminha: de um assistente único para orquestras de agentes especializados trabalhando juntos. Você não precisa disso agora; basta saber que existe e que o seu domínio dos subagentes é o primeiro passo nessa direção.

Com este módulo, você deu um salto: o Claude Code deixou de ser um assistente solo e virou o maestro de uma pequena equipe de ajudantes especializados. Você sabe o que é um subagente, por que e quando delegar, como criar um, como o agente decide acioná-lo e como usá-los na prática. Combinado com tudo que veio antes, você tem um domínio real da ferramenta. O próximo módulo continua ampliando esse poder com as skills, aquele sistema de que os comandos personalizados são a porta de entrada, e que se conecta de perto com os subagentes na forma de estender o que o Claude Code sabe fazer. A sua caixa de ferramentas segue crescendo.