- शुरुआत में Claude Code का उपयोग करते समय तरीका सिर्फ prompt निर्देश और बार-बार संशोधन तक सीमित था, लेकिन जटिल कामों में conversation history पर निर्भरता और context की सीमाओं जैसी समस्याएँ सामने आईं
- इसे हल करने के लिए, feature implementation से पहले plan document लिखवाया गया और उसे नए session के लिए एकमात्र single source of truth (SSOT) बनाया गया
- plan document में requirements को दोबारा व्यवस्थित करना, implementation details, code quality जाँचने के commands आदि शामिल होते हैं, और implementation के दौरान भी यह living document की तरह लगातार अपडेट होता रहता है
- इससे context loss की समस्या हल हो जाती है, और नए session में भी सिर्फ एक दस्तावेज़ के आधार पर प्रोजेक्ट आगे बढ़ाया जा सकता है
- नतीजतन, AI सिर्फ एक execution tool नहीं रहता, बल्कि डेवलपर को डिज़ाइन पर अधिक गहराई से सोचने और उसे दर्ज करने के लिए प्रेरित करने वाला collaborative design partner बन जाता है
समस्या की समझ: साधारण संवाद-आधारित तरीके की सीमाएँ
- Claude Code के साथ conversational तरीके से काम करते समय, यह छोटे कामों के लिए उपयुक्त है, लेकिन जैसे-जैसे काम जटिल होता जाता है, कई गंभीर सीमाएँ सामने आती हैं
- बातचीत ही एकमात्र truth source बन जाती है, इसलिए नया message पहले के निर्देशों को आसानी से ओवरराइड कर सकता है, और यह कब हुआ इसे स्पष्ट रूप से पहचानना कठिन होता है
- AI की context size limit के कारण, बातचीत लंबी होने पर पहले की जानकारी छूट सकती है
- Claude Code में conversation compression feature है, लेकिन यह सीमा पूरी तरह दूर नहीं होती
plan document-केंद्रित तरीके का प्रयोग
- इन समस्याओं को हल करने के लिए plan document आधारित approach अपनाई गई
- शुरुआत में Claude Code को implement किए जाने वाले feature या ठीक किए जाने वाले bug के बारे में यथासंभव विस्तार से बताया जाता है
- reference के लिए मौजूदा source files या पहले लिखे गए plan documents का भी उल्लेख किया जाता है
- बहुत अधिक specific implementation निर्देशों से बचा जाता है, ताकि AI की design suggestion भूमिका को प्रोत्साहित किया जा सके
- जब plan document पर्याप्त संतोषजनक हो जाता है, तब conversation history साफ़ करके उसी plan को context बनाकर नई शुरुआत की जाती है
- plan में feature summary, implementation plan, code और pseudocode, type/lint/test commands आदि शामिल होते हैं
सहयोगी डिज़ाइन प्रक्रिया
- जब AI का सुझाया गया डिज़ाइन पसंद नहीं आता, तो ठोस feedback देकर संशोधित approach की ओर ले जाया जाता है
- चर्चा के दौरान कभी यह भी महसूस होता है कि AI का शुरुआती सुझाव अधिक उपयुक्त था, और यह अपने दम पर डिज़ाइन बनाकर सीधे coding करने की तुलना में अधिक प्रभावी होता है
- व्यवस्थित बातचीत, किसी सहकर्मी डेवलपर के साथ plan पर चर्चा करने जैसे अनुभव देती है
- AI अपने आप पूरी तरह अलग approach नहीं देता, लेकिन पूछने पर दूसरे alternatives सुझा सकता है
living document तरीका
- plan document एक बार लिखकर छोड़ा नहीं जाता, बल्कि feature implementation के दौरान भी लगातार अपडेट किया जाता है
- implementation, type check, lint, और test की प्रक्रिया में सामने आने वाले बदलावों को real time में प्रतिबिंबित किया जाता है
- हर बार code commit करते समय plan की latest स्थिति की जाँच करने की आदत बनाई जाती है
- plan हमेशा up-to-date रहने से, नए conversation session में भी सिर्फ plan जोड़कर बिना context loss के काम आगे बढ़ाया जा सकता है
code review और development आदतों में बदलाव
- implementation शुरू होने के बाद समय-समय पर बदलावों की जाँच की जाती है, और संतुष्ट होने पर AI के काम पर अधिक भरोसा भी किया जाता है
- final code review के समय अपडेट किया गया plan document technical decision-making के आधार को समझने में मदद करता है
- पहले से विस्तार से plan बनाकर उसे document करने से बेहतर डेवलपर के रूप में विकसित होने का अनुभव मिलता है
- क्योंकि AI को समझाना होता है, इसलिए अपनी decision-making प्रक्रिया को अधिक स्पष्ट रूप से व्यवस्थित करना पड़ता है
अव्यवस्था से प्रणाली तक
- यह तरीका plan document को single source of truth बना देता है, context loss की समस्या को दूर करता है, और architectural thinking को बढ़ावा देता है
- plan document में specification और implementation log दोनों शामिल होते हैं, और यह सिर्फ ‘क्या’ नहीं बल्कि ‘क्यों’ और ‘कैसे’ भी दर्ज करता है
- अंतिम परिणाम एक योजनाबद्ध, अच्छी तरह documented और अधिक विश्वसनीय development process होता है
- AI एक साधारण implementer नहीं, बल्कि collaborative design partner के रूप में स्थापित हो जाता है
अभी कोई टिप्पणी नहीं है.