कोड को 10 गुना तेजी से सुरक्षित रूप से रिफैक्टर करने के लिए CLAUDE.md का उपयोग करें

Claude Code के साथ बड़े कोडबेस को रिफैक्टर करना तब विफल हो जाता है जब Claude किसी सत्र में बिना जानकारी के प्रवेश करता है। उसे यह नहीं पता होता कि UserService आंतरिक रूप से AuthService को कॉल करता है, या यह कि आपका डेटाबेस snake_case की अपेक्षा करता है, या यह कि आप छह महीने पहले Redux से Zustand पर चले गए थे। इस संदर्भ के बिना, Claude नए अमूर्तन गढ़ लेता है जो चुपचाप उन तीन फ़ाइलों को तोड़ देते हैं जो आपने उसे कभी दिखाई ही नहीं थीं। इसका समाधान है CLAUDE.md-एक संदर्भ एंकर दस्तावेज़ जिसे आप एक बार लिखते हैं और हर रिफैक्टरिंग सत्र में संदर्भित करते हैं।

अपने प्रोजेक्ट रूट में CLAUDE.md नाम की एक फ़ाइल बनाएं और इसमें दस्तावेज़ीकरण करें: सिस्टम का उद्देश्य सरल अंग्रेजी में, महत्वपूर्ण आर्किटेक्चरल निर्णय (आप कौन से पैटर्न उपयोग करते हैं और क्यों), ज्ञात नाजुक क्षेत्र या अदस्तावेज़ित निर्भरताएं, आपके कोडबेस के नामकरण सम्मेलन, और बाधाएं (जैसे, 'UserService का नाम न बदलें-इसे 15 माइक्रोसर्विसेस आयात करते हैं')। यह आपका रिफैक्टरिंग संविधान बन जाता है। जब आप Claude से UserDashboard को रिफैक्टर करने के लिए कहते हैं, तो उसे निर्देश दें कि पहले CLAUDE.md पढ़े, फिर src/components/UserDashboard.tsx और उसके सभी आयात पढ़े। अचानक Claude समझ जाता है कि वह किसे छू रहा है और क्या टूट सकता है।

व्यावहारिक वर्कफ़्लो: हर सत्र की शुरुआत किसी बदलाव से नहीं, बल्कि एक सवाल से करें। कहें 'CLAUDE.md पढ़ें, फिर src/services/PaymentProcessor.ts और उसे आयात करने वाली हर फ़ाइल का विश्लेषण करें। यह क्या करता है? अगर हम इसका इंटरफ़ेस बदल दें तो क्या टूटेगा?' Claude पूरी तरह सूचित स्थिति से जवाब देता है। उसके बाद ही उससे कोई कोड लिखने से पहले रिफैक्टरिंग के चरण प्रस्तावित करने के लिए कहें। यह पहले-पढ़ो, दूसरे-योजना-बनाओ, फिर-एक-बार-कोड-लिखो पैटर्न डिबगिंग लूप को 40-50 से घटाकर मात्र 2-3 पुनरावृत्तियों पर ले आता है।

डेवलपर्स बताते हैं कि Claude 600 पंक्तियों वाले React कंपोनेंट्स को 10 मिनट से भी कम समय में रिफैक्टर कर सकता है और सभी टेस्ट हरे बने रहते हैं-लेकिन केवल तब जब उसके पास सही संदर्भ संरचना हो। CLAUDE.md फ़ाइल एक ही रिफैक्टरिंग सत्र में अपनी लागत वसूल कर लेती है, विशेष रूप से कई रेपो बनाए रखने वाली टीमों के लिए।