O que é o modo de planejamento de um agente de IA?
Pela equipe do Tokencito · Atualizado em
O modo de planejamento é pedir a um agente de IA que primeiro proponha o que vai mudar, onde e como vai testar, sem editar nada ainda. Você revisa o plano, corrige e só depois deixa ele agir. Algumas ferramentas trazem isso como um modo à parte; em outras, basta pedir.
🗺️Propõe um plano→🔍Você revisa→✏️Você corrige→▶️Só então ele edita
Teste o que aprendeu
Uma pergunta do app. Escolha uma resposta.
Em qual destas tarefas pedir um plano antes é exagero?
Mexe com dinheiro e várias partes do app. Aí um plano deixa você barrar erros antes que custem.
É pequeno e dá para conferir o resultado num relance. Planejar custa mais que fazer.
Muitos arquivos e risco alto: se der errado, ninguém entra. Justo onde vale ver o plano primeiro.
Um plano útil dá para revisar: diz que passos vai dar, que arquivos mexe e como vai conferir que ficou certo. Imagine que você pede a um agente de código frete grátis a partir de certo valor numa loja online. Um bom plano cita o cálculo do carrinho, a tela de pagamento e os testes que vai rodar.
Depois você compara com duas coisas. Com as regras do projeto, as que deixou por exemplo no CLAUDE.md: se o plano adiciona uma biblioteca de datas e o projeto já usa outra, avise. E com o que falta: se não diz nada dos pedidos já cobrados, pergunte se mexe neles. Sinais de alerta: passos como "ajusto o que for preciso", arquivos que não têm a ver com o pedido ou nenhum passo para testar.
Como pedir quando não há modo
Nas ferramentas que trazem isso como modo, o agente costuma poder ler o projeto mas não editar até você aprovar. Se a sua não tem, uma frase resolve: "Antes de editar, me diga que arquivos vai mudar, em que ordem e como vai testar. Não mexa em nada até eu falar."
Diferença importante: um modo da ferramenta pode bloquear a edição; um pedido no chat só orienta o agente, que pode pular. Se a mudança é delicada, prefira o modo ou permissões que peçam sua aprovação antes de editar.
Quando ajuda e quando é exagero
Ajuda quando a mudança mexe em várias partes, dinheiro, o login dos usuários ou os dados deles: aí corrigir o plano custa uma frase e desfazer mudanças custa horas. É exagero quando a mudança é pequena e dá para conferir o resultado num relance, como renomear uma variável dentro de um só arquivo. Regra prática: se ler o plano leva mais tempo do que revisar a mudança, pule.
Erro comum: "aprovei o plano, pronto". O plano diz o que pretende fazer, não o que fez. Um bom plano pode ser executado mal, então no fim você ainda revisa o diff e os testes.