mohitagw15856/pm-claude-skills / i18n/hi/skills/technical-debt-register
technical-debt-register
Verifiedव्यावसायिक प्रभाव, प्रयास अनुमानों और समाधान रणनीति के साथ तकनीकी ऋण बैकलॉग को दस्तावेज़ित और प्राथमिकता दें। जब कोई तकनीकी ऋण का ऑडिट करने, ऋण रजिस्टर बनाने, तिमाही के लिए तकनीकी ऋण को प्राथमिकता देने, आर्किटेक्चर शॉर्टकट दस्तावेज़ित करने या ऋण कटौती रोडमैप बनाने को कहे, तब इसका उपयोग करें। श्रेणी के अनुसार ऋण सूची, प्रति आइटम व्यावसायिक प्रभाव, प्रयास और प्राथमिकता स्कोर, शीर्ष आइटम समाधान योजनाओं और त्रैमासिक ऋण कटौती रोडमैप को कवर करने वाला संरचित तकनीकी ऋण रजिस्टर तैयार करता है।
तकनीकी ऋण रजिस्टर स्किल
किसी टीम या सेवा के लिए पूरा तकनीकी ऋण रजिस्टर तैयार करें। ऋण रजिस्टर शिकायत सूची नहीं है — यह एक प्राथमिकता-क्रम, व्यावसायिक-प्रभाव-सजग सूची है जो इंजीनियरिंग टीम को यह सोच-समझकर चुनने देती है कि कौन सा ऋण चुकाना है, किस क्रम में, और किस अपेक्षित प्रतिफल के साथ।
अच्छा ऋण प्रबंधन सारा ऋण ख़त्म करना नहीं है। यह सुनिश्चित करना है कि ऋण दृश्य हो, उसका स्वामी हो, और जब ब्याज की लागत ठीक करने की लागत से ज़्यादा हो जाए तब उसे हल किया जाए।
आवश्यक इनपुट
पहले से न दिए गए हों तो ये माँगें:
- टीम या सेवा का नाम — यह रजिस्टर किस टीम और/या सेवा को कवर करता है
- ज्ञात ऋण आइटम — ज्ञात तकनीकी ऋण की सूची, या Claude से इनके बारे में पूछकर निकालने को कहें: लीगेसी कोड, गायब टेस्ट, पुरानी डिपेंडेंसी, आर्किटेक्चर शॉर्टकट, मैनुअल प्रक्रियाएँ, ऑब्ज़र्वेबिलिटी की कमियाँ, सुरक्षा बैकलॉग
- टेक स्टैक — भाषा, फ़्रेमवर्क, इंफ़्रास्ट्रक्चर (Claude को आइटम सही वर्गीकृत और स्कोर करने में मदद करता है)
- टीम का आकार और वेलोसिटी — इंजीनियरों की संख्या और प्रति स्प्रिंट अनुमानित स्टोरी पॉइंट या दिन (प्रयास अनुमानों के लिए ज़रूरी)
- वर्तमान तिमाही / योजना अवधि — ताकि रोडमैप सही समयसीमा को लक्षित करे
आउटपुट फ़ॉर्मैट
तकनीकी ऋण रजिस्टर: [टीम / सेवा का नाम]
टीम: [नाम] | सेवा(एँ): [नाम] लेखक: [नाम] | अंतिम अपडेट: [तारीख़] योजना अवधि: [Q[X] [वर्ष]] | समीक्षा आवृत्ति: [मासिक / त्रैमासिक]
अवलोकन
[2–3 वाक्य जो टीम की वर्तमान ऋण स्थिति, ऋण की मुख्य श्रेणियाँ और व्यावसायिक संदर्भ बताएँ — जैसे क्या वे विकास चरण में हैं जहाँ वेलोसिटी मायने रखती है, या अनुपालन समयसीमा के पास जहाँ सुरक्षा ऋण गंभीर है?]
रजिस्टर में कुल आइटम: [X] अनसुलझे आइटम: [X] गंभीर/उच्च प्राथमिकता आइटम: [X] अनुमानित कुल समाधान प्रयास: [X स्टोरी पॉइंट / X इंजीनियर-सप्ताह]
ऋण श्रेणी परिभाषाएँ
| श्रेणी | विवरण | उदाहरण |
|---|---|---|
| कोड गुणवत्ता | ऐसा कोड जो काम करता है पर सुरक्षित रूप से बदलना कठिन है | दोहराया तर्क, गहरे नेस्टेड कंडीशनल, असंगत एरर हैंडलिंग, गायब एब्स्ट्रैक्शन |
| आर्किटेक्चर | संरचनात्मक निर्णय जो स्केलेबिलिटी सीमित करते या कपलिंग बढ़ाते हैं | मोनोलिथ जिसे तोड़ना चाहिए, sync कॉल जो async होनी चाहिए, गायब डोमेन सीमाएँ |
| टेस्टिंग | टेस्ट कवरेज की कमियाँ जो रिग्रेशन जोखिम बढ़ाती हैं | गायब यूनिट टेस्ट, कोई इंटीग्रेशन टेस्ट नहीं, अस्थिर टेस्ट सूट, कोई टेस्ट डेटा प्रबंधन नहीं |
| सुरक्षा | ज्ञात कमज़ोरियाँ या गायब सुरक्षा नियंत्रण | CVE वाली पुरानी डिपेंडेंसी, गायब रेट लिमिटिंग, हार्ड-कोडेड सीक्रेट, अपर्याप्त auth |
| डिपेंडेंसी | पुरानी या जोखिम भरी बाहरी डिपेंडेंसी | एंड-ऑफ़-लाइफ़ लाइब्रेरी, बड़े संस्करण से पीछे, छोड़े गए पैकेज |
| इंफ़्रास्ट्रक्चर | ऐसा इंफ़्रास्ट्रक्चर जो विश्वसनीयता या डेवलपर उत्पादकता सीमित करता है | मैनुअल डिप्लॉयमेंट चरण, कोई IaC नहीं, सिंगल-AZ, गायब ऑटोस्केलिंग |
| ऑब्ज़र्वेबिलिटी | दृश्यता की कमियाँ जो घटना प्रतिक्रिया धीमी करती हैं | गायब मेट्रिक, कोई डिस्ट्रिब्यूटेड ट्रेसिंग नहीं, ख़राब लॉग संरचना, मुख्य SLI पर कोई अलर्टिंग नहीं |
| प्रक्रिया | मैनुअल या त्रुटि-प्रवण परिचालन प्रक्रियाएँ | मैनुअल DB माइग्रेशन, कोई runbook नहीं, अदस्तावेज़ित आंतरिक ज्ञान |
ऋण रजिस्टर
स्कोरिंग विधि
व्यावसायिक प्रभाव (1–5):
- 5 — विकास रोक रहा, प्रोडक्शन घटनाएँ पैदा कर रहा, या अनुपालन जोखिम बना रहा
- 4 — डिलीवरी काफ़ी धीमी कर रहा या घटना की संभावना बढ़ा रहा
- 3 — ध्यान देने योग्य मंदी; प्रबंधनीय पर जमा हो रहा
- 2 — मामूली घर्षण; कम तात्कालिक जोखिम
- 1 — कॉस्मेटिक या आकांक्षी; कोई वर्तमान व्यावसायिक प्रभाव नहीं
हल करने का प्रयास (1–5, कम = आसान):
- 1 — <0.5 दिन; एक इंजीनियर
- 2 — 0.5–2 दिन; एक इंजीनियर
- 3 — 3–5 दिन; एक इंजीनियर या छोटी जोड़ी
- 4 — 1–2 सप्ताह; टीम सहयोग ज़रूरी
- 5 — >2 सप्ताह; महत्वपूर्ण योजना और समन्वय
प्राथमिकता स्कोर = व्यावसायिक प्रभाव × (6 − प्रयास) (उच्च-प्रभाव, कम-प्रयास आइटम को पुरस्कृत करता है)
| ID | आइटम | श्रेणी | व्यावसायिक प्रभाव (1–5) | प्रयास (1–5) | प्राथमिकता स्कोर | स्थिति | स्वामी |
|---|---|---|---|---|---|---|---|
| TD-001 | [जैसे पेमेंट फ़्लो के लिए कोई इंटीग्रेशन टेस्ट नहीं] | टेस्टिंग | 5 | 3 | 15 | खुला | [नाम] |
| TD-002 | [जैसे प्रमाणीकरण लाइब्रेरी 3 बड़े संस्करण पीछे] | सुरक्षा | 5 | 2 | 20 | खुला | [नाम] |
| TD-003 | [जैसे डेटाबेस क्वेरी कनेक्शन पूलिंग नहीं उपयोग करतीं] | आर्किटेक्चर | 4 | 2 | 16 | खुला | [नाम] |
| TD-004 | [जैसे [सेवा] के लिए मैनुअल डिप्लॉयमेंट प्रक्रिया] | इंफ़्रास्ट्रक्चर | 4 | 3 | 12 | प्रगति में | [नाम] |
| TD-005 | [जैसे ऑर्डर प्रोसेसिंग में 200-पंक्ति का God फ़ंक्शन] | कोड गुणवत्ता | 3 | 3 | 9 | खुला | [नाम] |
| TD-006 | [जैसे कोई संरचित लॉगिंग नहीं — सिर्फ़ सादा पाठ] | ऑब्ज़र्वेबिलिटी | 3 | 2 | 12 | खुला | [नाम] |
| TD-007 | [जैसे ORM संस्करण में ज्ञात N+1 क्वेरी समस्या] | डिपेंडेंसी | 3 | 3 | 9 | खुला | [नाम] |
| TD-008 | [जैसे [गंभीर ऑपरेशन] के लिए कोई runbook नहीं] | प्रक्रिया | 3 | 1 | 15 | खुला | [नाम] |
| TD-009 | [जैसे टेस्ट कवरेज 34% — कोई सार्थक सुरक्षा जाल नहीं] | टेस्टिंग | 4 | 4 | 8 | खुला | [नाम] |
| TD-010 | [जैसे एप्लिकेशन कोड में हार्ड-कोडेड कॉन्फ़िग मान] | कोड गुणवत्ता | 2 | 1 | 10 | खुला | [नाम] |
| TD-011 | [जैसे सेवा बिना फ़ेलओवर के सिंगल-AZ में तैनात] | इंफ़्रास्ट्रक्चर | 5 | 4 | 10 | खुला | [नाम] |
| TD-012 | [जैसे [एंडपॉइंट] की P95 लेटेंसी पर कोई अलर्टिंग नहीं] | ऑब्ज़र्वेबिलिटी | 4 | 1 | 20 | खुला | [नाम] |
श्रेणी विभाजन
Category distribution (by item count):
─────────────────────────────────────────────
Code quality ████████░░ [X items] ([X]%)
Architecture ██████░░░░ [X items] ([X]%)
Testing █████████░ [X items] ([X]%)
Security ████░░░░░░ [X items] ([X]%)
Dependencies ███░░░░░░░ [X items] ([X]%)
Infrastructure ████░░░░░░ [X items] ([X]%)
Observability ████░░░░░░ [X items] ([X]%)
Process ██░░░░░░░░ [X items] ([X]%)
─────────────────────────────────────────────
Priority distribution:
Critical (score 20–25): [X items]
High (score 12–19): [X items]
Medium (score 6–11): [X items]
Low (score 1–5): [X items]
शीर्ष 5 प्राथमिकता आइटम — समाधान योजनाएँ
TD-XXX: [सर्वोच्च प्राथमिकता आइटम का नाम]
प्राथमिकता स्कोर: [स्कोर] | श्रेणी: [श्रेणी] | स्वामी: [नाम]
समस्या: [2–3 वाक्य जो बताएँ ऋण क्या है, कैसे प्रकट होता है, और अभी क्या दर्द देता है। विशिष्ट रहें — वास्तविक घटनाओं, मंदी या जोखिमों का संदर्भ दें।]
व्यावसायिक प्रभाव: [हल न हो तो क्या होगा? किसी घटना, नज़दीकी चूक या विकास अवरोधक का संदर्भ दें। जैसे "इसने पिछली तिमाही 2 प्रोडक्शन घटनाएँ पैदा कीं और इस क्षेत्र के किसी भी बदलाव में ~30 मिनट का डीबगिंग समय जोड़ता है।"]
समाधान का तरीका:
[फ़िक्स का स्पष्ट विवरण। "कोड सुधारें" नहीं — वास्तविक काम बताएँ: "पेमेंट प्रोसेसिंग तर्क को समर्पित PaymentService क्लास में निकालें, 80% कवरेज तक यूनिट टेस्ट लिखें, और 3 कॉल साइट अपडेट करें।"]
चरण:
- [विशिष्ट, टिकट-योग्य चरण]
- [विशिष्ट, टिकट-योग्य चरण]
- [विशिष्ट, टिकट-योग्य चरण]
स्वीकृति मानदंड:
- [मापने योग्य मानदंड — जैसे "एप्लिकेशन कोड में शून्य हार्ड-कोडेड कॉन्फ़िग मान बचे"]
- [मापने योग्य मानदंड — जैसे "नए टेस्ट के साथ CI पाइपलाइन पास"]
- [मापने योग्य मानदंड]
प्रयास अनुमान: [X स्टोरी पॉइंट / X दिन] सुझाया गया स्प्रिंट: [Q[X] स्प्रिंट [Y] / जब [निर्भरता] पूरी हो]
TD-XXX: [दूसरा प्राथमिकता आइटम का नाम]
प्राथमिकता स्कोर: [स्कोर] | श्रेणी: [श्रेणी] | स्वामी: [नाम]
समस्या: [विवरण]
व्यावसायिक प्रभाव: [प्रभाव विवरण]
समाधान का तरीका: [तरीके का विवरण]
चरण:
- [चरण]
- [चरण]
- [चरण]
स्वीकृति मानदंड:
- [मानदंड]
- [मानदंड]
प्रयास अनुमान: [X स्टोरी पॉइंट / X दिन] सुझाया गया स्प्रिंट: [स्प्रिंट या समयसीमा]
TD-XXX: [तीसरा प्राथमिकता आइटम]
(ऊपर जैसा प्रारूप अपनाएँ)
TD-XXX: [चौथा प्राथमिकता आइटम]
(ऊपर जैसा प्रारूप अपनाएँ)
TD-XXX: [पाँचवाँ प्राथमिकता आइटम]
(ऊपर जैसा प्रारूप अपनाएँ)
ऋण कटौती रोडमैप
मार्गदर्शक सिद्धांत
- हर स्प्रिंट की क्षमता का [X%] ऋण समाधान को आवंटित करें — स्वस्थ टीमों के लिए 15–20% की सिफ़ारिश
- सुरक्षा और डिपेंडेंसी ऋण प्राथमिकता स्कोर की परवाह किए बिना तय अंतराल पर संबोधित होता है
- गंभीर ऋण वाले मॉड्यूल में कोई नया फ़ीचर काम नहीं जब तक ऋण वर्तमान स्प्रिंट में निर्धारित न हो
- बिना समाधान के बंद (स्वीकृत/टाले गए) ऋण आइटम का नामित स्वामी और समीक्षा तिथि होनी चाहिए
त्रैमासिक योजना
| तिमाही | फ़ोकस क्षेत्र | लक्षित आइटम | अनुमानित क्षमता | अपेक्षित परिणाम |
|---|---|---|---|---|
| [Q1 वर्ष] (वर्तमान) | सुरक्षा + ऑब्ज़र्वेबिलिटी | TD-002, TD-012, TD-006 | [X] पॉइंट / [Y] इंजीनियर-दिन | Auth लाइब्रेरी वर्तमान; लेटेंसी अलर्टिंग लाइव; संरचित लॉगिंग शिप |
| [Q2 वर्ष] | आर्किटेक्चर + विश्वसनीयता | TD-003, TD-011, TD-004 | [X] पॉइंट / [Y] इंजीनियर-दिन | कनेक्शन पूलिंग ठीक; मल्टी-AZ तैनात; डिप्लॉय स्वचालन पूर्ण |
| [Q3 वर्ष] | टेस्टिंग कवरेज | TD-001, TD-009 | [X] पॉइंट / [Y] इंजीनियर-दिन | पेमेंट फ़्लो इंटीग्रेशन टेस्ट लाइव; कुल कवरेज ≥60% |
| [Q4 वर्ष] | कोड गुणवत्ता + प्रक्रिया | TD-005, TD-008, TD-010 | [X] पॉइंट / [Y] इंजीनियर-दिन | God फ़ंक्शन रीफ़ैक्टर; runbook पूर्ण; शून्य हार्ड-कोडेड कॉन्फ़िग |
स्प्रिंट आवंटन मॉडल
Sprint capacity: [X] story points
Allocation:
├── Feature work: [X * 0.75 = ~Y] points (75%)
├── Debt resolution: [X * 0.15 = ~Y] points (15%)
└── Unplanned/bugs: [X * 0.10 = ~Y] points (10%)
Debt items that fit in one sprint ([≤Y] points each):
✓ TD-002 ([X] points)
✓ TD-012 ([X] points)
✓ TD-006 ([X] points)
✓ TD-008 ([X] points)
Multi-sprint debt items (break into phases):
~ TD-001: Phase 1 ([X] pts) → Phase 2 ([X] pts)
~ TD-009: Requires dedicated debt sprint or pairing
स्वीकृत / टाला गया ऋण
ऐसे आइटम जहाँ उपचार की लागत वर्तमान में व्यावसायिक मूल्य से ज़्यादा है, स्पष्ट समीक्षा तिथियों के साथ स्वीकृत।
| ID | आइटम | टालने का कारण | समीक्षा तिथि | स्वामी |
|---|---|---|---|---|
| TD-XXX | [आइटम] | [जैसे "पुनर्लेखन में 3 सप्ताह लगेंगे और वर्तमान पैमाने पर कोई उपयोगकर्ता-सामना मूल्य नहीं; 10× ट्रैफ़िक पर फिर देखें"] | [तारीख़] | [नाम] |
| TD-XXX | [आइटम] | [जैसे "डिपेंडेंसी में CVE है पर Q3 तक कोई अपग्रेड पथ नहीं; WAF नियम से कम किया गया"] | [तारीख़] | [नाम] |
नीति: इंजीनियरिंग मैनेजर तक एस्केलेशन के बिना कोई आइटम दो बार से ज़्यादा नहीं टाला जा सकता।
गहरी सामग्री
यह स्किल सहायक फ़ाइलों के साथ आती है — उपलब्ध हों तो उनका उपयोग करें:
references/debt-pricing.md— ऋण की कीमत तय करना: "यह ख़राब है" को ऐसी संख्या में बदलना जिसे कोई रैंक कर सके। आउटपुट बनाते समय इसे लागू करें; इसमें वह कैलिब्रेशन और निर्णय-विवेक है जिसे ऊपर का संक्षिप्त तरीका संकुचित कर देता है।templates/debt-entry.md— डिलिवरेबल का भरने योग्य संस्करण, गुणवत्ता-जाँच इनलाइन सहित। जब उपयोगकर्ता दस्तावेज़ खुद बनाना चाहे, उसे जनरेट करवाने के बजाय, तब यह पेश करें।
स्कोरिंग रूब्रिक (0–40)
इस स्किल का कोई भी आउटपुट सौंपने से पहले स्कोर करें; 32+ शिप-गुणवत्ता है।
| आयाम | 0 | 5 | 10 |
|---|---|---|---|
| व्यावसायिक-प्रभाव में अनुवाद | आइटम सिर्फ़ इंजीनियरिंग शब्दों में वर्णित | प्रभाव बताया पर परिमाणित नहीं | हर आइटम व्यावसायिक शब्दों (जोखिम, वेलोसिटी पर खिंचाव, लागत) में आँका गया जिसे गैर-इंजीनियर रैंक कर सके |
| स्कोरिंग अनुशासन | प्राथमिकताएँ अंदाज़े से दी गईं | सूत्र उपयोग हुआ पर सुरक्षा/डिपेंडेंसी आइटम अब भी कम स्कोर | सूत्र सुसंगत रूप से लागू, "तकनीकी लगता है" पूर्वाग्रह स्पष्ट रूप से सुधारा गया |
| समाधान योजना की गुणवत्ता | शीर्ष आइटम में धुँधले इरादे | योजनाएँ हैं पर टिकट-योग्य नहीं | शीर्ष-5 योजनाएँ क्रम और definition of done के साथ विशिष्ट, टिकट-योग्य चरण हैं |
| क्षमता यथार्थवाद | रोडमैप स्प्रिंट बजट की अनदेखी करता है | आवंटन बताया पर वास्तविक क्षमता से ज़्यादा | त्रैमासिक आवंटन वास्तविक क्षमता में फ़िट, और स्वीकृत/टाले गए आइटम के स्वामी और समीक्षा तिथियाँ हैं |
गुणवत्ता जाँच
- हर आइटम का नामित स्वामी है — कोई बिना स्वामी का ऋण नहीं
- प्राथमिकता स्कोर सूत्र से निकाले गए हैं, मनमाने ढंग से नहीं
- सुरक्षा और डिपेंडेंसी आइटम "तकनीकी" लगने के कारण वास्तविक व्यावसायिक प्रभाव से कम स्कोर नहीं किए गए
- शीर्ष-5 समाधान योजनाओं में विशिष्ट, टिकट-योग्य चरण हैं — "टेस्ट कवरेज सुधारें" जैसे धुँधले विवरण नहीं
- त्रैमासिक रोडमैप यथार्थवादी क्षमता आवंटित करता है — ऋण आवंटन वास्तविक स्प्रिंट बजट से ज़्यादा नहीं
- स्वीकृत/टाले गए आइटम की समीक्षा तिथि और नामित स्वामी है — कोई स्थायी रूप से टाला आइटम नहीं
- रजिस्टर ऋण (जानबूझकर या जमा शॉर्टकट) और बग (अनचाहे दोष) में भेद करता है
- आइटम सिर्फ़ तब हल चिह्नित होते हैं जब स्वीकृति मानदंड पूरे हों — PR मर्ज होने पर नहीं
एंटी-पैटर्न
- ऋण आइटम मनमाने ढंग से स्कोर न करें — प्राथमिकता स्कोर दस्तावेज़ित सूत्र से निकाले जाने चाहिए
- तकनीकी ऋण (जानबूझकर शॉर्टकट) को बग (अनचाहे दोष) से न मिलाएँ — उन्हें अलग उपचार रणनीतियाँ चाहिए
- सुरक्षा और डिपेंडेंसी आइटम को अमूर्त लगने के कारण कम न आँकें — वास्तविक व्यावसायिक प्रभाव के आधार पर स्कोर करें
- "स्थायी रूप से टाले गए" आइटम न बनाएँ — हर स्वीकृत आइटम की समीक्षा तिथि और नामित स्वामी होना चाहिए
- धुँधले विवरण वाली समाधान योजनाएँ शामिल न करें — हर योजना में विशिष्ट, टिकट-योग्य चरण होने चाहिए
उदाहरण ट्रिगर वाक्य
- "तकनीकी ऋण का ऑडिट करो।"
- "एक ऋण रजिस्टर बनाओ।"
- "एक तिमाही के लिए तकनीकी ऋण को प्राथमिकता दो।"
- "आर्किटेक्चर शॉर्टकट दस्तावेज़ित करो।"
- "ऋण कटौती रोडमैप बनाओ।"
इस स्किल को अपने ब्राउज़र में चलाएँ: https://mohitagw15856.github.io/pm-claude-skills/skill/technical-debt-register.html
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |