Workspace Intelligence

Workspace Intelligence tek bir sorunun cevabıdır: bu proje nasıl çalışıyor?

Dosyaların içeriği değil. Ajan onları okuyabilir, hem de iyi okur. Okuyamadığı şey, bir deponun kodu etrafında biriken çalışma bilgisidir; bir değişikliğin gerçekten doğru mu yoksa yalnızca makul görünüyor mu olduğuna karar veren de tam olarak bu bilgidir.

Neyi modeller

• Mimari kararlar ve bu kararları doğuran gerekçeler.
• Kodun hiçbir yerinde görünmeyen gizli kısıtlar.
• Doğrulama gereksinimleri: bir işin bitmiş sayılması için nelerin kontrol edilmesi gerektiği.
• Önceki düzeltmeler: bu sorun en son ortaya çıktığında gerçekte neyin işe yaradığı.
• Bir ekibin yazıya dökmeden uyduğu konvansiyonlar.
• Prosedürler: tekrar eden bir işin burada hangi sırayla yapıldığı.
• Doğru yaklaşımı değiştiren bağlamsal bilgiler; örneğin bir veritabanının salt okunur bir replika olması.
• Teknik gerekçe; ajanın kasıtlı bir kararı iyi niyetle geri almasını engelleyen şey budur.
• Hepsi çalışabilecek birkaç uygulama arasından tercih edilen uygulamalar.
• Geçersiz kalmış kararlar; böylece eski bir karar artık güncelmiş gibi ele alınmaz.

Bunların hepsi ekibinizin okuyup düzenleyebileceği üç tür içerikte yaşar: hafıza kayıtları, kurallar ve beceriler.

Kapsam

Workspace Intelligence bir depoya, depo içinde de yollara bağlıdır.

Bir bilgi katmanının, çözmesi gereken sorunun kendisine dönüşmesini engelleyen mekanizma budur. Bir monorepo hakkında doğru olan her şey, tek bir paketteki değişiklikle ilgili değildir; hepsini iletmek, önemli olan üç cümleyi önemsiz iki yüz cümleyle yarıştırır. Bilgi, yönettiği yola bağlanır ve o yoldaki bir görev, kendisini yöneten bilgiyi alır.

Yola bağlı kapsam, bir çalışma alanının her turu ağırlaştırmadan büyümeye devam edebilmesinin de nedenidir. Bkz. aramanın nasıl çalıştığı.

Yetki

Workspace Intelligence, katı gereksinimler barındırabilen katmandır.

Gereksinimler kurallarda yaşar. Bir kural, bir kapsamda neyin olması ya da olmaması gerektiğini belirtir, bir önceliğe sahiptir ve tavsiyelerden ayrı, kendi bölümünde gelir. Bir kural ayrıca çalıştırılabilir bir kısıt da taşıyabilir: bir değişikliğin içermemesi gereken bir kalıp. Ajanın önerdiği bir kısıt öneri olarak saklanır ve uygulanmaz; bir kişi onayladıktan sonra, hook'ları bunu destekleyen istemcilerde araç öncesi hook eşleşen bir düzenlemeyi engelleyebilir. Bkz. güvenlik bariyeri olarak kurallar.

Bunlar projenin özellikleridir. Kişisel bir tercih daha kullanışlı olacak diye bir kenara bırakılmazlar ve User Intelligence bunları geçersiz kılamaz. Workspace Intelligence'ın tuttuğu diğer her şey tavsiye niteliğindedir ve tavsiye olarak iletilir; bu yüzden geçmişteki bir düzeltme hiçbir zaman bir kuraldan üstünmüş gibi sunulmaz.

Kaynaklar

Dört tür kaynak var ve hangisinin hangisi olduğu önemli.

Yazılmış içerik. Bir kişinin bilerek yazdığı ya da bir ajanın, genellikle önce size önerdikten sonra, Pathrule'un araçlarıyla yazdığı hafıza kayıtları, kurallar ve beceriler. Bunlar bir ekibin gösterip üzerinde tartışabileceği içeriklerdir ve omurgayı oluştururlar.

Koddan çıkan bulgular. Bir ajanın kodunuzu okuyarak vardığı sonuçlar; dayandıkları dosyalarla birlikte kaydedilir ve yalnızca o dosyalar değişmediği sürece tavsiye olarak iletilir. Bkz. proje öğrenimi.

Gerçek işten gelen kanıtlar. Ajan oturumlarının kendileri hakkında bildirdikleri: hangi bilginin iletildiği, hangisine gerçekten başvurulduğu, hangi dosyaların birlikte değiştiği, ajanın nerede tekrar tekrar takıldığı. Bkz. Pathrule'un neleri hesapladığı.

