HUMAN-INTENT.md

समस्या

सच कहें तो: अब हम कोड पढ़ना नहीं चाहते। एजेंटों के हर काम की जाँच नहीं करना चाहते, न ही प्रोजेक्ट की हर तकनीकी बारीकी दिमाग़ में रखना चाहते हैं।

लेकिन अगर एजेंटों पर किसी का नियंत्रण न हो, तो वे किसी भी प्रोजेक्ट को ऐसी अराजकता में बदल देंगे जिसे न इंसान सुलझा पाएगा, न एजेंट। यह बस समय की बात है।

विचार

HUMAN-INTENT.md आपकी रिपॉज़िटरी की रूट में रखी एक फ़ाइल है। इसमें आपका इरादा दर्ज है: प्रोजेक्ट की आर्किटेक्चर, डेवलपमेंट के नियम और प्रोडक्ट के फ़ैसले।

यह कोड का दस्तावेज़ नहीं है। यह वह कानून है जिसका कोड को पालन करना होगा।

नियम

• इसे आप लिखते हैं — और केवल आप

  एजेंट इस फ़ाइल को कभी नहीं बदलते। इसकी हर पंक्ति इंसान का लिया हुआ फ़ैसला है।

• इसके निर्देश एजेंट के लिए कानून हैं

  HUMAN-INTENT.md में जो लिखा है, वह बाकी सब पर भारी है। अगर कोड फ़ाइल के खिलाफ़ जाता है, तो गलत कोड है।

• यह आर्किटेक्चर, नियम और प्रोडक्ट तय करती है

  इरादा, नुस्खे नहीं। एजेंट पहले से सारे पैटर्न जानता है; आपका काम यह तय करना है कि क्या सही होना चाहिए — और क्यों।

यह क्यों काम करता है

एजेंटों के साथ कदम मिलाना नामुमकिन है: कोड इतना बनता है कि कोई पढ़ना नहीं चाहता। हर पंक्ति पर नियंत्रण रखना बेकार है। इरादे पर नियंत्रण रखना मुमकिन है।

HUMAN-INTENT.md नियंत्रण को एक स्तर ऊपर ले जाती है: आप हज़ारों पंक्तियों के कोड की जगह अपने फ़ैसलों वाली एक फ़ाइल पर नज़र रखते हैं। जब तक फ़ाइल कानून है, प्रोजेक्ट आपके इरादे के मुताबिक बढ़ता है — भले ही कोड कोई न पढ़े।

कैसे शुरू करें

1. अपनी रिपॉज़िटरी की रूट में HUMAN-INTENT.md बनाएँ।
2. जो फ़ैसले आप पहले ही ले चुके हैं, उन्हें लिखें: आर्किटेक्चर, डेवलपमेंट के नियम, प्रोडक्ट।
3. अपने एजेंट से कहें कि वह इस फ़ाइल को पढ़े और कानून माने — AGENTS.md या CLAUDE.md से इसका हवाला दें।
4. हर नया फ़ैसला फ़ाइल में जोड़ें। एजेंट को इसमें कभी लिखने न दें।
5. कोड की नहीं, इस फ़ाइल की समीक्षा करें।