π Plan Mode - Planejamento
Antes de escrever codigo, ative o Plan Mode para que o Claude crie um plano detalhado da feature. Isso evita retrabalho e garante uma arquitetura solida.
π‘ Conceito Principal
O Plan Mode faz o Claude pensar antes de agir:
- β’Pressione
Shift+Tabpara alternar para Plan Mode (ou useTabpara trocar entre Plan/Act) - β’
"Preciso de um sistema de notificacoes por email. Planeje a arquitetura" - β’O Claude vai listar arquivos a criar, dependencias, fluxo de dados e possΓveis edge cases
β‘ Dica Pratica
Inclua requisitos especificos no prompt: "Planeje um CRUD de produtos com: validacao, paginacao, filtros por categoria, e testes unitarios"
π Revisar o Plano
Revise e ajuste o plano antes de implementar. E mais barato mudar um plano do que refatorar codigo pronto.
π‘ Conceito Principal
Faca perguntas e peca ajustes ao plano:
- β’
"Use Redis para cache ao inves de in-memory" - β’
"Adicione rate limiting no plano" - β’Verifique se o plano segue os padroes do seu projeto existente
β‘ Dica Pratica
Peca ao Claude: "Antes de implementar, analise o codebase existente e garanta que o plano segue os mesmos padroes de arquitetura"
π οΈ Implementar
Com o plano aprovado, mude para Act Mode e implemente. O Claude vai criar arquivos, escrever codigo e configurar dependencias seguindo o plano.
π‘ Conceito Principal
A implementacao segue o plano passo a passo:
- β’Pressione
Tabpara voltar ao Act Mode e diga:"Implemente o plano" - β’O Claude cria arquivos, instala pacotes e configura tudo automaticamente
- β’Revise cada arquivo criado - aceite com
you peca mudancas
β‘ Dica Pratica
Para features grandes, implemente em etapas: "Implemente primeiro o modelo e a migration. Depois faremos o controller"
π§ͺ Testar
Peca ao Claude para escrever e rodar testes para a feature nova. Testes sao parte essencial de qualquer feature.
π‘ Conceito Principal
Testes garantem que a feature funciona e nao quebra nada existente:
- β’
"Escreva testes unitarios para o NotificationService" - β’
"Rode npm test e corrija qualquer falha" - β’Peca testes para edge cases: inputs invalidos, permissoes, limites
β‘ Dica Pratica
Use: "Escreva testes cobrindo: caso feliz, input invalido, usuario sem permissao, e limite de paginacao"
β¨ Polir
Antes do commit final, peca ao Claude para polir o codigo: melhorar nomes, adicionar comentarios, limpar imports e garantir consistencia.
π‘ Conceito Principal
O polimento transforma codigo funcional em codigo profissional:
- β’
"Revise o codigo que criamos. Melhore nomes de variaveis, adicione JSDoc e remova code smells" - β’
"Rode o linter e corrija qualquer warning" - β’Verifique se ha tratamento de erros adequado em todos os pontos
β‘ Dica Pratica
Peca uma revisao final: "Faca uma ultima revisao de todos os arquivos que criamos. Tem algo que podemos melhorar?"
π¦ Commit e Finalizacao
Finalize com um commit bem estruturado que documenta a nova feature para o historico do projeto.
π‘ Conceito Principal
Commits bem feitos facilitam o code review e o historico:
- β’Use
/commitpara gerar a mensagem automaticamente - β’Para features grandes, considere commits atomicos:
"Faca commits separados: um para o modelo, um para o controller e um para os testes" - β’O Claude gera mensagens como:
feat: add email notification system with queue support
β‘ Dica Pratica
Para features que precisam de PR, use /pr logo depois do commit. O Claude cria o Pull Request com descricao completa da feature.
π Resumo do Modulo
Proximo Modulo:
3.3 - Refatorar Codigo