Passo01
1 · Rode antes de ler
☐ Suba o projeto e use como usuário: cadastre, compre, cancele, erre de propósito.
☐ Anote as 3 telas ou rotas mais usadas. São elas que você vai estudar primeiro.
Dev júnior
O passo a passo para entender um código que você nunca viu.
7 passos, nesta ordem, para sair do “não entendo nada” para “sei onde mexer” em 1 dia. Com comandos e as perguntas certas para o time.
Os 7 passosrodeREADME e dependênciasporta de entradaum fluxo inteirodebuggertestes e históricodesenho confirmado
Quer ganhar autonomia mais rápido no código do time? Na mentoria, eu monto com você o plano de estudo para a vaga que você quer, ajusto o seu LinkedIn e te ensino a achar as melhores vagas.
Passo02
2 · Leia o README e as dependências
☐ README, CONTRIBUTING e a pasta docs, se existirem.
☐ package.json, requirements.txt, pom.xml ou go.mod: scripts (npm run dev, npm test) e bibliotecas principais.
☐ A árvore de pastas: tree -L 2 -I node_modules (ou ls nas pastas principais).
Passo03
3 · Ache a porta de entrada
☐ Procure onde a requisição chega: arquivo de rotas, controllers, main, index, app.
☐ Busque pela URL ou pelo texto da tela: grep -rn "/checkout" src (ou rg "/checkout").
☐ No front, busque pelo texto do botão que você clicou.
Passo04
4 · Siga um fluxo inteiro
☐ Escolha uma tela e siga do clique até o banco: rota → controller → serviço → query.
☐ Use “Ir para definição” e “Ver referências” do editor em cada função.
☐ Anote o caminho em uma lista. Não tente entender as funções que ficam fora dele.
Passo05
5 · Use o debugger
☐ Coloque um breakpoint na entrada do fluxo e execute a tela de novo.
☐ Avance linha a linha e veja os valores reais de cada variável.
☐ Sem debugger? Um log temporário em cada etapa resolve. Apague antes do PR.
Passo06
6 · Leia os testes e o histórico
☐ Os testes mostram o comportamento esperado: rode os do fluxo que você está estudando.
☐ git log -p --follow caminho/do/arquivo mostra cada mudança do arquivo.
☐ git blame na linha estranha leva ao PR que explica a decisão.
Passo07
7 · Desenhe e confirme
☐ Desenhe o fluxo em 5 caixas (papel, Excalidraw ou um bloco de texto).
☐ Mostre para alguém do time e pergunte: “Entendi que o pedido passa por A, B e C. Está certo?”
☐ Guarde o desenho no README ou na wiki. O próximo dev novo vai agradecer.
Frases prontas
“Qual é o fluxo mais importante para eu entender primeiro?”
“Tem alguma parte do código que todo mundo evita mexer? Por quê?”
“Onde ficam as regras de negócio principais?”
“Como eu rodo os testes e como sei se quebrei algo?”
“Quem é a melhor pessoa para perguntar sobre o banco e sobre o deploy?”
O júnior abre 40 arquivos e se perde. O sênior segue um fluxo e sabe onde mexer.
O júnior abre 40 arquivos e se perde. O sênior segue um fluxo do clique ao banco e já sabe onde mexer.
Rode → README e dependências → porta de entrada → um fluxo inteiro → debugger → testes e histórico → desenho confirmado.
Conteúdo sobre carreira dev, todo dia: @lucasadvice ↗
Mentoria
Entenda qualquer código e ganhe autonomia
Autonomia é o que separa o júnior do pleno. A mentoria acelera esse caminho: plano de estudo para a vaga que você quer, LinkedIn que mostra o seu trabalho e as empresas certas para conversar.