📋 Comecar com Plan Mode
Mudancas multi-arquivo sao as mais arriscadas. Sempre comece no Plan Mode para mapear todos os arquivos afetados antes de tocar em qualquer codigo.
💡 Conceito Principal
O prompt para iniciar uma refatoracao multi-arquivo:
- •
claude "Preciso [migrar/atualizar/renomear] [X] em todo o codebase. Entre no plan mode." - •O Claude vai listar todos os arquivos que precisam mudar
- •Revise o plano antes de aprovar a execucao
⚡ Dica Pratica
Nunca faca tudo de uma vez. O Plan Mode previne que o Claude saia fazendo mudancas sem sua aprovacao.
🔍 Revisando o Escopo
O Claude identifica todos os arquivos afetados. Sua funcao e revisar se o escopo esta completo e correto.
💡 Conceito Principal
- •Verifique se todos os arquivos relevantes estao na lista
- •Confirme que imports, testes e configuracoes estao incluidos
- •Pergunte: "Tem certeza que nao estamos esquecendo nenhum arquivo?"
📦 Executar em Lotes
A chave para migracoes seguras: executar em lotes pequenos, comecando pelo modulo core e movendo para os dependentes.
💡 Conceito Principal
- •
"Comece pelo modulo core, depois mova para os modulos dependentes." - •Cada lote deve ser testavel independentemente
- •Commits pequenos entre lotes para facilitar rollback
🧪 Testar Apos Cada Lote
A regra de ouro: testes verdes a todo momento. Rode os testes apos cada lote de mudancas.
💡 Conceito Principal
- •
"Rode os testes apos cada lote de mudancas." - •Se um teste falhar, pare e corrija antes de continuar
- •Nunca acumule lotes sem testar — o risco cresce exponencialmente
🔎 Varredura Final
Apos completar todos os lotes, faca uma varredura final para garantir que nada ficou para tras.
💡 Conceito Principal
- •
"Faca uma varredura final — tem algum arquivo que esquecemos?" - •Procure por referencias antigas que podem ter escapado
- •Rode a suite completa de testes uma ultima vez
💨 Use /compact em Migracoes Longas
Migracoes longas consomem muito contexto. O comando /compact resume a conversa e libera espaco para continuar.
💡 Conceito Principal
- •
/compactresume toda a conversa mantendo o contexto essencial - •Use entre lotes para manter a janela de contexto saudavel
- •Essencial para migracoes que levam mais de 30 minutos
✓ O que FAZER
- ✓Plan Mode antes de comecar
- ✓Lotes pequenos + testes
- ✓Usar /compact entre lotes
✗ O que NAO fazer
- ✗Fazer tudo de uma vez
- ✗Pular testes entre lotes
- ✗Ignorar o Plan Mode