Carte du projet : les agents savent où chercher avant de lire

La carte est construite avec tree-sitter. Dans les fichiers TypeScript, TSX, JavaScript, Python et Go, les fonctions, classes, méthodes, interfaces, types, enums et constantes sont extraits avec leurs plages de lignes, leurs signatures et la première phrase de leur documentation. Une trentaine d’autres langages, comme Rust, Java, PHP et Ruby, figurent sur la carte par chemin de fichier.

• Les imports sont résolus vers les fichiers du projet ; les tests sont liés aux fichiers qu’ils importent et aux fichiers source de même nom.
• Changent ensemble : les fichiers modifiés ensemble dans au moins deux des 500 derniers commits sont associés ; les commits touchant plus de 40 fichiers sont ignorés.
• Les fichiers sont trouvés avec git ls-files et .gitignore est respecté ; les dossiers comme node_modules, dist et build, les fichiers de plus de 1 Mo, générés ou minifiés sont ignorés.
• Dans les dépôts de plus de 20 000 fichiers, seuls les dossiers source (src, lib, app, packages/*/src…) sont indexés.

La carte est ajoutée à l’agent comme serveur MCP. Ses instructions lui demandent de commencer une tâche par map_related, de consulter map_outline avant de lire un fichier et map_usages avant de modifier du code. Les instructions d’un nouvel agent reçoivent aussi un court résumé des modules du projet, de ses points d’entrée et de sa commande de test.

• map_related : les fichiers qu’une tâche concerne le plus probablement, classés avec leurs raisons. Les mots de tâche en turc (sepet, kupon, ödeme…) correspondent aussi à leurs noms anglais dans le code.
• map_outline : les symboles d’un fichier avec leurs plages de lignes, le nombre de fichiers qui l’importent et ses tests.
• map_usages : où un symbole est défini et appelé, les fichiers qui l’importent et ses tests ; pour un fichier, ses importeurs et leurs importeurs.
• map_find : recherche approximative sur les noms de symboles et de fichiers, avec le type, fichier:ligne et la signature.
• map_overview : modules, points d’entrée et commande de test. map_api lit l’API réelle de la version installée d’un paquet dans node_modules à partir de ses fichiers .d.ts.

Il y a une carte par dossier (un projet ou un worktree), partagée par tous les agents qui y travaillent. Les changements de fichiers sont surveillés, les commits déclenchent un nouveau calcul des fichiers qui changent ensemble, et un fichier sur lequel un agent pose une question est revérifié avant la réponse. La carte est construite sur votre ordinateur et ne coûte aucun jeton ; chaque agent ne peut lire que la carte de son propre dossier.

L’onglet Project map de la page Details d’un projet dessine les fichiers sous forme de graphe coloré par module : imports en gris, fichiers qui changent ensemble en lignes orange pointillées. Saisissez une tâche et appuyez sur « Show » pour voir les fichiers qu’un agent consulterait, avec les raisons. La carte « Project map impact » de l’onglet AI ROI compare les conversations qui ont utilisé la carte à celles qui ne l’ont pas fait, selon la réussite, la validation du premier coup, les jetons par tâche et les relances.