परिचय: लंबी अवधि की कोडिंग के लिए नया प्लेबुक
यदि आपने कभी दर्जनों फाइलों में एक व्यापक रिफैक्टर को समन्वित करने की कोशिश की है, तो आप जानते हैं कि यह कितना मुश्किल है: अधूरा संदर्भ, नाजुक योजनाएं, और सहायक जो विषय से भटक जाते हैं। Anthropic के Claude Sonnet 4.5—Claude Code अनुभव के साथ जोड़ा गया—इन "लंबी अवधि" के कार्यों को ध्यान में रखकर बनाया गया था: मल्टी-फ़ाइल परिवर्तन, रिपॉजिटरी-स्पैनिंग माइग्रेशन, टेस्ट-ड्रिवन फिक्स और एजेंटिक वर्कफ़्लो जो एक निष्पादन योजना का पालन करते हैं।
Anthropic Sonnet 4.5 को एक हाइब्रिड रीज़निंग मॉडल के रूप में प्रस्तुत करता है जिसमें मजबूत निर्देश-अनुपालन और कोडिंग विश्वसनीयता है, और यह बेंचमार्क और डेवलपर रिपोर्ट में दिखता है। यही वह है जो आपको तब चाहिए जब आप किसी सहायक को 40 फाइलों को छूने के लिए कहते हैं, न कि 4 को, और फिर भी CI पास करते हैं। यह गाइड बड़े, वास्तविक दुनिया के कोडबेस पर Claude Sonnet 4.5 + Claude Code से लगातार, ऑडिट योग्य परिणाम प्राप्त करने के लिए सर्वोत्तम प्रथाओं को दर्शाता है। हम योजना, संदर्भ इंजीनियरिंग, टेस्ट-फर्स्ट फ्लो, ट्रेसबिलिटी और गार्डरेल पर ध्यान केंद्रित करेंगे जो डिफ्स को टाइट और अनुमानित रखते हैं।
लंबी अवधि की कोडिंग क्यों अलग (और कठिन) है
- क्रॉस-फाइल डिपेंडेंसी: एक कोर इंटरफेस का नाम बदलने से मॉडल, सेवाओं, परीक्षणों और दस्तावेज़ों में लहरें उठ सकती हैं।
- आर्किटेक्चरल मेमोरी: आपको प्रोजेक्ट स्ट्रक्चर और कन्वेंशन का एक साझा मानसिक मॉडल चाहिए।
- निष्पादन बहाव: सहायक योजना से भटक सकता है जब तक कि आप इसे परीक्षण, चेकपॉइंट और बाधाओं के साथ एंकर न करें।
- अभ्यास में संदर्भ सीमाएं: उदार संदर्भ विंडो के साथ भी, कोड और लॉग के अनियंत्रित डंप शोर और मतिभ्रम जोखिम पैदा करते हैं।
Claude Sonnet 4.5 + Claude Code टेबल पर क्या लाता है
- मजबूत निर्देश-अनुपालन और रिफैक्टरिंग विश्वसनीयता, जो इसे संरचित मल्टी-फ़ाइल परिवर्तनों और शैली गाइड और नामकरण कन्वेंशन के पालन के लिए बेहतर बनाती है।
- लंबी अवधि के कार्यों पर स्टेट-ऑफ-द-आर्ट कोडिंग प्रदर्शन संकेत, रिपॉजिटरी-स्केल संपादन और जटिल तर्क श्रृंखला में सुधार।
- Claude Code, Anthropic का कोडिंग अनुभव, रिपॉजिटरी-स्तरीय मदद, संरचित रिफैक्टरिंग और मल्टी-फ़ाइल स्थिरता पर केंद्रित है - ठीक वही जहाँ पारंपरिक चैट सहायक लड़खड़ाते हैं।
एक व्यावहारिक, समाधान-उन्मुख प्लेबुक
नीचे एक चरण-दर-चरण दृष्टिकोण दिया गया है जिसका आप रिपॉजिटरी-वाइड परिवर्तनों के लिए पुन: उपयोग कर सकते हैं, माइग्रेशन योजनाओं से लेकर CI-पासिंग डिफ्स तक।
- एक अनुबंध से शुरुआत करें: उद्देश्य, बाधाएं और निकास मानदंड
Claude Sonnet 4.5 को एक स्पष्ट मिशन अनुबंध दें। इसमें शामिल करें:
- उद्देश्य: “हमारे auth मिडलवेयर को Passport से Auth.js में मोनोरिपो में माइग्रेट करें।”
- बाधाएं: “auth से परे कोई API सतह परिवर्तन नहीं; सार्वजनिक प्रकारों को स्थिर रखें; तीसरे पक्ष के उपभोक्ताओं के लिए शून्य ब्रेकिंग परिवर्तन सुनिश्चित करें।”
- निकास मानदंड: “सभी परीक्षण पास; अपडेट किए गए दस्तावेज़; मूल्यह्रास नोट्स; चैंजलॉग प्रविष्टि; शून्य लिंट त्रुटियां।”
- गैर-लक्ष्य: “असंबंधित मॉड्यूल को न छुएं; प्रश्नों को अनुकूलित न करें।”
यह क्यों काम करता है: Sonnet 4.5 का बेहतर निर्देश-अनुपालन आपकी गुंजाइश पर लॉक हो जाता है और मध्य-उड़ान में अतिरेक को रोकता है।
- रिपॉजिटरी को चिपकाने के बजाय एक रिपॉजिटरी मैप बनाएं
हजारों लाइनों को पेस्ट न करें। एक क्यूरेटेड "रिपॉजिटरी मैप" प्रदान करें:
- उच्च-स्तरीय आर्किटेक्चर: packages/, apps/, services/ निर्देशिकाएं और प्रमुख सीमाएं।
- महत्वपूर्ण फाइलें: इंटरफेस, कोर यूटिलिटीज, एंट्री पॉइंट्स, DI कॉन्फ़िगरेशन।
- कन्वेंशन: नामकरण पैटर्न, त्रुटि हैंडलिंग मुहावरे, लॉगिंग, परीक्षण शैली।
- ज्ञात हॉटस्पॉट: लीगेसी मॉड्यूल, नाजुक परीक्षण, अस्थिर मॉक।
Claude को अपनी भाषा में रिपॉजिटरी मैप को वापस दोहराने और मील के पत्थर के साथ एक योजना का प्रस्ताव करने के लिए कहें। यह साझा समझ सुनिश्चित करता है और शुरुआती दौर में गलतफहमी को पकड़ता है - लंबी अवधि की योजना के लिए महत्वपूर्ण।
- मील के पत्थर के DAG के रूप में योजना बनाएं, न कि एक रैखिक टू-डू के रूप में
Claude को एक डिपेंडेंसी ग्राफ उत्पन्न करने के लिए कहें:
- मील का पत्थर 1: संगतता शिम और सुविधा झंडे पेश करें।
- मील का पत्थर 2: कोर मिडलवेयर एब्स्ट्रैक्शन अपडेट करें।
- मील का पत्थर 3: सेवाओं को उत्तरोत्तर माइग्रेट करें (जोखिम के अनुसार क्रमबद्ध)।
- मील का पत्थर 4: परीक्षण और फिक्स्चर अपडेट करें।
- मील का पत्थर 5: शिम/फ्लैग हटाएं, दस्तावेज़ों को अंतिम रूप दें।
प्रत्येक मील के पत्थर के लिए, अनुरोध करें:
- कारणों के साथ फ़ाइल टच-लिस्ट।
- परीक्षण प्रभाव और नए परीक्षण मामले।
- यदि CI टूट जाता है तो रोलबैक रणनीति।
यह DAG-शैली योजना बहाव को कम करती है, आपको सुरक्षित चरणों को समानांतर करने देती है, और Claude को संदर्भित करने के लिए एक संरचना देती है।
- टेस्ट-फर्स्ट एंकरिंग: पहले से ही विफल परीक्षण उत्पन्न करें
किसी भी रिफैक्टर से पहले Claude को लक्ष्य व्यवहार को एन्कोड करने वाले विफल परीक्षणों का प्रस्ताव करने के लिए कहें। उपयोग करें:
- सार्वजनिक सीमाओं पर अनुबंध परीक्षण।
- API प्रतिक्रियाओं या टेम्पलेट्स के लिए गोल्डन-फाइल स्नैपशॉट।
- अप्रचलित पथों के लिए पिछड़ा-संगत परीक्षण।
यह क्यों काम करता है: परीक्षण गार्डरेल बन जाते हैं जो लंबी अवधि के परिवर्तनों को ट्रैक पर और मापने योग्य रखते हैं। Claude Sonnet 4.5 की विश्वसनीयता तब चमकती है जब वह लगातार स्पष्ट संकेतों जैसे विफल बनाम पासिंग परीक्षणों के खिलाफ तर्क कर सकता है।
- मल्टी-फ़ाइल संपादन के लिए संदर्भ इंजीनियरिंग
संरचित संदर्भ फ़ीड करें, कच्चे कोड डंप नहीं:
- डिफ-केंद्रित संकेत: लाइन नंबरों और आसपास के फ़ंक्शन/वर्ग के साथ सबसे छोटे आवश्यक अंश प्रदान करें।
- इंटरफ़ेस-फर्स्ट: पहले सार्वजनिक प्रकार और इंटरफ़ेस साझा करें; Claude को टॉप-डाउन तर्क करने दें।
- ट्रेसबिलिटी: Claude को सभी छुई गई फ़ाइलों, तर्क और परीक्षणों के लिंक को सूचीबद्ध करते हुए एक "परिवर्तन घोषणापत्र" शामिल करने के लिए कहें।
- संघर्ष प्रत्याशा: कोड के स्निपेट प्रदान करें जिनके संघर्ष होने की संभावना है (उदाहरण के लिए, कस्टम auth रैपर) ताकि Claude उनके लिए योजना बना सके।
मल्टी-एजेंट और रिपॉजिटरी-स्तरीय सहायकों में शोध से पता चलता है कि संरचित, भूमिका-जागरूक संदर्भ रिपॉजिटरी-स्तरीय कार्यों के लिए क्रॉस-फ़ाइल सुसंगतता में काफी सुधार करता है।
- एक अपरिवर्तनीय योजना के साथ छोटे, समीक्षा योग्य बैच
मील के पत्थर के अनुरूप छोटे PR में काम करें:
- PR टेम्पलेट: उद्देश्य, गुंजाइश, परिवर्तन घोषणापत्र, परीक्षण डेल्टा, जोखिम नोट्स।
- Claude को कमिट संदेश उत्पन्न करने के लिए कहें जो मील के पत्थर योजना के अनुरूप हों।
- PR के अनुसार योजना को फ्रीज करें: यदि नया काम सामने आता है, तो PR को बढ़ाने के बजाय एक फॉलो-अप कार्य खोलें।
लाभ: मानव निरीक्षण को टाइट रखता है और रोलबैक को सर्जिकल बनाता है।
- कोडिंग कन्वेंशन और स्टेटिक गारंटी लागू करें
संकेत में अपने लिंटर्स, फॉर्मेटर्स और टाइप-चेक फ़्लैग प्रदान करें:
- “सभी कोड को eslint:recommended + कस्टम नियमों को पास करना होगा; प्रीटियर लागू; TypeScript strictNullChecks।”
- प्रतिनिधि लिंट या TypeScript त्रुटियों को साझा करें और Claude को अंतिम डिफ का प्रस्ताव करने से पहले उन्हें ठीक करने के लिए कहें।
Sonnet 4.5 का बेहतर निर्देश-अनुपालन इसे फ़ाइलों में लगातार इन बाधाओं का सम्मान करने में मदद करता है।
- शून्य-डाउनटाइम रिफैक्टर के लिए इंटरफ़ेस शिम और सुविधा झंडे का उपयोग करें
उच्च जोखिम वाले माइग्रेशन के लिए, Claude को निर्देश दें:
- पतले संगतता शिम पेश करें।
- झंडे या पर्यावरण टॉगल के पीछे नए पथों को गेट करें।
- परीक्षण स्थिर होने के दौरान अस्थायी रूप से दोहरे कोड पथ बनाए रखें।
यह प्रगतिशील रोलआउट और त्वरित रोलबैक की अनुमति देता है यदि मेट्रिक्स बढ़ जाते हैं।
- “क्यों” स्पष्टीकरण और जोखिम रजिस्टर के लिए पूछें
Claude को प्रत्येक महत्वपूर्ण परिवर्तन के लिए एक छोटा सा "क्यों" शामिल करने की आवश्यकता है:
- कौन सा अपरिवर्तनीय संरक्षित है?
- कौन सा परीक्षण इसे कवर करता है?
- जोखिम स्तर क्या है? फ़ॉलबैक क्या है?
ये स्पष्टीकरण कोड समीक्षा के दौरान सोना हैं और लंबी अवधि के संपादन में विश्वास बनाए रखने में मदद करते हैं।
- हर चीज को CI संकेतों में ग्राउंड करें
CI फीडबैक के साथ सहायक को टाइट लूप करें:
- विफल परीक्षण आउटपुट पेस्ट करें; लक्षित पैच के लिए पूछें।
- टाइप-चेक लॉग साझा करें; न्यूनतम डिफ्स के लिए पूछें जो व्यापक मंथन के बिना त्रुटियों को दूर करते हैं।
- विफलताओं के झरने होने पर एक समय में एक फ़ाइल ठीक करने की योजना की मांग करें।
- सुरक्षा-संवेदनशील पथों के लिए, गहराई में रक्षा संकेत जोड़ें
जब auth, क्रिप्टोग्राफी या भुगतान को छूते हैं:
- खतरा मॉडलिंग नोट्स और दुरुपयोग मामलों के लिए पूछें।
- अपरिवर्तनीय जांच, इनपुट सत्यापन और संवेदनशील संक्रमणों की लॉगिंग की आवश्यकता है।
- विफलता और दुरुपयोग परिदृश्यों के लिए परीक्षण मामलों की मांग करें।
- अंतिम हार्डनिंग पास: दस्तावेज़, चैंजलॉग और टेलीमेट्री
अंतिम मील के पत्थर को मर्ज करने से पहले:
- Claude को दस्तावेज़ अपडेट और माइग्रेशन नोट्स का मसौदा तैयार करने के लिए कहें।
- ब्रेकिंग/गैर-ब्रेकिंग झंडे के साथ एक चैंजलॉग उत्पन्न करें।
- पोस्ट-मर्ज निगरानी के लिए नए पथ के चारों ओर टेलीमेट्री डालें।
संकेत जिन्हें आप कॉपी/पेस्ट कर सकते हैं
- रिपॉजिटरी मैप सारांशक: “आप एक वरिष्ठ कर्मचारी इंजीनियर हैं। इस मानचित्र से हमारे आर्किटेक्चर को संक्षेप में बताएं, मान्यताओं को सूचीबद्ध करें और जोखिमों और परीक्षण रणनीति के साथ एक मील का पत्थर DAG प्रस्तावित करें। स्पष्टीकरण प्रश्न पूछें।”
- टेस्ट-फर्स्ट जनरेटर: “नए auth फ्लो के लिए विफल परीक्षण लिखें जो पिछड़ा संगतता को एन्कोड करते हैं। किनारे के मामलों और खराब इनपुट को शामिल करें।”
- परिवर्तन घोषणापत्र संगीतकार: “प्रत्येक फ़ाइल के लिए जिसे आप बदलने का प्रस्ताव करते हैं, सूचीबद्ध करें: कारण, अपेक्षित डिफ प्रकार, परीक्षण कवरेज और संभावित संघर्ष।”
- न्यूनतम-डिफ फिक्सर: “इन CI विफलताओं और फ़ाइल अंशों को देखते हुए, सबसे छोटे संभावित परिवर्तनों का प्रस्ताव करें जो बिल्ड को हरा कर देते हैं। कोई असंबंधित संपादन नहीं।”
- सुरक्षा हार्डनिंग: “टोकन रीफ्रेश के लिए इनपुट सत्यापन, लॉगिंग और दुरुपयोग-केस परीक्षण जोड़ें। एक छोटा खतरा मॉडल प्रदान करें।”
आम नुकसान और उनसे कैसे बचें
- नुकसान: पूरी फ़ाइलों के साथ संदर्भ को अधिभारित करना।
फिक्स: लाइन नंबरों के साथ इंटरफ़ेस-फर्स्ट सारांश और लक्षित अंश प्रदान करें।
- नुकसान: एक ही PR के अंदर गुंजाइश रेंगना।
फिक्स: मील के पत्थर-आधारित बैच आकार और PR के अनुसार एक अपरिवर्तनीय योजना लागू करें।
- नुकसान: फ़ाइलों में शैली बहाव।
फिक्स: लिंटर/फॉर्मेटर कॉन्फ़िगरेशन साझा करें; प्रत्येक पैच में पूर्व-कमिट संगत स्वरूपण की आवश्यकता है।
- नुकसान: अपुष्ट तर्क।
फिक्स: सहायक को प्रत्येक परिवर्तन को परीक्षणों से बांधने और "क्यों" नोट्स शामिल करने की आवश्यकता है।
- नुकसान: मौन ब्रेकिंग परिवर्तन।
फिक्स: पिछड़ा-संगत परीक्षण और सुविधा झंडे तब तक जोड़ें जब तक कि मेट्रिक्स समानता साबित न करें।
संकेत कि आपकी प्रक्रिया काम कर रही है
- शॉर्टर टाइम-टू-ग्रीन: स्थिर करने के लिए कम CI चक्र।
- स्पष्ट डिफ और तर्क के साथ छोटे PR।
- टेस्ट-फर्स्ट एंकरिंग के कारण कम प्रतिगमन दर।
- परिवर्तन घोषणापत्र और "क्यों" स्पष्टीकरण के कारण तेजी से कोड समीक्षा।
Claude Sonnet 4.5 + Claude Code आपके स्टैक में कहाँ फिट बैठता है
- योजना और रिफैक्टरिंग डिज़ाइन: मजबूत निर्देश-अनुपालन निर्भर योजनाएँ बनाने में मदद करता है, खासकर बहु-चरणीय कार्यों के लिए।
- रिपॉजिटरी-स्तरीय संपादन: Claude Code लंबी अवधि के काम के लिए उपयुक्त बहु-फ़ाइल स्थिरता और रिफैक्टरिंग सहायता पर केंद्रित है।
- जटिल कोडिंग कार्यों पर बेंचमार्क-समर्थित विश्वसनीयता: डेवलपर प्लेटफ़ॉर्म नोट्स बेहतर लंबी अवधि के कोडिंग प्रदर्शन की ओर इशारा करते हैं।
ध्यान देने योग्य: यदि आप डेवलपर टूलिंग या गेटवे का उपयोग करते हैं जो पहले से ही Sonnet 4.5 का समर्थन करते हैं, तो एकीकरण सीधा है - कई भागीदार सार्वजनिक रूप से उपलब्धता की पुष्टि करते हैं, जिससे आप अपनी मौजूदा पाइपलाइनों में उपरोक्त प्रथाओं का परीक्षण कर सकते हैं।
वैसे: यदि आप ब्राउज़र से काम कर रहे हैं, तो आधुनिक AI साइडबार और एक्सटेंशन तेजी से उन्नत मॉडल एक्सेस और कोडिंग सुविधाएँ प्रदान करते हैं, जिससे आपके IDE या रिपॉजिटरी ब्राउज़र को छोड़े बिना टेस्ट-फर्स्ट और डिफ-केंद्रित वर्कफ़्लो लागू करना आसान हो जाता है।
कार्रवाई योग्य अगले कदम
- अपनी रिपॉजिटरी मैप और कन्वेंशन को पुन: प्रयोज्य संकेत प्रस्तावना के रूप में एन्कोड करें।
- प्रत्येक PR के लिए परिवर्तन घोषणापत्र के साथ मील के पत्थर DAG को अपनाएं।
- किसी भी परिवर्तन के लिए टेस्ट-फर्स्ट पर स्विच करें जो पाँच से अधिक फ़ाइलों में फैला हो।
- auth/भुगतान पथों के लिए सुरक्षा हार्डनिंग संकेत जोड़ें।
- CI के साथ लूप बंद करें: विफलताओं को पेस्ट करें, न्यूनतम रूप से ठीक करें, दोहराएं।
मुख्य बातें
- लंबी अवधि की कोडिंग एक योजना और संदर्भ समस्या है; Claude Sonnet 4.5 की ताकत - तर्क, निर्देश-अनुपालन और रिपॉजिटरी-स्केल कोडिंग - उन जरूरतों के लिए अच्छी तरह से मैप करती है।
- संरचना क्रिया से बेहतर है: रिपॉजिटरी मैप, DAG मील के पत्थर, टेस्ट-फर्स्ट एंकरिंग और परिवर्तन घोषणापत्र अनुमानित परिणाम देते हैं।
- बहाव और प्रतिगमन से बचने के लिए डिफ्स को न्यूनतम, ऑडिट योग्य और परीक्षणों से बांधे रखें।
- शून्य-डाउनटाइम माइग्रेशन के लिए सुविधा झंडे और शिम का उपयोग करें, फिर मेट्रिक्स समानता को मान्य करने के बाद उन्हें हटा दें।
निष्कर्ष
लंबी अवधि की कोडिंग सिर्फ एक बड़ी संदर्भ विंडो के बारे में नहीं है; यह अनुशासित प्रक्रिया और एक सहायक के बारे में है जो एक योजना पर टिक सकता है। Claude Sonnet 4.5 और Claude Code के साथ, आप रिपॉजिटरी-वाइड रिफैक्टर, फ़्रेमवर्क माइग्रेशन और आर्किटेक्चरल क्लीनअप को मज़बूती से निष्पादित कर सकते हैं - जब तक आप मॉडल को संरचित संदर्भ फ़ीड करते हैं, काम को टेस्ट-फर्स्ट मील के पत्थर तक लॉक करते हैं, और समीक्षा योग्य, न्यूनतम डिफ्स को लागू करते हैं। भुगतान पर्याप्त है: तेजी से स्थिरीकरण, सुरक्षित मर्ज और एक कोडबेस जो हर पुनरावृत्ति के साथ स्वस्थ होता जाता है।
अक्सर पूछे जाने वाले प्रश्न
Q1: Claude Sonnet 4.5 को लंबी अवधि की कोडिंग के लिए क्या अच्छा बनाता है?
यह मजबूत निर्देश-अनुपालन को बेहतर कोडिंग विश्वसनीयता के साथ जोड़ता है, जिससे इसे बाधाओं और परीक्षणों का पालन करते हुए बहु-चरणीय, बहु-फ़ाइल परिवर्तनों की योजना बनाने और निष्पादित करने में मदद मिलती है। रिपोर्ट और प्लेटफ़ॉर्म नोट्स लंबी अवधि के कार्यों पर बेहतर प्रदर्शन को उजागर करते हैं।
Q2: मैं Claude को अभिभूत किए बिना पर्याप्त संदर्भ कैसे दूं?
पूरी फ़ाइलों के बजाय लाइन नंबरों के साथ एक क्यूरेटेड रिपॉजिटरी मैप, प्रमुख इंटरफ़ेस और लक्षित अंश प्रदान करें। एक परिवर्तन घोषणापत्र के लिए पूछें और मॉडल को प्रत्येक संपादन को मान्य करने के लिए परीक्षणों का संदर्भ देने की आवश्यकता है।
Q3: क्या Claude Code रिपॉजिटरी-स्तरीय रिफैक्टर को संभाल सकता है?
हाँ। Claude Code को बहु-फ़ाइल स्थिरता और संरचित रिफैक्टरिंग के लिए डिज़ाइन किया गया है, जो इसे माइग्रेशन, इंटरफ़ेस परिवर्तन और बड़े पैमाने पर नाम बदलने जैसे रिपॉजिटरी-स्तरीय कार्यों के लिए उपयुक्त बनाता है।
Q4: मैं लंबे रिफैक्टर में गुंजाइश रेंगने से कैसे बचूं?
PR के अनुसार अपरिवर्तनीय गुंजाइश के साथ मील के पत्थर DAG का उपयोग करें, और PR को छोटा और समीक्षा योग्य रखें। न्यूनतम डिफ्स की आवश्यकता है, लिंटिंग/फॉर्मेटिंग लागू करें, और प्रत्येक चरण को पहले विफल परीक्षणों के साथ एंकर करें।
Q5: मुझे सुरक्षा-संवेदनशील कोड के लिए कौन से गार्डरेल का उपयोग करना चाहिए?
खतरा मॉडलिंग, इनपुट सत्यापन, लॉगिंग और दुरुपयोग-केस परीक्षण के लिए संकेत जोड़ें। सुरक्षित रोलआउट के लिए सुविधा झंडे और शिम का उपयोग करें, और ऐसे परीक्षणों की आवश्यकता है जो विफलता और दुरुपयोग परिदृश्यों को कवर करते हैं।