Claude के साथ परियोजना कार्यान्वयन और रखरखाव को स्वचालित करके वास्तुशिल्प त्रुटियों से बचें।

Claude Code, एमसीपी और AI Agent Skills को कवर करने वाली श्रृंखला के Claude Code Part 6 में, लेखक वर्णन करता है कि उसने क्लाउड से वास्तुशिल्प प्रस्तावों में क्या बदलने के लिए कहा था, जिन समीक्षा प्रश्नों ने मदद की थी, और वह कौन सा सबक चाहता था कि एजेंट बाद के सत्रों में ले जाए। लेख Andrej Karpathy के बिंदु का अनुसरण करता है जो वाइब कोडिंग फेंकने वाले सप्ताहांत परियोजनाओं के लिए बहुत बुरा नहीं है, लेकिन तर्क देता है कि बड़ी प्रणालियों को अधिक संदर्भ, निरीक्षण और चुनौती की आवश्यकता होती है।

लेखक एक परियोजना के बारे में संपीड़ित ज्ञान के लिए संकेत और समर्थन संसाधनों की तुलना करता है। यदि कोई एप्लिकेशन कैप्चर किए गए मूल विनिर्देश से अधिक प्रोजेक्ट-विशिष्ट जानकारियों को समाप्त कर देता है, तो प्रक्रिया हानिकारक संपीड़न की तरह व्यवहार करती है। व्यावहारिक परिणाम यह है कि एजेंट द्वारा उत्पादित कोड को अभी भी एक इंजीनियरिंग निर्णय के रूप में इलाज करने की आवश्यकता होती है, न कि तैयार उत्तर के तौर पर।

एक डुप्लिकेट चेकसम ने लापता आर्किटेक्चर जाँच को उजागर किया

एक उदाहरण में Claude Code के साथ ओपस 5.5 प्रोफ़ाइल पृष्ठों पर चेकसम के लिए एक तंत्र का निर्माण करना शामिल था। नियत अद्यतन प्रोफाइल सामग्री बदलते समय updated_at तिथि को बदलने के लिए था, ताकि Google अनुक्रमण के दौरान परिवर्तनों का अधिक कुशलता से पता लगा सके। क्लाउड ने प्रत्येक प्रोफ़ਾਈਲ के लिए फिंगरप्रिंट प्रस्तावित किया, प्रसंस्करण के बाद चयनित फ़ील्ड और संबंधित पंक्तियों को इकट्ठा करना, उन्हें हैश करना और परिणाम की तुलना पिछले मूल्य से करना.

डिजाइन अपने आप में उचित लग रहा था, लेकिन इसने परियोजना की पहले से मौजूद क्षमता को दोहराया। प्रसंस्करण-सूचना तालिकाओं ने पहले से ही परिवर्तित इनपुट को पहचानने और बार-बार काम करने से बचने के लिए मर्ज पाइपलाइन द्वारा उपयोग किए जाने वाले चेकसम संग्रहीत किए थे। क्लाउड ने डुप्लीकेशन को चिह्नित नहीं किया या नए कैलकुलेटर वर्गों, अतिरिक्त प्रश्नों और एक अन्य फ़ील्ड सूची को परिभाषित करने से पहले एक वास्तुशिल्प निर्णय के लिए पूछा कि परिवर्तन का क्या मतलब है।

जब लेखक ने एजेंट को मौजूदा चेकसम फ़ील्ड की ओर पुनर्निर्देशित किया, तो कार्यान्वयन बदल गया। प्रोफ़ाइल के अधिकांश भाग को फिर से पढ़ने और हैश करने के बजाय, दिनांक अद्यतन प्रासंगिक मौजूदा चेक्सम मानों का संयोजन कर सकता था। डुप्लिकेट फील्ड सूचियों और अतिरिक्त क्वेरी हटा दी गई थीं। यह एपिसोड एक दोहराए गए समीक्षा प्रश्न को दर्शाता हैः तंत्र जोड़ने से पहले, एजेंट ने कौन सा मौजूदा तंत्र पाया होगा?

स्पष्ट शर्तों के बिना स्मृति नोट्स पर्याप्त नहीं हैं

