उत्तरप्रकाशित14 स्रोत
टेस्ट, नियम और योजनाएँ: प्रोजेक्ट फ़ाइलों को व्यवस्थित करने के छह व्यावहारिक सिद्धांत
टेस्ट को केंद्रीकृत रखना अच्छा डिफ़ॉल्ट है, लेकिन Go में पैकेज के निजी हिस्सों की जाँच के लिए कुछ टेस्ट उसी पैकेज में रखने पड़ सकते हैं। प्रोजेक्ट स्पेक मौजूदा अपेक्षाएँ बताता है, ADR किसी अहम फ़ैसले का कारण दर्ज करता है और टेस्ट जाँचने का तरीका देता है—इनकी भूमिकाएँ अलग हैं। योजना को फ़्रीज़ करना उसे पूरा मानकर संग...
प्रकाशितकर्ताGPT Image 2 से चित्र बनाए गए
शोध उत्तर
मुख्य निष्कर्ष
- टेस्ट को केंद्रीकृत रखना अच्छा डिफ़ॉल्ट है, लेकिन Go में पैकेज के निजी हिस्सों की जाँच के लिए कुछ टेस्ट उसी पैकेज में रखने पड़ सकते हैं।
- प्रोजेक्ट स्पेक मौजूदा अपेक्षाएँ बताता है, ADR किसी अहम फ़ैसले का कारण दर्ज करता है और टेस्ट जाँचने का तरीका देता है—इनकी भूमिकाएँ अलग हैं।
- योजना को फ़्रीज़ करना उसे पूरा मानकर संग्रहित करना नहीं है; अधूरे काम और उसे फिर शुरू करने की शर्तें सुरक्षित रखें।
- अस्थायी फ़ाइलें साफ़ करने से पहले जाँचें कि कहीं वे किसी निष्कर्ष या स्वीकृति के लिए इकलौता ज़रूरी सबूत तो नहीं हैं।
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/L2Q8zxg7UqZZOsMb8CmQKOfK9IR2/images/53D2DD20E6A8C8FDDC17/74C3321FB646B5554586.png)
AI संकेत
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这套布局可以作为收敛方向，但需要纠正三个等同关系：所有测试不能无条件迁出业务包，规范不是全部 ADR 的摘要，冻结也不是完成归档。以下是六项建议的明确边界；涉及的新路径均为候选，尚未创建或迁移。\n\n 1.. Topic tags: general web, openai, automation, workflow, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbnails, icons, a
फ़ोल्डर संरचना को सरल बनाने की कोशिश में अक्सर तीन अलग बातें एक मान ली जाती हैं: हर टेस्ट को बिज़नेस कोड से बाहर रखना, सभी ADR को एक सामान्य स्पेक में समेटना, और रुकी हुई योजना को पूरा मानकर संग्रहित करना। ये बराबर नहीं हैं।
नीचे छह सुझाव दिए गए हैं, साथ में उनकी सीमाएँ भी। जिन नए रास्तों का ज़िक्र है, वे प्रस्तावित हैं—अभी बनाए या माइग्रेट नहीं किए गए हैं।
1. टेस्ट को एक जगह रखें—लेकिन भाषा की ज़रूरतों के अनुसार अपवाद रखें
टेस्ट को केंद्रीकृत करना एक अच्छा डिफ़ॉल्ट है, पर यह वादा करना ठीक नहीं कि किसी भी प्रोजेक्ट में टेस्ट फ़ाइलें स्रोत कोड के साथ नहीं रहेंगी।
- Python: टेस्ट को
tests/में रखना प्राथमिक विकल्प हो सकता है। माइग्रेशन के दौरान इम्पोर्ट, टेस्ट डिस्कवरी, फ़िक्स्चर और CI की जाँच करें। मौजूदा रिपॉज़िटरी का CI पहले से केंद्रीकृत टेस्ट पथ का उपयोग करता है। - Go: अगर व्हाइट-बॉक्स टेस्ट को पैकेज के अप्रकाशित (unexported) सदस्यों तक पहुँचना है, तो उसे जाँचे जा रहे पैकेज के साथ रखना पड़ सकता है। ब्लैक-बॉक्स, कई घटकों और एंड-टू-एंड टेस्ट को प्राथमिकता से केंद्रीकृत किया जा सकता है। Go का टूलचेन पैकेज के साथ टेस्ट फ़ाइलें भी कम्पाइल करता है और उसी पैकेज या
_testप्रत्यय वाले बाहरी टेस्ट पैकेज—दोनों का समर्थन करता है।14
दो सीमाएँ अलग-अलग हैं: internal पैकेज को इम्पोर्ट करने की पाबंदी उसके डायरेक्टरी पूर्वजों के संबंध पर निर्भर करती है; इसका मतलब यह नहीं कि पैकेज को इम्पोर्ट करने के लिए टेस्ट का उसी डायरेक्टरी में होना ज़रूरी है। अप्रकाशित सदस्यों तक पहुँच पैकेज की एक अलग सीमा है। 10
16
इसलिए «हर Go टेस्ट को बिज़नेस डायरेक्टरी से बाहर निकालें और साथ ही व्हाइट-बॉक्स कवरेज व एन्कैप्सुलेशन ज्यों का त्यों रखें» को सार्वभौमिक नियम न बनाएँ। केवल फ़ोल्डर साफ़ दिखाने के लिए आंतरिक स्थिति को सार्वजनिक न करें और न ही बिज़नेस लॉजिक की नकल करें।
जिससे बचना है, वह बेकार टिकटों के टुकड़े और एक ही चीज़ की बार-बार जाँच है—ज़रूरी टेस्ट फ़ाइलें नहीं। लगातार चलने वाले रिग्रेशन टेस्ट संस्करण-नियंत्रण में रखें; एक बार के प्रयोग अस्थायी फ़ोल्डर में जा सकते हैं।
2. स्पेक, ADR और वैश्विक नियम—तीन अलग भूमिकाएँ
specs/ को सभी ADR का सामान्य सार मानना सही नहीं होगा। इन स्तरों की भूमिका अलग रखें:
| स्तर | यह किस सवाल का जवाब देता है? | सामग्री का आधार |
|---|---|---|
| वैश्विक कार्य-पद्धति | विश्लेषण, जाँच और डिलीवरी कैसे करनी है? | पद्धति के रखरखावकर्ता |
प्रोजेक्ट प्रवेश-द्वार AGENTS.md |
इस प्रोजेक्ट में काम कैसे करना है? | पुष्ट प्रोजेक्ट नियम और काम शुरू करने के निर्देश |
प्रोजेक्ट स्पेक specs/ |
अभी किन व्यवहारों और अनुबंधों का पालन होना चाहिए? | उपयोगकर्ता की ज़रूरतें, स्वीकृत फ़ैसले और अधिकृत संशोधन |
निर्णय रिकॉर्ड docs/adr/ |
किसी विकल्प को क्यों चुना गया? | अहम वास्तु-निर्णय, विकल्प और उनके बीच का संबंध |
Cline के आधिकारिक दस्तावेज़ स्थायी नियमों की व्यवस्था बताते हैं, जिससे अलग-अलग सत्रों में लागू निर्देश सहेजे जा सकते हैं। 4 लेकिन यहाँ दिए गए स्रोत यह साबित नहीं करते कि Cline अपने-आप किसी खास प्रकार की फ़ाइल को प्रोजेक्ट के स्पेक फ़ोल्डर में लिखता है। इसे Cline की गारंटी नहीं, बल्कि प्रोजेक्ट का अपना नियम समझें।
प्रोजेक्ट की सामग्री केवल हाथ से लिखना ज़रूरी नहीं, और उसे बनाने के लिए किसी दबाव की स्थिति का इंतज़ार भी नहीं करना पड़ता:
- शुरुआत में सहायक, उपयोगकर्ता की ज़रूरतों और रिपॉज़िटरी में उपलब्ध सबूत के आधार पर स्पेक का प्रस्ताव दे सकता है; जो अज्ञात है, उसे अज्ञात ही रखें।
- हर नए काम से पहले उससे जुड़े स्पेक और फ़ैसले पढ़ें, फिर इस काम की स्वीकृति-शर्तें और जाँच तय करें।
- नया ADR तभी प्रस्तावित करें जब कोई अहम नया विकल्प या समझौता सामने आए। पहले से लागू फ़ैसले का संदर्भ दें; हर योजना के लिए वही निर्णय दोबारा दर्ज न करें।
- जाँच का नतीजा यह बता सकता है कि कोड स्पेक पर खरा उतरता है या स्पेक में कमी है। केवल सफल जाँच से यह तय नहीं होता कि माँग क्या होनी चाहिए।
- फ़ैसले को अधिकृत रूप से स्वीकार कर स्पेक अपडेट होने के बाद, मौजूदा नियम संबंधित जगह लिखें और ज़रूरत पड़ने पर ADR का संदर्भ दें—पूरा पुराना इतिहास कॉपी न करें।
संक्षेप में: स्पेक मौजूदा अनुबंध है, ADR फ़ैसले का आधार दर्ज करता है और टेस्ट जाँचने का तरीका देता है। ये आपस में जुड़े हैं, लेकिन एक-दूसरे की जगह नहीं लेते। किसी प्रोजेक्ट में मिली बात को समीक्षा के बिना वैश्विक नियम भी न बनाएँ।
3. ADR का रास्ता बदलें, स्वीकार करने के नियम नहीं
नए निर्णय रिकॉर्ड के लिए docs/adr/ को डिफ़ॉल्ट स्थान बनाना ठीक है। इसे प्रोजेक्ट का नामकरण-नियम समझें, कोई अनिवार्य उद्योग-मानक नहीं।
मौजूदा निर्णय-प्रक्रिया बनाए रखें:
- प्रस्तावित, स्वीकृत, अस्वीकृत और बदले जा चुके निर्णय—सभी को ज़रूरत पड़ने पर दर्ज किया जा सकता है; केवल स्वीकृत फ़ैसले ही नहीं।
- नया काम पुराने लागू निर्णय का उपयोग करे; वही ADR दोबारा न बनाए।
- पुराना निर्णय बदले तो दोनों के संबंध का रिकॉर्ड रखें; पुराने कारण को पीछे से न बदलें।
- टेस्ट पास होना अपने-आप ADR को स्वीकृत करने की अनुमति नहीं देता।
माइग्रेशन में फ़ाइलें स्थानांतरित करने के साथ वास्तविक संदर्भ, रूटिंग और पहुँच-नियम भी अपडेट करने होंगे।
4. योजना फ़ोल्डर सपाट रखें—पर फ़्रीज़ और पूरा होना अलग रखें
plans/ में योजनाओं को सीधे रखना व्यावहारिक है; थोड़ी-सी पुरानी योजनाओं के लिए अलग-अलग सबफ़ोल्डर बनाना ज़रूरी नहीं। नामकरण के लिए ये प्रस्ताव रखे जा सकते हैं:
| उपयोग | प्रस्तावित फ़ाइल | अर्थ |
|---|---|---|
| मौजूदा सक्रिय योजना | pending_implementation_plan.md |
सक्रिय काम का एक डिफ़ॉल्ट प्रवेश-बिंदु |
| काम पूरा होने के बाद | plan-20261022-example-id.md |
पूरी हुई और संग्रहित करने की अनुमति मिली योजना |
| अधूरी योजना को रोकना | plan-20261022-example-id-frozen.md |
बाकी काम सुरक्षित है, लेकिन योजना अब डिफ़ॉल्ट रूप से सक्रिय नहीं |
फ़्रीज़ के लिए नया फ़ोल्डर या तुरंत नया स्टेटस जोड़ना ज़रूरी नहीं। मौजूदा वैलिडेटर में रुकी हुई स्थिति का समर्थन है; फ़्रीज़ की गई योजना में रुकने का कारण, बाकी काम और दोबारा शुरू करने की शर्तें लिखी जा सकती हैं।
- पूरा करके संग्रहित करना: सभी ज़रूरी स्वीकृति-जाँच पास हों और संग्रह की अनुमति मिली हो।
- अधूरा फ़्रीज़ करना: योजना को सक्रिय प्रवेश-बिंदु से हटाएँ, मगर उसे पूरा न बताएँ और अपुष्ट प्रस्ताव को तथ्य न बनाएँ।
- काम छोड़ देना: साफ़ लिखें कि उसे आगे लागू नहीं किया जाएगा और इसका क्या असर होगा। इसे केवल «अभी रुका है» न कहें। औपचारिक रूप से समाप्त करने का नया स्टेटस चाहिए या नहीं, यह अनुबंध में अलग बदलाव का विषय है।
डिफ़ॉल्ट रूप से केवल सक्रिय योजना पढ़ें; उसी फ़ोल्डर की हर पुरानी फ़ाइल नहीं। पुरानी योजना तभी ढूँढ़ें जब उपयोगकर्ता इतिहास देखना या काम फिर शुरू करना चाहे। दोबारा शुरू करने से पहले अनुमति लें, मूल योजना का संदर्भ सुरक्षित रखते हुए नया निष्पादन-रिकॉर्ड बनाएँ और फिर से जाँच करें—पुरानी «सब ठीक» स्थिति को नई अनुमति न मानें। यह मौजूदा जीवनचक्र नियम के अनुरूप है।
फ़ाइल का नाम बदल देना स्वीकृति का सबूत नहीं है। फ़ाइल पर लिखकर पुराना काम मिटने से बचाएँ, अधूरी बातें सुरक्षित रखें और जुड़े संदर्भ अपडेट करें। केवल स्थायी प्रवेश-बिंदु बनाए रखने के लिए खाली योजना-टेम्पलेट न बनाएँ।
5. टेस्ट और कोड का संबंध: एक-से-एक नहीं, ज़रूरत के मुताबिक कई-से-कई
«एक कोड फ़ाइल के लिए ठीक एक टेस्ट फ़ाइल» का नियम उपयोगी नहीं है। एक टेस्ट कई घटकों को जाँच सकता है और एक घटक के लिए यूनिट, प्रॉपर्टी और इंटीग्रेशन रिग्रेशन टेस्ट—तीनों ज़रूरी हो सकते हैं।
शुरुआत के लिए:
tests/के भीतर टेस्ट को मॉड्यूल या ज़िम्मेदारी के आधार पर व्यवस्थित करें।- संबंधित स्पेक में मुख्य अपरिवर्तनीय शर्तें, टेस्ट चलाने के रास्ते और सीमित दायरे वाले सत्यापन कमांड लिखें।
- केवल तब प्रस्तावित
टेस्ट मैप फ़ाइलजोड़ें जब रास्तों का संबंध ढूँढ़ना वास्तव में मुश्किल हो।
मैप में केवल ज़रूरी संबंध रखें: मॉड्यूल या अनुबंध की पहचान, स्रोत कोड का दायरा, टेस्ट का दायरा और जाँच चलाने का तरीका। पूरी डायरेक्टरी संरचना की नकल न करें और टेस्ट पास होने की स्थिति की दूसरी, हाथ से रखी जाने वाली सूची न बनाएँ।
मैप के रखरखाव का मतलब है कि उसमें दिए रास्ते और कमांड काम करते रहें। मैप का मौजूद होना अपने-आप पर्याप्त कवरेज या सफल टेस्ट साबित नहीं करता।
6. अस्थायी सामग्री साफ़ करें, लेकिन भरोसे का फैसला फ़ोल्डर देखकर न करें
एक बार के ड्राफ़्ट, अस्थायी स्क्रिप्ट और खोज-रिपोर्ट को .scratch/ में रखना सुविधाजनक है। लेकिन यह कहना ठीक नहीं कि वहाँ मौजूद सामग्री कभी प्राथमिक स्रोत नहीं हो सकती या उसे कभी भी पूरा मिटाया जा सकता है।
- मॉडल से बना शोध-सारांश द्वितीयक व्याख्या है; उसे अपने-आप तथ्य न मानें।
- असली टेस्ट आउटपुट या निदान रिकॉर्ड अस्थायी फ़ोल्डर में होने पर भी प्राथमिक सबूत हो सकता है। उसकी विश्वसनीयता स्रोत, वातावरण, समय और रिकॉर्ड की पूर्णता पर निर्भर करती है।
- अगर कोई योजना, निर्णय या स्वीकृति उस सामग्री को उद्धृत करती है और वह उसका इकलौता सबूत है, तो उसे मनमाने ढंग से न मिटाएँ। पहले ज़रूरी मूल रिकॉर्ड सुरक्षित करें या उस पर निर्भर निष्कर्ष स्पष्ट रूप से वापस लें।
- अहम निष्कर्ष सहेजते समय सबूत कहाँ से आया, उसका दायरा क्या है और क्या अज्ञात है—यह भी रखें। सार छोटा करने से अनुमान तथ्य नहीं बन जाता।
docs/ की पुरानी रिपोर्ट और वास्तु-चित्रों को भी केवल पुराना होने के कारण कचरा न मानें। उन्हें इन श्रेणियों में अलग करना उपयोगी है: मौजूदा रखरखाव दस्तावेज़, स्पष्ट रूप से ऐतिहासिक सामग्री और अभी जाँच बाकी सामग्री।
- मौजूदा दस्तावेज़ में उसकी लागू सीमा लिखें और संबंधित अनुबंध बदलने पर उसकी समीक्षा करें।
- पुराने चित्र या प्रस्ताव को ऐतिहासिक, पुराना या बदला हुआ चिह्नित करें; उसे मौजूदा आधार न मानें।
- जिस प्रक्रिया-सामग्री का आगे कोई उपयोग या संदर्भ नहीं है, उसे अनुमति मिलने पर अस्थायी फ़ोल्डर में ले जाएँ या हटाएँ।
रिकॉर्ड को सहेजकर रखना और हर बार उसे लोड करना अलग बातें हैं। ज़रूरी इतिहास बचाए रखें, लेकिन हर काम में पूरा इतिहास न पढ़ें। संदर्भ का अनावश्यक बोझ घटाने के लिए पहले लक्षित पढ़ाई और दस्तावेज़ की मौजूदा स्थिति का स्पष्ट संकेत इस्तेमाल करें—सबूत मिटाना पहला उपाय नहीं होना चाहिए।
नतीजा
यह संरचना अपनाई जा सकती है, बशर्ते चार सीमाएँ साफ़ रहें: टेस्ट केंद्रीकृत हों लेकिन भाषा-विशेष अपवाद बचें; स्पेक मौजूदा अनुबंध बताए, सभी ADR का सार न बने; फ़्रीज़ योजना को पूरा घोषित न करे; और अस्थायी फ़ाइलें साफ़ करते समय इकलौता ज़रूरी सबूत न मिटे।
मौजूदा डिफ़ॉल्ट योजना-पथ और अनुमत रास्ते तथा विश्लेषण मोड के संपादन-क्षेत्र अभी पुरानी संरचना से जुड़े हैं। आगे माइग्रेशन करना हो तो नियम, टेम्पलेट, संदर्भ, वैलिडेशन और होस्ट-अनुकूलन सभी साथ अपडेट करने होंगे; केवल फ़ोल्डर का नाम बदलना पर्याप्त नहीं। इस समीक्षा में कोई फ़ाइल लिखी, स्थानांतरित, फ़्रीज़ या साफ़ नहीं की गई है।
Studio Global AI
अपना शोध जारी रखें
इस पृष्ठ में एक स्रोत-समर्थित उत्तर शामिल है जिसे आप Studio Global के अंदर जारी रख सकते हैं।
लोग पूछते भी हैं
"टेस्ट, नियम और योजनाएँ: प्रोजेक्ट फ़ाइलों को व्यवस्थित करने के छह व्यावहारिक सिद्धांत" का संक्षिप्त उत्तर क्या है?
टेस्ट को केंद्रीकृत रखना अच्छा डिफ़ॉल्ट है, लेकिन Go में पैकेज के निजी हिस्सों की जाँच के लिए कुछ टेस्ट उसी पैकेज में रखने पड़ सकते हैं।
सबसे पहले सत्यापित करने योग्य मुख्य बिंदु क्या हैं?
टेस्ट को केंद्रीकृत रखना अच्छा डिफ़ॉल्ट है, लेकिन Go में पैकेज के निजी हिस्सों की जाँच के लिए कुछ टेस्ट उसी पैकेज में रखने पड़ सकते हैं। प्रोजेक्ट स्पेक मौजूदा अपेक्षाएँ बताता है, ADR किसी अहम फ़ैसले का कारण दर्ज करता है और टेस्ट जाँचने का तरीका देता है—इनकी भूमिकाएँ अलग हैं।
मुझे अभ्यास में आगे क्या करना चाहिए?
योजना को फ़्रीज़ करना उसे पूरा मानकर संग्रहित करना नहीं है; अधूरे काम और उसे फिर शुरू करने की शर्तें सुरक्षित रखें।