Objetivo: ao final, o consultor aplica o ciclo de trabalho padrão e entende por que pular o "planejar" é a causa nº 1 de retrabalho.
O que você precisa levar desta aula
Quatro etapas: explorar, planejar, executar, confirmar. Pular "planejar" é a causa nº 1 de retrabalho.
Plan mode pesquisa e propõe sem alterar nada. Use antes de qualquer tarefa que muda arquivos.
Na confirmação, leia o que mudou — não o resumo. E procure o que não estava no plano.
As quatro etapas
Etapa
O que você faz
O que você ganha
Explorar
Pede um diagnóstico antes de pedir mudança
Descobre o que você não sabia que estava lá
Planejar
Usa plan mode; lê o plano; corrige
Evita retrabalho. Corrigir plano é uma frase
Executar
Libera; acompanha
O trabalho acontece
Confirmar
Lê o que mudou; procura o que não estava no plano
Descobre o que o resumo não conta
Explorar: o pedido de diagnóstico
Explore esta pasta e me diga o que tem aqui: quantos arquivos, de que
tipos, como estão organizados, o que parece duplicado ou desatualizado,
e o que parece estar fora de lugar.
O retorno é sempre maior que o esperado. Achados típicos numa pasta de projeto SAP:
Três esquemas de nomenclatura conflitantes, de pessoas diferentes
Prováveis duplicados com nomes diferentes
Subpasta de fase anterior misturada com a atual
Arquivos de trabalho abandonados no meio dos entregáveis
Versões conflitantes do mesmo documento
Qualquer um desses, se você tivesse pedido "reorganize" direto, teria sido reorganizado junto.
Planejar: o plan mode
Modo em que ele pesquisa e propõe sem alterar nada. Você recebe o plano, revisa, corrige, e só então libera.
O que olhar no plano:
Verifique
Pergunta
Escopo
Ele vai tocar em algo que deveria ficar intacto?
Completude
Falta uma etapa essencial?
Reversibilidade
Ele vai sobrescrever, ou criar novo?
Ordem
A sequência faz sentido?
Casos especiais
Ele previu a exceção que você conhece?
Custo relativo: corrigir o plano é uma frase. Corrigir 200 arquivos movidos indevidamente é uma tarde.
Confirmar: leia o diff, não o resumo
A armadilha: um resumo bem escrito e verdadeiro no que afirma, que omite o que você mais precisava saber.
"Reorganizei as 312 evidências no padrão solicitado e gerei o índice."
Correto. E o diff mostra que ele também alterou matriz-testes.xlsx, que você não pediu.
O procedimento:
Peça a lista de arquivos alterados
Compare com o que estava no plano
Investigue primeiro o que não estava no plano — é aí que está a surpresa
Abra dois ou três arquivos alterados e confira
No Nível 2 e 3 isso ganha ferramentas dedicadas (/code-review, hooks de verificação). No Nível 1, o hábito de olhar o que mudou já resolve a maior parte.
Uma prévia do Nível 2
Você vai reparar que repete as mesmas instruções em toda sessão: onde estão as coisas, qual é o padrão de nomes, o que não tocar. Existe um lugar para fixar isso — o arquivo CLAUDE.md, que é o módulo 2.3 inteiro.
Na Wayon isso já vem pronto. O CLAUDE.md padrão da casa é montado pelo Geovani (geovani@nkodeai.com), engenheiro de AI da NkodeAI, no setup do ambiente no início do curso — junto dos hooks de política. Você não parte de um arquivo em branco: parte do padrão da casa e acrescenta o que é do seu projeto. O módulo 2.3 mostra como as camadas se somam.
Quiz — 5 questões
1.Ordene as quatro etapas do ciclo. - Explorar → Planejar → Executar → Confirmar ✅
1. Ordene as quatro etapas do ciclo.
Explorar → Planejar → Executar → Confirmar ✅
2.Você vai pedir para reorganizar uma pasta de documentação com 847 arquivos. Qual é o primeiro passo?
a)Pedir a reorganização, e corrigir depois se algo sair errado
Com 847 arquivos, "corrigir depois" pode ser uma tarde.
b)Pedir um diagnóstico da pasta antes de pedir qualquer mudança
Correto. Você vai descobrir coisas que não sabia — fase antiga misturada, duplicados, esquemas conflitantes.
c)Fazer backup e pedir a reorganização
Backup é boa prática e não substitui o diagnóstico: você continua sem saber o que tem lá.
Ver resposta e por quê
❌a) Com 847 arquivos, "corrigir depois" pode ser uma tarde.
✅b) Correto. Você vai descobrir coisas que não sabia — fase antiga misturada, duplicados, esquemas conflitantes.
❌c) Backup é boa prática e não substitui o diagnóstico: você continua sem saber o que tem lá.
3.No plan mode, você lê o plano e vê que a etapa 3 vai mover uma subpasta histórica que deveria ficar intacta.
a)Deixe executar e mova de volta depois
Mover de volta 200 arquivos e conferir que voltaram ao lugar certo é o retrabalho que o plan mode existe para evitar.
b)Cancele e refaça o pedido do zero
Exagero. O plano está quase todo certo.
c)Corrija o plano antes de liberar: "ignore a subpasta Fase1, é histórica"
Correto. Uma frase agora contra 200 arquivos movidos e uma tarde de desfazer.
Ver resposta e por quê
❌a) Mover de volta 200 arquivos e conferir que voltaram ao lugar certo é o retrabalho que o plan mode existe para evitar.
❌b) Exagero. O plano está quase todo certo.
✅c) Correto. Uma frase agora contra 200 arquivos movidos e uma tarde de desfazer.
4.Qual é o erro na etapa de confirmação?
a)Ler o resumo do que ele diz que fez, em vez do que efetivamente mudou
Correto. Um resumo verdadeiro pode omitir o arquivo que ele tocou fora do plano.
b)Ler o diff arquivo por arquivo
É trabalhoso em volume alto, mas é o comportamento correto — priorizando o que não estava no plano.
c)Comparar o resultado com o plano
É exatamente o que se deve fazer.
Ver resposta e por quê
✅a) Correto. Um resumo verdadeiro pode omitir o arquivo que ele tocou fora do plano.
❌b) É trabalhoso em volume alto, mas é o comportamento correto — priorizando o que não estava no plano.
❌c) É exatamente o que se deve fazer.
5.Por que "planejar" é a etapa mais frequentemente pulada, e por que isso custa caro? ---
a)Porque o plan mode é difícil de ativar
É trivial de ativar. O obstáculo é a pressa, não a ferramenta.
b)Porque parece atraso, e é onde o erro de escopo é barato de corrigir
Correto. Trinta segundos lendo o plano contra uma tarde desfazendo.
c)Porque o plano nunca reflete o que ele vai fazer
Reflete. É justamente por isso que ler o plano funciona.
Ver resposta e por quê
❌a) É trivial de ativar. O obstáculo é a pressa, não a ferramenta.
✅b) Correto. Trinta segundos lendo o plano contra uma tarde desfazendo.
❌c) Reflete. É justamente por isso que ler o plano funciona.