Mimariye genel bakış

Pathrule; siz, çalışma alanınız ve çalıştırdığınız kodlama ajanları arasında duran zekâ katmanıdır.

Bu cümlenin her parçası belirli bir iş görüyor, bu yüzden onu parça parça açmakta fayda var. Sizinle ajanlarınız arasında, çünkü Pathrule'un tuttuklarının bir kısmı kodla ilgili bilgiler değil, sizin nasıl çalışmayı tercih ettiğinizdir. Çalışma alanınızla ajanlarınız arasında, çünkü geri kalanı tek bir deponun ve onun etrafındaki ekibin kendisi hakkında öğrendikleridir. Bir katman, çünkü hiçbir ajanın içinde değildir: Claude Code'dan Codex'e geçmek neyin bilindiğini değil, işi kimin yürüttüğünü değiştirir.

Pathrule ne değildir: bir kodlama modeli, bir IDE ya da bir ajan çalışma ortamı. Uygulama kodunuzu yazmaz ve kodlama ajanınız kendi model sağlayıcısını kullanmaya devam eder.

Sistemin yapısı

        YOU                        YOUR TEAM
         |                             |
         v                             v
 USER INTELLIGENCE   WORKSPACE INTELLIGENCE   TEAM INTELLIGENCE
  (your machine)     (memories, rules,        (Pathrule Cloud,
                      skills, findings)        human-verified)
         \                   |                    /
          \                  v                   /
           +-------->  TASK-SCOPED DELIVERY  <--+
                             |
                             v
        Claude Code / Codex / Cursor / Copilot / Windsurf

Birkaç bilgi kaynağı tek bir noktada buluşur. Belirli bir iş için, o yol ve o prompt açısından önemli olan kısım seçilir, önceliklendirilir ve istemcinin desteklediği mekanizma üzerinden ajana iletilir.

Temel katmanlar ve istemciler

CLI, VS Code eklentisi ve yerel MCP sunucusu, sizin kurduğunuz yüzeylerdir. Her birini Pathrule CLI, VS Code için Pathrule ve Remote MCP sayfaları anlatır.

Yaşam döngüsü

Altı aşama. Her biri bir diyagram değil, üründe gözlemleyebileceğiniz bir şeydir.

Gözlem. Çalışma kanıt üretir: kişilerin ve ajanların yazdığı hafıza kayıtları, kurallar ve beceriler, ajanların kod hakkında kaydettiği bulgular, ajanların günlüğe yazdığı etkinlikler ve hangi oturuma neyin iletildiği.

Anlama. Pathrule'un Intelligence Engine'i bu kanıtın gelecekteki iş için ne anlama geldiğini çıkarır. Pathrule Cloud'da Team Intelligence, ekip kanıtlarını analiz ederek önerilen kalıplara dönüştürür. Apple Silicon bir Mac'te isteğe bağlı yerel model, nasıl çalıştığınıza dair öğrettiklerinizi kendi ifadelerinize dayanan yapılandırılmış bir tercihe dönüştürür. Çıkarımla elde edilen her şey, bir kişi onaylayana kadar öneri olarak kalır.

Derleme. Bilgi, her ajanın zaten okuduğu dosyalara (örneğin bilginin geçerli olduğu yollardaki CLAUDE.md ya da AGENTS.md) ve hook'ların okuduğu yerel bir indekse dönüştürülür. Bkz. derleme.

İletim ve otomatik denetim. Her görev için yola ve prompt'a uyan bilgi seçilir, önceliklendirilir ve prompt başına bir bütçe içinde iletilir; sığmayan her şey başlığıyla listelenir. Bir kural çalıştırılabilir bir kısıt taşıyabilir; bir kişi bunu onayladıktan sonra, hook'ları bunu destekleyen istemcilerde araç öncesi hook eşleşen bir düzenlemeyi engelleyebilir. Yalnızca yazılı bir gereklilik, tek başına engelleyici bir denetim oluşturmaz.