लेखक बताते हैं कि क्लाउड एक परियोजना सीख रहा है कहने का अर्थ है निर्देशों में सुधार और बाद के सत्रों के लिए उपलब्ध नोट्स. यह मॉडल के भार को फिर से प्रशिक्षित नहीं करता है. Claude Code प्रोजेक्ट इंस्ट्रक्शंस और स्थायी मेमोरी फ़ाइलों का समर्थन करता है, और / स्मृति कमांड संग्रहीत सामग्री दिखा सकता है। वे फाइलें संदर्भ प्रदान कर सकती हैं, लेकिन वे व्यवहार को लागू नहीं करती हैं या गारंटी देती हैं कि प्रत्येक भविष्य के सत्र एक सबक लागू करेंगे।

एक मेमोरी नोट को घटक, विफलता और उस स्थिति का नाम देने की आवश्यकता है जिसने इसे उजागर किया। "सावधान रहना याद रखें" भविष्य के सत्र में कार्रवाई करने के लिए बहुत कम देता है। लेखक क्लाउड से किसी घटक के लिए प्रासंगिक मार्गदर्शन दिखाने का सुझाव देते हैं, बस जांच की गई त्रुटि के साथ इसकी तुलना करते हैं, और विफलता की स्थिति के साथ एक संक्षिप्त अद्यतन प्रस्तावित करते हैं. वह व्यक्तिगत प्राथमिकताओं को भी अलग करता है, जैसे कि छोटे स्पष्टीकरण, साझा टीम ज्ञान से, जैसे साझा पार्सर के जीवनचक्र के बारे में नियम।

स्थानीय परीक्षणों से अधिक उत्पादन भार का पता चला

लेख में स्वचालित कौशल, पुनः सत्यापन या डेवलपर द्वारा पकड़ी गई त्रुटियों को सूचीबद्ध किया गया है। एक स्वचालित उत्पादन-परीक्षण कौशल ने 3 प्रयासों पर एक असफल डाउनलोड फिर से शुरू करने की कोशिश की क्योंकि एक अन्य कोड पथ पहले ही दोहराया जा चुका था, जिससे कैप एक मिनट के भीतर समाप्त हो गया। एक फिक्स ने सही रिकॉर्ड में बाहरी आईडी स्थानांतरित कर दी थी, लेकिन दो रिकॉर्ड इससे मेल खाते थे, जिसके कारण आईडी उनके बीच उछाल आया और 2 दिनों में 1.3 हजार चेतावनियां उत्पन्न हुईं। अन्य उदाहरणों में लीक हुए प्रसंस्करण ताले के लिए अपूर्ण सुधार शामिल हैं, वन-ऑफ क्लीनअप स्क्रिप्ट जो खराब झंडे को वापस आने से नहीं रोकती थीं, और एक एकल एपोस्ट्रोफ़ द्वारा टूटी हुई कॉन्फ़िगरेशन फ़ाइल, जिसने केवल निरंतर एकीकरण को पकड़ लिया।

पुनः सत्यापन ने एक टिकट को रोक दिया, जिसने उत्पादन डेटा के साथ जांच करने के बाद 200 हजार डेटाबेस पंक्तियों को ठीक करने के लिए कहा था। एक शाखा जो नकली आंकड़ों के साथ वास्तविक उत्पादन डेटा को ओवरराइट करती थी उसे खारिज कर दिया गया था। कभी-कभी अपनी स्थिति बचाने में विफल रहने वाले स्वचालन दोहराव वाली टिप्पणियां पोस्ट किए जाने से पहले पकड़े गए थे। डेट हेल्पर जो दिन की रोशनी-बचत परिवर्तनों पर एक घंटे तक टाइमस्टैम्प स्थानांतरित करता है वह हमेशा के लिए पेजिंग लूप चला सकता था, इसलिए एक सुरक्षित संस्करण जोड़ा गया था.

