Öneri değil,
uyulan bir kural.
Yapay zekâ kodlama ajanları için kurallar ve kısıtlar. Her birinin kapsamı, önceliği ve zorunluluk düzeyi var; böylece bir gereksinim hiçbir zaman sıradan bir tercih gibi gelmez.
Tutarlar cent cinsinden tam sayı olarak saklanır.
- nerede
- Yalnızca /services/billing altında
- ne kadar güçlü
- Kapsam içindeyken her zaman gönderilir
- ihlal durumunda
- Eşleşen bir düzenleme uygulanmadan önce reddedilir
Kapsam sorunu çözüldü. Öncelik sorunu çözülmedi.
- Güvenlik kuralı, stil ipucuyla aynı ağırlıkta okunur
- Kırkıncı turda ağırlığı değişir
- Hatayı anlatır ama engelleyemez
- Kuralın kendi geçmişi tutulmaz
- Servis anahtarı asla yayına çıkmazhigh, strict
- Tutarlar tam sayı centhigh
- İsimli export'ları tercih etlow
- services/billing/checkout.ts
- Her kural kendi önceliğini taşır
- Yalnızca geçerli olduğu yerde devreye girer
- Katı bir kural düzenlemeyi reddedebilir
- Sürümlü ve incelenebilir
Talimat dosyalarıyla artık bir kuralı belirli bir klasöre yönlendirebilirsiniz. Yine de Anthropic kendi dokümanlarında bu dosyalar için hâlâ “context, not enforced configuration” (zorunlu yapılandırma değil, bağlam) diyor ve kesin uyulması gereken her şey için hook'ları öneriyor.
Yüksek öncelik bir bütçedir.
Her şey yüksek
- yüksek, her zaman gönderilir
- 96
- orta, ilgiliyse
- 0
- düşük, yer varsa
- 0
Çoğu orta
- yüksek, her zaman gönderilir
- 5
- orta, ilgiliyse
- 28
- düşük, yer varsa
- 16
Kuralların yarısı yüksek öncelikliyse aslında hiçbiri değildir. Varsayılan olarak orta seçin; bir kuralı ancak ihlal edildiğinde yaşanacak olayı somut olarak söyleyebiliyorsanız yükseltin.
Katı kural nerede engelleyebilir?
Katı kural Claude Code üzerinde düzenlemeyi engeller.
neden pathrule setup, düzenlemeyi çalışmadan önce kontrol eden Pathrule hook'unu kaydeder.
neden Claude Code'daki hook'un aynısı; her düzenlemenin ve yazma işleminin öncesinde ve sonrasında çalışır.
neden Araç hook'ları, Cursor'ın kurallarıyla birlikte her düzenlemenin öncesinde ve sonrasında çalışır.
neden CLI ve VS Code eklentisi, hook'u Copilot'ın hook çalıştırdığı yere kaydeder.
neden Windsurf'te hook yok; dolayısıyla engellemenin bağlanabileceği bir yazma öncesi olay da yok.
neden Barındırılan uç nokta hiç hook kurmaz. Kurallar bağlam olarak ulaşır.
Belirleyen kural değil, istemcidir. Yazma öncesi hook'un olduğu yerde, onaylı bir engelleme deseni olan katı kural, eşleşen düzenlemeyi durdurur ve gerekçe olarak kendini gösterir.
Bu gerçekten bir kural mı?
- Cevap “duruma bağlı” diye mi başlıyor?Ajan bunu duruma göre değerlendirmeli.Hafıza kaydı yazın
- Birinin sürekli tekrarladığı bir adım dizisi mi?Sıra, tek tek adımlardan daha önemli.Beceri yazın
- Pazarlığı yok mu?Kapsamını, önceliğini ve zorunluluk düzeyini belirleyin.Bu bir kuraldır
Bir tercihi kural diye yazarsanız, diğer bütün kurallarınızın inandırıcılığından yersiniz.
Sık sorulan sorular.
Yapay zekâ ajanı kuralı nedir?
Bir yapay zekâ kodlama ajanının tanımlı bir kapsam içinde uyması gereken kısıt. Bir kural bir kapsam türü (folder, file_type ya da project), bir öncelik (high, medium ya da low) ve bir zorunluluk düzeyi (advisory ya da strict) taşır; bunlar birlikte kuralın nerede geçerli olduğunu, ne kadar güçlü öne çıktığını ve ihlal edildiğinde ne olacağını belirler.
Kural ile hafıza kaydı arasındaki fark nedir?
Bir hafıza kaydı burada neyin doğru olduğunu söyler ve ajan onu duruma göre değerlendirir. Bir kural ise neyin olmaması gerektiğini söyler ve pazarlığa açık değildir. Dürüst cevap “duruma bağlı, ajan bunu düşünmeli” ise onun yerine bir hafıza kaydı yazın: onu kural diye yazarsanız, diğer bütün kurallarınızın inandırıcılığından yersiniz.
Yapay zekâ ajanım kurallarını neden yok sayıyor?
Genellikle üç nedenden biriyle: kural uzun bir talimat dosyasında alakasız yönergelerle yarışıyordur, kapsamı yanlış olduğu için önemli olduğu yollarda hiç devreye girmiyordur ya da tercih gibi yazıldığı için haklı olarak bir kenara bırakılıyordur. Uzun okumalar: Cursor kuralları neden sessizce yok sayılır ve Claude Code CLAUDE.md dosyanızı neden yok sayar.
Bir kural bir değişikliği gerçekten engelleyebilir mi, yoksa yalnızca tavsiye mi eder?
İkisi de mümkün ve bu istemciye bağlı. Onaylı bir engelleme desenine sahip katı bir kuralı yerel Pathrule hook'u kontrol eder; hook eşleşen bir düzenlemeyi uygulanmadan önce reddeder ve gerekçe olarak kuralı gösterir. Pathrule CLI ve VS Code eklentisi bu hook'u Claude Code, Codex, Cursor ve GitHub Copilot için kaydeder. Windsurf ve Remote MCP'de ise kurallar yalnızca bağlam olarak gelir; engellemenin bağlanabileceği bir yazma öncesi olay yoktur.
Kaç kural yüksek öncelikli olmalı?
Az sayıda. Yüksek öncelik, kapsam eşleştiğinde her zaman eklenmek demektir; bu yüzden bir bütçedir: kurallarınızın yarısı yüksek öncelikliyse aslında hiçbiri değildir. Bunu ihlali hatalara, güvenlik gerilemelerine ya da uyumluluk sorunlarına yol açan kurallara ayırın, geri kalan her şeyi varsayılan olarak orta önceliğe bırakın.
Bunun Cursor Rules ya da CLAUDE.md'den farkı ne?
Cursor kuralları da Claude Code kuralları da yola bağlanabilir ve her iki ürün de hook sunar. Pathrule her kuralı kapsamı, önceliği ve zorunluluk düzeyiyle tek bir çalışma alanı kaynağında saklar, göreve göre seçer ve Claude Code, Codex, Cursor, GitHub Copilot ve Windsurf'e gönderir. Yan yana: Pathrule vs Cursor Rules ve Pathrule vs talimat dosyaları.
Mevcut kural dosyalarımı silmem gerekir mi?
Hayır. Pathrule onların üstünde çalışır. CLAUDE.md, AGENTS.md ve .cursorrules iyi oldukları işi, yani depo genelindeki sabitleri taşımayı sürdürür. Pathrule bu dosyaların iyi modelleyemediği yola bağlı kısıtları taşır.
Aynı kural birden fazla yola uygulanabilir mi?
Evet. Kurallar yeniden kullanılabilir: tek bir kural nesnesi birden fazla düğüme bağlanabilir; böylece ortak bir kısıt her dizin için kopyalanmak yerine bir kez yazılır ve bir kez incelenir. Yazımla ilgili ayrıntılar Kural nasıl yazılır sayfasında.