İçeriğe geç
Pathrule

dokümanlar

Hangi konu kime sorulmalı

Ekip üyesi profilleri her kişiye çalıştığı alanların kanıta dayalı bir resmini, kendi yazdığı bir karar kapsamını ve her ajanın ilk okuduğu dosyalara derlenen kısa bir ekip bloğunu verir; böylece asistan başkası adına karar vermez, sizi doğru meslektaşa yönlendirir.

Bu sayfada

Kod tabanınızı tanıyan bir asistan bile bir konuda ciddi bir hata yapabilir: karar vermek ona düşmeyen bir şeye karar verir. Herkese açık bir alanın adını değiştirir, bir fiyatlandırma kuralını değiştirir, bir modülü yeniden yapılandırır; üstelik ekipte o alanın referansı olan ve tek cümleyle yanıt verebilecek biri olduğundan habersizdir.

Ekip üyesi profilleri bu boşluğu kapatır. Organizasyonunuzdaki her kişiye tek bir soruyu yanıtlayan bir profil verilir: hangi konu kime sorulmalı; bu yanıtın kısa bir sürümü de her ajanın ilk araç çağrısından önce okuduğu dosyalara derlenir.

Profil bir depoya değil, ekibe aittir

Profil organizasyon kapsamındadır ve çalışma alanından bağımsızdır. Ödemeler konusunda referans olan biri, iş ister API deposunda, ister mobil uygulamada, ister geçen ay henüz var olmayan bir serviste yapılsın, ödemeler konusunda referanstır. Profili tek bir çalışma alanına bağlamak, aynı bilgiyi her depo için yeniden kurmak demek olurdu; bir dizin de tam olarak böyle eskir.

İki yarı var ve yalnızca biri çıkarsanır

Bir profilin türetilen bir yarısı ve beyan edilen bir yarısı vardır; bu ayrım bilinçlidir.

Türetilen: gerçekten çalıştığınız alanlar. Pathrule her iş parçası için zaten kısa bir kayıt tutar ve hangi yoldaki hangi hafıza kaydını ve kuralı kimin yazdığını zaten bilir. Kanıt bu iki sayımdır: bir yola karşı kaydedilen iş ve o yolda yazılan bilgi. Başka hiçbir şey okunmaz: ne kodunuz, ne commit mesajlarınız, ne de bir işin ne kadar sürdüğü. Pencere kayar, böylece geride bıraktığınız bir alan yıllarca peşinizden gelmez, profilinizden yavaş yavaş silinir.

Beyan edilen: karar kapsamınız. Bunu kişinin kendisi yazar ve asla türetilmez. Bir ürün kararı üzerindeki yetki dosyalara dokunmaktan doğmaz; bunu etkinlik sayılarından çıkarsayan bir sistem, o yetkiyi uydurmuş olurdu. Geçen ay faturalama koduna en çok dokunan kişi, bir fiyatlandırma kuralına karar vermesi gereken en son kişi olabilir. Bu yüzden Pathrule tahmin etmek yerine sorar.

Aynı kural görünen adınız, zamirleriniz ve ne kadar müsait olduğunuz için de geçerlidir: kendi sözlerinizle, kendi satırınızda.

Kendi profilinizi görür ve düzeltebilirsiniz

Bir ajana sizin ve ekibiniz hakkında tam olarak ne söylendiğini okuyabilirsiniz: ekip bloğu, Pathrule'un istemcileriniz için yazdığı CLAUDE.md ya da AGENTS.md gibi talimat dosyalarının sonundaki Team bölümüdür.

Türetilen liste son söz değildir. Kişi kendi alan ya da etiket listesini yazdığında onun listesi türetilenin önüne geçer; bu listenin varlığı da yanıtı çıkarsanmış değil düzeltilmiş olarak işaretler, böylece bir sonraki türetmede hiçbir şey onu sessizce ezmez.

Bu sınırı arayüz değil veritabanı uygular. Bir kişi kendi profil satırını yazabilir, başka kimsenin satırını yazamaz.

Ajana gerçekte ne gelir

Profil tablosu değil. Ajanlarınızın ilk okuduğu talimat dosyalarına eklenen ve özünde şuna benzeyen kısa bir blok:

  • ekibin adı ve dosyanın ait olduğu kişi, kendi alanlarından birkaçıyla birlikte
  • birkaç meslektaş, her biri referans olduğu tek bir alanla birlikte
  • beyan edilmiş karar kapsamları, kısa bir liste halinde
  • tek bir talimat: kullanıcıya adıyla hitap et ve bir karar başka birinin alanına dokunuyorsa, onun yerine karar vermek yerine o alanın sahibini işaret et

Özelliğin bütün amacı bu son satırdır. Talimatı olmayan bir isim listesi, ajanın üzerinden geçip gittiği bir veridir. Bu yüzden talimata, başka hiçbir şey ölçülmeden önce yer ayrılır; blok sonunda talimattan ibaret kalacak ve işaret edilecek kimse olmayacaksa, gürültü olarak gönderilmek yerine tamamen kaldırılır.

Blok neyi söyleyemez

Blok isim, yol, etiket ve beyan edilmiş kapsam kabul eder. Performans, hız, kalite ya da kıdem iddiası için bir alan yoktur; serbest metin de uzunlukça sınırlandırılır ve tek satıra indirilir. Bu bir inceleme yönergesi değil, yapısal bir özelliktir: derlenmiş bir talimat dosyası burada bir meslektaş hakkında bir paragraf görüş barındıramaz, çünkü böyle bir cümlenin taşınabileceği hiçbir yer yoktur.

Blok bilerek küçük de tutulur: başlığı dahil küçük ve sabit bir bütçe. Söylenecek şey bütçeye sığmadığında bir cümle yarıdan kesilmez, en az değerli uçtan tam satırlar çıkarılır; böylece kısaltılmış bir blok da ajanın üzerine harekete geçebileceği bir metin olarak okunur. Her dosyada tek blok, tek bir kez; asla ikincisi olmaz.

Neden derlenmiş dosyayla taşınır

Pathrule'un bir ajana ulaşmanın iki yolu vardır: oturumun başında bir kez okunan derlenmiş talimat dosyaları ve Claude Code ile Codex'te her prompt'ta modele ulaşan tur başına hook. Hook, isteğe göre değişen şeyler için doğru kanaldır. Bu blok isteğe göre değişmez; uzun bir oturumun her prompt'unda onun maliyetini ödemek, sabit tek bir bilgi için defalarca ödeme yapmak olurdu.

Dosyanın en sonunda durmasının nedeni de bununla ilişkilidir. Önbelleğe alınmış bir talimat ön eki, değişen ilk bayttan itibaren geçersiz olur ve ekip üyeliği, çalışma alanı bilginizden çok daha sık değişir. Değişken bloğu en sona koymak, biri ekibe katıldığında üstündeki her şeyin bayt bayt aynı kalmasını sağlar.

Görünürlük kişi bazındadır ve varsayılan olarak ekibinize görünürdür. Gizli yapılan bir profil, derlenmiş blok dahil ekibe dönük tüm okumalardan çıkarılır; böylece ekipteki hiçbir ajana o kişinin hangi alanda referans olduğu söylenmez. Bu tercih profille aynı satırda tutulur ve veritabanı bunu her sorguya uygular; dolayısıyla bir ekran filtrelemeyi unuttuğu için gizli bir profilin sızdığı hiçbir yüzey yoktur.