नमस्ते, मैं एक डेवलपर हूं जो Claude Code रोज़ इस्तेमाल करता है। जैसे-जैसे CLAUDE.md बड़ा होता गया, दो बातें लगातार खटकती रहीं।
- नियम session की शुरुआत (t=0) में एक साथ लोड हो जाते हैं, जबकि उन नियमों की ज़रूरत असल में कई दर्जन turns बाद पड़ती है। Context जमा होता जाता है और एक बार compaction हो जाने पर explicit rules धुंधली background जानकारी बनकर रह जाते हैं।
@docs/pr-rules.mdजैसे reference documents हर session में token cost पहले से वसूल लेते हैं, जबकि वास्तव में PR बनाने वाले sessions केवल कुछ ही होते हैं।
इसलिए मैंने एक plugin बनाया जो rules को "session के ऊपर लिखी declaration" नहीं बल्कि "actions से जुड़े event listeners" में compile करता है।
/nunchi:compile CLAUDE.md और reference documents से rules निकालकर trigger (tool + regular expression) लगाए हुए rule files बनाता है, और PreToolUse hook gh pr create जैसे action से ठीक पहले original documents को उसी समय पढ़कर पहुंचाता है। जब compaction हो जाता है, तो SessionStart hook delivery state को reset कर देता है ताकि अगले trigger पर फिर से delivery हो सके (re-delivery का प्रत्यक्ष मापन 5/5)। हर delivery JSONL में log होती है, और /nunchi:report से देखा जा सकता है कि "कौन-सा rule कब trigger हुआ और क्या बचाया गया"।
सभी संख्याएं preregistered experiments के रूप में repo में सार्वजनिक हैं।
- Session start tokens: 8 rule documents (~76KB) को
@importसे हटाने पर 79,683 → 45,808 (−42.5%, ~34k tokens)। Document cost अब केवल उन्हीं sessions में चुकानी पड़ती है जहां वह action वास्तव में trigger होता है। - Compaction के बाद rule violations: baseline (केवल CLAUDE.md) में 3 runs में 1 बार, और पूरे experiment में यह पहली बार देखा गया violation था — और वह बिंदु ठीक वही था जहां "compaction ने
@reference document के अंदर का rule हटा दिया था"। हालांकि preregistered gate पार नहीं हुआ, इसलिए मैं यह दावा नहीं करता कि "JIT में compliance rate ज्यादा है" — यह अभी unverified है, और README में भी यही लिखा है। - Compile quality: वास्तविक wild CLAUDE.md के 12 उदाहरणों (airflow, next.js, supabase आदि, 166KB) में format validity 100%, hallucination 0। Recall adversarial gold के मुकाबले 35% पर कम है, और इसे छिपाया नहीं गया है; issue में track किया जा रहा है।
- Korean documents compatibility: Korean wild CLAUDE.md के 4 उदाहरणों (pinpoint सहित) में format violations, over-extraction, hallucination सभी 0, और निषेधात्मक अभिव्यक्ति ("कभी भी सीधे commit नहीं करता") की intensity classification 88%। Korean में CLAUDE.md लिखने वालों के लिए writing guide भी है।
मौजूदा approaches से फर्क: path-scoped rules एक "file read" trigger हैं, जबकि nunchi एक "action" trigger है (दोनों को साथ रहने के लिए design किया गया है)। Context Mode/RTK जैसे tools context में आने वाले output को compress करने के लिए हैं, जबकि nunchi compression नहीं करता बल्कि delivery timing को schedule करता है। Token बचत इसका side effect है; असली बात यह है कि rules action से ठीक पहले भरोसेमंद तरीके से context में मौजूद हों और इसे logs से साबित किया जा सके।
फिलहाल इसे वास्तविक रूप से इस्तेमाल करने वाला केवल मैं ही हूं, इसलिए अलग workflows (monorepo, दूसरी भाषाओं वाली teams, बड़े CLAUDE.md) में यह कैसे काम करता है, इसका data चाहिए। Installation दो lines की है:
/plugin marketplace add seob717/nunchi
/plugin install nunchi@nunchi-marketplace
Trigger inference कहां गलत पड़ता है, regex से किस तरह के rules पकड़ में नहीं आते, report में और क्या देखना चाहेंगे — किसी भी तरह का feedback बेहद स्वागतयोग्य है।
अभी कोई टिप्पणी नहीं है.