Wie nutzt man einen KI-Assistenten, um einen großen oder unbekannten Codebase zu verstehen, den man gerade übernommen hat?

Question

Accepted Answer

Eine KI ist großartig zur **Orientierung** in unfamiliar Code — aber nur, wenn du sie **an den echten Dateien verankert** hältst, anstatt sie eine generische Version beschreiben zu lassen, was das System wahrscheinlich tut. Leite sie zu tatsächlichen Pfaden und bitte sie, zu lesen, bevor sie erklärt.

## Strategien, von breit bis spezifisch

- **Frage nach einer High-Level-Karte und Einstiegspunkten** — "Wo beginnt eine Anfrage? Was sind die Hauptmodule und wie hängen sie zusammen?" Das gibt dir einen Überblick, bevor du eintauchst.
- **Verfolge ein einzelnes Feature End-to-End** — wähle ein echtes Feature (z. B. "Benutzer-Login") und lass die KI es von der Route, durch den Controller und Service, zur Datenbank verfolgen. Tracing schlägt abstrakte Übersichten.
- **Fasse ein Modul nach dem anderen zusammen** — "Fasse zusammen, wofür `src/billing/` verantwortlich ist," nicht das ganze Repo auf einmal.
- **Erkläre unfamiliar Code** — füge eine knifflige Funktion ein und frage, was sie tut und warum, Zeile für Zeile.
- **Generiere eine Abhängigkeitsübersicht** — was importiert was, welche Module sind zentral, wo ist die Kopplung.

## Halte es verankert

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

Die verankerte Version zwingt die KI, ihre Antwort auf deinen Code zu stützen, sodass du jeden Schritt gegen die echten Dateien überprüfen kannst, anstatt einer plausiblen Verallgemeinerung zu vertrauen.

## Warum es wichtig ist

Eine große Codebase zu erben ist hauptsächlich ein **Lese- und Mapping-Problem**, und genau dort beschleunigt dich eine KI — sie kann ein Modul zusammenfassen, einen Flow verfolgen oder eine kryptische Funktion in Sekunden erklären und verwandelt Tage kalten Lesens in gelenkte Erkundung. Das Risiko besteht darin, dass eine nicht verankerte Eingabe dir eine selbstsichere, generische Antwort gibt, die nicht mit dem echten Code übereinstimmt. Wenn du jede Frage an **echte Dateipfade** ankernst und ihre Nachverfolgung gegen diese Dateien überprüfst, behältst du die Geschwindigkeit der KI, ohne ihre Halluzinationen zu erben — du baust schneller ein genaues mentales Modell auf, und du kannst ihm vertrauen, weil du es gegen die Quelle überprüft hast.