CLAUDE.md kurallarını hook’lara “derleyen” Claude Code eklentisi

Merhaba, Claude Code’u her gün kullanan bir geliştiriciyim. CLAUDE.md büyüdükçe iki şey sürekli gözüme batmaya başladı.

1. Kuralların oturum başlangıcında (t=0) topluca yüklenmesi, o kurallara gerçekten ihtiyaç duyulan anın ise onlarca tur sonra gelmesi. Bağlam birikip bir kez sıkıştırma geçtikten sonra açık kurallar silik bir arka plana düşüyor.
2. @docs/pr-rules.md gibi referans belgelerin her oturumda token ücretini peşin ödetmesi, oysa gerçekten PR oluşturan oturumların yalnızca bir kısmı olması.

Bu yüzden kuralları “oturumun üstündeki bir beyan” olmaktan çıkarıp “aksiyona bağlı bir event listener” olarak derleyen bir eklenti yaptım.

/nunchi:compile, CLAUDE.md ve referans belgelerden kuralları çıkarıp bunlara tetikleyiciler (araç + regex) eklenmiş kural dosyaları oluşturuyor; PreToolUse hook’u da gh pr create gibi bir aksiyondan hemen önce özgün belgeyi o anda okuyup teslim ediyor. Sıkıştırma geçtikten sonra SessionStart hook’u teslim durumunu sıfırlıyor; böylece bir sonraki tetikleyicide tekrar teslim ediyor (yeniden teslim ölçümü 5/5). Tüm teslimler JSONL olarak kaydediliyor ve /nunchi:report ile “hangi kural ne zaman ateşlendi, neleri tasarruf ettirdi” görülebiliyor.

Rakamların tamamı, ön kayıtlı deneyler olarak depoda açıkça yayımlanmış durumda.

• Oturum başlangıcı token’ları: 8 kural belgesini (~76KB) @import’tan çıkarınca 79.683 → 45.808 (−%42,5, ~34k token). Belge maliyeti yalnızca ilgili aksiyonun gerçekten tetiklendiği oturumlarda ödeniyor.
• Sıkıştırma sonrası kural ihlali: Temel durumda (yalnızca CLAUDE.md) 3 çalıştırmanın 1’inde, tüm deney boyunca ilk kez gözlenen bir ihlal vardı — o nokta tam olarak “sıkıştırmanın attığı @referans belgesindeki kural”dı. Ancak ön kayıtlı eşiği geçemediği için “JIT daha yüksek uyum oranı sağlar” iddiasında bulunmuyorum — bu henüz doğrulanmadı ve README’de de böyle yazıyor.
• Derleme kalitesi: Gerçek dünyadan 12 CLAUDE.md’de (airflow, next.js, supabase vb., 166KB) biçim geçerliliği %100, uydurma 0. Recall, adversarial gold’a göre %35 ile düşük; bunu da saklamadan issue olarak takip ediyorum.
• Korece belge uyumluluğu: Korece yazılmış 4 gerçek dünya CLAUDE.md’de (pinpoint dahil) biçim ihlali, aşırı çıkarım ve uydurma 0; yasaklayıcı ifadelerin (“asla doğrudan commit yapmayın”) güç derecesi sınıflandırması %88. CLAUDE.md’yi Korece yazanlar için bir yazım rehberi de var.

Mevcut yaklaşımlardan farkı: path-scoped rules “dosya okuma” tetikleyicisidir; nunchi ise “aksiyon” tetikleyicisidir (ikisi birlikte var olacak şekilde tasarlandı). Context Mode/RTK türü araçlar, bağlama gelen çıktıyı sıkıştıran araçlardır; nunchi ise sıkıştırma değil, teslim zamanını zamanlamadır. Token tasarrufu bir yan ürün; asıl nokta kuralın aksiyondan hemen önce kesin olarak bağlamda bulunması ve bunun log ile kanıtlanabilmesi.

Şu anda gerçek kullanıcısı yalnızca benim; bu yüzden başka iş akışlarında (monorepo’lar, farklı dil ekipleri, büyük CLAUDE.md dosyaları) nasıl davrandığına dair veriye ihtiyacım var. Kurulum iki satır:

/plugin marketplace add seob717/nunchi  
/plugin install nunchi@nunchi-marketplace  

Tetikleyici çıkarımının yanlış olduğu yerler, regex ile yakalanmayan kural türleri, raporda daha fazla görmek istedikleriniz — her türlü geri bildirimi memnuniyetle alırım.