Comecando em Plan Mode
O maior erro ao construir features novas e comecar a codar antes de planejar. O Plan Mode do Claude Code e um modo especial onde o Claude analisa, projeta e propoe uma arquitetura completa sem escrever nenhuma linha de codigo. Isso economiza tokens, evita retrabalho e produz features mais coesas.
🎯 Conceito Principal
O Plan Mode e ativado com Shift+Tab ou pedindo ao Claude para "entrar em plan mode". Neste modo, ele analisa o codebase, identifica onde as mudancas precisam acontecer, e cria um plano detalhado antes de tocar em qualquer arquivo:
- • Design first: O Claude mapeia quais arquivos precisam ser criados ou modificados, quais dependencias existem e qual a melhor abordagem arquitetural
- • Economia de tokens: Planejar antes custa uma fracao do que reescrever codigo apos uma abordagem errada
- • Visao completa: Voce ve o plano inteiro antes de aprovar, podendo ajustar a abordagem antes de qualquer implementacao
💡 Dica Pratica
Inicie qualquer feature nova com este prompt:
O Claude vai ler o codebase, entender a arquitetura existente e propor um plano. So aprove quando estiver satisfeito com a abordagem.
Revisando o Plano
O plano gerado pelo Claude nao e para ser aceito cegamente. Revise a arquitetura, os tradeoffs e as decisoes antes de aprovar a implementacao. Este e o momento mais barato para mudar de direcao.
🎯 Conceito Principal
Na revisao do plano, avalie tres dimensoes criticas:
- • Arquitetura: A feature esta sendo adicionada no lugar certo? Segue os padroes existentes do projeto? Cria acoplamento desnecessario?
- • Tradeoffs: Quais sao as alternativas? O Claude escolheu a abordagem mais simples? Ha complexidade desnecessaria?
- • Escopo: O plano cobre todos os requisitos? Ha edge cases nao considerados? A feature vai funcionar em todos os cenarios?
💡 Dica Pratica
Pergunte sobre alternativas e tradeoffs antes de aprovar:
Implementacao Step-by-Step
Com o plano aprovado, a implementacao comeca. Mas nao peca tudo de uma vez. Construa incrementalmente, verificando cada passo antes de avancar para o proximo. Isso reduz o risco de erros em cascata e facilita o debug se algo der errado.
🎯 Conceito Principal
A construcao incremental segue o principio de "fazer funcionar primeiro, depois melhorar":
- • Core primeiro: Implemente a funcionalidade basica que faz a feature funcionar no cenario mais simples
- • Adicione camadas: Validacoes, error handling, edge cases e optimizacoes sao adicionados em passos subsequentes
- • Verifique cada passo: Apos cada incremento, verifique se tudo ainda funciona antes de avancar
💡 Dica Pratica
Quebre features grandes em tarefas menores e peca uma de cada vez:
Testando Durante a Construcao
Testes nao sao algo para "depois". Escreva testes junto com a implementacao, idealmente antes (TDD) ou imediatamente apos cada componente. Isso garante que voce detecta problemas cedo, quando o custo de corrigi-los e baixo.
🎯 Conceito Principal
O padrao "test alongside" significa que cada incremento da feature vem acompanhado de testes:
- • Testes unitarios: Para cada funcao ou metodo novo, crie testes que cobrem o caminho feliz e os edge cases
- • Testes de integracao: Para interacoes entre componentes, verifique que o fluxo completo funciona
- • Rode frequentemente: Apos cada mudanca significativa, rode a suite de testes para pegar regressoes cedo
💡 Dica Pratica
Peca testes junto com cada parte da implementacao:
Polish e Review Final
Antes de commitar, faca uma revisao final de qualidade. Isso inclui cleanup de codigo, verificacao de edge cases, documentacao e garantia de que a feature segue os padroes do projeto.
🎯 Conceito Principal
O polish final transforma codigo funcional em codigo de producao:
- • Cleanup: Remova console.logs, TODOs temporarios, codigo comentado e imports nao utilizados
- • Edge cases: Pense em inputs invalidos, estados de erro, concorrencia, limites de performance
- • Consistencia: Verifique que a feature segue os padroes de naming, estrutura e estilo do resto do projeto
💡 Dica Pratica
Peca ao Claude uma revisao critica do que foi construido:
Do Commit ao PR
A feature esta pronta. Agora e hora de empacotar tudo para entrega: commit limpo com mensagem semantica e pull request com descricao clara. Os comandos /commit e /pr automatizam este processo.
🎯 Conceito Principal
O fluxo /commit + /pr e o fechamento natural de qualquer feature:
- • /commit: Analisa o diff, gera mensagem semantica (feat:, fix:, refactor:) e cria o commit com sua aprovacao
- • /pr: Analisa os commits na branch, gera titulo e descricao do PR e cria o PR no GitHub automaticamente
- • Revisao: Voce pode editar tanto a mensagem de commit quanto a descricao do PR antes de confirmar
💡 Dica Pratica
O fluxo completo de entrega em dois comandos:
Exercicio Pratico
Implementar feature completa usando Plan Mode
Escolha um projeto pessoal e adicione uma feature nova usando o workflow completo: Plan Mode, implementacao incremental, testes e commit.
Inicie em Plan Mode
Descreva a feature e peca ao Claude para planejar antes de codar.
Revise e aprove o plano
Questione tradeoffs e alternativas antes de aprovar.
Implemente step-by-step com testes
Construa incrementalmente, testando cada passo.
Polish, /commit e /pr
Faca review final, commit semantico e crie o PR.
✅ Criterios de Sucesso
📋 Resumo do Modulo
Proximo Modulo:
3.3 - Workflow: Refatorar Codigo