Estratégias de Auto-Planejamento

Você pediu um ajuste rápido no banco de dados e o Claude reescreveu a camada ORM inteira. Surpresas assim são exatamente o que o Auto Plan Mode evita. O Claude te mostra o plano primeiro. Nada é tocado até você aprovar.

Ganho Rápido: Rode isso uma vez e você está configurado:

O Claude te entrega um plano antes de qualquer operação de arquivo. Aprove ou rejeite. Nada se move até você dizer.

A flag --append-system-prompt foi lançada no Claude Code v1.0.51. Ela cola instruções extras no system prompt do Claude. O Auto Plan Mode se apoia nela para acionar a ferramenta oculta exit_plan_mode por conta própria.

Seu loop agora é: Plano -> Sua Aprovação -> Execução

O Manual Plan Mode também existe. Você o ativa com Shift+Tab duas vezes, e ele pede que você se lembre. O Auto Plan Mode tira o trabalho de lembrar do seu caminho.

Planos custam tokens e deixam as coisas um pouco mais lentas. Por isso vale saber onde o overhead se paga.

Use o Auto Plan Mode quando:

• A base de código é nova para você
• A mudança é difícil de reverter
• Você quer o hábito de pensar antes de agir
• Novos membros da equipe estão aprendendo o Claude Code

Pule o Auto Plan Mode quando:

• Você está prototipando rápido e quebrar coisas é barato
• A mudança é pequena e óbvia
• Velocidade bruta é o único objetivo

Proteção Padrão (Recomendado)

Aciona um plano antes de qualquer escrita de arquivo:

Proteção Máxima

Aciona um plano para tudo, incluindo buscas:

Configuração Reutilizável

Coloque o prompt em um arquivo para você puxar da mesma forma toda vez:

Cenário 1: O Refactor Ansioso

Você pede: "Corrija o null check em user.js"

Sem o Auto Plan Mode, o Claude pode decidir que o módulo de usuário inteiro poderia estar mais arrumado e refatora tudo. Com o plano na sua frente, você percebe e diz "só a linha 47, deixe o resto em paz."

Cenário 2: O Delete em Cascata

Você pede: "Limpe os imports não utilizados"

O plano volta querendo tocar 23 arquivos. Você aprova os 5 que realmente precisam e rejeita o resto.

Cenário 3: A Mudança Quebrando

Você pede: "Atualize o formato de resposta da API"

O plano mostra o Claude reescrevendo tanto a API quanto todos os componentes de frontend que leem dela. Você detecta a quebra antes de acontecer.

O Auto Plan Mode fica ao lado da ativação manual. Para sessões somente de pesquisa onde o Claude está só olhando ao redor, pressione Shift+Tab duas vezes. O auto-planejamento cobre o resto.

Planejando todo pedido pequeno? Mude para o prompt de "Proteção Padrão". Ele só aciona em Write, Edit e Bash.

Não ativando de jeito nenhum? Certifique-se de que está no Claude Code v1.0.51 ou mais novo. Verifique se a referência exit_plan_mode está escrita corretamente.

Aprovação não está funcionando? É por design. Cada nova mensagem de usuário precisa de nova aprovação. Aprovações antigas não se transferem.

Quer algo mais estruturado? O Code Kit do ClaudeFast vem com um comando /team-plan que auto-classifica tarefas em cinco níveis (trivial, moderado, complexo, colaborativo, indefinido) e direciona cada um para o modo de execução certo, da execução direta até a orquestração multi-agente completa do /team-build.

Próximos Passos: Leia o guia manual de Modos de Planejamento para sessões somente de pesquisa. Coloque as regras de auto-planejamento no seu CLAUDE.md. Estude o Gerenciamento de Contexto para manter o uso de tokens baixo depois que o auto-planejamento estiver ativo.