Arama doğru bilgiyi nasıl bulur

Bir çalışma alanında binlerce hafıza kaydı, kural ve beceri bulunabilir. Aramanın işi, önemli olan birkaçını asistan işe başlamadan önce bağlamına koymak ve gerisini dışarıda bırakmaktır. Bu sayfa, bu seçimin ne yaptığını ve zamanla nasıl iyileştiğini anlatır. Önceliklendirmenin nasıl hesaplandığı Pathrule'un tescilli motorunun bir parçasıdır ve yayımlanmaz.

Önce yol kapsamı

İlk filtre konumdur. Her hafıza kaydı, kural ve beceri bir düğüm yolunda yer alır. Asistan /apps/api/payments içinde çalışırken Pathrule, o yola sabitlenmiş olanlardan ve üstündeki yollardan miras aldıklarından başlar. /apps/web/dashboard içindeki küçük bir arayüz değişikliği, veritabanı migration'larıyla ilgili kuralları getirmez.

Bu, Temel kavramlar sayfasında anlatılan yol kapsamının ta kendisidir; burada ilk eleme olarak uygulanır. Daha maliyetli herhangi bir işlem çalışana kadar aday kümesi zaten küçülmüş olur.

Anlam ve anahtar kelimeler bir arada

Yol alanı daralttıktan sonra Pathrule, niyetinizi adaylarla aynı anda iki yoldan eşleştirir.

• Anahtar kelime eşleştirme tam isabetleri yakalar: bir dosya adı, bir fonksiyon adı, bir hafıza kaydı başlığındaki birebir bir ifade.
• Anlama dayalı eşleştirme gerisini yakalar: hafıza kaydının yazıldığından farklı ifade edilmiş bir soru, eş anlamlı bir sözcük, başka sözcüklerle söylenmiş bir ifade, kayıtla hiç ortak kelimesi olmayan bir kavram.

İkincisi, fazladan adımları olan bir metin araması değildir. Her kayıt ve isteğiniz, paylaştıkları kelimelere göre değil, ne anlama geldiklerine göre karşılaştırılır; bu yüzden hiç ortak dize olmadan da eşleşme olabilir. Bkz. Pathrule neleri hesaplar.

Hiçbiri tek başına yeterli değildir. Anahtar kelime araması, aynı şeyi başka kelimelerle söyleyen bir hafıza kaydını kaçırır. Anlama dayalı arama ise tam bir dosya adı eşleşmesini bulanıklaştırabilir. Pathrule ikisini birleştirir; böylece tam eşleşme önceliğini korur, aynı fikri farklı kelimelerle anlatan bir eşleşme de yine öne çıkar.

Bir Cloud çalışma alanında prompt hook'u, bilginin anlama göre önceliklendirilebilmesi için prompt'unuzun başını (yaklaşık ilk 1.000 karakteri) Pathrule Cloud'a gönderir. Bu çağrı yavaş kalırsa veya başarısız olursa hook, o prompt için yerel dizine geri döner. Hesap olmadan, yerel modda eşleştirme yol kapsamına ve anahtar kelimelere dayanır.

Üzerinde çalıştığınız dosyanın komşuları

Hem yol kapsamı hem anlam, asistanın çalıştığı yerden yola çıkar. Ek bir sinyal bunu biraz genişletir: Pathrule, ekibinizin aynı iş kapsamında alışkanlık olarak birlikte değiştirdiği dosyaları öğrenir ve bu komşulara bağlı bilginin de öne çıkmasına izin verir.

Bu sayede, alındığı dosyaya bir kez kaydedilmiş bir karar, prompt o dosyadan hiç söz etmese bile ona ihtiyaç duyan oturumlara ulaşır. Sinyal dosya içeriklerinden değil, dosya yollarından oluşturulur: ajanlarınızın kaydedilen çalışmalarının dokunduğu yollardan ve bir Cloud çalışma alanında yakın tarihli git geçmişinin dosya yollarından alınan tek seferlik bir başlangıç verisinden. Böylece ekibiniz henüz pek çalışma kaydetmemişken de işe yarar. Dosyalar artık birlikte değişmedikçe sinyal zayıflar. Bir Cloud çalışma alanında, komşulardan biri asistanın önündeki dosyayla özellikle sık birlikte değişiyorsa, ajanın istediği bağlam o dosyanın adını veren tek satırlık bir uyarı da taşır. Bkz. Birlikte değişen dosyalar.

