Claude Code के साथ टेक डेट को कैसे विज़ुअलाइज़ और व्यवस्थित रूप से कम करें

“हम रिफैक्टर करना चाहते हैं लेकिन कभी समय नहीं मिलता।” “हम शुरुआत कहाँ से करें?” टेक डेट चुपचाप बढ़ती रहती है। Claude Code के साथ, आप डेट को व्यवस्थित रूप से सामने ला सकते हैं, प्राथमिकता दे सकते हैं और चुका सकते हैं — सामान्य लागत के एक अंश में।

1. पूरे कोडबेस में कोड स्मेल्स का पता लगाएं

पूरे स्कैन से शुरुआत करें।

claude -p "
src/ में कोड स्मेल्स के लिए स्कैन करें। जाँचें:

- 50 लाइनों से अधिक लंबे फ़ंक्शन
- गहरी नेस्टिंग (4+ लेवल)
- डुप्लिकेटेड लॉजिक
- God Classes (अत्यधिक ज़िम्मेदारियाँ)
- मैजिक नंबर
- अनयूज़्ड एक्सपोर्ट्स
- any टाइप का उपयोग
- TODO / FIXME टिप्पणियाँ

docs/tech-debt/smells.md में आउटपुट इस प्रारूप में दें:
| File | Line | Smell | Severity(1-5) | Suggested fix |
"

गंभीरता के अनुसार रैंक की गई सूची आपका शुरुआती बिंदु बन जाती है।

2. डिपेंडेंसी डेट को मापें

पुरानी लाइब्रेरीज़ और वल्नरेबिलिटीज़ भी डेट हैं।

claude -p "
package.json के साथ npm audit और npm outdated का विश्लेषण करें:

1. मेजर अपडेट की आवश्यकता वाली लाइब्रेरीज़
2. ज्ञात वल्नरेबिलिटीज़
3. अनमेंटेन्ड पैकेजेज़
4. डुप्लिकेट्स (जैसे moment + date-fns एक साथ)

docs/tech-debt/dependencies.md में आउटपुट दें, जिसमें वर्तमान वर्ज़न, नवीनतम, ब्रेकिंग चेंजेज़, अपडेट प्राथमिकता — टेबल के रूप में हों।
"

3. ICE Scores से प्राथमिकता तय करें

आप सब कुछ ठीक नहीं कर सकते। Impact × Confidence × Ease के आधार पर रैंक करें।

claude -p "
docs/tech-debt/smells.md और dependencies.md का उपयोग करके प्रत्येक आइटम को स्कोर करें:

- Impact (I): बिजनेस/डेव वेलोसिटी पर प्रभाव (1-10)
- Confidence (C): प्रभाव की निश्चितता (1-10)
- Ease (E): ठीक करने का प्रयास (1-10)

Score = I × C × E के अवरोही क्रम में सॉर्ट करें।
docs/tech-debt/backlog.md के रूप में आउटपुट दें।
शीर्ष 10 के लिए अनुमानित पर्सन-डे शामिल करें।
"

संख्यात्मक स्कोर प्रोडक्ट मैनेजर्स के सामने तर्क को स्पष्ट करते हैं।

4. छोटे रिपेमेंट PRs ऑटो-जेनरेट करें

पुनर्भुगतान को समीक्षा योग्य PRs में विभाजित करें।

claude -p "
docs/tech-debt/backlog.md में #1 आइटम के लिए:

1. ब्रांच बनाएँ: refactor/tech-debt-001
2. केवल उस समस्या को ठीक करें (कोई व्यवहार परिवर्तन नहीं)
3. सुनिश्चित करें कि मौजूदा टेस्ट पास होते हैं
4. बड़ा होने पर कई कमिट्स में विभाजित करें
5. gh pr create चलाएँ

PR बॉडी में शामिल करें:
- डेट क्या थी
- अभी क्यों चुकाएं
- ICE स्कोर
- अन्य कोड पर प्रभाव का दायरा
"

5. बिना टेस्ट वाले हॉट स्पॉट्स की पहचान करें

कम कवरेज वाले क्षेत्र भविष्य की डेट बन जाते हैं।

