Temel kavramlar

Pathrule'un veri modeli bilinçli olarak küçük tutulmuştur. Üç tür içerik, bir düğüm ağacı ve yola dayalı bir kapsam. Bu yapıyı kafanızda bir kez oturttuğunuzda Pathrule'un geri kalanı doğal olarak bundan çıkar.

Bu sayfayı okurken aklınızda tutmanız gereken bir nokta var: aşağıdaki üç içerik türü yazım yüzeyidir. Bunlar bir kişinin yazdığı, düzenlediği ve üzerine tartıştığı şeylerdir; yani girdidir. Ajana ulaşan ise göreve özeldir: yalnızca o an üzerinde çalıştığı işe uyan kayıtlar, önceliklendirilmiş ve göreve göre uyarlanmış olarak gelir. O tarafı mimariye genel bakış sayfası anlatıyor; bu sayfa ise sizin yazdıklarınızı ele alıyor.

Çalışma alanı ağacı

Çalışma alanı, düğümlerden oluşan bir ağaçtır. Kök, çalışma alanının kendisidir. Alt düğümler, deponuzda ekibinizin hakkında bilgi yazdığı bölümleri yansıtan klasörler veya dosyalardır.

/                            workspace root
  /apps                      folder node
    /apps/web                folder node
      /apps/web/auth         folder node
        /apps/web/auth/login.tsx   file node

Ağacı elle oluşturmanız gerekmez. /apps/web/auth konumuna bir hafıza kaydı yazdığınızda Pathrule gereken düğüm zincirini o anda oluşturur. Boş düğümlerin hiçbir maliyeti yoktur ve yol işe yaramaz hale gelirse sonradan kolayca silinebilir.

Hafıza kayıtları

Hafıza kaydı, bir ekip arkadaşının asistan daha sonra okuyabilsin diye yazdığı kısa bir Markdown belgesidir.

• Bilgiler: şema notları, tasarım kararları, dikkat edilmesi gereken tuzaklar.
• Olay sonrası değerlendirmeler: neyin bozulduğu, ne öğrenildiği, nasıl düzeltildiği.
• Konvansiyonlar: ekibin bir işi yapmayı tercih ettiği yol.

Hafıza kayıtları varsayılan olarak tavsiye niteliğindedir. Hook, asistanın çalıştığı yolla ilgili olduklarına karar verdiğinde asistanın bağlamında yer alırlar.

Hafıza kayıtlarının çoğunu kişiler ya da sizinle birlikte çalışan bir asistan yazar. Cloud çalışma alanlarında Pathrule kendiliğinden birkaç kayıt da ekler: bir ajan ilk kez derin bağlam istediğinde dosya adlarından tanınan, "TypeScript project" veya "Docker containerization" gibi, çalışma alanı kökünde duran kısa teknoloji notları. Bunlar sıradan hafıza kayıtlarıdır; diğerleri gibi düzenleyebilir veya silebilirsiniz.

Kurallar

Kural, asistanın belirli bir kapsamda uyması gereken bir kısıtlamadır.

Bir kuralda şunlar bulunur:

• Bir kapsam türü. folder, kuralın bir dizinin altında geçerli olduğunu belirtir. file_type, *.tsx gibi bir dosya glob'una uygulandığını belirtir. project, çalışma alanının her yerinde geçerli olduğunu belirtir.
• Bir öncelik. En önemli kısıtlamalar için high, genel yönlendirmeler için medium, üslup tercihleri için low. Öncelik, bir kuralın ne kadar güçlü biçimde öne çıkacağını belirler; engelleyip engellemeyeceğini değil.
• Bir otomatik denetim modu. advisory kurallar bağlam olarak eşlik eder ve nasıl uygulanacaklarına asistan karar verir. strict bir kural, bir kişinin onayladığı çalıştırılabilir bir kısıtlama taşır ve hook'ları bir araç çağrısından önce çalışan istemcilerde eşleşen bir değişikliği uygulanmadan önce engelleyebilir.
• Bir gövde. En iyi sonucu kısa, emir kipinde yazılmış bir madde listesi verir.

Kapsamları mevcut yolla eşleştiğinde yüksek öncelikli kurallar önce öne çıkar. Düşük öncelikli kurallar ise faydalı olma ihtimalleri yüksek olduğunda gösterilir.

Beceriler

Beceri, asistanın adımları her seferinde baştan çıkarmak yerine çağırabileceği adlandırılmış bir prosedürdür.

Örnekler:

• replay-stripe-webhook: tam CLI komutunu ve onu çalıştırmadan önceki güvenlik adımlarını içeren bir kontrol listesi.
• regenerate-fixtures: betiğin yolu, girdileri ve beklenen çıktı.
• release-check: ekibin asistanın her zaman adım adım izlemesini istediği sürüm öncesi kontrol listesi.

Beceriler adlarıyla bulunabilir. Asistan, mevcut yola bağlı becerileri Pathrule'dan isteyip göreve uyanı seçebilir.

Yol kapsamı

Her hafıza kaydı, kural ve beceri bir düğüm yolunda bulunur. Nerede karşınıza çıkacağını bu yol belirler.

• /apps/web konumundaki bir hafıza kaydı, apps/web altındaki her iş için geçerlidir.
• / konumundaki bir hafıza kaydı her yerde geçerlidir.
• /services/billing konumundaki bir beceri, iş faturalama servisinin içinde yapıldığında asistana sunulur.

Asistanın bağlam penceresini küçük tutan şey yol kapsamıdır. apps/web/dashboard içindeki küçük bir arayüz düzeltmesinin veritabanı migration kurallarını görmesine gerek yoktur.

Öncelik ve otomatik denetim

Öncelik ve otomatik denetim birbirinden bağımsız iki ayardır.

• Öncelik (high, medium, low), bir kuralın ne kadar güçlü biçimde öne çıkacağını belirler. high değerini idareli, yalnızca en önemli kısıtlamalar için kullanın.
• Otomatik denetim (advisory veya strict), bir ihlal durumunda ne olacağını belirler. Tavsiye niteliğindeki kurallar bağlam olarak sunulur ve nasıl uygulanacaklarına asistan karar verir; her yeni kural tavsiye niteliğinde başlar. Bir ajan bir kural için çalıştırılabilir bir kısıtlama önerebilir; bu kısıtlama öneri olarak saklanır ve denetlenmez. Bir kişi onu onayladıktan sonra yerel hook, eşleşen bir düzenlemeyi uygulanmadan önce kontrol eder, değişikliği engelleyebilir ve gerekçe olarak kuralı gösterir.

Pathrule CLI ve VS Code eklentisi Claude Code, Codex, Cursor ve GitHub Copilot için mevcut hook'ları kaydeder; engelleme, istemcinin hook'unun bir araç çağrısını durdurabildiği yerlerde geçerlidir. Windsurf'ün hook'u yoktur, Remote MCP de hook kurmaz: ikisi de kuralları bağlam olarak alır ve Pathrule'un yazma öncesi engelleme olayı olmaz.

Bu sayfanın yeri

• Pathrule neleri hesaplar, yazılan bu üç türün çevresindeki türetilmiş katmanı anlatır.
• Hook'lar nasıl çalışır, çalışma zamanının gönderilecek ilgili kısmı nasıl seçtiğini açıklar.
• MCP'ye genel bakış, asistanın düğümleri okumak ve yazmak için kullandığı araçları listeler.
• Hızlı başlangıç, bu modeli iş başında görmenin en hızlı yoludur.