Como você usa um assistente de IA para entender um codebase grande ou desconhecido que você acabou de herdar?

Question

Accepted Answer

Uma IA é ótima para **orientação** em código desconhecido — mas apenas se você mantê-la **ancorada nos arquivos reais** em vez de deixá-la descrever uma versão genérica do que o sistema provavelmente faz. Aponte-a para caminhos reais e peça que ela leia antes de explicar.

## Estratégias, do amplo ao específico

- **Peça um mapa de alto nível e pontos de entrada** — "Onde uma requisição começa? Quais são os módulos principais e como se relacionam?" Isso lhe dá uma visão geral antes de mergulhar.
- **Rastreie um único recurso de ponta a ponta** — escolha um recurso real (ex: "login de usuário") e peça à IA para segui-lo da rota, passando pelo controller e service, até o banco de dados. Rastrear é melhor que visões gerais abstratas.
- **Resuma um módulo por vez** — "Resuma pelo que `src/billing/` é responsável", não todo o repo de uma vez.
- **Explique código desconhecido** — cole uma função complicada e pergunte o que ela faz e por quê, linha por linha.
- **Gere uma visão geral de dependências** — o que importa o quê, quais módulos são centrais, onde está o acoplamento.

## Mantenha-o ancorado

```text
❌ UNGROUNDED: "How does authentication usually work in a Node app?"
   → generic textbook answer; may not match THIS codebase at all

✅ GROUNDED: "Read src/auth/login.js and src/middleware/session.js.
             Trace what happens when POST /login is called, step by step,
             citing the functions involved."
   → the AI must read the actual files → its explanation maps to YOUR system
```

A versão ancorada força a IA a basear sua resposta no seu código, para que você possa verificar cada etapa contra os arquivos reais em vez de confiar em uma generalidade plausível.

## Por que isso importa

Herdar um codebase grande é principalmente um **problema de leitura e mapeamento**, e é exatamente onde uma IA o acelera — ela pode resumir um módulo, rastrear um fluxo ou explicar uma função críptica em segundos, transformando dias de leitura fria em exploração guiada. O risco é que um prompt não ancorado lhe dê uma resposta confiante e genérica que não corresponda ao código real. Ancorar cada pergunta a **caminhos de arquivo reais** e verificar seu rastreamento contra esses arquivos mantém a velocidade da IA sem herdar suas alucinações — você constrói um modelo mental preciso mais rápido, e pode confiar nele porque verificou contra a fonte.