परियोजना की निर्देश फ़ाइल हर सत्र की शुरुआत में पढ़ी जाती है, यानी जब तक फ़ाइल है, उसकी हर पंक्ति हर अनुरोध पर चुकाई जाती है। यही एक तथ्य तय कर देता है कि उसमें क्या आएगा और क्या नहीं। जो कुछ कोड पढ़कर पता चल जाता है — भाषा, फ़्रेमवर्क, फ़ोल्डरों की बनावट — वह ऐसे पाठक को दोहराया जा रहा है जो पहले ही देख रहा है। जगह उसका उलटा कमाता है: वह टेस्ट कमांड जिसे एक विकल्प चाहिए, वह Node संस्करण जो बिल्ड तोड़ देता है, वह परिपाटी जिसे नया व्यक्ति ग़लत ही अनुमान लगाएगा, वह बात जो पहले ही किसी की आधी दोपहर ले चुकी है। यह बिल्डर इन्हीं श्रेणियों के इर्द-गिर्द बना है, फ़ाइल की क़ीमत आँकता है, और उन पंक्तियों को दिखाता है जो रिपॉज़िटरी को उसी के बारे में बता रही हैं।
विशेषताएँ
खाली पन्ने के बजाय «क्या लिखना है» से निर्देशित खंड
चलता हुआ टोकन अनुमान — हर अनुरोध की क़ीमत, एक बार की नहीं
जो कोड पहले ही दिखा देता है उसे दोहराती पंक्तियाँ दिखाता है
कुछ न बदलने वाले खोखले उपदेश दिखाता है
फ़ाइल उस आकार तक बढ़ जाए जहाँ वह सरसरी पढ़ी जाने लगे तो चेतावनी
छाँटने लायक शीर्षक न हों तो टिप्पणी
ख़ाली खंड छोड़ दिए जाते हैं, ख़ाली लिखे नहीं जाते
CLAUDE.md के रूप में डाउनलोड
परियोजना निर्देश बिल्डर का उपयोग कैसे करें
परियोजना का नाम लिखिए
सिर्फ़ वही खंड भरिए जिनमें कुछ ग़ैर-ज़ाहिर कहने को है
बढ़ते हुए टोकन अनुमान पर नज़र रखिए
चेतावनियाँ पढ़िए और फ़ाइल डाउनलोड कीजिए
उदाहरण
इनपुट
This project is a React app.
आउटपुट
Warning: the language and framework are visible from the manifest
हर पंक्ति की कसौटी: क्या पाठक यह दस सेकंड में ख़ुद पता कर लेगा?
सामान्य त्रुटियाँ और समस्या निवारण
फ़ाइल बहुत बड़ी बताई जा रही है। — जो कभी-कभार ही प्रासंगिक है उसे अलग दस्तावेज़ में ले जाइए जिसे सत्र ज़रूरत पड़ने पर पढ़ ले। निर्देश फ़ाइल उसके लिए है जो हमेशा सच है।
जो पंक्ति मुझे चाहिए थी उसे «पता लगाने योग्य» बताया गया। — अगर वह सचमुच काम की है तो चेतावनी छोड़ दीजिए। यह जाँच यह पूछने का न्यौता है कि पाठक वैसे भी पता कर लेता या नहीं, नियम नहीं है।
निर्देश जोड़ने पर कुछ बदलता नहीं। — ठोस और जाँचे जा सकने वाले निर्देश आम निर्देशों से कहीं बेहतर उतरते हैं। «components/ui की प्रिमिटिव इस्तेमाल करो» «साफ़ कोड लिखो» से बेहतर है।
इसे CLAUDE.md कहें या कुछ और? — सामग्री वही रहती है। जिस नाम को आपका औज़ार पढ़ता है उसी से सहेज लीजिए; बनावट और अनुशासन नहीं बदलते।
अक्सर पूछे जाने वाले प्रश्न
निर्देश फ़ाइल में असल में क्या आना चाहिए?
वह जो कोड से पता नहीं चलता और वरना ग़लत अनुमान लगाया जाएगा: वह कमांड जिसे विकल्प चाहिए, वह संस्करण जो बिल्ड तोड़ता है, वह परिपाटी जो किसी एक फ़ाइल में नहीं दिखती, और साफ़-साफ़ मनाही। बाक़ी सब उस पाठक को दोहराना है जो पहले ही पढ़ना जानता है।
यह कितनी लंबी हो?
इतनी छोटी कि अब भी पढ़ी जाए। अनुमान टाइप करते ही दिखता है; कुछ हज़ार टोकन के बाद यह पूछने लायक है कि कौन-सी पंक्तियाँ सचमुच हमेशा प्रासंगिक हैं — बाक़ी उस दस्तावेज़ में रह सकती हैं जो ज़रूरत पर पढ़ा जाए।
«साफ़ कोड लिखो» क्यों दिखाया जाता है?
क्योंकि उससे कुछ बदलता नहीं। आम उपदेश हर अनुरोध पर टोकन ख़र्च करता है और किसी फ़ैसले का आधार नहीं देता; ठोस परिपाटी — तर्क कहाँ रखा जाए, कौन-सी प्रिमिटिव इस्तेमाल हों — आधार देती है।
हर अनुरोध पर चुकाना क्या मायने रखता है?
फ़ाइल छाँटने की वजह ठीक यही है। एक पन्ना निर्देश एक बार में छोटी रक़म है और हज़ारों अनुरोधों पर ख़ासी रक़म, इसीलिए अनुमान छिपाने के बजाय पाठ के बग़ल में रखा है।
क्या इसमें गोपनीय कुंजियाँ रख सकते हैं?
नहीं — यह हर सत्र में संदर्भ में पढ़ी जाती है और आम तौर पर रिपॉज़िटरी में जाती है। साख अपने परिवेश में रखिए और निर्देशों में ज़रूरत पड़े तो सिर्फ़ नाम से इशारा कीजिए।
संबंधित टूल
स्किल बिल्डर — SKILL.md लिखिए, frontmatter साथ-साथ जाँचा जाता है।
सबएजेंट बिल्डर — सबएजेंट की परिभाषा फ़ाइल बनाइए, उसके उपकरण और मॉडल समेत।