Diller arasında çalışır

Anlama dayalı eşleştirme tek bir dile bağlı değildir. Türkçe bir prompt, İngilizce yazılmış bir hafıza kaydını öne çıkarabilir; karışık dilde yazılmış bir prompt da doğru kaydı yine bulabilir.

Bu, düz anahtar kelime aramasının çözemediği durumdur. Prompt ile hafıza kaydı aynı fikri paylaşıp hiç ortak kelime içermediğinde eşleştirmenin yazılışa göre değil, anlama göre çalışması gerekir.

En iyi eşleşmeler kullanıma hazır gelir

Arama iki kademede iletir. Prompt'a açıkça uyan kayıtlar tam içerik olarak gelir; böylece asistan gidip okumak yerine doğrudan ekibinizin bilgisiyle çalışır. Her turda, prompt başına bir bütçe dahilinde yalnızca en ilgili birkaç kayıt gönderilir ve asistanda zaten bulunan içerik tekrar gönderilmez; böylece asistan bütün bilgi tabanını taşımadan ihtiyacı olanı alır.

Uygun olan diğer her şey bir ad, bir id ve tek bir satır olarak gelir. Bu, asistanın kaydı tanıması ve önemli olduğu anlaşılırsa gövdesini çekmesi için yeterlidir; böylece sığmayan ilgili bir kayıt da atılmaz, listede yer alır. Beceriler adlarıyla sunulur, çünkü bir prosedür dayatılmamalı, istenmelidir. Birbirinden ayrı iki şey soran bir prompt parça parça eşleştirilir; böylece iki kısım da bilgi alır. Üçünü de Neler tam içerikle, neler yalnızca adıyla gelir sayfası ele alır.

Adaylar kanıttır, yanıt değil

Arama emin olmadığında eminmiş gibi davranmaz. Pathrule olası kayıtları aday olarak öne çıkarır ve asistana, birine göre hareket etmeden önce tam gövdeyi okumasını söyler. Aday, kontrol etmeye değer bir işarettir; tekrarlanacak bir bilgi değildir.

Bu, Pathrule'un yanlış bağlamın hiç bağlam olmamasından daha kötü olduğu yönündeki kalıcı kuralından gelir. Belirsiz bir durumda Pathrule bir yanıtı kesinmiş gibi sunmak yerine bir aday gösterir.

Bilginin gerçekte nasıl kullanıldığından öğrenir

Arama, bir hafıza kaydının yazıldığı anda donup kalmaz. Pathrule zaman içinde hangi kayıtların hangi tür işlerde gerçekten yardımcı olduğunu gözlemler ve bunun gelecekteki sonuçları etkilemesine izin verir. Bir görev türünde sürekli işe yaradığını kanıtlayan bir kaydın benzer işlerde ileride öne çıkma olasılığı artar.

Bu gözlem, birinin verdiği bir puan değil, somuttur. Her iletim, turun nasıl geçtiğiyle birlikte kaydedilir: iletilen kayıtlardan hangilerine asistanın yalnızca sahip olmakla kalmayıp gerçekten başvurduğu, işin kaç araç çağrısı gerektirdiği ve bunlardan kaçının hangi dosyalarda başarısız olduğu. Bilgi aldığı halde yine de başarısızlıklarla karşılaşan bir tur, kendisine verilen bilginin aleyhine sayılır.

Bu kayıt istenmez; iletimi yapan katmanın kendisi tarafından tutulur. Turun ölçülmesi için asistanın bir araç çağırması veya herhangi bir şekilde iş birliği yapması gerekmez; bu da döngüyü istemciler arasında tutarlı tutar.

Kayıt iş türüne göre tutulduğundan sonuç, kayıt başına tek bir puan değildir. Aynı hafıza kaydı bir migration için yüksek, küçük bir arayüz değişikliği için düşük öncelik alabilir. Elle güncellenen tek bir önem alanı bu farkı ifade edemez.

