⚡ O que o /init Faz
O comando /init e um slash command do Claude Code que analisa automaticamente seu projeto e gera um CLAUDE.md baseado no que encontra. Ele le package.json, requirements.txt, go.mod, Dockerfiles e qualquer arquivo de configuracao para montar um perfil completo do projeto.
🎯 Conceito Principal
- •Scan automatico: Le arquivos de configuracao, dependencias, scripts e estrutura de pastas
- •Geracao de CLAUDE.md: Produz um arquivo CLAUDE.md com todas as secoes preenchidas
- •Deteccao de stack: Identifica linguagem, framework, banco de dados, ferramentas de teste
- •Deteccao de comandos: Le scripts do package.json, Makefile, etc. para popular a secao Commands
💡 Dica Pratica
Rode /init no seu projeto agora e veja o resultado. Mesmo que voce ja tenha um CLAUDE.md, comparar com o que /init gera pode revelar informacoes que voce esqueceu de incluir.
📅 Quando Usar /init
O /init e mais util em cenarios especificos. Nem sempre e a melhor opcao, mas quando e, economiza muito tempo.
🎯 Conceito Principal
- •Projeto novo: Voce acabou de criar o repo e quer um CLAUDE.md rapido como ponto de partida
- •Onboarding: Voce entrou em um projeto existente e quer entender rapidamente a estrutura
- •Auditoria: Voce quer verificar se seu CLAUDE.md atual cobre tudo que o /init detectaria
- •Prototipo: Projeto rapido onde voce quer um CLAUDE.md minimo sem esforco manual
💡 Dica Pratica
O melhor workflow: rode /init para gerar a base, depois edite manualmente para adicionar suas convencoes especificas. O /init cuida dos fatos (stack, comandos), voce cuida das opinoes (convencoes, patterns).
🔍 O que /init Detecta Automaticamente
O /init e surpreendentemente bom em detectar informacoes do projeto. Ele analisa multiplos arquivos de configuracao para montar um perfil completo.
🎯 Conceito Principal
- •Linguagem e versao: Detecta via package.json, pyproject.toml, go.mod, Cargo.toml
- •Framework: Identifica Next.js, React, FastAPI, Express, Django, etc.
- •Comandos: Extrai scripts do package.json, Makefile, docker-compose.yml
- •Estrutura: Mapeia diretorios principais e seus propositos
- •Dependencias: Lista dependencias importantes e ferramentas de desenvolvimento
💡 Dica Pratica
O /init detecta fatos, nao opinoes. Ele sabe que voce usa Next.js 14 e pnpm, mas nao sabe que voce prefere named exports ou que nunca quer usar 'any'. A parte de convencoes e opinoes voce precisa adicionar manualmente.
✎️ Editando o Resultado do /init
O CLAUDE.md gerado pelo /init e um ponto de partida, nao o produto final. Voce precisa editar e complementar com informacoes que so voce conhece.
🎯 Conceito Principal
- •Adicione convencoes: O /init nao detecta convencoes de codigo. Adicione suas regras de estilo
- •Adicione Things To Avoid: Regras negativas vem da experiencia, nao da analise de arquivos
- •Refine descricoes: O /init pode gerar descricoes genericas. Torne-as especificas para seu projeto
- •Remova redundancias: Nem tudo que o /init detecta e relevante para o CLAUDE.md. Corte o excesso
💡 Dica Pratica
Trate o output do /init como um primeiro draft. Abra no editor, leia secao por secao, e pergunte: 'Isso e util pro Claude saber?'. Se sim, mantenha. Se nao, corte. Depois adicione o que falta.
🔄 /init em Projetos Existentes
Rodar /init em um projeto que ja tem CLAUDE.md requer cuidado. O comportamento depende da configuracao, mas o padrao e perguntar se voce quer sobrescrever.
🎯 Conceito Principal
- •Backup primeiro: Antes de rodar /init num projeto com CLAUDE.md existente, faca backup
- •Comparacao: Use o resultado do /init para comparar com seu CLAUDE.md atual
- •Merge manual: Copie do /init o que esta faltando no seu CLAUDE.md atual
- •Nao sobrescreva: Raramente faz sentido substituir um CLAUDE.md curado manualmente pelo /init
💡 Dica Pratica
O truque: rode /init e salve o resultado em um arquivo temporario. Depois compare com seu CLAUDE.md atual usando diff. Adicione o que esta faltando e ignore o que o /init gerou de forma generica.
⚖️ Comparando /init vs CLAUDE.md Manual
Cada abordagem tem vantagens e desvantagens. A melhor estrategia e combinar as duas: /init para a base, manual para a qualidade.
🎯 Conceito Principal
- •/init: rapido e automatico: Em 5 segundos voce tem um CLAUDE.md funcional com fatos do projeto
- •Manual: preciso e customizado: Voce define exatamente o que importa com o nivel de detalhe certo
- •Combinacao ideal: /init gera a base com fatos + voce adiciona convencoes e opinoes
- •Manutencao: Re-rode /init periodicamente para verificar se faltam novos comandos ou dependencias
💡 Dica Pratica
O workflow ideal: /init no dia 1, edicao manual no dia 2, e re-execucao do /init a cada mes para verificar se algo mudou no projeto que deveria estar no CLAUDE.md.
Exercicio Pratico
Exercicio: Rodar /init em 3 Projetos e Comparar
Tempo estimado: 15-20 minutos
Escolha 3 projetos
Selecione projetos com stacks diferentes (ex: um Next.js, um Python, um script simples).
Rode /init em cada um
Abra Claude Code em cada projeto e rode /init. Salve o resultado de cada um.
Compare os resultados
Analise: o que e comum entre todos? O que e especifico de cada stack?
Edite o melhor
Escolha o projeto mais importante e transforme o resultado do /init em um CLAUDE.md completo e curado.
📋 Resumo do Modulo
Proximo Modulo:
2.7 - Templates por Stack (Next.js, Python, Go)