npm test -- --coverage --coverageReporters=json

claude -p "
coverage/coverage-summary.json का विश्लेषण करें:

- 50% से कम कवरेज वाली फ़ाइलें
- उनमें से, जिनमें बिजनेस लॉजिक है
- टेस्ट जोड़ने की प्राथमिकता

docs/tech-debt/coverage-gaps.md में आउटपुट दें।
शीर्ष 3 फ़ाइलों के लिए टेस्ट केस प्रस्तावित करें।
"

गुणात्मक प्रभाव के लिए टेस्ट ऑटो-जेनरेशन के साथ संयोजन करें।

6. साप्ताहिक रिपोर्ट्स के साथ पुनर्भुगतान को दृश्यमान बनाएं

दृश्यता के बिना, टीमें हार मान लेती हैं।

claude -p "
पिछले हफ्ते के टेक डेट रिपेमेंट पर रिपोर्ट करें:

- सुलझाए गए आइटम (docs/tech-debt/backlog.md की जाँच करें)
- नई खोजी गई डेट
- गंभीरता-5 आइटम जो अभी भी खुले हैं
- डिपेंडेंसी अपडेट प्रगति

docs/tech-debt/weekly-report-$(date +%Y-%m-%d).md में आउटपुट दें।
5 मिनट के स्टैंडअप रीडआउट के लिए ट्यून करें।
"

पुनर्भुगतान को संस्थागत बनाने के लिए सोमवार सुबह cron करें।

7. नई डेट को गेट पर रोकें

अगर इनफ्लो जारी रहा तो पुनर्भुगतान व्यर्थ है। CLAUDE.md में नियमों को कोडिफाई करें।

## नई टेक डेट को रोकने के नियम

### निषिद्ध
- नई any-टाइप वैल्यूज़ (अपरिहार्य होने पर कारण सहित // @ts-expect-error का उपयोग करें)
- TODO के बिना स्टॉपगैप लॉजिक
- टेस्ट के बिना बिजनेस लॉजिक

### PR चेकलिस्ट
- [ ] नए कोड की कवरेज ≥ 80%
- [ ] शून्य ESLint एरर्स
- [ ] PR में डिपेंडेंसी जोड़ने का औचित्य

### स्वीकार्य अपवाद
- हॉटफ़िक्स (फ़ॉलो-अप टिकट के साथ)
- POC कोड (प्रोडक्शन से पहले फिर से लिखना होगा)

Pre-commit hooks के माध्यम से लागू करें। देखें Hooks गाइड।

एंटी-पैटर्न्स

❌ एक विशाल रिफैक्टर PR

“सब कुछ ठीक करने” वाले PRs समीक्षा योग्य नहीं होते। एक स्मेल = एक PR।

❌ व्यवहार परिवर्तनों को मिलाना

एक ही PR में फीचर कार्य और रिफैक्टरिंग को कभी न मिलाएँ। समीक्षा का बोझ दोगुना हो जाता है।

❌ टेस्ट के बिना रिफैक्टरिंग

अगर कवरेज कम है, तो पहले टेस्ट लिखें, फिर रिफैक्टर करें। सुरक्षा जाल न होने का अर्थ है नए बग।

निष्कर्ष

• स्मेल्स, डिपेंडेंसी डेट और कवरेज गैप्स को सामने लाने के लिए Claude Code का उपयोग करें
• ICE स्कोरिंग से प्राथमिकता को मात्राबद्ध करें
• पुनर्भुगतान को छोटे PRs में विभाजित करें
• साप्ताहिक प्रगति रिपोर्ट प्रकाशित करें
• CLAUDE.md नियमों के माध्यम से नई डेट को रोकें
• एक स्मेल = एक PR

टेक डेट “कभी” ठीक करने वाली चीज़ नहीं है। यह हर हफ्ते थोड़ी-थोड़ी चुकाने वाली चीज़ है। Claude Code उस लय की लागत को ध्वस्त कर देता है।

संबंधित: रिफैक्टरिंग ऑटोमेशन / Legacy कोड मॉडर्नाइज़ेशन / कोड रिव्यू चेकलिस्ट

आधिकारिक डॉक्स: Anthropic Claude Code