कुछ मुद्दों को डेवलपर द्वारा पाया गया था। नए प्रश्न सही थे लेकिन उत्पादन डेटाबेस को अधिभारित कर दिया, जिससे क्वेरी लागत का अनुमान लगाने और एक सूचकांक का प्रस्ताव करने के लिए एक नियम सामने आया। लंबे समय तक चलने वाले कार्यकर्ता में कैश्ड मान ने एक आइटम के डेटा को अगले में लीक किया, साझा सेवाओं में प्रति-आइटम राज्य के खिलाफ एक नियम प्रेरित किया और एक परीक्षण जो एक कार्यकर्ता के माध्यम से दो वस्तुओं को चलाता है। खाली पृष्ठ पर फेंकी गई त्रुटि बाद के पाइपलाइन चरणों को छोड़ दी, इसलिए नियम समाप्त होने से पहले पूरी पाइप लाइन पढ़ने के लिए बन गया। एक वास्तविक व्यक्ति का संरक्षित नाम कमिट, टेस्ट और प्रलेखन पृष्ठ में दिखाई दिया, जिसमें इतिहास फिर से लिखना और केवल काल्पनिक-नाम नियम की आवश्यकता थी।

लेखक यह भी नोट करता है कि PHP_INT_MAX एक डिफ़ॉल्ट ऊपरी सीमा के रूप में सुविधाजनक लग सकता है, लेकिन पीएचपी में एक वैध मूल्य डेटाबेस पैरामीटर की इच्छित रेंज से अधिक हो सकता है। क्वेरी कैसे बांधती है या इसे डालता है इस पर निर्भर करता है। माइग्रेशन उदाहरण कम अस्पष्ट था: पोस्टग्रीएसक्यूएल सिंटैक्स ने WHERE से पहले TABLESPACE रखा है। लेख कहता है कि डेवलपर्स ने पहले ही गलती कर दी थी और उपयुक्त परीक्षण वातावरण में माइग्रेसन को निष्पादित करना मेमोरी नोट की तुलना में मजबूत सबूत है।

टेकअवे एक बेहतर समीक्षा प्रश्न है

उदाहरणों में, अधिकांश समस्याओं ने स्थानीय परीक्षण पास किए और केवल उत्पादन डेटा या लोड के साथ दिखाई दिए। दैनिक उत्पादन-परीक्षण कौशल और कोडिंग से पहले वास्तविक डेटा की जांच करना सबसे अधिक पकड़ा गया। लेखक में दो छोटे पायथन अभ्यास शामिल हैं ताकि वास्तविक पीएचपी और पोस्टग्रेएसक्यूएल एप्लिकेशन को उजागर किए बिना विफलता पैटर्न को अलग किया जा सके, जबकि यह ध्यान दिया जाए कि उत्पादन कोड स्वयं निर्यात नहीं होता है। पाठकों को प्रत्येक चेक स्थापित करने के बाद अपनी भाषा और टेस्ट फ्रेमवर्क में चेक्स को अनुकूलित करने के लिए प्रोत्साहित किया जाता है।

वास्तविक परियोजनाओं में एजेंटों का उपयोग करने वाली टीमों के लिए, लेख का मूल्य दुर्लभ बग की सूची नहीं है। यह एक अनुस्मारक है कि एजेंट-उत्पादित कोड को अभी भी मानव कोड के समान वास्तुशिल्प जांच की आवश्यकता होती है। उपयोगी प्रश्न यह नहीं है कि क्या कोई प्रस्ताव अलग से उचित लगता है, लेकिन क्या यह मौजूदा तंत्र को दोहराता है, साझा स्थिति को सुरक्षित रूप से संरक्षित करता है, उत्पादन भार जीवित रहता है, और अगले सत्र के सत्यापन के लिए पर्याप्त सटीक सबक रिकॉर्ड करता है।

SEO मेटाडाटा

मेटा विवरणः Claude Code Part 6 विवरण कैसे एमसीपी और AI एजेंट कौशल वास्तुशिल्प त्रुटियों को उजागर करते हैं, डुप्लिकेट चेकसम से लेकर उत्पादन-केवल बग्स और स्मृति नोट तक

टैगः Claude Code, AI एजेंट कौशल, एमसीपी, सॉफ्टवेयर आर्किटेक्चर, डेवलपर वर्कफ़्लो

विशेष रुप से प्रदर्शित छवि: कोड ब्लॉकों का अमूर्त मैत्रीपूर्ण चित्रण, एक मेमोरी फ़ाइल और डेटाबेस स्कीमा, कोई वास्तविक लोग नहीं, कोई लोगो, कोई पाठ