Cum folosești un asistent AI pentru a înțelege un codebase mare sau necunoscut pe care tocmai l-ai moștenit?

Question

Accepted Answer

Un AI este excelent pentru **orientare** în cod necunoscut — dar doar dacă îl păstrezi **ancorat în fișierele reale** în loc să-i permiți să descrie o versiune generică a ceea ce sistemul probabil face. Indică-i căile reale și cere-i să citească înainte să explice.

## Strategii, de la generale la specifice

- **Cere o hartă la nivel înalt și punctele de intrare** — "De unde pornește o cerere? Care sunt modulele principale și cum se raportează una la alta?" Aceasta îți oferă o vedere generală înainte să te cufunzi.
- **Urmărește o singură funcție de la capăt la capăt** — alege o funcție reală (de ex. "autentificare utilizator") și lasă AI-ul să o urmeze de la rută, prin controller și serviciu, până la baza de date. Urmărirea bate descrierile abstracte.
- **Rezumă un modul la un moment dat** — "Rezumează pentru ce este responsabil `src/billing/`", nu întregul repo deodată.
- **Explică cod necunoscut** — lipește o funcție complicată și cere-i ce face și de ce, linie după linie.
- **Generează o privire de ansamblu a dependențelor** — ce importă ce, care module sunt centrale, unde este cuplajul.

## Păstrează-l ancorat

```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
```

Versiunea ancorată forțează AI-ul să-și bazeze răspunsul pe codul tău, deci poți verifica fiecare pas împotriva fișierelor reale în loc să ai încredere într-o generalitate plauzibilă.

## De ce conteaza

Moștenirea unui codebase mare este în esență o **problemă de lectură și cartografiere**, și exact acolo accelerează te un AI — poate rezuma un modul, urmări un flux sau explica o funcție criptică în secunde, transformând zile de lectură rece în explorare ghidată. Riscul este că o comandă neancorata îți oferă un răspuns încrezător și generic care nu se potrivește codului real. Ancorând fiecare întrebare la **căi reale de fișiere** și verificând urmărirea ei împotriva acelor fișiere păstrezi viteza AI-ului fără a moșteni halucinațiile sale — construiești un model mental mai precis mai rapid, și poți avea încredere în el pentru că l-ai verificat pe bază de sursa.