Öğrenme bilinçli olarak temkinlidir.

• Belirsiz sonuçlar öğretmez. Sonucu belirsiz olan bir tur ders olarak kullanılmaz.
• Açık bir isabetsizlik azaltır, silmez. Tek bir açık isabetsizlik, bir kaydın o iş türündeki konumunu düşürür ama geçmişini tamamen silmez.
• Etki zamanla azalır. Güncel kodla örtüşmeyi bırakan bir kayıt, sonuçları bozmaya devam etmek yerine geri planda kalır.

Üstelik öğrenme miktarı değil, seçimi değiştirir. Bir kaydın kanıtladıkları onu eşit derecede ilgili bir rakibinin önüne geçirebilir; ancak herhangi bir şeyin gönderilip gönderilmeyeceğine karar veren ilgi eşiğinin ötesine itmez. Zamanla bir çalışma alanı, aynı miktarda bağlamla her turda daha isabetli birkaç kayıt iletir. Öğrenme bağlama yer açmaz, isabeti artırır.

Bu döngüyü baştan sona Bilgi nasıl katlanarak büyür sayfası, eskimiş kayıtların incelemeye nasıl çıkarıldığını ise Öneriler ve öz denetim sayfası ele alır.

Tüm ekip için aynı

Bir Cloud çalışma alanında önceliklendirme, her kişinin istemcisindeki ayrı bir kopyaya değil, Pathrule Cloud'daki çalışma alanının ortak verilerine dayanır. Aynı yolda aynı şeyi soran iki ekip arkadaşı, hangi kodlama ajanını kullanırlarsa kullansınlar tutarlı sonuçlar alır. Claude Code ve Codex, prompt'a göre önceliklendirilmiş seçimi prompt gönderim hook'ları üzerinden alır. Cursor ve GitHub Copilot'ta prompt gönderim hook'u yoktur; bu yüzden onlarda yola bağlı bilgiyi oturum ve araç hook'ları taşır. Windsurf dahil her istemci, MCP sunucusundan pathrule_get_context ile bağlam istediğinde önceliklendirilmiş bir seçim alır.

Bu, öğrenmenin de ortak olduğu anlamına gelir. Bir kayıt işe yaradığını kanıtladığında yalnızca onu tetikleyen kişi için değil, ekipteki herkes için daha iyi öne çıkar.

Aramanın görmedikleri

Arama; ekibinizin yazdığı hafıza kayıtları, kurallar ve beceriler ile birlikte üzerinde çalıştığınız yol, isteğinizdeki kelimeler ve geçmiş çalışmaların nasıl gittiğine dair kayıt üzerinde çalışır. Kaynak dosyalarınızın içeriğini okumaz, dizinlemez ve yüklemez. Eşleştirme deponun kendisi üzerinde değil, ekibinizin yazmayı seçtiği bilgi üzerinde çalışır.

Bir Cloud çalışma alanı, bir çalışma kopyasından dosya yollarını alır: bir ajan ilk kez derin bağlam istediğinde Pathrule, hangi dosyaların birlikte değiştiğine dair başlangıç verisi için yakın tarihli git geçmişinin dosya yollarını, kullanılan teknolojileri tanımak için de klasör ağacının üst kısmındaki dosya adlarını okur. Bundan ayrı olarak pathrule snapshot, siz veya ajanınız çalıştırdığınızda dosya ağacını, manifest dosyalarını, kısa doküman örneklerini ve yakın tarihli git meta verilerini yükler. Neyin okunduğunu ve neyin saklandığını Pathrule neleri hesaplar sayfası listeler.

Bu sayfanın yeri

• Temel kavramlar, aramanın kullandığı ilk filtre olan yol kapsamını tanımlar.
• Hook'lar nasıl çalışır, seçilen ilgili kısmın asistana ilk araç çağrısından önce nasıl ulaştığını anlatır.
• Bilgi nasıl katlanarak büyür, aramayı iletme, yakalama ve puanlama döngüsünün içine yerleştirir.