PathruleYapay zekâ ile kodlamada
bağlam katmanı.
Bağlam katmanı, ekibin hafıza kayıtlarını, kurallarını ve becerilerini yollara göre düzenler ve ekibin kullandığı ajanlara, ilk araç çağrısından önce, yalnızca geçerli olan kısmı iletir. Burada ekiplerin bunu yapmasının beş yolunu ve hangisinin size uyduğunu nasıl anlayacağınızı bulacaksınız.
Bağlam katmanı olmadan
- Asistan sipariş modülünü açar, şemayı okur, import'ları fiyatlandırma ve vergi koduna kadar izler ve kuponun nereye uygulandığını çıkarmak için indirim handler'ını okur.
- İndirimi sipariş toplamına uygulayan, akla yatkın bir değişiklik yazar. Diff derlenir; ama ekibin zaten bildiği bir nedenle yanlıştır.
- Bir reviewer bunu yakalar, satır kalemi konvansiyonunu yeniden anlatır ve döngü tekrarlanır. Bilgi tek bir kişinin kafasında kalır.
- Okunan çok sayıda dosya, çok sayıda araç çağrısı, uzun bir girdi penceresi ve bir inceleme turuna mal olan yanlış bir dönemeç.
Bağlam katmanıyla
- Sipariş yolu için eşleşen bilgi hook anında, ilk araç çağrısından önce ulaşır. Model kuponların satır kalemine uygulandığını zaten bilir.
- İndirimi ilk denemede satır kalemine uygular, çünkü kural daha başlamadan bağlamdaydı.
- Katı bir kural, indirimi yanlış yere uygulayan bir değişikliği uygulanmadan önce engelleyebilir; böylece düzeltme incelemeden sonra değil, önce yapılır.
- Kısa, odaklı bir bağlam penceresi ve hedefli bir değişiklik, çünkü yalnızca bu yolun kuralları eklendi.
Bir ajana bağlam vermenin beş yolu.
- Talimat dosyaları
- ne zaman seçilir
- Tek kişi, tek depo, az sayıda konvansiyon
- bilgi ne zaman ulaşır
- Her turda, tamamı
- araç değişince kalır mı
- Hayır, her araç kendi dosyasını okur
- nerede tıkanır
- İkinci kişi ya da ikinci ajan geldiğinde: her araç kendi kopyasını ister.
- Hafıza API'si
- ne zaman seçilir
- Kendi ürününüze hafıza ekliyorsunuz
- bilgi ne zaman ulaşır
- Sorgulandığında
- araç değişince kalır mı
- Evet, çağrı noktası sizin elinizdeyse
- nerede tıkanır
- Tasarımı gereği sessiz. Kimsenin sormadığı bir kısıt asla ulaşmaz.
- Vektör arama
- ne zaman seçilir
- Cevap yazılı, yeri bilinmiyor
- bilgi ne zaman ulaşır
- Sorgulandığında
- araç değişince kalır mı
- Evet, ama indeksi çalıştırmak size kalır
- nerede tıkanır
- Hiçbir dosyada yer almayan bir kararı döndüremez.
- Ajan çalışma alanı
- ne zaman seçilir
- Darboğaz paralel ajanlar
- bilgi ne zaman ulaşır
- Yol başına değil, oturum başına
- araç değişince kalır mı
- Konu bu değil: aracın kendisi
- nerede tıkanır
- İkinci bir checkout, hangi bilginin nereye ait olduğuna karar vermez.
- Yola bağlı katman
- ne zaman seçilir
- Birden fazla ajan kullanan tek bir kişi ya da tek depoda çalışan bir ekip
- bilgi ne zaman ulaşır
- İlk araç çağrısından önce, yolun kapsamıyla
- araç değişince kalır mı
- Evet, bilgi tüm araçların dışında durur
- nerede tıkanır
- Tek bir ajan kullanan tek bir kişi için gereğinden fazla.
Bunlardan ikisi birbirinin rakibi değil. Kendi ürününüzdeki bir hafıza API'si ile ajanlarınız için bir bağlam katmanı aynı anda var olabilir.
Ne zaman gerekmez.
Tek kişi, tek depo, tek ajan ve bir sayfaya sığan konvansiyonlar: depoya commit edilmiş bir CLAUDE.md doğru cevaptır, bağlam katmanı ise ek yüktür. Kırılma noktası ne deponun ne de ekibin büyüklüğüdür; ikinci ajan ya da ikinci kişidir (hangisi önce gelirse). Aynı depoda Claude Code ve Codex çalıştıran tek bir geliştiricinin bile bu sorunu zaten vardır: birine ne öğretirseniz öğretin diğeri bilmez ve her biri farklı bir dosya okur.
Bir bağlam katmanı neleri taşır
- Hafıza kayıtlarıEkibin öğrendikleriOnu öğrenen mühendis başka bir işe geçtiğinde kaybolan “bunu denedik, işe yaramadı” türünden bilgiler. Geçerli oldukları yola bağlanır. Devamı: yapay zekâ kodlama ajanları için kalıcı hafıza.
- KurallarNe yapılmalı, nelerden kaçınılmalıTavsiye niteliğinde ve katı kısıtlar. Kesin bariyerler (
/apps/webiçindeconsole.logyok) ve esnek tercihler (/packages/uiiçinde isimli export'ları tercih et). Devamı: yapay zekâ kodlama ajanları için kurallar. - BecerilerÇok adımlı prosedürlerEkibin oturttuğu prosedürler: bir migration nasıl eklenir, bir feature flag nasıl yayına alınır, güvenlik incelemesi nasıl yürütülür. Adıyla çağrılabilir. Devamı: yapay zekâ kodlama ajanları için beceriler.
- Yola göre dizinlenmişBilgi, ilgili olduğu kodun yanında dururHer hafıza kaydı, kural ve beceri bir yola bağlıdır.
/services/billingiçin yazılmış bir kural, model/apps/mobileiçinde çalışırken asla devreye girmez.
Tek dosya ve bağlam katmanı
- Aracın kendi talimat dosyaları yola göre kapsamlanabilir ve sürüm kontrolüyle paylaşılabilir.
- Token maliyeti ekip kurallarıyla doğrusal olarak büyür.
- Dosya başına tek asistan. Araç değiştikçe ekip bilgisi kaybolur.
- Push yetkisi olan herkes düzenleyebilir. Yapılandırılmış bir inceleme yok.
- Bilgi kulaktan kulağa aktarılır.
- Yalnızca modelin çalıştığı dizinle ilgili, yola bağlı bilgi.
- Token maliyeti tüm kural setine göre değil, yalnızca ilgili kurallara göre artar.
- Tek katman, çok sayıda asistan. Araç değişse de ekibin bilgisi sıfırlanmaz.
- Sunucu tarafında denetlenen çalışma alanı erişimi ve eskimiş kuralları yakalayan denetimle incelenebilir bir bilgi grafı.
- Bilgi bir kez yazılır ve bir sonraki ekip arkadaşının oturumuna otomatik olarak iletilir.
Desteklenen yapay zekâ kodlama asistanları
Claude CodeCLAUDE.md, prompt hook'u dahil hook'lar, MCP
CodexAGENTS.md, prompt hook'u dahil hook'lar, MCP
Cursor.cursor/rules, oturum ve araç hook'ları, MCP
GitHub CopilotTalimat dosyaları, oturum ve araç hook'ları, MCP
WindsurfKural dosyası ve MCP, hook yok- Herhangi bir MCP istemcisiMCP üzerinden hafıza
Sık sorulan sorular.
Yapay zekâ ile kodlamada bağlam katmanı nedir?
Bir ekibin tipli bilgisi (hafıza kayıtları, kurallar ve beceriler) ile ekibin kullandığı yapay zekâ kodlama asistanları arasındaki yönlendirme katmanı. Bu bilgiyi yollara göre düzenler ve yalnızca ilgili kısmı hook anında, ilk araç çağrısından önce modele iletir.
Bağlam katmanının CLAUDE.md ya da AGENTS.md'den farkı ne?
CLAUDE.md ve AGENTS.md, her talimatı her turda gönderen düz dosyalardır. Bağlam katmanı bir üst seviyededir: bilgiyi yollara göre dizinlenmiş bir grafta saklar ve modele yalnızca eşleşen alt ağacı iletir; böylece modelin gördüğü her talimat mevcut yol için gerçekten işe yarar.
Bağlam katmanı bir yapay zekâ kodlama aracı mı?
Hayır. Bağlam katmanı kod üretmez, çıkarım çalıştırmaz ya da IDE'nizin yerini almaz. Ekibiniz ile seçtiğiniz yapay zekâ kodlama asistanı arasındaki katmandır; ekibi tek bir araca kilitlemeden her oturumu daha akıllı hâle getirir.
Bağlam katmanı neleri taşır?
Üç tür tipli ekip bilgisi: hafıza kayıtları (öğrendikleriniz), kurallar (ne yapılmalı ya da nelerden kaçınılmalı) ve beceriler (çok adımlı prosedürler). Kaynak kodunuzu ya da deponuzun bir indeksini taşımaz.
Pathrule bu bağlam katmanını nasıl uygular?
Pathrule ekip bilgisini yollara göre dizinlenmiş bir grafta saklar, tek bir MCP sunucusu sunar ve her ajana onun izin verdiği şekilde ulaşır: Claude Code ve Codex için prompt hook'u dahil hook'lar, Cursor ve GitHub Copilot için oturum ve araç hook'ları, Windsurf için bir kural dosyası. Modele yalnızca mevcut çalışma dizinine uyan kısım iletilir.
Bağlam katmanı kaynak kodu görür mü?
Görmesi gerekmez. Pathrule deponuzun kaynak kodunu otomatik olarak yüklemez. Cloud modunda Pathrule Cloud ekibin yazdığı hafıza kayıtlarını, kuralları ve becerileri saklar, geçerli olanı sıralamak için her prompt'un başlangıcı gönderilir ve pathrule snapshot, siz ya da ajanınız çalıştırdığında, dosya ağacını, manifest dosyalarını, kısa doküman örneklerini ve son git meta verilerini yükler. Yerel modda hesap yoktur. Ayrıntıların tamamı Güvenlik sayfasında.
Hangi bağlam aracını seçmeliyim?
Gerçekte hangi sorunu yaşadığınıza bağlı. Tek bir depoda tek bir ajan çalıştıran tek bir kişiye depoya commit edilmiş bir CLAUDE.md yeter. Kendi ürününüzün içindeki hafıza bir hafıza API'sinin işidir. Yazılı ama yeri bulunması zor bilgi vektör aramanın işidir. İzole checkout'larda çalışan paralel ajanlar bir ajan çalışma alanının işidir. Yola bağlı bir bağlam katmanı ise ikinci bir ajanın ya da ikinci bir kişinin devreye girdiği an içindir; çoğu insan için bu an ikinci ajandır. Beş yaklaşım ve her birinin nerede tıkandığı yukarıda anlatılıyor.
Bağlam katmanı ile hafıza API'si arasındaki fark nedir?
Bilginin ne zaman geldiği. Bir hafıza API'si ancak sorgulandığında cevap verir; bu yüzden ajanın sormayı hiç düşünmediği bir kısıt ona hiç ulaşmaz. Bağlam katmanı ise ajanın çalışacağı yolu okur ve eşleşen bilgiyi, ajan sorsa da sormasa da, ilk araç çağrısından önce iletir.
Vektör RAG bir bağlam katmanı mıdır?
Hayır. Vektör arama, zaten yazılı olan metni bulur ve sorguya benzerliğine göre sıralar. Bağlam katmanı ise hiçbir dosyada olmayan kararları, geçerli oldukları yola bağlı olarak taşır ve onları zorunlu kılabilir: bir depo metin döndürürken, bir kuralın kapsamı, önceliği ve zorunluluk düzeyi vardır. Benzerlik, bir metnin ilgili olup olmadığına dair bir tahmindir; yol ise kesin bir bilgidir. Uzun okuma: Vektör RAG ve yola bağlı bağlam.
Tek başıma çalışıyorsam bağlam katmanına ihtiyacım var mı?
Asıl soru tek başına çalışmanız değil, kaç ajan çalıştırdığınızdır. Tek bir ajanı ve bir sayfalık konvansiyonu olan tek bir kişi, bir talimat dosyasının tam olarak iyi olduğu durumdur. Aynı depoda Claude Code, Codex ve Cursor çalıştıran tek bir kişinin ise bağlam katmanının çözdüğü sorun zaten vardır: birine öğrettiğiniz onun içinde kalır ve her biri farklı bir dosya okur. Pathrule'un bireysel kullanım için ücretsiz olmasının nedeni de bu.