⚛️ Template para Next.js/React
O template para Next.js com App Router e TypeScript e o mais pedido. Cobre Server Components, Tailwind, shadcn/ui e as convencoes modernas do ecossistema React.
🎯 Conceito Principal
- •App Router by default: Declare explicitamente que usa App Router, nao Pages Router
- •Server vs Client Components: Defina quando usar cada um como regra clara
- •Tailwind + shadcn/ui: Especifique o sistema de estilo para evitar CSS-in-JS ou styled-components
- •TypeScript strict: Declare strict mode e regras de types (nunca any)
💡 Dica Pratica
Ao usar esse template, o Claude vai gerar componentes React que usam Server Components por padrao, named exports, Tailwind classes e Zod validation. Exatamente o padrao moderno de Next.js 14+.
🐍 Template para Python/FastAPI
O template para Python com FastAPI e uv cobre padroes modernos de backend Python: async handlers, Pydantic models, dependency injection e testing com pytest.
🎯 Conceito Principal
- •Package manager: uv: Declare uv explicitamente para evitar que o Claude use pip ou poetry
- •Pydantic models: Todas as request/response schemas como Pydantic BaseModel
- •Async handlers: Endpoints async por padrao com dependency injection
- •Type hints: Type hints em todas as function signatures, sem excecao
💡 Dica Pratica
O erro mais comum com Python no Claude e o package manager. Se voce usa uv e nao declara, o Claude vai rodar pip install. Esse template resolve isso logo na primeira secao.
🐚 Template para Go
O template para Go cobre convencoes idiomaticas: modules, error handling, testing, interfaces e patterns de concorrencia.
🎯 Conceito Principal
- •Go modules: Declare o uso de go modules e o path do modulo
- •Error handling: Go idiomatico: return error, nao panic. Check every error
- •Testing: Table-driven tests, testify assertions, test files _test.go
- •Interfaces: Accept interfaces, return structs. Interfaces no consumer side
💡 Dica Pratica
Go tem convencoes fortes da comunidade. O template deve reforcar essas convencoes idiomaticas porque o Claude as vezes gera Go com patterns de outras linguagens. Explicite: 'This is Go, follow Go idioms'.
📡 Template para Node.js/Express
O template para Node.js com Express cobre REST API patterns: routing, middleware, validation, error handling e estructura de projeto.
🎯 Conceito Principal
- •Express + TypeScript: Declare se usa TypeScript com Express ou JavaScript puro
- •Middleware pattern: Ordem de middlewares: cors, helmet, body-parser, auth, routes, error handler
- •Validation: Zod ou Joi para validacao de input em todas as rotas
- •Error handling: Centralized error handler middleware, custom error classes
💡 Dica Pratica
Com Express, o Claude tende a gerar codigo desestruturado se nao receber instrucoes claras. O template deve definir a estrutura de pastas e o pattern de routing para manter consistencia.
🔧 Adaptando Templates para Seu Caso
Nenhum template serve perfeitamente para todos os projetos. Voce precisa adaptar e customizar para refletir as decisoes unicas do seu projeto.
🎯 Conceito Principal
- •Remova o que nao se aplica: Se nao usa testes E2E, remova essa secao do template
- •Adicione o que falta: Templates sao genericos. Suas regras de negocio sao unicas
- •Ajuste convencoes: O template pode preferir named exports mas voce pode preferir default
- •Mantenha o formato: A estrutura de secoes funciona. Mude o conteudo, nao o formato
💡 Dica Pratica
Copie o template mais proximo da sua stack, abra no editor e leia secao por secao perguntando: 'Isso e verdade no meu projeto?'. Mude o que nao e, adicione o que falta, delete o que sobra. 15 minutos e voce tem um CLAUDE.md customizado.
👥 Compartilhando Templates no Time
Templates de CLAUDE.md podem ser compartilhados e padronizados dentro do time. Isso garante que todos os membros usem Claude Code com as mesmas instrucoes.
🎯 Conceito Principal
- •Template do time: Crie um template padrao que novos projetos devem usar como base
- •Repo de templates: Mantenha um repositorio central com templates por stack
- •Onboarding: Novos membros copiam o template e customizam para o projeto
- •Evolucao coletiva: O time inteiro contribui para melhorar os templates via PRs
💡 Dica Pratica
Crie um repo no GitHub do seu time chamado 'claude-templates' com um CLAUDE.md para cada stack que o time usa. Novos projetos fazem fork do template e customizam. Isso padroniza a qualidade das interacoes com o Claude Code em toda a empresa.
Exercicio Pratico
Exercicio: Criar Template CLAUDE.md para 2 Stacks
Tempo estimado: 15-20 minutos
Escolha 2 stacks
Selecione as 2 stacks que voce mais usa no dia a dia (ex: Next.js e Python).
Crie o template para a stack 1
Baseado nos exemplos deste modulo, crie um CLAUDE.md completo para a primeira stack.
Crie o template para a stack 2
Repita para a segunda stack, ajustando convencoes, comandos e patterns.
Teste em projetos reais
Aplique cada template em um projeto real da stack correspondente e verifique a qualidade do output do Claude.
📋 Resumo do Modulo
Proximo Modulo:
2.8 - Boas Praticas e Otimizacao (< 200 linhas)