MODULO 3.4

👾 Entender um Codebase Novo

Como usar o Claude Code para fazer onboarding rapido em qualquer projeto, entendendo arquitetura, padroes e fluxos em minutos.

6
Topicos
20
Minutos
Inic.
Nivel
Pratico
Tipo
1

🌍 Visao Geral (Big Picture)

Comece pedindo ao Claude uma visao geral da arquitetura do projeto. Isso te da o mapa antes de explorar os detalhes.

💡 Conceito Principal

Perguntas para entender o big picture rapidamente:

  • "Descreva a arquitetura geral deste projeto. Quais sao os principais modulos?"
  • "Quais tecnologias e frameworks este projeto usa?"
  • "Qual e a estrutura de pastas e o que cada pasta contem?"

Dica Pratica

Comece simples: claude "O que este projeto faz? Me de uma visao geral em 5 pontos"

2

🔬 Zoom In

Apos entender o big picture, mergulhe nos modulos especificos que voce precisa trabalhar.

💡 Conceito Principal

Explore areas especificas com perguntas direcionadas:

  • "Explique como o sistema de pagamentos funciona. Quais arquivos estao envolvidos?"
  • "Como os dados fluem do frontend ate o banco de dados?"
  • "Quais padroes de design sao usados neste modulo?"

Dica Pratica

Foque na area onde voce vai trabalhar: "Preciso mexer no modulo de usuarios. Me explique tudo sobre ele em detalhes"

3

🔄 Rastrear um Fluxo

Peca ao Claude para rastrear um fluxo completo de ponta a ponta. Isso e a melhor forma de entender como as pecas se conectam.

💡 Conceito Principal

Trace request flows para entender a integracao:

  • "Trace o fluxo completo quando um usuario faz login: do click no botao ate a resposta"
  • "Siga o caminho de um pedido: da criacao ate o envio do email de confirmacao"
  • O Claude vai listar cada arquivo e funcao na ordem em que sao chamados

Dica Pratica

Peca com detalhes: "Trace o fluxo incluindo: arquivo, funcao, linha, e o que cada passo faz"

4

📖 Usar /init

O comando /init gera um arquivo CLAUDE.md com um resumo do projeto, padroes e convencoes que o Claude usara em todas as interacoes futuras.

💡 Conceito Principal

O /init cria memoria persistente do projeto:

  • Digite /init na raiz do projeto
  • O Claude analisa o codebase e gera um arquivo CLAUDE.md com: tecnologias, estrutura, padroes, comandos uteis
  • Nas proximas sessoes, o Claude le o CLAUDE.md automaticamente e ja sabe o contexto

Dica Pratica

Rode /init assim que clonar um repo novo. Depois edite o CLAUDE.md para adicionar detalhes que voce descobriu manualmente.

5

❓ Perguntas "Por que?"

As perguntas mais valiosas sao as de "por que" - elas revelam decisoes de design, trade-offs e contexto historico que nenhum README explica.

💡 Conceito Principal

Perguntas "por que" para entender decisoes arquiteturais:

  • "Por que usaram MongoDB ao inves de PostgreSQL neste projeto?"
  • "Por que tem dois sistemas de autenticacao? Qual devo usar?"
  • "Por que esta funcao e tao complexa? Tem algum edge case especial?"

Dica Pratica

O Claude pode analisar o git log para inferir decisoes: "Olhe o historico de commits deste arquivo e me diga por que essa mudanca foi feita"

6

🚀 Onboarding Rapido

Combine todas as tecnicas para fazer onboarding em minutos ao inves de dias. O Claude transforma semanas de exploracao em uma conversa.

💡 Conceito Principal

Roteiro de onboarding completo em 5 passos:

  • 1. /init para gerar o CLAUDE.md
  • 2. Peca a visao geral da arquitetura
  • 3. Trace 2-3 fluxos principais do sistema
  • 4. Faca perguntas "por que" sobre decisoes que nao entendeu
  • 5. Peca: "Quais sao as armadilhas comuns que um novo dev encontraria neste projeto?"

Dica Pratica

Finalize com: "Se eu precisar adicionar uma nova feature de X, por onde eu comecaria? Quais arquivos preciso criar/modificar?"

📋 Resumo do Modulo

Big Picture - Entenda a arquitetura geral primeiro
Zoom In - Mergulhe nos modulos que vai trabalhar
Trace Flow - Siga fluxos de ponta a ponta
/init - Gere CLAUDE.md para memoria persistente
Why Questions - Pergunte "por que" para entender decisoes
Onboarding - Combine tudo para onboarding em minutos

Proximo Modulo:

3.5 - Escrever Testes