İçeriğe geç
Pathrule

kurallar

Ö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.

tek kural, üç ayar/services/billing

Tutarlar cent cinsinden tam sayı olarak saklanır.

kapsam
öncelik
zorunluluk
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.

CLAUDE.mdher satır, aynı ağırlık
  • 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
pathrulebu dosya için 3 kural
  • 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.

Örnek çalışma alanı, tek prompt

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.

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ı?

  1. Cevap “duruma bağlı” diye mi başlıyor?Ajan bunu duruma göre değerlendirmeli.Hafıza kaydı yazın
  2. Birinin sürekli tekrarladığı bir adım dizisi mi?Sıra, tek tek adımlardan daha önemli.Beceri yazın
  3. 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.

Kuralı bir kez yazın.
Her ajan ona uysun.