Definition of done: एजेंट संदर्भ पैकेज
एक AI कोडिंग एजेंट को वे तथ्य, नियम, सीमाएं, और उदाहरण प्रदान करता है जो definition of done को लगातार लागू करने के लिए आवश्यक हैं। यह अपनाने की सीमाओं और प्रेक्षित विफलता साक्ष्य को ठीक करता है जबकि पर्यावरण-विशिष्ट सीमाओं को कॉन्फ़िगर करने योग्य बनाए रखता है।
पैकेज स्थिति: मानव समीक्षा के लिए संदर्भ संदर्भ तैयार। अनुबंध और परीक्षण परिदृश्य पूर्ण हैं, लेकिन कोई दावा नहीं किया गया है कि कोई अपनाने वाली कार्यान्वयन ने उन्हें पारित किया है।
निर्णय
Definition of done के लिए, पथ और कार्य द्वारा सीमित संस्करण-नियंत्रित रिपॉजिटरी निर्देशों को अपनाएं। व्यवहार को एक अधिकारिक लेखन पथ, टाइप किए गए इंटरफेस, स्पष्ट स्थिति, और idempotent साइड-इफेक्ट हैंडलिंग के माध्यम से लागू करें। यह पैकेज एक संदर्भ अनुबंध है: अपनाने वाली टीम को अपने पर्यावरण में साक्ष्य से संख्यात्मक सीमाएं, प्रदाता, अधिकार क्षेत्र, और परिचालन मालिक चुनने होंगे।
दायरा
- Definition of done के अभिनेता, इनपुट, आउटपुट, स्थितियां, नीति या स्कीमा संस्करण, और इस कार्यान्वयन ब्लॉक द्वारा वर्णित बाहरी रूप से दिखाई देने वाले परिणाम।
- प्राथमिक और वैकल्पिक इंटरफेस, पृष्ठभूमि कार्य, कैश, एकीकरण, समर्थन पथ, और साक्ष्य जो समान सीमा का परीक्षण कर सकते हैं।
- संदर्भ को सुरक्षित रूप से लागू करने के लिए आवश्यक अपनाने-विशिष्ट कॉन्फ़िगरेशन, रोलआउट, पुनर्प्राप्ति, और सत्यापन जिम्मेदारियां।
इस ब्लॉक के बाहर
- हर अपनाने वाले के लिए एक सार्वभौमिक विक्रेता, फ्रेमवर्क, अधिकार क्षेत्र, संख्यात्मक सीमा, प्रतिधारण अवधि, या सेवा-स्तर उद्देश्य चुनना।
- यह दावा करना कि पैकेज किए गए परिदृश्य ने डाउनस्ट्रीम कार्यान्वयन के खिलाफ चलाए गए हैं या यह संदर्भ कानूनी, सुरक्षा, या पहुंच प्रमाणन प्रदान करता है।
अनुबंध
- निर्देश प्राथमिकता, लागू पथ, आवश्यक जांच, निषिद्ध परिवर्तन, और हैंडऑफ़ में अपेक्षित साक्ष्य घोषित करें।
- कमांड, संस्करण, वास्तुकला, और फ़ाइल स्थान रिपॉजिटरी स्रोतों से निकालें न कि मेमोरी या पड़ोसी परियोजना से।
- निष्पादन योग्य सत्यापन को गद्य दावों से अलग रखें और रिकॉर्ड करें जब कोई जांच नहीं चलाई गई हो या पूरी नहीं हो सकी हो।
- एजेंट से अपेक्षा करें कि वह असंबंधित परिवर्तनों को संरक्षित करे और जब क्रेडेंशियल्स, विनाशकारी सीमा, या उत्पाद प्राधिकरण गायब हो तो रुक जाए।
- सीमा पर इनपुट को एक बार मान्य करें और डाउनस्ट्रीम लॉजिक द्वारा उपयोग किए जाने वाले सामान्यीकृत प्रतिनिधित्व को संरक्षित करें।
- व्यवसाय संक्रमण को आउटबॉक्स रिकॉर्ड के साथ पहले या परमाणु रूप से स्थायी करें; उपभोक्ता टिकाऊ ऑपरेशन पहचान द्वारा डुप्लिकेट हटाते हैं।
- लागू व्यवहार, समीक्षा किया गया कोड, प्रासंगिक परीक्षण पास, अद्यतन स्कीमा और दस्तावेज़ीकरण, सुरक्षा और पहुंच जांच, अवलोकनीयता, रोलआउट, रोलबैक, और स्वामित्व साक्ष्य की आवश्यकता।
- निष्पादित नहीं हुए, अनिर्णायक, माफ किए गए, और अवरुद्ध जांचों को ईमानदारी से प्रस्तुत करें; मर्ज, तैनाती, या स्थिति परिवर्तन अकेले पूर्णता को संतुष्ट नहीं कर सकते जब डाउनस्ट्रीम तत्परता अनसुलझी हो।
कार्यान्वयन मार्गदर्शन
- पहले अतिरिक्त संग्रहण और इंटरफेस परिवर्तन भेजें, प्रेक्षित रूप से बैकफिल करें, फिर संगतता साक्ष्य के बाद पुराने पथों को सेवानिवृत्त करें।
- Definition of done के इनपुट, आउटपुट, अभिनेता, स्थितियां, अपरिवर्तनीयताएं, साइड इफेक्ट, और साक्ष्य को मॉडल करें इससे पहले कि फ्रेमवर्क या विक्रेता विवरण चुने जाएं।
- लागू Definition of done अनुबंध या नीति संस्करण को भौतिक स्थिति के साथ संग्रहित करें ताकि माइग्रेशन, पुनःप्रसारण, और समर्थन निर्णय जिम्मेदार बने रहें।
- नियंत्रित रोलआउट के पीछे पथ पेश करें, अपेक्षित और प्रेक्षित परिणामों की तुलना करें, और अपनाने के साक्ष्य पूर्ण होने तक एक परीक्षण किया गया पुनर्प्राप्ति मार्ग रखें।
विफलता हैंडलिंग और सुरक्षा उपाय
- विरोधाभासी या पुराना संदर्भ एक अवरोधक के रूप में सामने आता है जिसमें सटीक स्रोत होते हैं; एजेंट ऐसा टाई-ब्रेकर नहीं बनाता जो परियोजना व्यवहार को बदलता हो।
- अमान्य या विरोधाभासी Definition of done स्थिति अस्वीकार या क्वारंटीन की जाती है; कार्यान्वयन कभी भी ऐसा मान अनुमानित नहीं करता जो प्राधिकरण बढ़ाए या प्रभाव को दोहराए।
- पुनः प्रयास सीमित होते हैं और टिकाऊ पहचान का उपयोग करते हैं; समाप्ति के बाद, कार्य निरीक्षण योग्य अंतिम स्थिति तक पहुंचता है जिसमें जिम्मेदार मालिक होता है।
सत्यापन और संचालन
- स्थायित्व से पहले और बाद में निर्भरता विफलता इंजेक्ट करें और साबित करें कि पुनः प्रयास एक बाहरी रूप से दिखाई देने वाले परिणाम पर संकेंद्रित होता है।
- Definition of done सफलता, अस्वीकृति, सत्यापन विफलता, निर्भरता विफलता, पुनः प्रयास समाप्ति, और पुनर्प्राप्ति की निगरानी अनुबंध संस्करण द्वारा करें बिना संवेदनशील पेलोड आयामों के।
- नीति, स्कीमा, निर्भरता, माइग्रेशन, या सीमा परिवर्तनों के बाद युग्मित सकारात्मक और नकारात्मक फिक्स्चर को पुनः चलाएं और परिणामी साक्ष्य संरक्षित करें।
अपनाने की धारणाएं
- उदाहरण में नाम और मान एक ठोस फिक्स्चर हैं, सार्वभौमिक डिफ़ॉल्ट नहीं; अपनाने वाले उन्हें प्रलेखित साक्ष्य और स्वामित्व के माध्यम से बदलते हैं।
- अपनाने वाली प्रणाली प्रमाणीकृत पहचान, टिकाऊ ऑपरेशन या रिकॉर्ड संस्करण, सीमित टेलीमेट्री, और परिवर्तन के लिए नियंत्रित पथ प्रदान कर सकती है।
इस पैकेज में निष्पादन-समान उदाहरण फिक्स्चर और स्वीकृति अनुबंध हैं। संरचना और मेटाडेटा जांचने के लिए संग्रह सत्यापक चलाएं, फिर लक्षित रिपॉजिटरी में परिदृश्यों का अनुवाद और निष्पादन करें और कार्यान्वयन साक्ष्य रिकॉर्ड करें।