Claude Code के पाँच रूल्स जिन्हें वह छोड़ नहीं सकता
हमने अपनी ही TypeScript invoicing API पर Claude Code को असली फ़ीचर दिए और उसे एक validator को दोबारा इस्तेमाल करने के बजाय कॉपी करते पकड़ा। यह लेख codebase के सड़ने के खिलाफ पाँच रूल्स गिनाता है और हर रूल के लिए वह Claude Code hook या setting बताता है जो उसे लागू करती है। Anthropic के documentation के अनुसार CLAUDE.md फ़ाइल context है, enforced configuration नहीं, यानी उसमें लिखा रूल बस एक वाक्य है जिसे मॉडल काम के सामने तौलता है। नीचे के enforcers वे फ़ाइलें हैं जिन्हें harness चलाता है: edit के तुरंत बाद चलने वाला duplication blocker, एक turn जो टेस्ट red रहते खत्म नहीं हो सकता, और configuration के वे gates जिन्हें agent छू नहीं सकता।
जो रूल आप लिखते हैं, और जो check harness चलाता है
Claude Code hook एक छोटी script है जिसे Claude Code खुद एक तय क्षण पर चलाता है, किसी tool call से पहले या बाद में। जब script error code के साथ exit करती है, तो उसने जो print किया वह Claude को इनकार के रूप में लौट जाता है। Anthropic की best practices निर्देशों को दो तरह में बाँटती हैं: वे जो आप लिखते हैं और मॉडल पढ़ता है (एक prompt, CLAUDE.md फ़ाइल, एक skill) और वे जो आप configure करते हैं और harness चलाता है (एक hook, एक deny rule, एक managed setting)। memory documentation कहता है कि CLAUDE.md दिशानिर्देशों के लिए है, और Claude तय कर सकता है कि कोई दिशानिर्देश लागू नहीं होता।
हमने इस बँटवारे को एक छोटी invoicing API पर परखा, बिना कोई रूल लिखे, और Claude से recurring schedules और outstanding report का CSV export माँगा। Claude हरा सिग्नल लेकर लौटा: typecheck पास, हर टेस्ट पास। एक duplication detector ने कुछ और बताया: invoice parser को लाइन दर लाइन नए schedule parser में कॉपी कर दिया गया था, और handler का customer lookup नए handler में।
| Setup | Features | मिले exact clones | पास होते टेस्ट |
|---|---|---|---|
| CLAUDE.md में गद्य के रूप में लिखे रूल्स | 1 | 0 | 45 |
| कोई रूल नहीं लिखा | 1, फिर उसके ऊपर दूसरा | 3, फिर भी 3 | 47, फिर 55 |
दोनों features के बाद भी clones Claude की रिपोर्ट में अदृश्य रहे। इस लेख का हर enforcer .claude फ़ोल्डर के अंदर की एक ही settings फ़ाइल में रहता है, जिसमें एक hooks block और एक deny list है।
पहला रूल: लिखने से पहले दोबारा इस्तेमाल करें
Enforcer Edit और Write tools पर लगा एक PostToolUse hook है। script अपने input से edit हुई फ़ाइल का path पढ़ती है, source फ़ोल्डर पर jscpd चलाती है, और clones की गिनती की तुलना repo में रखे baseline से करती है, ताकि पुरानी duplication आज के काम को न रोके। गिनती बढ़ने पर script रूल और जुड़वाँ कोड की जगह print करती है और code 2 के साथ exit करती है। hooks reference कहता है कि tool चलने के बाद exit code 2 संदेश Claude को दिखाता है; 0 से exit करने वाली script को कभी देखा नहीं जाता, चाहे वह कुछ भी print करे।
hook लगाकर schedules feature को दोबारा चलाने पर Claude ने नया handler लिखा और hook तुरंत चला, उसने invoices handler के customer lookup को जुड़वाँ बताया। Claude की अगली पंक्ति थी कि यह check अब दोनों handlers में है और वह इसे customer repository में एक method बनाकर दोनों जगह से बुलाएगा। अंत में detector साफ़ था और साझा check एक ही जगह रहता था।
सीमाएँ: jscpd हूबहू कॉपी पकड़ता है, शुरू से दोबारा लिखा गया helper नहीं, और edit के बाद चलने वाला hook उसे वापस नहीं ले सकता। वह सिर्फ़ feedback देता है।
दूसरा रूल: ऐसा कोई module नहीं जो किसी ने माँगा न हो
Enforcer Write tool पर लगा एक PreToolUse hook है। script बस एक चीज़ जाँचती है: क्या path source फ़ोल्डर के अंदर है और क्या फ़ाइल अभी मौजूद नहीं है। अगर हाँ, तो वह कारण के साथ ask कहने वाला JSON decision print करती है, और Claude Code उसे permission prompt में बदल देता है। hooks reference PreToolUse hook को चार संभावित decisions देता है: allow, deny, ask या defer।
दोबारा चलाने पर Claude Code ने schedules feature के हर नए module से पहले रुककर पूछा। feature को बाकी repo की तरह एक schedule module, एक store और एक handler चाहिए थे, इसलिए हर एक को मंज़ूरी मिली। बाद में CSV helpers को नए utils module में ले जाने के अनुरोध पर वही prompt आया, जिसे ठुकरा दिया गया: Claude Code ने उस batch की दोनों writes अस्वीकार कीं, turn बिना कुछ लिखे खत्म हुआ, और Claude ने दोबारा कोशिश नहीं की।
हमारे चलाए version, 2.1.294, पर दो सीमाएँ: prompt फ़ाइल का नाम दिखाता है जबकि कारण Claude के transcript में जाता है, dialog में नहीं; और shell command से बनी फ़ाइल Write tool call नहीं होती, इसलिए वह इस hook से निकल जाती है।
तीसरा रूल: conventions गद्य नहीं, lint हैं
Enforcer प्रोजेक्ट का linter है, जिसे एक hook हर edit हुई फ़ाइल पर चलाता है। conventions (interfaces की जगह type aliases, कोई enum नहीं, कोई any नहीं, एक domain layer जो input या output नहीं करती) गद्य से ESLint config में चली जाती हैं: एक restricted-syntax rule प्रोजेक्ट के अपने संदेश के साथ interface या enum को ठुकराता है, और एक restricted-imports rule फ़ाइल access को domain फ़ोल्डर से बाहर रखता है। Edit और Write पर लगा PostToolUse hook अभी बदली फ़ाइल पर ESLint चलाता है और error पर code 2 से exit करता है, ताकि उल्लंघन ठीक उसी लाइन पर Claude तक पहुँचे।
convention के शब्द .claude/rules/ के नीचे एक rules फ़ाइल में रहते हैं जिसमें paths header होता है, जो फ़ाइल को तभी लोड करता है जब Claude उस फ़ोल्डर को छुए। memory documentation कहता है कि path-scoped rule तब लोड होता है जब Claude किसी मेल खाती फ़ाइल को पढ़ता, लिखता या edit करता है, और चेताता है कि जो header parse न हो वह रूल को हर जगह लोड करा देता है।
status union को enum में और एक type को interface में बदलने को कहा गया, तो Claude ने कुछ edit नहीं किया। उसने कहा कि यह refactor प्रोजेक्ट के अपने रूल्स तोड़ेगा, lint config और वह hook बताया जो इस बदलाव को flag करेगा, और बदले में const object सुझाया। domain के भीतर फ़ाइल पढ़ने का लालच देने वाला holidays feature माँगने पर, Claude ने सूची बाहर से पास की, क्योंकि domain को input या output की अनुमति नहीं है। hook को चलने की ज़रूरत ही नहीं पड़ी। जब उसे हाथ से खराब फ़ाइल दी गई, तो उसने errors उनकी लाइनों पर और इनकार लौटाया।
चौथा रूल: पूरा होने का मतलब है checks पास होना
Enforcer एक Stop hook है, यानी ऐसी script जो तब चलती है जब Claude अपना turn खत्म करना चाहता है और जवाब दे सकती है "अभी नहीं"। script typecheck और टेस्ट suite चलाती है; कुछ भी red होने पर वह फ़ेल हुआ output print करती है और code 2 से exit करती है। वह पास होते टेस्टों की संख्या की तुलना एक रखे baseline से भी करती है, इसलिए जो suite इसलिए हरा दिखे कि कोई टेस्ट मिटा दिया गया, वह भी red गिना जाता है। वह stop_hook_active flag जाँचती है जिसका documentation वर्णन करता है, जो तब true होता है जब Claude पहले से hook की वजह से जारी है, और उस स्थिति में 0 से exit करती है ताकि hook कभी loop में न फँसे।
जल्दबाज़ी वाले developer की भूमिका निभाते हुए, हमने एक report field का तेज़ rename माँगा और Claude से कहा कि टेस्ट न चलाए। Claude ने edit shell command से किया, कहा कि suite अब फ़ेल होगी, और turn खत्म करने की कोशिश की। hook ने टेस्ट चलाए और "Rule 4: tests fail. Not done yet." के साथ फ़ेल होती assertions लौटाकर इनकार किया। Claude की अगली पंक्ति थी कि प्रोजेक्ट का stop hook हरे टेस्ट माँगता है, इसलिए वह पुरानी अपेक्षाएँ अपडेट करेगा। टेस्ट अपनी जगह बने रहे।
documentation लगातार 8 इनकारों पर loop की सीमा रखता है, जिसके बाद turn वैसे भी खत्म हो जाता है। पास कराने के लिए दोबारा लिखा गया टेस्ट पकड़ में नहीं आता; मिटाया गया टेस्ट आता है। एक जाल: एक बहुचर्चित thread में शिकायत थी कि Claude stop hooks को नज़रअंदाज़ करता है, और उसमें दी गई script 0 से exit करती थी, इसलिए harness ने कभी कुछ रोका ही नहीं। रोकने वाला code 2 है, कारण error channel पर।
पाँचवाँ रूल: agent अपने ही gates ढीले नहीं कर सकता
ऊपर के हर check का एक shortcut है: compiler config में strict बंद कर दो, runner config में फ़ेल होता टेस्ट बाहर कर दो, settings फ़ाइल से hook मिटा दो। Enforcer settings फ़ाइल के permissions block में एक deny list है, हर फ़ाइल के लिए एक Edit(...) पंक्ति: compiler config, test config, lint config और .claude फ़ोल्डर के अंदर सब कुछ। permissions documentation कहता है कि deny rules पहले जाँचे जाते हैं और कोई allow rule किसी deny से अपवाद नहीं निकाल सकता।
stop hook को धीमा करने की वजह से हटाने को कहने पर Claude ने settings पढ़ीं और कोशिश नहीं की: उसने कहा कि फ़ाइल में .claude फ़ोल्डर पर deny rule है, वह shell command से इसे टाल सकता है, और ऐसा करना उस सुरक्षा को बायपास करना होगा जो टीम ने जानबूझकर लगाई। strict बंद करने को कहने पर उसने लिखे रूल के आधार पर मना कर दिया और बदले में एक flag के साथ typecheck चलाया। फिर भी बदलने को कहने पर Claude ने फ़ाइल पर shell command आज़माई, और harness ने जवाब दिया कि उस command की अनुमति अस्वीकृत है। Claude का जवाब था कि उसने कोई और रास्ता नहीं आज़माया, क्योंकि वैसा करना उसी चीज़ को निष्फल करना होगा जिसने यह रोक लगाई।
सीमा भी documented है: deny rule उस script को नहीं रोकता जो फ़ाइल को खुद खोलती है, और फ़ाइल को अब भी हाथ से edit किया जा सकता है। यही मकसद है।
कौन सा रूल पहले लगाएँ
हर रूल एक फ़ाइल है जिसे आप कॉपी करते हैं, एक वाक्य नहीं जिसके पढ़े जाने की आप उम्मीद करते हैं। गद्य के रूप में लिखे रूल्स के साथ एक feature ने कोई रूल नहीं तोड़ा; कुछ न लिखने पर अगले features ने तीन exact clones छोड़े जो बने रहे; enforcers चालू होने पर हर एक ने एक असली edit ठुकराया।
| अगर आप एक ही चीज़ लगाएँ | क्यों |
|---|---|
| Stop hook | सबसे कम setup में सबसे ज़्यादा सुरक्षा |
| फिर deny list | settings फ़ाइल में चार पंक्तियाँ |
| कुछ नहीं | throwaway prototype पर |
जब suite मिनटों लेती हो, तो तेज़ हिस्सा hook में रखें और बाकी pipeline में ले जाएँ। ईमानदार सीमा Claude Code repository के एक लंबे issue से आती है: hook वही लागू करता है जो एक tool call दिखा सके, और abstraction सही है या नहीं, यह इंसानी फ़ैसला रहता है। documentation का अपना अंगूठे का नियम: अगर आप CLAUDE.md की किसी पंक्ति पर ज़ोर बढ़ाते जाते हैं और Claude फिर भी चूकता है, तो वह पंक्ति hook में होनी चाहिए।
AIDive