MODULO 3.2

πŸ‘Ύ Construir Feature Nova

Como usar o Plan Mode para planejar, implementar e polir uma feature nova do zero com o Claude Code.

6
Topicos
25
Minutos
Inter.
Nivel
Pratico
Tipo
1

πŸ“‹ 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+Tab para alternar para Plan Mode (ou use Tab para 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"

2

πŸ” 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"

3

πŸ› οΈ 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 Tab para 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 y ou peca mudancas

⚑ Dica Pratica

Para features grandes, implemente em etapas: "Implemente primeiro o modelo e a migration. Depois faremos o controller"

4

πŸ§ͺ 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"

5

✨ 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?"

6

πŸ“¦ 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 /commit para 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

βœ“
Plan Mode - Planeje antes de codar com Shift+Tab
βœ“
Revisao - Ajuste o plano antes de implementar
βœ“
Implementacao - Execute o plano no Act Mode
βœ“
Testes - Escreva e rode testes automaticamente
βœ“
Polimento - Melhore nomes, docs e code quality
βœ“
Commit - Use /commit para finalizar com mensagem profissional

Proximo Modulo:

3.3 - Refatorar Codigo