Módulo 4 - O fluxo agêntico por dentro
Pensar e planejar antes de agir
8 min de leitura · por Cesar Gargiulo, revisado pela equipe ValorFinal e GuardiaSec · Atualizado em 13/07/2026
O que você vai aprender
- Entender que o agente pode raciocinar mais fundo em tarefas difíceis.
- Reconhecer a lista de tarefas que ele monta.
- Conhecer a ideia do plan mode: planejar antes de agir.
- Saber quando estimular o planejamento.
Ouvir o resumo desta aula
Um recap de cerca de 2 minutos na voz do Valim, para ouvir no trânsito ou na academia.
Ler a transcrição do resumo
Resumo da aula: Pensar e planejar antes de agir.
Os objetivos desta aula. Entender que o agente pode raciocinar mais fundo em tarefas difíceis. Reconhecer a lista de tarefas que ele monta. Conhecer a ideia do plan mode: planejar antes de agir. Saber quando estimular o planejamento.
Veja o essencial, parte por parte.
Pensar mais fundo quando a tarefa pede. Em tarefas difíceis, o Claude Code pode raciocinar por mais tempo antes de agir (raciocínio estendido).
A lista de tarefas que ele monta. Quando o trabalho tem vários passos, o Claude Code costuma montar uma lista de tarefas, uma checklist do que precisa ser feito, com o estado de cada item: pendente, em andamento ou concluido.
A ideia do plan mode. Uma mudança grande, que toca muitas partes do projeto.
Esse foi o resumo do essencial. Para se aprofundar, leia a aula completa e responda os exercícios.
Pensar mais fundo quando a tarefa pede
Nem todo problema tem o mesmo tamanho, e o Claude Code ajusta o esforco de pensamento a dificuldade. Em tarefas simples, ele responde rápido. Em tarefas difíceis, com muitas partes e riscos, ele pode acionar um raciocínio mais profundo, pensando por mais tempo antes de agir. Esse pensar mais fundo rende um planejamento melhor: em vez de sair editando na primeira ideia, ele considera caminhos, antecipa problemas e escolhe uma abordagem. O custo e um pouco mais de tempo, que costuma se pagar quando a alternativa seria errar o caminho e refazer.
Você pode estimular esse pensamento mais cuidadoso pela forma de pedir. Sinalizar que a tarefa e delicada, pedir que ele pense bem antes de começar ou que primeiro proponha uma abordagem convida o agente a planejar em vez de atropelar. Isso é especialmente útil em decisões de arquitetura, mudanças que tocam muitas partes ou problemas que já resistiram a uma primeira tentativa. Trocar a pressa por um instante de planejamento e um dos ajustes mais simples que mais melhoram o resultado, e não custa quase nada além de uma frase no pedido.
A lista de tarefas que ele monta
Quando o trabalho tem vários passos, o Claude Code costuma montar uma lista de tarefas, uma checklist do que precisa ser feito, com o estado de cada item: pendente, em andamento ou concluido. Essa lista serve a dois donos. Para o agente, e um jeito de não se perder em tarefas longas, marcando o que já fez e o que falta, mesmo depois de muitas idas e voltas. Para você, e uma janela clara de acompanhamento: da para ver o plano se desenrolar, perceber se algum passo importante ficou de fora e cobrar o que faltou antes do fim.
A lista de tarefas também melhora a sua revisão. Em vez de julgar só o resultado final, você consegue conferir se o caminho fez sentido: os passos estão na ordem certa? Falta validar alguma coisa? Ele lembrou de rodar os testes? Se algo essencial não aparece na lista, e o momento de pedir que inclua. Trabalhar com o plano a vista, e não só com o produto pronto, e uma forma poderosa de dirigir tarefas complexas, porque você corrige o rumo enquanto ainda e barato, em vez de descobrir um buraco só no final.
🎮 Jogo da aula
Planejamento: ajuda ou atrapalha?
Para cada afirmacao sobre o agente pensar e planejar, diga se e verdadeira ou falsa.
Um cuidado de equilibrio: nem toda tarefa merece um planejamento elaborado. Pedir uma lista de tarefas e um raciocínio profundo para trocar o texto de um botao seria exagero, só gastando tempo. O bom senso e casar o esforco de pensamento com a dificuldade real: tarefas pequenas fluem direto; tarefas grandes pedem plano. Com o tempo, o próprio agente calibra isso bem, e você aprende quando dar aquele empurraozinho para ele pensar mais, sem transformar cada pedido simples numa reuniao de planejamento.
A ideia do plan mode
Existe uma forma dedicada de separar o planejar do agir, chamada plan mode, que você vai aprofundar em um módulo próprio mais a frente. A ideia e simples e poderosa: nesse modo, o Claude Code explora o projeto e escreve um plano completo do que pretende fazer, mas não toca em nenhum arquivo até você aprovar o plano. Você le a proposta com calma, ajusta se quiser e só então libera a execução. E como pedir o roteiro da obra antes de deixar o pedreiro começar a levantar parede: muito mais barato corrigir no papel do que na alvenaria.
Por enquanto, guarde o conceito: pensar antes de agir não é só uma qualidade interna do agente, e algo que você pode exigir de forma explicita, até travando a ação até aprovar o plano. Isso fecha a ideia central deste módulo: o Claude Code não é um atropelador que sai editando; bem conduzido, ele explora, pensa, planeja, age e confere. A última aula mostra o que acontece quando, apesar de tudo isso, algo da errado, e como o agente encontra e corrige os próprios erros, transformando cada falha num passo do caminho.
Teste rápido
Qual é a ideia central do plan mode?
Perguntas frequentes
- O agente sempre pensa mais fundo?
- Não. Ele ajusta o esforco a dificuldade: tarefas simples fluem rápido; tarefas difíceis podem acionar um raciocínio mais profundo. Pensar demais em algo trivial só gastaria tempo. Você pode estimular o pensamento mais cuidadoso sinalizando que a tarefa e delicada ou pedindo uma abordagem antes.
- Para que serve a lista de tarefas?
- Ela organiza trabalhos de vários passos, mostrando o que está pendente, em andamento e concluido. Ajuda o agente a não se perder em tarefas longas e ajuda você a acompanhar o plano, perceber se algum passo importante ficou de fora e cobrar antes do fim.
- Qual a diferença entre pensar antes e o plan mode?
- Pensar antes e uma qualidade do agente, que planeja internamente conforme a dificuldade. O plan mode é um modo explícito em que ele escreve um plano completo e não toca em nenhum arquivo até você aprovar. Um e comportamento; o outro e uma trava que você ativa, aprofundada em módulo próprio.
- Quando devo pedir para ele planejar antes?
- Em tarefas grandes, que tocam muitas partes, em mudanças sensíveis onde errar sai caro, ou em projetos novos para você. Nesses casos, alinhar a abordagem antes evita ir longe na direção errada. Em tarefas pequenas, planejar demais só atrasa; deixe fluir.
- Planejar deixa tudo mais lento?
- Um pouco mais lento no começo, mas costuma economizar tempo no total, porque evita refazer. Em tarefas difíceis, os minutos gastos planejando poupam horas de retrabalho por ter pegado o caminho errado. O segredo e casar o planejamento com a dificuldade, sem transformar tudo em reuniao.
Fontes
Seu progresso fica salvo neste aparelho. Assinantes sincronizam entre os aparelhos.