Codebasis kartieren

Ein Repo, das du nie gesehen hast, von drei Agenten gleichzeitig gelesen.

In einer Codebasis, die du nicht kennst, geht der erste Tag damit drauf herauszufinden, wo was liegt. Setz eine Haupt-Session auf das Repo an, und sie teilt das Lesen auf: Ein Helfer nimmt die Datenschicht, einer die API, einer Frontend und Build. Jeder schickt eine kurze Zusammenfassung mit Dateipfaden zurück, und die Haupt-Session schreibt aus allen einen Überblick.

Kostenlos und Open SourceLäuft auf Mac und LinuxDeine eigenen Logins für Claude und Codex
Das Claude-Code-Terminal der Haupt-Session, nachdem ihre Helfer berichtet haben, mit ihrer zusammengefassten Übersicht
Aufgenommen auf einem Demo-Rechner: Die Haupt-Session fasst zusammen, was ihre Helfer zurückgeschickt haben.

Lass einen Agenten ein großes Repo erklären, und du bekommst eine Führung durch den ersten Ordner

Eine einzige Session liest alles selbst, und ein großes Repo passt nicht hinein. Die Teile, die sie zuerst gelesen hat, kommen ausführlich heraus, und der Rest bekommt je einen Satz.

Ein Agent für sich allein
  • Ein Leser, der sich durch das ganze Repo arbeitet
  • Details, wo er angefangen hat, Vermutungen überall sonst
  • Jede Rückfrage startet das Lesen von vorn
Agenten nebeneinander in Overvibe
  • Ein Helfer pro Bereich, alle lesen gleichzeitig
  • Ein Überblick, geschrieben aus jedem Bericht
  • Rückfragen gehen an den Helfer, der diesen Teil gelesen hat

Drei Leserund ein Überblick

Du tippst

Ich bin neu in diesem Repo. Lass Helfer die Hauptteile parallel kartieren und schreib mir einen Überblick in ARCHITECTURE.md.

  1. 1Die Haupt-Session teilt das Repo auf

    Sie sieht sich die Ordner auf oberster Ebene an und gibt jedem Helfer einen Bereich und dieselben drei Fragen: Was liegt hier, wer ruft es auf, was ist riskant zu ändern?

  2. 2Helfer lesen, niemand bearbeitet

    Jeder in seinem eigenen Terminal unter der Haupt-Session, und jeder meldet mit Dateipfaden, was er gefunden hat.

  3. 3Der Überblick kommt zurück

    Die Haupt-Session schreibt ARCHITECTURE.md aus den Berichten und schließt mit dem, was sie noch nicht weiß.

Dahinter steckt ein Helfer pro Bereich. Die zweite Zeile ist für später: Der Helfer, der die API gelesen hat, kommt mit seiner Unterhaltung zurück und antwortet aus dem, was er schon gelesen hat. Zur CLI-Referenz

$ overvibe new --attach --tool codex --cwd . --name "repo: map api" \
    --prompt "Read src/api. What is here, what calls it, what is risky to change? Give paths. Do not edit. When done, run: overvibe send \"$OVERVIBE_SESSION\" \"<map>\""
$ overvibe resume "repo: map api" --prompt "Where does the API check auth?"

Ein Agent genügt, wenn

das Repo klein genug ist, um es in einem Durchgang zu lesen, oder dich nur eine Ecke davon interessiert. Frag Claude direkt. Helfer lohnen sich, sobald das Repo mehrere Teile hat, für die man jeweils eine Weile zum Lesen braucht.

Fragen

Ändern die Helfer etwas?

Der Prompt sagt ihnen, dass sie es nicht sollen. Bei einem Repo, dem du noch nicht traust, starte sie mit --mode ask. Dann fragt jedes Tool, bevor es etwas ausführt, und du antwortest in Overvibe.

Was ist der Unterschied zu einem Recherche-Briefing?

Dasselbe Muster, auf Code gerichtet. Das Recherche-Briefing deckt Quellen außerhalb des Repos ab, etwa Doku, das Web und Exporte.

Kann ich einen Tag später noch Fragen stellen?

Ja. Stopp die Helfer, sobald der Überblick da ist, und overvibe resume holt einen mit seiner Unterhaltung zurück, wenn du eine Frage zu seinem Teil hast.

Weitere Wege, Agenten zusammenzuspannen

Hol dir den Überblick, bevor du den Code liest

Installier Overvibe, öffne eine Haupt-Session im Repo und bitte um einen Helfer pro Bereich.

Die Overvibe-App: ein Koordinator mit seinen Helfern Codex und Gemini (agy) in der Seitenleiste, jeder mit seinem Status, und eine Session, die auf dich wartet