Pensar e planejar antes de agir

Pensar mais fundo quando a tarefa pede

Nem todo problema tem o mesmo tamanho, e o Claude Code ajusta o esforço de pensamento à 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 é 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 é 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 é 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 concluído. Essa lista serve a dois donos. Para o agente, é 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ê, é uma janela clara de acompanhamento: dá 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, é o momento de pedir que inclua. Trabalhar com o plano à vista, e não só com o produto pronto, é uma forma poderosa de dirigir tarefas complexas, porque você corrige o rumo enquanto ainda é barato, em vez de descobrir um buraco só no final.

Um cuidado de equilíbrio: nem toda tarefa merece um planejamento elaborado. Pedir uma lista de tarefas e um raciocínio profundo para trocar o texto de um botão seria exagero, só gastando tempo. O bom senso é casar o esforço 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 empurrãozinho para ele pensar mais, sem transformar cada pedido simples numa reunião 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 à frente. A ideia é 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ê lê a proposta com calma, ajusta se quiser e só então libera a execução. É 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, é algo que você pode exigir de forma explícita, 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 dá errado, e como o agente encontra e corrige os próprios erros, transformando cada falha num passo do caminho.