Asistanı yavaşlatan dosyalar

Bazı dosyalarda çalışmak bir asistan için diğerlerine göre daha zordur ve bunun nedeni genellikle kodun kendisi değildir. Dokümanlarınızda yeri değişmiş bir yol. Güvenle düzenlenemeyen, otomatik üretilmiş bir dosya. Ajanın sahip olmadığı bir izni gerektiren bir dizin. Bu dosyaların hangileri olduğunu, onlarla uğraşırken canınız sıkıldığı için kabaca zaten biliyorsunuz. Pathrule bunu kesin olarak kaydeder.

Neler kaydedilir

Bir asistanın çağırdığı araç başarısız olduğunda üç şey saklanır: aracın türü, üzerinde çalıştığı dosya ve nasıl başarısız olduğunu belirten kısa bir kod. file_not_found, permission_denied, timeout, rate_limit, token_limit, syntax_error ya da hata gerçek olduğu halde hiçbir şey onu tanımıyorsa unknown.

Kaydın tamamı bundan ibarettir. Komut yok. Hata mesajı yok. Dosya yok. Bir yola bağlı bir sayı ve bir kod. Cloud çalışma alanında bu sayılar ve kodlar, çalışma alanıyla birlikte Pathrule Cloud'da saklanır.

Hata bildirilmez, gözlemlenir. Pathrule'un araç hook'u çağrının kendisini izler; dolayısıyla sayı, asistanın kendi hatasını fark etmesine, bir oturumu hatırlamasına ya da sonrasında herhangi bir şey çağırmasına bağlı değildir. Sessizce başarısız olup yoluna devam eden bir asistan da hatayı açıkça bildiren bir asistanla tamamen aynı şekilde kaydedilir. Çağrının ne kadar sürdüğü de aynı gözlemin parçasıdır; askıda kalan bir komutu reddedilen bir komuttan ayırt etmeyi sağlayan da budur. Bu, Pathrule'un araç hook'larının bulunduğu istemciler için geçerlidir: Claude Code, Codex, Cursor ve GitHub Copilot. Windsurf'te Pathrule hook'ları yoktur, bu nedenle araç çağrıları bu şekilde gözlemlenmez.

Yol önce çalışma alanına göreli biçime dönüştürülür ve bu, göründüğünden daha önemlidir. Bir dizüstü bilgisayardaki mutlak yol /Users/<name>/… şeklindedir ve o adın paylaşılan bilgiye taşınması için hiçbir neden yoktur. Göreli yollar ayrıca aynı dosyanın her makine için ayrı ayrı değil, ekip genelinde doğru şekilde tek bir grupta toplanmasını sağlar.

Ne için kullanılır

İşin nerede tıkandığını gösteren bir tablo. Hatalar zamanla dosyaya, araca ve koda göre gruplanır. Ortaya bir grafik değil, kısa bir liste çıkar: asistanın en çok başarısız olduğu dosyalar ve nasıl başarısız olduğu. file_not_found altında sürekli görünen bir dosya, genellikle kendi talimatlarınızın bir yerinde kalmış eskimiş bir yolu işaret eder. syntax_error altında görünen bir dosya genellikle gerçekten düzenlemesi zor bir dosyadır. permission_denied altında görünen bir dosya ise genellikle bir kez düzeltip kurtulabileceğiniz bir kurulum sorunudur.

Arama öğrenmesi. Bir tur Pathrule'dan bilgi aldığı halde yine de hatalarla karşılaştıysa, o bilgi negatif bir sinyal alır. Bazı hata türleri sıradan bir isabetsizlikten daha ağır sayılır, çünkü bunlar genellikle yönlendirmenin asistanı gidemeyeceği bir yere gönderdiği anlamına gelir. Bu sinyal, arama doğru bilgiyi nasıl bulur sayfasında anlatılan döngüye katılır. Kötü giden turlarda sürekli karşımıza çıkan bilgilerin seçilme olasılığı, kimsenin onu incelemesine gerek kalmadan giderek azalır.

Sinyalin göremedikleri

Bu kısım hangi asistanı kullandığınıza bağlıdır ve her asistanda aynı değildir.

Dosya araçları hataları düzgün bildirir. Başarısız olan bir okuma, düzenleme ya da yazma işlemi mesajıyla birlikte gelir, sınıflandırılır ve doğru dosyaya bağlanır. Önemli olan durum da budur, çünkü bir sayıyı üzerinde harekete geçilebilir hale getiren şey dosya yoludur.

Shell komutları ise çoğu zaman bunu yapmaz. Bazı asistanlar hiç çıkış kodu bildirmez; bu yüzden başarısız olan bir komutla başarılı olan bir komut birebir aynı görünür. Pathrule çıktı metninden hata çıkarımı yapmaz: bir arama sonucu gayet meşru bir şekilde "no such file or directory" ifadesini içerebilir ve bir dosyaya yanlışlıkla bağlanmış bir hata, hiç kaydedilmemiş bir hatadan daha kötüdür. Asistan bir hata bildirmediğinde hiçbir şey kaydedilmez; hiçbir kuralın tanımadığı bir hata bildirdiğinde ise kod tahmin yerine unknown olur.

Ne yapmaz

Bir hatanın kaydedilmesi araç çağrısını engellemez ve asistanın bağlamında görünmez. Hata, kod tabanınız hakkında olaydan sonra kaydedilen bir bilgidir. Asistanın neleri yapmasına izin verildiğini değiştirmez ve kötü bir kaydı olan dosya yasak bölge sayılmaz. Buradaki hiçbir şey bir kişiye iliştirilmiş bir puan değildir: kayıt dosyalarla ilgilidir, o dosyalarda kimin çalıştığıyla değil.