Project Map: Agents wissen, wo sie suchen müssen, bevor sie lesen

Die Karte wird mit tree-sitter gebaut. In TypeScript-, TSX-, JavaScript-, Python- und Go-Dateien werden Funktionen, Klassen, Methoden, Interfaces, Typen, Enums und Konstanten mit Zeilenbereichen, Signaturen und dem ersten Satz ihrer Doku extrahiert. Rund 30 weitere Sprachen, etwa Rust, Java, PHP und Ruby, sind über den Dateipfad auf der Karte.

• Imports werden auf Projektdateien aufgelöst; Tests werden mit den Dateien verknüpft, die sie importieren, und mit Quelldateien gleichen Namens.
• Change together: Dateien, die in mindestens zwei der letzten 500 Commits gemeinsam geändert wurden, werden gepaart; Commits mit mehr als 40 Dateien werden ignoriert.
• Dateien werden mit git ls-files gefunden und .gitignore wird beachtet; Ordner wie node_modules, dist und build, Dateien über 1 MB sowie generierte und minifizierte Dateien werden übersprungen.
• In Repositories mit mehr als 20.000 Dateien werden nur Quellordner (src, lib, app, packages/*/src …) indexiert.

Die Karte wird dem Agent als MCP-Server hinzugefügt. Seine Anweisungen sagen dem Agent, eine Aufgabe mit map_related zu beginnen, vor dem Lesen einer Datei map_outline zu prüfen und vor Codeänderungen map_usages. Die Anweisungen eines neuen Agents erhalten außerdem eine kurze Zusammenfassung der Module, Einstiegspunkte und des Testbefehls des Projekts.

• map_related: die Dateien, die eine Aufgabe am wahrscheinlichsten betrifft, mit Begründung gerankt. Türkische Aufgabenwörter (sepet, kupon, ödeme …) passen auch auf ihre englischen Namen im Code.
• map_outline: die Symbole einer Datei mit Zeilenbereichen, wie viele Dateien sie importieren, und ihre Tests.
• map_usages: wo ein Symbol definiert und aufgerufen wird, die importierenden Dateien und ihre Tests; bei einer Datei ihre Importeure und deren Importeure.
• map_find: unscharfe Suche über Symbol- und Dateinamen, mit Art, Datei:Zeile und Signatur.
• map_overview: Module, Einstiegspunkte und der Testbefehl. map_api liest die echte API der installierten Version eines Pakets in node_modules aus seinen .d.ts-Dateien.

Es gibt eine Karte pro Ordner (ein Projekt oder ein Worktree), geteilt von allen Agents, die dort arbeiten. Dateiänderungen werden beobachtet, Commits lösen eine neue Zählung der gemeinsam geänderten Dateien aus, und eine Datei, nach der ein Agent fragt, wird vor der Antwort neu geprüft. Die Karte wird auf deinem Rechner gebaut und kostet keine Tokens; jeder Agent kann nur die Karte seines eigenen Ordners lesen.

Der Tab „Project map“ auf der Details-Seite eines Projekts zeichnet die Dateien als nach Modul eingefärbten Graph: Imports in Grau, gemeinsam geänderte Dateien als gestrichelte orange Linien. Gib eine Aufgabe ein und drücke „Show“, um die Dateien zu sehen, die ein Agent sich ansehen würde, mit Begründung. Die Karte „Project map impact“ im Tab AI ROI vergleicht Gespräche mit und ohne Karte nach Erfolg, Bestehen im ersten Anlauf, Tokens pro Aufgabe und Nachfragen.