Doğrulama. Pathrule neyi ilettiğini ve ajanın ardından hangi kayıtları okuduğunu kaydeder; böylece bir bilginin etkisi varsayılmak yerine ölçülebilir.

Öğrenme. Ajanların gerçekten kullandıkları, bir sonraki seferde neyin öne çıkarılacağına yön verir. Güncelliğini yitirmiş bilgi, yenilenmek üzere işaretlenebilir. Cloud'da ekip kalıpları taslaktan önerilene, oradan doğrulanmışa ilerler ya da reddedilir veya süresi dolar; ajanlara yalnızca doğrulanmış olanlar ulaşır.

Eş anlamlı olmayan kavramlar

Bu dokümanların geri kalanı, bu kavramları birbirinden ayrı tutmaya dayanır.

• Hafıza, kaydedilmiş olandır. Belirli bir anda yazılmış, bir karara dair bir not.
• Bilgi, o kaydın gelecekteki iş için ne anlama geldiği ve bunu destekleyen kanıttır.
• Zekâ, hangi bilginin ne zaman önemli olduğuna karar veren sistemdir.
• Bağlam, tek bir görev için verilen cevaptır: burada, şu anda neyin önemli olduğu.
• Bulgu, bir ajanın kod hakkında kaydettiği bir sonuçtur. Tavsiye niteliğindedir, her iletimde koda karşı kontrol edilir ve hiçbir zaman kendiliğinden kurala dönüşmez.
• Öneri, Pathrule'un ya da bir ajanın çıkardığı ama bir kişinin onaylamadığı şeydir. Güvenilir kabul edilmez.
• Doğrulanmış bilgi, bir kişinin onayladığı şeydir.
• Kural, bir kişinin belirli bir kapsam için koyduğu kısıttır. Çalıştırılabilir biçimi için otomatik denetim ancak bir kişi onu onayladıktan sonra devreye girer.
• İletim, tek bir görev için ajana gerçekten ulaşan şeydir. Bunu Agent IR anlatır.

Hafıza kaydı bir girdidir. Bağlam bir çıktıdır. İkisi de ürünün kendisi değildir.

Sırada ne okumalı

• Workspace Intelligence: kapsam, yetki, kaynaklar, yaşam döngüsü.
• User Intelligence: neyi öğrettiğiniz, neyi kontrol ettiğiniz ve proje gerekliliklerinin neden yine de önce geldiği.
• Proje öğrenimi: ajanların kodunuzdan kaydettiği ve tavsiye olarak paylaşılan bulgular.
• Yerel model: isteğe bağlı, cihaz üzerinde çalışan model, platformu ve ne için kullanıldığı.
• Knowledge IR: her bilginin türünün ve yetkisinin iletim boyunca nasıl korunduğu.
• Derleme: Pathrule'un ajanlarınızın okuduğu dosyalara ne yazdığı.
• Proposed Knowledge: güvenilir kabul edilmeden önce bir kişiyi bekleyen her şey.
• Agent IR: bir ajanın tek bir görev için aldığı şey.
• Güvenlik ve geri dönüş: Pathrule'un emin olmadığında ne yaptığı.

Açık paket sınırı

Pathrule CLI, Apache-2.0 lisansıyla açık kaynaktır ve npm'de @pathrule/cli olarak yayımlanır. github.com/pathrule altındaki herkese açık depolar arasında Apache-2.0 lisanslı CLI, core, patterns ve benchmarks ile MIT lisanslı önceki MCP sunucusu bulunur.

Pathrule Cloud ve çıkarım, öğrenme, değerlendirme, seçim ve önceliklendirme ile model destekli özellikleri kapsayan Intelligence Engine tescillidir. Bu dokümanlar bunların nasıl inşa edildiğini değil, sizin için ne yaptığını anlatır.

Ayrıntılar için Açık kaynak çekirdek sayfasına bakın.