उत्तरप्रकाशित14 स्रोत
AI एजेंट के दस्तावेज़ व्यवस्थित करें—बिना हर प्रोजेक्ट पर एक जैसा ढाँचा थोपे
फ़ोल्डरों के नाम से ज़्यादा अहम है यह तय करना कि किस जानकारी का आधिकारिक स्रोत क्या है और कौन उसे अपडेट कर सकता है। पुरानी योजना को मिटाने के बजाय उसे सामान्य दृश्य से हटाएँ, लेकिन उसकी स्थिति और काम के प्रमाण सुरक्षित रखें। AGENTS.md जैसे निर्देशों की पहचान हर टूल में एक जैसी नहीं होती; अलग अलग एजेंट के लिए लोडिंग...
प्रकाशितकर्ताGPT Image 2 से चित्र बनाए गए
शोध उत्तर
मुख्य निष्कर्ष
- फ़ोल्डरों के नाम से ज़्यादा अहम है यह तय करना कि किस जानकारी का आधिकारिक स्रोत क्या है और कौन उसे अपडेट कर सकता है।
- पुरानी योजना को मिटाने के बजाय उसे सामान्य दृश्य से हटाएँ, लेकिन उसकी स्थिति और काम के प्रमाण सुरक्षित रखें।
- AGENTS.md जैसे निर्देशों की पहचान हर टूल में एक जैसी नहीं होती; अलग अलग एजेंट के लिए लोडिंग की जाँच ज़रूरी है।
- स्थायी नियम संक्षिप्त रखें, पर काम की योजना और सत्यापन साक्ष्य को ज़रूरत के अनुसार विस्तार दें।
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/r4PONBDeiygm6rkyQ1INhTEQyyP2/images/C7AB80FC077AFBDCC74B/E16B680C3CF0FB35FFC8.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":"建议统一“信息职责、权威来源、生命周期和读取契约”，而不是强制所有项目采用同一套目录。BMAD 的任务治理与蓝图的知识分层可以结合，但计划保留、跨宿主加载、测试隔离和文档预算必须分别定义，不能由目录名称代替。\n\n 保留蓝图的职责分离，调整其绝对化规则。\n 借鉴 BMAD 的稳定身份、渐进细化、来源追溯和历史. Topic tags: general web, ai safety, openai, chatgpt, llm. 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
AI एजेंट के लिए दस्तावेज़ों का ढाँचा बनाते समय सबसे आसान रास्ता अक्सर एक तयशुदा फ़ोल्डर-संरचना अपनाना लगता है। लेकिन टीम के काम करने का तरीका, एजेंट चलाने वाला टूल और प्रोजेक्ट का आकार अलग-अलग हो सकता है। इसलिए बेहतर सवाल यह है: किस जानकारी का आधिकारिक स्रोत क्या है, उसे कौन बदलेगा और उसे कब पढ़ना चाहिए?
BMAD जैसे कार्यप्रवाह और प्रोजेक्ट-स्तरीय ज्ञान-ढाँचे को साथ रखा जा सकता है—बशर्ते योजनाओं, नियमों, मौजूदा स्थिति और परीक्षण-प्रमाण की भूमिकाएँ साफ़ हों।
फ़ोल्डर से पहले तय करें कि जानकारी किस काम की है
एजेंट के लिए रखी सामग्री आम तौर पर अलग-अलग ज़िम्मेदारियाँ निभाती है:
- नियम: काम के दौरान किन शर्तों का पालन करना है।
- तथ्य और निर्णय: क्या सत्यापित है, और किसी अहम फ़ैसले के पीछे क्या कारण था।
- योजना: कौन-सा काम करना है और उसकी प्रगति कहाँ तक पहुँची है।
- प्रमाण: किन जाँचों या परीक्षणों के आधार पर कहा जा सकता है कि काम पूरा है।
- मसौदे: खोज, चर्चा या शुरुआती विचार, जिन्हें अभी आधिकारिक निर्देश नहीं मानना चाहिए।
इन चीज़ों को एक ही फ़ाइल में रखना अपने-आप में गलत नहीं है। समस्या तब होती है जब कई जगह एक ही स्थिति या नियम को अलग-अलग ढंग से अपडेट किया जाए। हर अहम जानकारी का एक संपादन योग्य आधिकारिक स्रोत रखें। दूसरे पन्ने उस जानकारी का सार दिखा सकते हैं, लेकिन यह स्पष्ट होना चाहिए कि वह सार कहाँ से आया है और कब पुराना पड़ सकता है।
BMAD की स्थानीय सामग्री में काम को स्थिर पहचान वाले टास्क और योजनाओं से जोड़ने, विवरण को ज़रूरत पड़ने पर विस्तार देने और टीम के बदलावों को मौजूदा तरीके से अलग रखने पर ज़ोर दिखता है। इसके व्यावहारिक दस्तावेज़ों में कस्टमाइज़ेशन को डिफ़ॉल्ट सामग्री से अलग रखने और पूरे डिफ़ॉल्ट ढाँचे की नकल करने के बजाय सीमित ओवरराइड रखने की सलाह भी है।
पूरी हो चुकी योजना को मिटाना हमेशा सही नहीं
काम पूरा होने पर पुरानी योजना को सक्रिय सूची से हटाना उपयोगी हो सकता है। लेकिन उसे मिटा देने से स्थिति, शुरुआती संस्करण, लागू किए गए बदलावों और समीक्षा के निष्कर्षों का रिकॉर्ड भी खो सकता है। BMAD की स्थानीय जीवनचक्र-मार्गदर्शिका पूर्ण योजनाओं को सुरक्षित रखने की वजह यही बताती है।
इसलिए अभी दिखाई देने वाली चीज़ों को संक्षिप्त रखें, पर इतिहास का रिकॉर्ड बचाएँ। कोई पुरानी योजना सामान्य रूप से लोड न हो, फिर भी ज़रूरत पड़ने पर उसकी स्थिति और काम के प्रमाण ढूँढ़े जा सकें। नई बार शुरू हुआ एजेंट भी केवल पुराने सफल परीक्षण के आधार पर किसी नए बदलाव को पूरा घोषित न करे।
छोटे, अकेले संभाले जाने वाले प्रोजेक्ट में एक सक्रिय कार्य-दृश्य पर्याप्त हो सकता है। लेकिन टीम के कई सदस्य या समानांतर काम हों, तो उसे पूरी टीम की एकमात्र बदलती हुई योजना न बनाएँ। काम की स्थिर पहचान और हर काम की अपनी योजना इस स्थिति में अधिक स्पष्ट रहती है।
हर एजेंट में एक ही निर्देश फ़ाइल काम करेगी—यह मानकर न चलें
AGENTS.md को Codex पहचानता है, जबकि उससे जुड़ी कई योजना और कार्यप्रवाह फ़ाइलें सुझाई गई परंपराएँ हैं—टूल की अनिवार्य फ़ाइलें नहीं। इसलिए किसी दूसरे एजेंट द्वारा उन्हीं फ़ाइलों को पढ़े जाने की गारंटी नहीं माननी चाहिए। 6
व्यवहार में हर इस्तेमाल होने वाले टूल के लिए जाँचें कि कौन-सी फ़ाइल कहाँ से लोड होती है, उप-फ़ोल्डरों के नियम लागू होते हैं या नहीं, और निर्देशों में आपसी टकराव तो नहीं। प्रवेश-दस्तावेज़ में यह भी साफ़ लिखें कि कौन-सी अतिरिक्त सामग्री किस काम के लिए पढ़नी है। केवल “ज़रूरत पड़ने पर पढ़ें” कहने से ज़रूरी जानकारी तक पहुँच सुनिश्चित नहीं होती।
इसका मतलब यह नहीं कि हर एजेंट के लिए अलग ज्ञान-भंडार बनाएँ। साझा जानकारी रखी जा सकती है, लेकिन उसे पढ़ने का तरीका हर टूल के लिए अलग से सत्यापित करना पड़ सकता है।
छोटे स्थायी निर्देश, विस्तृत काम की योजना
हर बार पढ़ी जाने वाली निर्देश-फ़ाइल में कुछ प्रमुख नियम और जानकारी खोजने का रास्ता होना चाहिए; उसे परियोजना का पूरा विश्वकोश बनाने की ज़रूरत नहीं। दूसरी ओर, लंबा या जोखिमभरा काम अधिक विस्तृत योजना माँग सकता है। OpenAI के Codex उदाहरण में भी जटिल काम के लिए विस्तार से लिखी और समय के साथ अपडेट होने वाली योजनाएँ दिखाई गई हैं। 5
Geoffrey Huntley के Ralph लेख में एक लूप में एक काम पर ध्यान देने की बात है। 14 उनके मार्गदर्शक में अलग-अलग विषयों के लिए विनिर्देश और परियोजना की build/test प्रक्रिया से जुड़े व्यावहारिक निर्देश रखने का उदाहरण मिलता है।
11 इससे “छोटा काम, स्पष्ट दायरा और जाँच का रास्ता” अपनाने की सीख मिलती है—यह साबित नहीं होता कि हर प्रोजेक्ट को एक जैसी निर्देश-फ़ाइल या फ़ोल्डर-संरचना चाहिए।
निर्देशों की कोई एक सार्वभौमिक शब्द या पंक्ति-सीमा तय करने का पर्याप्त आधार यहाँ नहीं है। उसकी जगह देखें कि एजेंट वास्तव में क्या लोड करता है, क्या जानकारी बार-बार दोहराई गई है और क्या छोटा करने से किसी ज़रूरी शर्त का संदर्भ टूट जाएगा।
परीक्षण-फ़ाइल और परीक्षण का आउटपुट अलग चीज़ें हैं
टेस्ट के लिए रखी स्थिर, दोबारा इस्तेमाल की जा सकने वाली डेटा-फ़ाइलें और किसी एक रन से बने लॉग एक जैसी चीज़ें नहीं हैं। परीक्षण डेटा को सुरक्षित और दोहराने योग्य बनाए रखना उपयोगी हो सकता है; वहीं रन के आउटपुट के लिए आकार, संवेदनशीलता और कितने समय तक रखना है—इन बातों के नियम चाहिए।
इसी तरह, यूनिट, इंटीग्रेशन और एंड-टू-एंड परीक्षणों के लिए इस्तेमाल होने वाला वातावरण और उनसे होने वाले संभावित प्रभाव स्पष्ट करें। सिर्फ़ किसी फ़ाइल को test नाम वाले फ़ोल्डर में रखने से उसका व्यवहार तय नहीं हो जाता।
अपनाने लायक नियम
- जानकारी को उसके काम के आधार पर वर्गीकृत करें—सिर्फ़ यह देखकर नहीं कि उसे इंसान ने लिखा या मशीन ने।
- एक ही महत्वपूर्ण तथ्य के कई स्वतंत्र, संपादन योग्य संस्करण न बनाएँ।
- दस्तावेज़ में वे बातें प्राथमिकता से रखें जिन्हें स्रोत कोड अपने-आप नहीं बता सकता—जैसे निर्णय का कारण या बाहरी बाधा।
- प्रवेश-दस्तावेज़ को नियमों और सही सामग्री तक पहुँचने का रास्ता बनाएँ, पूरी परियोजना का विश्वकोश नहीं।
- नियम, प्रगति और पूरा होने के प्रमाण अलग-अलग पहचान में आने चाहिए।
- पुराने फ़ैसले बदले जा सकते हैं, लेकिन यह दर्ज करें कि उन्हें किस निर्णय ने और क्यों बदला।
- परीक्षण के स्रोत और किसी रन से बने आउटपुट के लिए अलग रखरखाव नियम बनाएँ।
- जहाँ जाँच को भरोसेमंद तरीके से स्वचालित किया जा सकता है, वहाँ वास्तविक टूल से जाँचें; केवल दस्तावेज़ में नियम लिख देना पर्याप्त नहीं।
- फ़ोल्डर का नाम किसी एजेंट को कमांड चलाने, नेटवर्क पर डेटा भेजने या बदलाव तैनात करने की अनुमति नहीं देता। ये अनुमतियाँ अलग से तय होनी चाहिए।
सबसे सुरक्षित शुरुआत पूरे प्रोजेक्ट की फ़ाइलें इधर-उधर करना नहीं है। पहले तय करें कि नियम, योजना, स्थिति और प्रमाण का आधिकारिक स्रोत कौन-सा होगा। फिर एजेंट के लोडिंग व्यवहार को जाँचें, एक सरल सक्रिय कार्य-दृश्य बनाएँ और वास्तविक काम के अनुभव से नियम सुधारें।
Studio Global AI
अपना शोध जारी रखें
इस पृष्ठ में एक स्रोत-समर्थित उत्तर शामिल है जिसे आप Studio Global के अंदर जारी रख सकते हैं।
लोग पूछते भी हैं
"AI एजेंट के दस्तावेज़ व्यवस्थित करें—बिना हर प्रोजेक्ट पर एक जैसा ढाँचा थोपे" का संक्षिप्त उत्तर क्या है?
फ़ोल्डरों के नाम से ज़्यादा अहम है यह तय करना कि किस जानकारी का आधिकारिक स्रोत क्या है और कौन उसे अपडेट कर सकता है।
सबसे पहले सत्यापित करने योग्य मुख्य बिंदु क्या हैं?
फ़ोल्डरों के नाम से ज़्यादा अहम है यह तय करना कि किस जानकारी का आधिकारिक स्रोत क्या है और कौन उसे अपडेट कर सकता है। पुरानी योजना को मिटाने के बजाय उसे सामान्य दृश्य से हटाएँ, लेकिन उसकी स्थिति और काम के प्रमाण सुरक्षित रखें।
मुझे अभ्यास में आगे क्या करना चाहिए?
AGENTS.md जैसे निर्देशों की पहचान हर टूल में एक जैसी नहीं होती; अलग अलग एजेंट के लिए लोडिंग की जाँच ज़रूरी है।
सूत्र
developers.openai.comdevelopers.openai.com › cookbook › examplesdevelopers.openai.com
ghuntley.comRalph Wiggum as a "software engineer" - Geoffrey Huntley
github.comhow-to-ralph-wiggum/README.md at main - GitHub