Claude Code – #9 Dividindo tarefas com subagents

Divisão de trabalho com IA

O vídeo aborda uma funcionalidade avançada e extremamente útil do Claude Code, a capacidade de delegar partes de uma tarefa complexa para agentes secundários, chamados de subagents. Em vez de tentar resolver um problema grande e multifacetado em uma única conversa linear com o modelo de linguagem, Tiago Matos demonstra como orquestrar múltiplos agentes trabalhando em paralelo ou em sequência. A ideia central é espelhar a forma como times de desenvolvimento humanos operam, com um líder distribuindo atividades para especialistas focados, cada um responsável por um arquivo, uma função ou um aspecto bem definido do sistema. Isso muda o paradigma de uso da IA, passando de um assistente que faz tudo de uma vez, muitas vezes se perdendo em contextos muito longos, para um ecossistema de agentes colaborativos.

Ao fragmentar o problema, cada subagent se mantém dentro de uma janela de contexto enxuta e com um objetivo claríssimo. Isso reduz drasticamente as alucinações e inconsistências que surgem quando um único modelo precisa manter em mente dezenas de requisitos e arquivos simultaneamente. Tiago Matos contextualiza essa técnica dentro da sua própria experiência prática com desenvolvimento de software, mostrando que o Claude Code, atuando como o agente maestro, pode gerar instruções detalhadas para esses subagentes, monitorar seus resultados e integrar tudo de volta ao código principal. A promessa dessa abordagem é permitir que tarefas que antes pareciam grandes demais para uma IA possam ser executadas com mais previsibilidade e qualidade profissional.

Configurando o arquivo de instruções

Um ponto crucial que o criador destaca é a forma de instruir o sistema a usar subagents, que não acontece por meio de comandos na interface de chat, mas sim através de um arquivo de instruções específico do projeto. Tiago Matos explica como criar e configurar o arquivo de instruções do Claude Code para definir explicitamente quando e como delegar trabalho. A clareza na definição dos papéis é o que torna a mágica possível: o arquivo descreve que, para determinados tipos de solicitação, o agente principal não deve escrever código, mas sim elaborar prompts detalhados e disparar subagents.

Esse arquivo de instruções serve como uma memória permanente e estruturada sobre a estratégia de desenvolvimento do projeto. Tiago demonstra como específicar o número máximo de subagents simultâneos, os limites de cada um e a lógica de divisão. Por exemplo, pode-se configurar que ao solicitar a criação de uma nova funcionalidade MVC, um subagent ficará responsável pela Model, outro pela View e outro pelo Controller. Cada um deles recebe um prompt enriquecido com o contexto relevante apenas para sua tarefa, como a estrutura do banco de dados para a Model ou o design system para a View. Esse nível de detalhamento extraído do arquivo de instruções é o que permite ao Claude Code gerenciar a delegação de forma autônoma, sem que o desenvolvedor precise microgerenciar cada passo.

Exemplo prático de delegação

O vídeo avança para uma demonstração direta dentro do terminal, o habitat natural do Claude Code. A tarefa escolhida é a criação de uma aplicação simples, mas com partes bem distintas, como uma página de listagem e um formulário de contato. Em uma abordagem tradicional, o modelo geraria arquivo por arquivo, talvez misturando responsabilidades. Com a instrução de subagents ativada, o comportamento muda radicalmente. O agente principal anuncia que irá dividir a tarefa: um subagent para os endpoints da API, outro para os templates visuais e um terceiro para a lógica de validação do formulário.

Tiago mostra como o Claude Code orquestra a criação, supervisão e encerramento de cada subagent. Acompanhar o processo no terminal evidencia o ganho de paralelismo e organização, pois os subagents trabalham de maneira independente, reportando seus resultados ao agente principal assim que cada um termina seu bloco de código. A demonstração deixa claro que a integração final é feita por um último passo, onde o agente principal revisa as saídas, resolve pequenos conflitos e monta os arquivos finais. Essa prática espelha o conceito de merge de branches em um sistema de controle de versão, mas gerenciado inteiramente pela IA e com tempo total de execução drasticamente reduzido.

Controlando o contexto e a qualidade

Uma das maiores dores de quem usa IA para gerar código é a degradação da qualidade em conversas muito longas. Tiago aborda esse problema diretamente ao explicar como subagents isolam contextos, evitando que detalhes de uma parte do sistema poluam a lógica de outra. Cada subagent opera em sua própria bolha de contexto, recebendo exatamente a informação de que precisa. Isso previne o fenômeno de ‘gato por lebre’, onde o modelo confunde nomes de classes ou aplica regras de negócio de um módulo em outro. O vídeo explica que essa arquitetura de agentes é especialmente valiosa para times que estão produzindo muito código com Claude Code e encontram limites na janela de tokens.

Além do isolamento, Tiago Matos ressalta o aumento na qualidade das revisões. Como o agente principal não éstá sobrecarregado com os detalhes de baixo nível de cada pedaço de código, ele pode assumir um papel de revisor sênior. Após todos os subagents concluírem, o agente maestro verifica se a integração faz sentido, se os contratos de API desenhados pela IA de backend batem com os esperados pela IA de frontend e se a coesão do sistema como um todo foi mantida. O ganho de qualidade final se deve a essa especialização de funções entre agentes orquestradores e executores, replicando um fluxo de pull request e code review dentro do terminal.

Reflexos na produtividade de times reais

Para além do tutorial técnico, o conteúdo provoca uma reflexão sobre como isso muda a dinâmica de um time. Tiago, um criador focado em produtividade e boas práticas, conecta a funcionalidade dos subagents à sua visão de escalabilidade pessoal. Em vez de o desenvolvedor gastar horas configurando cada detalhe, a IA assume o papel de tech lead operacional, gerenciando tarefas que antes exigiriam múltiplas idas e vindas entre colegas ou entre branches. A economia de tempo é mais do que a simples aceleração de digitação de código; é a redução do custo cognitivo de manter o estado de múltiplas implementações ao mesmo tempo.

O vídeo é propositalmente curto, mas denso. Em cerca de doze minutos, Tiago entrega uma visão completa que vai da justificativa teórica ao passo a passo prático no terminal. Ao finalizar, ele deixa claro que éssa funcionalidade é um diferencial para quem deseja usar o Claude Code não apenas como um copiloto, mas como um gerente de equipe de IA. A implicação para o futuro do desenvolvimento é que a complexidade do software não precisa mais ser um limitador para o indivíduo, desde que ele saiba projetar um bom arquivo de instruções e confiar na orquestração autônoma de múltiplos agentes de inteligência artificial.