Plugin Claude Code yang "mengompilasi" aturan CLAUDE.md menjadi hook

Halo, saya developer yang memakai Claude Code setiap hari. Semakin besar CLAUDE.md, ada dua hal yang terus mengganggu saya.

1. Aturan dimuat utuh saat sesi dimulai (t=0), padahal momen saat aturan itu benar-benar dibutuhkan sering kali baru datang puluhan giliran kemudian. Setelah konteks menumpuk dan kompaksasi lewat sekali, aturan eksplisit itu turun derajat menjadi latar belakang yang samar.
2. Dokumen referensi seperti @docs/pr-rules.md membayar token di muka pada setiap sesi, padahal sesi yang benar-benar membuat PR hanya sebagian.

Karena itu saya membuat plugin yang mengompilasi aturan bukan sebagai "deklarasi di bagian atas sesi", melainkan sebagai "event listener yang terikat pada aksi".

/nunchi:compile mengekstrak aturan dari CLAUDE.md dan dokumen referensi lalu membuatnya menjadi file aturan yang diberi trigger (tool + regex), dan hook PreToolUse membaca serta mengantarkan dokumen asli tepat sebelum aksi seperti gh pr create dijalankan. Setelah kompaksasi lewat, hook SessionStart mereset status pengantaran sehingga pada trigger berikutnya dokumen akan diantarkan lagi (pengukuran re-delivery 5/5). Semua pengantaran dicatat dalam JSONL, dan lewat /nunchi:report kita bisa melihat "aturan mana yang terpicu kapan, dan apa yang dihemat".

Semua angka dipublikasikan di repo sebagai eksperimen preregistrasi.

• Token awal sesi: setelah 8 dokumen aturan (~76KB) dikeluarkan dari @import, 79,683 → 45,808 (−42.5%, ~34k token). Biaya dokumen hanya dibayar pada sesi ketika aksi terkait benar-benar terpicu.
• Pelanggaran aturan setelah kompaksasi: pada baseline (hanya CLAUDE.md), terjadi 1 kali dalam 3 run, dan itu adalah pelanggaran pertama yang teramati di seluruh eksperimen — tepat pada titik saat "aturan dalam dokumen referensi @ yang dibuang oleh kompaksasi" dibutuhkan. Namun, karena tidak lolos gate preregistrasi, saya tidak mengklaim bahwa "JIT punya tingkat kepatuhan lebih tinggi" — ini masih belum tervalidasi, dan README juga menjelaskannya demikian.
• Kualitas kompilasi: pada 12 CLAUDE.md dunia nyata (airflow, next.js, supabase, dll. total 166KB), validitas format 100%, halusinasi 0. Recall rendah, 35% dibanding gold adversarial, dan ini juga tidak disembunyikan; masih dilacak lewat issue.
• Kompatibilitas dokumen berbahasa Korea: pada 4 CLAUDE.md Korea dunia nyata (termasuk pinpoint), pelanggaran format, over-extraction, dan halusinasi semuanya 0; penilaian intensitas untuk ekspresi larangan ("jangan pernah commit langsung") mencapai 88%. Ada juga panduan penulisan untuk yang menulis CLAUDE.md dalam bahasa Korea.

Perbedaannya dengan pendekatan yang ada: path-scoped rules adalah trigger "membaca file", sedangkan nunchi adalah trigger "aksi" (keduanya dirancang untuk bisa hidup berdampingan). Jenis Context Mode/RTK adalah alat untuk memampatkan output yang masuk ke konteks, sedangkan nunchi bukan memampatkan, melainkan menjadwalkan waktu pengantaran. Penghematan token hanyalah efek samping; inti utamanya adalah aturan pasti berada di konteks tepat sebelum aksi, dan itu bisa dibuktikan lewat log.

Saat ini saya masih satu-satunya pengguna aktif, jadi saya butuh data tentang bagaimana ini bekerja di workflow lain (monorepo, tim dengan bahasa lain, CLAUDE.md berukuran besar). Instalasinya dua baris:

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

Titik-titik saat inferensi trigger keliru, jenis aturan yang tidak tertangkap regex, hal-hal yang ingin lebih terlihat di report — umpan balik apa pun akan sangat saya hargai.