Cloud çalışma alanında, yerel kopyanızdan alınan ilk veriler. Bir ajan Cloud çalışma alanında Pathrule'dan ilk kez derin bağlam istediğinde, yerel çalışma zamanı hangi dosyaların birlikte değiştiğini öğrenmek için son git geçmişindeki dosya yollarını okur ve kullanılan teknolojileri (örneğin bir TypeScript, Docker ya da GitHub Actions yapılandırması) tanımak için klasör ağacının üst seviyelerindeki dosya adlarını listeler. Yol çiftleri, birlikte değişen dosyaların başlangıç noktası olarak çalışma alanına kaydedilir; böylece bu sinyal, ekibiniz henüz çok fazla iş kaydetmeden önce de işe yarar. Tanınan her teknoloji, çalışma alanının kökünde "TypeScript project" gibi kısa bir hafıza kaydına dönüşür ve size sorulmadan yazılır; düzenleyebileceğiniz ya da silebileceğiniz sıradan bir hafıza kaydıdır. Yerel bir çalışma alanı bu adımı atlar ve hangi dosyaların birlikte değiştiğini yalnızca kaydedilen işlerden öğrenir.

Kaynak olmayan şey ise kaynak kodunuzdur. Pathrule kodunuzu otomatik olarak yüklemez; yukarıdaki ilk veri toplama adımı dosya içeriklerini, diff'leri ya da commit mesajlarını değil, dosya adlarını ve yollarını okur. Cloud çalışma alanında pathrule snapshot, siz ya da ajanınız çalıştırdığınızda, Pathrule'un projeyi tanımlayabilmesi için dosya ağacını, manifest dosyalarını, kısa doküman örneklerini ve son git meta verilerini yükler. Pathrule'un neleri hesapladığı sayfası neyin okunduğunu ve neyin saklandığını listeler.

Team Intelligence

Pathrule Cloud'da Team Intelligence, bir ekibin çalışmasının ürettiği kanıtlara bütün olarak bakar ve kalıplar önerir: sürekli tekrar eden konvansiyonlar, düzeltmeler ve kararlar. Team ve Enterprise planlarında kullanılabilir; organizasyon sahipleri ve yöneticileri bunu web konsolunda, organizasyonun Team guidance ayarları altından yönetir.

Bir kalıp taslaktan öneri aşamasına geçer ve bir kişi onu ya doğrular ya da reddeder; kimsenin ilgilenmediği bir önerinin süresi dolar. Ajanlara yalnızca doğrulanmış kalıplar ulaşır. Team Intelligence'ın çıkardığı hiçbir şeye kendi başına güvenilmez.

Yaşam döngüsü

1. Yazılır ya da önerilir. Bir kişi bunu CLI, VS Code eklentisi ya da ajanı aracılığıyla yazar. Saklamaya değer bir şey keşfeden ajan bunu Pathrule'un yazma araçlarıyla, genellikle önce size önerdikten sonra kaydeder; yazma işleminin kime ait olduğu bellidir, sürümlenir ve geri alınabilir. Ajanınızdan "Set up Pathrule for this project" istemeniz, ajanın hafıza kayıtları, kurallar ve beceriler önerdiği ve onayladıklarınızı yazdığı rehberli bir tarama başlatır. Cloud çalışma alanında Pathrule ayrıca yukarıda anlatılan kısa teknoloji hafıza kayıtlarını da ekler.
2. Bir şey çıkarım yoluyla elde edildiyse onaylanır. Çıkarım yoluyla elde edilen bilgi bir kişiyi bekler: bir kuralın çalıştırılabilir kısıtı yalnızca onaydan sonra uygulanır, bir Team Intelligence kalıbı da ancak doğrulandıktan sonra ajanlara ulaşır. Tek istisna ajan bulgularıdır ve bunlar tavsiye niteliğinde kalır. Bkz. Proposed Knowledge.
3. İletilir. Bir görevle ilgili kısım, istemcinin desteklediği mekanizma üzerinden ajana gelir. Bkz. Agent IR.
4. Ölçülür. İletim ve ajanın bununla ne yaptığı kaydedilir; böylece bir kaydın konumu, onu kimin yazdığını değil, gerçekte ne olduğunu yansıtır.
5. Yenilenir, yerini başkasına bırakır ya da kullanımdan kaldırılır. Eskimiş görünen bilgi bir yenileme görevi olarak işaretlenebilir ve bir kişi ya da ajan bu görevi ele alır. Yerini sonradan gelen bir karara bırakmış bir karar artık güncel kabul edilmez. Bkz. öneriler ve öz denetim.

Proje değiştirdiğinizde ne değişir

Hepsi. Workspace Intelligence depoya aittir; farklı bir depo açmak, o depoda çalışan diğer herkesle paylaşılan farklı bir proje bilgisi bütünü demektir.

Sizinle birlikte gelen şey ise size ait olan User Intelligence: Pathrule'a öğrettiğiniz ve her yerde uygulanmasını seçtiğiniz tercihler.