Visao Geral: O que Faz e Como
O primeiro passo ao entrar num codebase novo e obter o big picture. O que o projeto faz? Qual o tech stack? Como esta organizado? O Claude Code responde tudo isso em segundos ao explorar a estrutura de diretorio, package.json, README e arquivos de configuracao.
🎯 Conceito Principal
A exploracao top-down comeca pelo mais alto nivel e vai aprofundando:
- •Proposito: O que este projeto faz? Qual problema resolve? Quem sao os usuarios?
- •Tech stack: Quais linguagens, frameworks, bancos de dados e servicos sao usados?
- •Estrutura: Como as pastas estao organizadas? Qual e o entry point? Onde ficam rotas, modelos, servicos?
💡 Dica Pratica
Use este prompt para obter o big picture de qualquer projeto:
Zoom In: Fluxos Especificos
Apos o big picture, e hora de mergulhar nos fluxos que importam. Autenticacao, processamento de pagamentos, pipeline de dados — peca ao Claude para tracar fluxos especificos que sao relevantes para o seu trabalho.
🎯 Conceito Principal
O zoom in dirigido foca nos fluxos mais importantes:
- •Fluxo de autenticacao: Como usuarios fazem login? JWT? Sessions? OAuth? Onde fica o middleware de auth?
- •Fluxo de dados: Como dados entram no sistema? Como sao processados, validados e persistidos?
- •Fluxo de negocio: Qual e o fluxo principal do negocio? Pedido, pagamento, entrega? Cada dominio tem seu fluxo critico
💡 Dica Pratica
Trace de Execucao
O trace de execucao e o nível mais profundo de entendimento. Voce pede ao Claude para seguir uma requisicao especifica do inicio ao fim: desde o endpoint HTTP ate a resposta ao usuario, passando por middlewares, controllers, services e repositories.
🎯 Conceito Principal
O request-response tracing revela como o sistema realmente funciona:
- •Request path: Por quais arquivos e funcoes a requisicao passa? Quais middlewares sao aplicados?
- •Data flow: Como os dados sao transformados em cada camada? Quais validacoes sao aplicadas?
- •Error handling: O que acontece quando algo da errado em cada ponto? Como os erros sao propagados?
💡 Dica Pratica
Criando Memoria com /init
Apos explorar o codebase, use o comando /init para criar uma memoria persistente do projeto. Isso gera um arquivo CLAUDE.md na raiz do projeto com informacoes que o Claude vai lembrar em sessoes futuras.
🎯 Conceito Principal
O /init cria a memoria de projeto que acelera todas as sessoes futuras:
- •CLAUDE.md gerado: Contem descricao do projeto, tech stack, convencoes de codigo e comandos comuns
- •Persistencia: O arquivo fica no repositorio e e lido automaticamente em toda nova sessao do Claude Code
- •Customizavel: Voce pode editar o CLAUDE.md para adicionar regras especificas, workflows preferidos e padroes do time
💡 Dica Pratica
Apos explorar o codebase, gere a memoria:
Revise o CLAUDE.md gerado e adicione informacoes que o Claude nao conseguiu inferir automaticamente, como regras do time, processos de deploy ou convencoes especiais.
Perguntando "Por Que"
As perguntas mais valiosas nao sao "o que" ou "como" — sao "por que". Por que esta biblioteca foi escolhida? Por que a autenticacao funciona assim? Por que ha uma camada extra aqui? Entender decisoes de design e tao importante quanto entender o codigo.
🎯 Conceito Principal
Understanding decisions revela o contexto que nao esta no codigo:
- •Decisoes arquiteturais: Por que microservicos? Por que monolito? Por que esta divisao de responsabilidades?
- •Trade-offs historicos: Certos padroes existem por razoes que so fazem sentido no contexto da epoca
- •Debt intencional: Nem todo "codigo feio" e acidental. Algumas decisoes foram conscientes e tem razoes validas
💡 Dica Pratica
Onboarding em 15 Minutos
Combinando todos os passos anteriores, voce pode fazer onboarding completo em qualquer projeto em 15 minutos. Esta e a tecnica de speed onboarding que transforma o Claude Code no melhor colega para te guiar num codebase desconhecido.
🎯 Conceito Principal
A tecnica speed onboarding segue uma sequencia otimizada:
- •Minutos 1-3: Big picture — proposito, stack, estrutura de pastas
- •Minutos 4-8: Zoom in — 2-3 fluxos criticos do negocio
- •Minutos 9-12: Trace — uma requisicao completa do inicio ao fim
- •Minutos 13-15: /init — criar memoria persistente do projeto
💡 Dica Pratica
Use um timer de 15 minutos e siga a sequencia. Ao final, voce tera um entendimento solido e um CLAUDE.md para sessoes futuras. Funciona para qualquer tamanho de projeto.
Exercicio Pratico
Clonar repo desconhecido e mapear arquitetura em 15 minutos
Clone um projeto open source que voce nunca viu e aplique a tecnica de speed onboarding.
Clone um repo desconhecido
Escolha um projeto popular que voce nunca explorou (ex: fastify, prisma, ou qualquer outro).
Aplique o speed onboarding de 15 minutos
Big picture → Zoom in → Trace → /init. Use timer.
Verifique seu entendimento
Tente explicar a arquitetura do projeto para alguem (ou escreva um resumo). Se conseguir, o onboarding funcionou.
✅ Criterios de Sucesso
📋 Resumo do Modulo
Proximo Modulo:
3.5 - Workflow: Escrever Testes