🔍 O que o /init Faz
O comando /init e um atalho do Claude Code que analisa automaticamente o seu projeto e gera um arquivo CLAUDE.md inicial. Ele examina a estrutura de pastas, arquivos de configuracao, dependencias e padroes existentes para criar um ponto de partida.
💡 Conceito Principal
O /init funciona em tres etapas automaticas:
- •Analise - Le package.json, pyproject.toml, Dockerfile, configs de linting, etc.
- •Inferencia - Identifica a stack, frameworks, padroes de codigo e estrutura
- •Geracao - Cria (ou atualiza) o CLAUDE.md com as informacoes detectadas
⚡ Dica Pratica
Para usar, basta digitar /init no prompt do Claude Code. O comando funciona em qualquer diretorio e detecta automaticamente o tipo de projeto.
⏰ Quando Usar o /init
O /init e mais util em situacoes especificas. Saber quando usa-lo (e quando nao usar) economiza tempo e evita resultados insatisfatorios.
💡 Conceito Principal
Os melhores cenarios para usar /init:
- •Projeto existente sem CLAUDE.md - Ponto de partida rapido
- •Onboarding em projeto novo - Entender a stack rapidamente
- •Apos grandes mudancas na stack - Atualizar o CLAUDE.md existente
⚡ Dica Pratica
Use /init como ponto de partida, nunca como resultado final. O CLAUDE.md gerado e um rascunho que precisa de revisao e personalizacao com as regras especificas do seu projeto.
📄 O que o /init Gera
O /init gera um CLAUDE.md com as secoes padrao, preenchidas com base na analise automatica do projeto. O resultado varia conforme o tipo de projeto e as informacoes disponiveis nos arquivos de configuracao.
💡 Conceito Principal
O /init tipicamente gera:
# Exemplo de saida do /init em um projeto Next.js:
# CLAUDE.md
## Project Overview
Next.js application with TypeScript...
## Tech Stack
- Next.js 14, React 18, TypeScript
- Tailwind CSS, Prisma...
## Commands
- npm run dev, npm run build, npm test...
## Code Style
- ESLint config detected...
## Project Structure
- src/app/ - pages, src/components/ - components...
- •Detecta stack a partir de package.json/pyproject.toml
- •Extrai comandos dos scripts definidos no projeto
- •Mapeia a estrutura de diretorios principal
⚡ Dica Pratica
Revise sempre o CLAUDE.md gerado. O /init pode detectar o framework mas nao sabe se voce usa App Router ou Pages Router, se prefere Server Components, ou quais convencoes de naming a equipe adota.
✏️ Customizando o Resultado
Apos o /init gerar o CLAUDE.md, o proximo passo e customizar e enriquecer o conteudo com informacoes que so voce (e sua equipe) conhece sobre o projeto.
💡 Conceito Principal
O processo de customizacao segue uma checklist:
- 1.Revise o overview - adicione contexto de negocio e escala
- 2.Verifique versoes na tech stack - especifique versoes exatas
- 3.Adicione o comando de teste individual (quase nunca gerado)
- 4.Escreva as Code Conventions da equipe
- 5.Adicione a secao Things To Avoid (nunca gerada pelo /init)
- 6.Inclua contexto adicional (migracoes, areas sensiveis, decisoes)
⚡ Dica Pratica
A secao "Things To Avoid" quase nunca e gerada pelo /init, mas e uma das mais valiosas. Adicione-a manualmente apos o /init com pelo menos 5 regras do que o Claude nao deve fazer no seu projeto.
⚠️ Limitacoes do /init
O /init e uma ferramenta util, mas tem limitacoes claras que voce deve conhecer para nao confiar excessivamente no resultado gerado automaticamente.
💡 Conceito Principal
Principais limitacoes a considerar:
- •Nao conhece convencoes da equipe - So detecta o que esta nos configs, nao decisoes verbais
- •Nao gera Things To Avoid - Nao sabe quais erros voce ja encontrou
- •Pode ser generico demais - Descreve o framework, nao o SEU uso dele
- •Nao detecta padroes arquiteturais - Nao sabe se voce usa DDD, Clean Architecture, etc.
- •Pode detectar errado - Em monorepos complexos, pode confundir as stacks
⚡ Dica Pratica
Nunca aceite o resultado do /init sem revisao. Trate-o como um rascunho que precisa de pelo menos 15 minutos de edicao para se tornar realmente util. A parte manual e o que faz a diferenca.
🔄 Combinando /init com Edicao Manual
A melhor abordagem e usar o /init como bootstrap e depois refinar manualmente. Esse fluxo combinado cria um CLAUDE.md completo em minutos, em vez de horas escrevendo do zero.
💡 Conceito Principal
O fluxo recomendado em 5 passos:
# Passo 1: Gere o base
$ claude
> /init
# Passo 2: Revise o resultado
> Revise o CLAUDE.md e me diga o que falta
# Passo 3: Adicione Things To Avoid
# (edite manualmente ou peca ao Claude)
# Passo 4: Adicione convencoes especificas
# (nomes de variaveis, padroes de commit, etc.)
# Passo 5: Commite e compartilhe com a equipe
$ git add CLAUDE.md && git commit -m "add CLAUDE.md"
- •Use /init para o esqueleto, adicione a alma manualmente
- •Peca ao proprio Claude para sugerir melhorias no CLAUDE.md
- •Atualize o CLAUDE.md ao longo do tempo conforme o projeto evolui
⚡ Dica Pratica
Apos algumas semanas usando o Claude Code com o CLAUDE.md, rode /init novamente e compare. O Claude pode detectar novos padroes que surgiram. Faca merge das novas informacoes com as que voce ja tinha.
📋 Resumo do Modulo
Trilha 2 Concluida!
Voce agora sabe tudo sobre CLAUDE.md. Volte para a pagina da Trilha 2 para revisar os modulos.