Comment utilisez-vous un assistant IA pour comprendre une base de code volumineuse ou méconnue que vous venez d'hériter ?

Question

Accepted Answer

Un assistant IA est excellent pour **s'orienter** dans un code méconnu — mais seulement si vous le **gardez ancré dans les vrais fichiers** plutôt que de le laisser décrire une version générique de ce que le système fait probablement. Pointez-le vers des chemins réels et demandez-lui de lire avant d'expliquer.

## Stratégies, du général au spécifique

- **Demandez une carte de haut niveau et les points d'entrée** — « Par où commence une requête ? Quels sont les modules principaux et comment sont-ils liés ? » Cela vous donne une vue d'ensemble avant de plonger.
- **Tracez une seule fonctionnalité de bout en bout** — choisissez une vraie fonctionnalité (par exemple « connexion utilisateur ») et demandez à l'IA de la suivre de la route, à travers le contrôleur et le service, jusqu'à la base de données. Le traçage surpasse les overviews abstraits.
- **Résumez un module à la fois** — « Résumez ce dont `src/billing/` est responsable », pas tout le repo à la fois.
- **Expliquez du code méconnu** — collez une fonction compliquée et demandez ce qu'elle fait et pourquoi, ligne par ligne.
- **Générez un aperçu des dépendances** — qui importe quoi, quels modules sont centraux, où se trouve le couplage.

## Gardez-le ancré

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

La version ancrée force l'IA à baser sa réponse sur votre code, pour que vous puissiez vérifier chaque étape contre les vrais fichiers au lieu de faire confiance à une généralité plausible.

## Pourquoi c'est important

Hériter d'une grande base de code est principalement un **problème de lecture et de cartographie**, et c'est exactement là où un assistant IA vous accélère — il peut résumer un module, tracer un flux ou expliquer une fonction énigmatique en quelques secondes, transformant des jours de lecture à froid en exploration guidée. Le risque est qu'une requête sans ancrage vous donne une réponse générique confiante qui ne correspond pas au code réel. Ancrer chaque question à des **chemins de fichiers réels** et vérifier son traçage contre ces fichiers garde la rapidité de l'IA sans hériter de ses hallucinations — vous construisez un modèle mental précis plus rapidement, et vous pouvez le vérifier parce que vous l'avez vérifié par rapport à la source.