Proje haritası: ajan kodu okumadan önce nereye bakacağını bilsin

Harita tree-sitter ile kurulur. TypeScript, TSX, JavaScript, Python ve Go dosyalarında fonksiyon, sınıf, metot, arayüz, tip, enum ve sabitler; satır aralıkları, imzaları ve ilk doküman cümleleriyle çıkarılır. Rust, Java, PHP, Ruby gibi 30 kadar dil daha dosya yoluyla haritaya girer.

• Importlar proje dosyalarına çözülür; testler, import ettikleri ve adları eşleşen kaynak dosyalara bağlanır.
• Birlikte değişenler: son 500 commit’te en az iki kez birlikte değişen dosyalar eşleşir; 40’tan fazla dosyaya dokunan commit’ler sayılmaz.
• Dosyalar git ls-files ile bulunur ve .gitignore’a uyulur; node_modules, dist, build gibi klasörler ile 1 MB’ı aşan, üretilmiş ve küçültülmüş dosyalar atlanır.
• 20.000 dosyayı aşan depolarda yalnızca kaynak klasörleri (src, lib, app, packages/*/src…) indekslenir.

Harita ajana bir MCP sunucusu olarak eklenir. Sunucunun talimatı ajana göreve map_related ile başlamasını, bir dosyayı okumadan önce map_outline’a, kodu değiştirmeden önce map_usages’a bakmasını söyler. Yeni ajanın talimatına projenin modüllerini, giriş noktalarını ve test komutunu anlatan kısa bir özet de eklenir.

• map_related: bir görevin büyük olasılıkla dokunacağı dosyalar, nedenleriyle sıralı. Türkçe görev kelimeleri (sepet, kupon, ödeme…) koddaki İngilizce karşılıklarıyla da eşleşir.
• map_outline: bir dosyanın sembolleri satır aralıklarıyla, onu kaç dosyanın import ettiği ve testleri.
• map_usages: bir sembolün tanımı, çağrıldığı yerler, onu import eden dosyalar ve testler; bir dosya için import edenler ve onların import edenleri.
• map_find: sembol ya da dosya adında bulanık arama; tür, dosya:satır ve imza.
• map_overview: modüller, giriş noktaları ve test komutu. map_api ise node_modules’taki paketin kurulu sürümünün gerçek API’sini .d.ts dosyalarından okur.

Her klasör (proje ya da worktree) için tek harita vardır ve oradaki tüm ajanlar onu paylaşır. Dosya değişiklikleri izlenir, commit’ler birlikte değişenleri yeniden hesaplatır, ajanın sorduğu dosya cevaptan önce yeniden kontrol edilir. Harita bu bilgisayarda kurulur, token harcamaz; her ajan yalnızca kendi klasörünün haritasını okuyabilir.

Proje Detaylar → Proje haritası sekmesi dosyaları modüllere göre renklenen bir grafikte gösterir: import bağlantıları gri, birlikte değişenler kesikli turuncu çizilir. Bir görev yazıp “Göster” dersen ajanın bakacağı dosyalar nedenleriyle işaretlenir. AI verimi sekmesindeki “Proje haritası etkisi” kartı, haritayı kullanan ve kullanmayan konuşmaları başarı, ilk seferde geçme, görev başına token ve müdahale sayısıyla karşılaştırır.