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.

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.

Diagrama mostrando o agente diante de uma tarefa difícil optando por pensar mais fundo antes de agir, montando ao lado uma lista de tarefas com itens marcados como pendente, em andamento e concluido, e só então partindo para a ação com um plano em mãos.
Pensar mais fundo e organizar uma lista de tarefas: o planejamento que precede a boa ação.

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.