उत्तरप्रकाशित13 स्रोत
टेस्ट और दस्तावेज़ों का ढेर नहीं, सही जीवनचक्र है असली चुनौती
लंबे समय तक उपयोगी रहने वाले टेस्ट और एकबारगी जाँच को अलग रखें; दोनों को एक जैसा मानकर हटाना सही नहीं। Overalls के बारे में उपलब्ध जानकारी वर्चुअल मशीनों पर एजेंट कार्य चलाने की बात करती है, लेकिन उससे टेस्ट या दस्तावेज़ों के प्रबंधन की पुष्टि नहीं होती। हर नई फ़ाइल के लिए उसका उद्देश्य, जमा करने की ज़रूरत, डिलीवरी...
प्रकाशितकर्ताGPT Image 2 से चित्र बनाए गए
शोध उत्तर
मुख्य निष्कर्ष
- लंबे समय तक उपयोगी रहने वाले टेस्ट और एकबारगी जाँच को अलग रखें; दोनों को एक जैसा मानकर हटाना सही नहीं।
- Overalls के बारे में उपलब्ध जानकारी वर्चुअल मशीनों पर एजेंट कार्य चलाने की बात करती है, लेकिन उससे टेस्ट या दस्तावेज़ों के प्रबंधन की पुष्टि नहीं होती।
- हर नई फ़ाइल के लिए उसका उद्देश्य, जमा करने की ज़रूरत, डिलीवरी का दायरा और रखने या हटाने की शर्त तय होनी चाहिए।
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/Ct73VtXRvYVtxLOrIWogs8h8njx2/images/14A07FDFEAF32EEE32FC/0F2CDBA675F3E1798D02.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":"这两个痛点应该纳入 V4 的“产物背压”，但治理目标应是减少无价值产物、隔离临时材料、控制提交与分发，而不是取消长期测试或把所有文档合并。前面回答中的部分来源编号没有对应真实检索证据，相关归因撤回；以下仅依据本次真实检索和已经返回的仓库读取结果。\n\n 1.. Topic tags: general web, llm, agents, ai, 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 thumbna
AI एजेंटों से कोडिंग कराने पर अक्सर दो तरह की सामग्री जमा होने लगती है: एकबारगी जाँच के लिए बनाई गई टेस्ट फ़ाइलें और हर काम के साथ बढ़ते विश्लेषण, योजनाएँ व नोट्स। इसका हल सभी टेस्ट हटाना या सारे दस्तावेज़ एक बड़ी फ़ाइल में समेटना नहीं है। ज़रूरत ऐसे नियमों की है जो तय करें कि कौन-सी सामग्री स्थायी संपत्ति है और कौन-सी सिर्फ़ अस्थायी काम का हिस्सा।
Overalls से क्या सीख मिलती है—और क्या नहीं
उपलब्ध विवरण के मुताबिक, Overalls पहले loom नाम से जाना जाता था। Geoffrey Huntley के लेख में इसे अस्थायी Firecracker वर्चुअल मशीनों पर एजेंटों को कोडिंग के काम सौंपने वाले सिस्टम के रूप में बताया गया है।10 परियोजना का README इसे डेवलपमेंट मशीनों और AI एजेंटों के लिए स्व-होस्ट किया जा सकने वाला प्लेटफ़ॉर्म बताता है; उसमें हर मशीन को टिकाऊ Firecracker microVM कहा गया है।
12
इन जानकारियों से यह निष्कर्ष नहीं निकलता कि Overalls अपने-आप टेस्ट फ़ाइलें अलग करता है, दस्तावेज़ों को संक्षिप्त रखता है या काम ख़त्म होते ही रिपॉज़िटरी साफ़ कर देता है। ऐसे खास दावों की पुष्टि के लिए पर्याप्त साक्ष्य उपलब्ध नहीं हैं। वर्चुअल मशीनों में काम अलग रखना और किसी प्रोजेक्ट की टेस्ट, Git कमिट या दस्तावेज़ नीति तय करना—ये अलग समस्याएँ हैं।
V4 में नियम हैं, पर सामग्री का जीवनचक्र अधूरा है
रिपॉज़िटरी की मौजूदा व्यवस्था में कुछ उपयोगी आधार पहले से हैं:
.github/workflows/ci.ymlमें कॉन्ट्रैक्ट टेस्ट और बाद के चरणों में एसेट सुरक्षा तथा डिलीवरी से जुड़े रीग्रेशन टेस्ट शामिल हैं। इसलिए टेस्ट फ़ाइलें हटाने से पहले देखना होगा कि वे किस मौजूदा जाँच का हिस्सा हैं। CI में कोई जाँच कॉन्फ़िगर होना इस बात का प्रमाण नहीं कि वह अभी सफलतापूर्वक चली भी है।bmad-core.mdविश्लेषण, ADR यानी तकनीकी निर्णयों के रिकॉर्ड, योजनाओं, विनिर्देशों और तथ्य-आधार के बीच भूमिका का फ़र्क बताता है।.gitignoreकुछ रनटाइम डायरेक्टरी, सैंडबॉक्स और अस्थायी फ़ाइलों को अनदेखा करता है, लेकिन मसौदों और जाँच के सबूतों को कब रखना है—यह पूरी नीति नहीं बताता।collect_source()सूट के स्रोत में मौजूद सामान्य फ़ाइलों को ढूँढ़कर प्लगइन डायरेक्टरी में रखता है। इससे यह जोखिम बनता है कि स्रोत में गलती से रखी गई अस्थायी सामग्री डिलीवरी में चली जाए; हालांकि ऐसा पहले हो चुका है, इसका प्रमाण नहीं है।
इसलिए V4 के लिए प्राथमिकता नई डायरेक्टरी संरचना खड़ी करना नहीं, बल्कि हर सामग्री का जीवनचक्र स्पष्ट करना होनी चाहिए: क्या इसे बनाना ज़रूरी है, कहाँ रखा जाए, क्या इसे कमिट या डिलीवर करना है, और इसे कब तक सहेजना है।
अस्थायी जाँच अलग रखें, उपयोगी टेस्ट बचाएँ
“बहुत सारी टेस्ट फ़ाइलें” और “सोर्स कोड बिखरा हुआ दिखना”—दोनों एक ही शिकायत नहीं हैं। किसी फ़ाइल को सिर्फ़ इसलिए हटाना ठीक नहीं कि उसके नाम में test है।
| सामग्री | उपयुक्त जगह | कमिट और डिलीवरी का सामान्य नियम |
|---|---|---|
| लंबे समय तक काम आने वाले यूनिट, रीग्रेशन और कॉन्ट्रैक्ट टेस्ट | प्रोजेक्ट की मौजूदा टेस्ट संरचना | आम तौर पर वर्ज़न कंट्रोल में; डिलीवरी में शामिल करना उपयोग पर निर्भर |
| एकबारगी निदान या अस्थायी जाँच स्क्रिप्ट | काम के लिए स्वीकृत अस्थायी क्षेत्र | सामान्यतः कमिट या डिलीवर न करें |
| लॉग, कवरेज डेटा और बनाई गई रिपोर्ट | रनटाइम या सत्यापन-साक्ष्य क्षेत्र | ज़रूरत और तय अवधि के अनुसार रखें; इन्हें अपने-आप सोर्स इतिहास में न जोड़ें |
| उपयोगी बग-उदाहरण और दोबारा चलाए जा सकने वाले टेस्ट डेटा | समीक्षा के बाद स्थायी टेस्ट सामग्री | रीग्रेशन में मदद मिले तो सुरक्षित रखें |
फ़ाइल बनाने से पहले जाँचें कि क्या मौजूदा टेस्ट बढ़ाकर वही काम हो सकता है। कमिट से पहले तय करें कि फ़ाइल लंबे समय की इंजीनियरिंग संपत्ति है या सिर्फ़ स्थानीय जाँच का हिस्सा। और डिलीवरी से पहले पूछें कि क्या यह सामग्री सचमुच उपयोगकर्ता को दिए जाने वाले पैकेज का हिस्सा होनी चाहिए।
टेस्ट की जगह बदलने से पहले भाषा के नियम भी समझने होंगे। Go की दस्तावेज़ीकरण में पैकेज के भीतर और पैकेज के बाहर रखी टेस्ट फ़ाइलों के बीच स्पष्ट अंतर है।13 इसलिए हर भाषा पर एक ही डायरेक्टरी नियम लागू करना उचित नहीं होगा। Python में अलग टेस्ट डायरेक्टरी पर विचार किया जा सकता है; Go में पैकेज की पहुँच, टेस्ट खोजने के तरीके और कॉल संबंध जाँचने के बाद ही बदलाव होना चाहिए।
यह भी स्पष्ट करें कि परेशानी कहाँ है: अगर इंस्टॉलर में टेस्ट नहीं चाहिए, तो डिलीवरी का दायरा बदलना होगा। अगर रिपॉज़िटरी में अस्थायी फ़ाइलें नहीं चाहिए, तो कमिट नीति बदलनी होगी। अगर कोड देखते समय फ़ाइलें ध्यान भटकाती हैं, तो लेआउट या देखने का तरीका बदलना होगा। ये तीन अलग लक्ष्य हैं।
दस्तावेज़ों को भूमिका के हिसाब से रखें
हर बातचीत या एजेंट रन के बाद नया दस्तावेज़ बनाना ज़रूरी नहीं। मौजूदा ढाँचे को इस तरह इस्तेमाल किया जा सकता है:
- सत्र का विश्लेषण: जब तक उसे दोबारा काम आने वाले संदर्भ के रूप में सहेजने की मंज़ूरी न हो, उसे सत्र का हिस्सा रहने दें।
analysis/: मंज़ूर किए गए विश्लेषण, साक्ष्य, तुलना और अनिश्चितताओं के लिए—रोज़मर्रा के मसौदों का ढेर बनाने के लिए नहीं।adrs/: महत्वपूर्ण तकनीकी फैसलों और उनके कारणों के लिए; पूरी शोध रिपोर्ट या काम की क्रमवार डायरी की नकल यहाँ न रखें।pending_implementation_plan.md: लक्ष्य, अनुमति, चरण, निर्भरताएँ और स्वीकृति की शर्तें दर्ज करने के लिए। इसे हर गतिविधि के लॉग में न बदलें; मौजूदा सक्रिय योजना को बिना अनुमति न बदलें।scratch/: एक साझा अस्थायी क्षेत्र बनाने पर विचार किया जा सकता है, लेकिन उसका होना अपने-आप फ़ाइलें बनाने, मिटाने या कोई काम चलाने की अनुमति नहीं देता।verification/: ज़रूरी मूल जाँच-साक्ष्य के लिए; क्या कमिट होगा और कितने समय रखा जाएगा, यह अलग से तय करें।
दस्तावेज़ों को बातचीत के हर दौर के हिसाब से नहीं, अलग विषय या फैसले के हिसाब से बाँटें। विश्लेषण, निर्णय और योजना अपनी-अपनी भूमिका निभाएँ और जहाँ ज़रूरी हो एक-दूसरे का संदर्भ दें—पूरी सामग्री बार-बार कॉपी न करें। पुराने संदर्भों का सार बनाते समय तथ्य, अनुमान और बाकी जाँच को अलग रखें; संक्षेप के नाम पर किसी अनुमान को तथ्य न बना दें।
कम फ़ाइलें होने से AI एजेंट ज़्यादा गलतियाँ करते हैं—यह अभी एक जाँचने योग्य अनुमान है, स्थापित कारण-परिणाम नहीं। इसलिए बिना प्रमाण कोई तय पन्ना-सीमा या प्रभाव का वादा करने के बजाय पहले दोहराव, पुरानी सामग्री और काम से असंबंधित संदर्भ घटाएँ।
V4 के लिए व्यावहारिक नियम
हर नई सामग्री के साथ पाँच बातें साफ़ होनी चाहिए: उसका उद्देश्य क्या है, उसे कहाँ रखना है, क्या उसे स्थायी रूप से सहेजना है, क्या उसे कमिट या डिलीवर करना है, और उसे कब रखना या हटाना है। जहाँ संभव हो, पहले से मौजूद टेस्ट या दस्तावेज़ का विस्तार करें; हर जाँच के लिए नई फ़ाइल और हर विश्लेषण के लिए नया दस्तावेज़ अनिवार्य न करें।
किसी बदलाव को लागू करने से पहले सुनिश्चित करें कि CI के ज़रूरी टेस्ट अब भी खोजे और चलाए जा सकें, काम के रीग्रेशन उदाहरण न खोएँ, अस्थायी फ़ाइलें अनावश्यक कमिट या डिलीवरी में न जाएँ, और दस्तावेज़ों के लिंक तथा सक्रिय योजनाएँ सुरक्षित रहें। इस सामग्री में वर्णित समीक्षा केवल पढ़ने और सुझाव देने तक सीमित है—इसमें फ़ाइलें बदलने, टेस्ट चलाने, सामग्री साफ़ करने या योजना पर लिखने की पुष्टि नहीं है।
Studio Global AI
अपना शोध जारी रखें
इस पृष्ठ में एक स्रोत-समर्थित उत्तर शामिल है जिसे आप Studio Global के अंदर जारी रख सकते हैं।
लोग पूछते भी हैं
"टेस्ट और दस्तावेज़ों का ढेर नहीं, सही जीवनचक्र है असली चुनौती" का संक्षिप्त उत्तर क्या है?
लंबे समय तक उपयोगी रहने वाले टेस्ट और एकबारगी जाँच को अलग रखें; दोनों को एक जैसा मानकर हटाना सही नहीं।
सबसे पहले सत्यापित करने योग्य मुख्य बिंदु क्या हैं?
लंबे समय तक उपयोगी रहने वाले टेस्ट और एकबारगी जाँच को अलग रखें; दोनों को एक जैसा मानकर हटाना सही नहीं। Overalls के बारे में उपलब्ध जानकारी वर्चुअल मशीनों पर एजेंट कार्य चलाने की बात करती है, लेकिन उससे टेस्ट या दस्तावेज़ों के प्रबंधन की पुष्टि नहीं होती।
मुझे अभ्यास में आगे क्या करना चाहिए?
हर नई फ़ाइल के लिए उसका उद्देश्य, जमा करने की ज़रूरत, डिलीवरी का दायरा और रखने या हटाने की शर्त तय होनी चाहिए।