Yapay zeka kodlama asistanları, özellikle Claude Code gibi ajanlar, bir özellik geliştirirken sürekli olarak küçük kararlar alır. Bu kararların çoğu, geliştiricinin açık onayı olmadan alınır ve genellikle sadece geçici sohbet kayıtlarında saklanır. Ancak bu kayıtlar varsayılan olarak 30 gün sonra silinir. Grepathy, bu sorunu çözmek için geliştirilmiş bir açık kaynak araçtır. Ajanın aldığı kararları yerel sohbet kayıtlarından okuyarak, kodla birlikte depoya eklenen bir Markdown dosyasına yazar. Böylece kod inceleyenler, ekip arkadaşları ve hatta gelecekteki AI ajanları, bir kod parçasının neden belirli bir şekilde yazıldığını doğrudan depodan öğrenebilir.
Grepathy’nin çalışma prensibi oldukça basittir. Geliştirici normal bir şekilde Claude Code ile çalışır ve ajan kodlama sürecinde kararlar alır. Git push işlemi sırasında Grepathy devreye girer: ajanın oturum kaydını (transcript) okur, önemli kararları çıkarır ve bunları .ai/why/.md dosyasına yazar. Bu dosya, depoya eklenir ve böylece herkesin erişimine açılır. Örneğin, bir sözleşme projesinde ajan, planlanmamış bir şekilde Clerk'te misafir kullanıcılar oluşturdu. CTO bu durumu fark ettiğinde neden böyle bir karar alındığını sorguladı. Geliştirici bu kararı vermediği için cevap veremedi. Grepathy olsaydı, depoda şöyle bir not yer alırdı: 'Misafir kimlikleri Clerk'te önceden oluşturuldu. Durum: ajan başlatımlı - planda veya yönlendirmelerde istenmedi. Ajan, downstream auth kontrollerini basitleştirmek için bu yaklaşımı çıkarsadı. Risk: misafir kullanıcılar normal kayıt yolundan sapar.'
Araç, ajanın kararlarını almasını engellemez veya push işlemini bloke etmez. Ayrıca staging alanına dokunmaz ve kendisi hiçbir şey push etmez. Birden fazla ajan ve çalışma ağacıyla sorunsuz çalışır. Gelecekteki ajanlar, bu karar kayıtlarına otomatik olarak erişebilir. CLAUDE.md dosyasındaki bir yönlendirme, ajanın .ai/why/ dizinine bakmasını sağlar. Ayrıca bir PreToolUse hook'u, bir dosyayı düzenlemeden hemen önce ilgili karar kayıtlarını ajanın bağlamına enjekte eder. Böylece ajan, kodu değiştirmeden önce geçmiş kararları görür ve tutarlılık sağlanır.
Gizlilik konusunda Grepathy oldukça hassastır. Oturum kayıtları asla kullanıcının makinesinden çıkmaz. Sadece özetlenmiş Markdown dosyası paylaşılır ve bu özet, kesin kurallara uyar: kullanıcının mesajlarını alıntılamaz, kafa karışıklığını veya ileri geri konuşmaları betimlemez, iş veya para detaylarını içermez ve sırları temizler. Özetleme işlemi, bir gizlilik/finans tarayıcısı ve her girdinin gerçek koda işaret ettiğini kontrol eden deterministik iki adımlı bir doğrulama ile desteklenir. Kullanıcı, push öncesi dosyayı inceleyebilir ve gerekirse düzenleyebilir veya silebilir; Grepathy bu değişikliklere kalıcı olarak saygı duyar.
Grepathy’nin etkinliği, kör ve önceden kaydedilmiş bir değerlendirme ile test edilmiştir. Sonuçlar, aracın özellikle şu alanlarda yardımcı olduğunu göstermektedir: Kodda olmayan bilgileri kaydetme (örneğin, 'CDN düşünüldü ancak reddedildi' gibi kararlar), Claude Code’un 30 gün sonra sildiği oturum kayıtlarını kurtarma ve ekip üyelerinin veya gelecekteki ajanların 'neden' sorusuna yanıt verme. Ancak araç, ajanın önemli kodu yeniden düzenlemesini engelleyemez veya ajanları genel olarak daha zeki yapmaz. Sadece kodda yazılı olmayan bilgileri belgelemek için etkilidir.
Detaylar ve Etkileri
Grepathy, Beads ve görev takip araçlarından farklıdır. Bu araçlar ajanların ne yapması gerektiğini takip ederken, Grepathy neden yapıldığını kaydeder. Her ikisi de birlikte kullanılabilir. Ayrıca, Grepathy sadece Claude Code ile çalışır; ancak kod inceleme dosyaları Markdown olduğu için herhangi bir araç bu dosyaları okuyabilir. Gelecekte Codex desteği de planlanmaktadır. Araç, npm install ile kolayca kurulabilir ve grepathy init komutu ile yapılandırılabilir.
Sonuç olarak, Grepathy, AI kodlama asistanlarının şeffaflığını artıran, ekip içi iletişimi güçlendiren ve kod inceleme sürecini iyileştiren yenilikçi bir araçtır. Özellikle büyük projelerde ve birden fazla geliştiricinin veya AI ajanının birlikte çalıştığı ortamlarda, kararların izlenebilirliği ve açıklanabilirliği kritik öneme sahiptir. Grepathy, bu ihtiyacı karşılayarak yazılım geliştirme süreçlerine değerli bir katkı sunmaktadır.
Kaynak: github.com
