मुझे 30+ उपयोगी GitHub रिपॉजिटरी मिलीं और अब मैं उन्हें ट्रैक करना नहीं भूलता (Claude + Obsidian, पूर्ण गाइड)

मैं एक रिपॉजिटरी को स्टार करता हूँ, उसे क्लोन करता हूँ, आधा-अधूरा काम करवाता हूँ, और अगली समस्या पर चला जाता हूँ। तीन महीने बाद मुझे वही फ़ोल्डर फिर मिलता है और मुझे याद नहीं रहता कि मैंने इसे क्यों लिया था, क्या मैंने कभी इसका इस्तेमाल किया था, या क्या मैंने एक ही तरह के टूल को अलग-अलग नामों से दो बार क्लोन किया था। तीस से अधिक रिपॉजिटरी होने पर, यह मज़ाक नहीं रह जाता और असली समय बर्बाद करने लगता है।

एक रिपो के लिए एक README पर्याप्त क्यों नहीं है?

एक README आपको बताता है कि लेखक ने इसे किस लिए बनाया है। यह इस बारे में कुछ नहीं कहता कि आपने इसे क्यों लिया, क्या आप वास्तव में इसका उपयोग कर रहे हैं, या क्या आपके पास पहले से तीन अन्य टूल हैं जो बिल्कुल वही काम कर रहे हैं।

यही वह हिस्सा है जो कोई नहीं लिखता, क्योंकि कोई भी उन रिपॉजिटरी के लिए नहीं लिखता जो उनकी अपनी नहीं हैं। आप कुछ उपयोगी क्लोन करते हैं, उसे एक बार चलाते हैं, और जैसे ही आप टर्मिनल बंद करते हैं, इसके पीछे का कॉन्टेक्स्ट गायब हो जाता है। इसे एक ही फ़ोल्डर में 30 रिपॉजिटरी के साथ गुणा करें और आपको एक कब्रिस्तान मिलता है जिसे साफ करने से आप डरते हैं, क्योंकि आप निश्चित नहीं हैं कि क्या ज़रूरी है और क्या बेकार है।

इनमें से कुछ भी किसी एक README में नहीं दिखता। यह तभी दिखता है जब कोई चीज़ आपके द्वारा एकत्रित सभी चीज़ों को पढ़ती है, एक शेड्यूल पर, बिना आपको याद दिलाए।

आपको अंत में क्या मिलेगा?

एक वॉल्ट, दो फ़ोल्डर:

1found-tools-vault/
2├── notes/                  # आपके द्वारा लिए गए प्रत्येक रिपो के लिए एक मार्कडाउन नोट
3│   ├── some-scraper-tool.md
4│   └── ...
5└── memory/
6    └── PORTFOLIO.md         # चार क्रॉस-रिपो पास यहाँ लिखते हैं

डिस्क पर सादा मार्कडाउन। इसे Obsidian में खोलें, या टर्मिनल से cat करें। कोई डेटाबेस नहीं, ऐसा कुछ नहीं जिसे आप स्वयं नहीं पढ़ सकते।

इसे सेट करें?

Mac या Linux पर:

1mkdir -p ~/found-tools-vault/notes ~/found-tools-vault/memory

Windows पर, PowerShell:

1New-Item -ItemType Directory -Force -Path "$HOME\found-tools-vault\notes","$HOME\found-tools-vault\memory"

नीचे दिए गए Loop 1 और Loop 2 को इस फ़ोल्डर पर इंगित करें और सेटअप पूरा हो जाता है। यहाँ से आगे सब कुछ वही है जो आप Claude को इसके अंदर करने के लिए कहते हैं।

स्टैक: वही तीन टुकड़े, बस दूसरे लोगों के कोड पर इंगित किए गए?

वॉल्ट। एक Obsidian फ़ोल्डर, आपके द्वारा क्लोन किए गए प्रत्येक टूल के लिए एक नोट, साथ ही क्रॉस-रिपो पास के लिए एक फ़ोल्डर।

स्रोत। आपके क्लोन फ़ोल्डर में मौजूद हर रिपॉजिटरी, चाहे आप इसे रोज़ाना उपयोग करें या इसका अस्तित्व भूल गए हों।

दिमाग। Claude, काम के अनुसार विभाजित। सस्ता मॉडल रिपॉजिटरी और उसका README पढ़ता है। Sonnet निर्णय लेता है: क्या यह आपके द्वारा पहले से लिए गए किसी अन्य टूल की डुप्लिकेट है, और क्या यह वास्तव में डिस्क स्पेस के लायक है।

Loop 1: प्रति टूल एक नोट, जो Claude द्वारा लिखा गया है, आपके द्वारा नहीं?

महत्वपूर्ण, इसे किसी वास्तविक चीज़ पर चलाने से पहले:

• इस लूप को कभी भी कोड पुश न करने दें, डिपेंडेंसी इंस्टॉल न करने दें, या टूल से कुछ भी न चलाने दें। हमेशा केवल-पढ़ने के लिए।
• why_i_grabbed_it को आपके अपने नोट्स, कमिट्स, या आपके प्रोजेक्ट्स में अन्यत्र उपयोग से भरा जाता है, न कि रिपॉजिटरी के अपने README से अनुमान लगाकर।
• यदि आप यह नहीं बता सकते कि आप किसी टूल का उपयोग कर रहे हैं, तो नोट को status: unclear के साथ लिखें, न कि इसे छोड़ें।

1ट्रिगर:   नया रिपो फ़ोल्डर में क्लोन किया गया, या दिन में एक बार
2चरण:
3  1. रिपॉजिटरी पढ़ें: README, package.json / requirements.txt, अंतिम
4     अपस्ट्रीम कमिट की तारीख, और जाँचें कि क्या यह आपके अन्य
5     प्रोजेक्ट्स में कहीं संदर्भित है (imports, configs, scripts)
6  2. notes/<repo-name>.md लिखें या अपडेट करें:
7       ---
8       repo:
9       what_it_does:
10       why_i_grabbed_it:
11       last_upstream_commit:
12       referenced_in_my_projects: []
13       status: in-use | shelved | duplicate | unclear
14       ---
15       ## यह वास्तव में क्या करता है
16       ## मैंने इसे क्यों लिया
17       ## क्या मैं वास्तव में इसका उपयोग कर रहा हूँ
18सत्यापित करें:    हर फ़ील्ड भरा हुआ है, "referenced_in_my_projects" को वास्तविक
19           उपयोग के आधार पर जाँचा गया है, अनुमानों से नहीं
20रोकें:      सत्यापन पास हो, या 2 पुनः प्रयास, फिर मैन्युअल समीक्षा के लिए चिह्नित करें

यह अकेला Loop 2 के बिना भी बनाने लायक है। पहली बार जब आप इनमें से 30 को एक साथ पढ़ते हैं, तो उनमें से आधे आपको आश्चर्यचकित करेंगे, या तो इसलिए कि आप भूल गए थे कि आप टूल का उपयोग कर रहे थे, या इसलिए कि आपने कभी उपयोग नहीं किया था।

एक जनरेटेड टूल नोट, उस वास्तविक क्लोन किए गए फ़ोल्डर के बगल में जिसका वह वर्णन करता है। यह वह कॉन्टेक्स्ट है जिसे आप अन्यथा कभी नहीं लिखेंगे।

एक बार Loop 1 चलने के बाद 30 फ़ाउंड रिपॉजिटरी वास्तव में कैसी दिखती हैं?

एक सूची जिसे Claude हर बार जब आप कुछ नया क्लोन करते हैं, तब पुनर्जीवित करता है, सीधे नोट्स से लिया गया:

• github.com/author/scrape-lite - उपयोग में, अंतिम अपस्ट्रीम कमिट 2 दिन पहले, संदर्भित: feed-reader प्रोजेक्ट में
• github.com/author/tg-bot-kit - उपयोग में, अंतिम अपस्ट्रीम कमिट 5 दिन पहले, संदर्भित: मेरे दो बॉट्स में
• github.com/author/quick-scheduler - अलग रखा हुआ, अंतिम अपस्ट्रीम कमिट 41 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/api-wrapper-x - उपयोग में, अंतिम अपस्ट्रीम कमिट 1 दिन पहले, संदर्भित: एक प्रोजेक्ट में
• github.com/author/rss-to-json - डुप्लिकेट, अंतिम अपस्ट्रीम कमिट 3 दिन पहले, संदर्भित: कोई नहीं (scrape-lite के समान काम)
• github.com/author/cheap-queue - उपयोग में, अंतिम अपस्ट्रीम कमिट 6 घंटे पहले, संदर्भित: दो प्रोजेक्ट्स में
• github.com/author/webhook-relay-lib - अलग रखा हुआ, अंतिम अपस्ट्रीम कमिट 96 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/simple-cache - उपयोग में, अंतिम अपस्ट्रीम कमिट 2 दिन पहले, संदर्भित: तीन प्रोजेक्ट्स में
• github.com/author/old-scraper - अपस्ट्रीम द्वारा छोड़ा गया, अंतिम अपस्ट्रीम कमिट 340 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/notify-me - अस्पष्ट, अंतिम अपस्ट्रीम कमिट 12 दिन पहले, संदर्भित: निश्चित नहीं
• github.com/author/token-utils - उपयोग में, अंतिम अपस्ट्रीम कमिट 1 दिन पहले, संदर्भित: एक प्रोजेक्ट में
• github.com/author/quick-parser - डुप्लिकेट, अंतिम अपस्ट्रीम कमिट 8 दिन पहले, संदर्भित: कोई नहीं (rss-to-json के समान काम)
• github.com/author/tiny-orm - अलग रखा हुआ, अंतिम अपस्ट्रीम कमिट 55 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/rate-limiter - उपयोग में, अंतिम अपस्ट्रीम कमिट 3 दिन पहले, संदर्भित: दो प्रोजेक्ट्स में
• github.com/author/config-loader - उपयोग में, अंतिम अपस्ट्रीम कमिट 4 दिन पहले, संदर्भित: मेरे अधिकांश प्रोजेक्ट्स में
• github.com/author/legacy-fetch - अपस्ट्रीम द्वारा छोड़ा गया, अंतिम अपस्ट्रीम कमिट 400+ दिन पहले, संदर्भित: कोई नहीं
• github.com/author/env-check - उपयोग में, अंतिम अपस्ट्रीम कमिट 9 दिन पहले, संदर्भित: एक प्रोजेक्ट में
• github.com/author/pretty-logs - अलग रखा हुआ, अंतिम अपस्ट्रीम कमिट 70 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/proxy-list - अस्पष्ट, अंतिम अपस्ट्रीम कमिट 20 दिन पहले, संदर्भित: निश्चित नहीं
• github.com/author/backoff-lib - उपयोग में, अंतिम अपस्ट्रीम कमिट 6 दिन पहले, संदर्भित: दो प्रोजेक्ट्स में
• github.com/author/dead-simple-db - अलग रखा हुआ, अंतिम अपस्ट्रीम कमिट 88 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/quick-hash - उपयोग में, अंतिम अपस्ट्रीम कमिट 1 दिन पहले, संदर्भित: एक प्रोजेक्ट में
• github.com/author/retry-wrapper - डुप्लिकेट, अंतिम अपस्ट्रीम कमिट 14 दिन पहले, संदर्भित: कोई नहीं (backoff-lib के समान काम)
• github.com/author/format-time - उपयोग में, अंतिम अपस्ट्रीम कमिट 2 दिन पहले, संदर्भित: मेरे अधिकांश प्रोजेक्ट्स में
• github.com/author/quick-mailer - अलग रखा हुआ, अंतिम अपस्ट्रीम कमिट 50 दिन पहले, संदर्भित: कोई नहीं
• github.com/author/health-check-lib - उपयोग में, अंतिम अपस्ट्रीम कमिट 5 दिन पहले, संदर्भित: दो प्रोजेक्ट्स में
• github.com/author/dotenv-plus - उपयोग में, अंतिम अपस्ट्रीम कमिट 3 दिन पहले, संदर्भित: मेरे अधिकांश प्रोजेक्ट्स में
• github.com/author/simple-lock - अस्पष्ट, अंतिम अपस्ट्रीम कमिट 30 दिन पहले, संदर्भित: निश्चित नहीं
• github.com/author/old-notify - अपस्ट्रीम द्वारा छोड़ा गया, अंतिम अपस्ट्रीम कमिट 500+ दिन पहले, संदर्भित: कोई नहीं
• github.com/author/tiny-scheduler - डुप्लिकेट, अंतिम अपस्ट्रीम कमिट 18 दिन पहले, संदर्भित: कोई नहीं (quick-scheduler के समान काम)

(ऊपर के नाम प्लेसहोल्डर हैं, सूची के आकार को दर्शाने के लिए, वास्तविक टूल नहीं)

तीस पंक्तियाँ मैन्युअल रूप से पढ़ने के लिए कुछ नहीं हैं। यह ध्यान देने के लिए भी पर्याप्त है कि आपके पास तीन अलग-अलग retry-लॉजिक लाइब्रेरी हैं जो एक ही काम कर रही हैं, और जिन रिपॉजिटरी पर आप वास्तव में निर्भर हैं, उनमें से एक का अपस्ट्रीम कमिट एक साल से अधिक पुराना है।

एक बार सभी 30 नोट्स मौजूद होने के बाद वॉल्ट का ग्राफ़ दृश्य: प्रत्येक टूल एक नोड के रूप में, डुप्लिकेट और साझा उद्देश्य वाली रिपॉजिटरी दृश्यमान क्लस्टर में खींची गई।

Loop 2: वे पास जो केवल तब काम करते हैं जब आपने 30+ टूल एकत्र कर लिए हों?

एक एकल टूल का README आपको यह नहीं बता सकता। केवल वही चीज़ जो आपके द्वारा ली गई सभी चीज़ों को पढ़ती है, यह बता सकती है।

1ट्रिगर:   हर 12 घंटे
2चरण:
3  पास 1, वास्तव में अलग रखा गया:
4    किसी भी रिपो को फ़्लैग करें जिसकी status: in-use है लेकिन आपके
5    किसी भी प्रोजेक्ट में 30+ दिनों से संदर्भित नहीं है, अपने स्वयं के
6    रिपॉजिटरी में वास्तविक उपयोग के लिए क्रॉस-चेक करें, अनुमानों से नहीं
7  पास 2, डुप्लिकेट टूल:
8    सभी नोट्स में "यह वास्तव में क्या करता है" की तुलना करें, समान समस्या
9    हल करने वाली किसी भी चीज़ को समूहित करें, मिलान फ़ंक्शन नामों या
10    मिलान उद्देश्य से पुष्टि की गई, न कि केवल समान-ध्वनि वाले विवरण
11  पास 3, अपस्ट्रीम जोखिम:
12    किसी भी टूल को फ़्लैग करें जिस पर आप निर्भर हैं और जहाँ अंतिम अपस्ट्रीम
13    कमिट 120+ दिन पुराना है, ताकि आप जान सकें कि कौन सी डिपेंडेंसी बिना
14    चेतावनी के पुरानी हो सकती है
15  पास 4, ईमानदार पढ़ाई:
16    प्रति टूल एक पंक्ति कि क्या यह डिस्क स्पेस और इसे याद रखने के मानसिक
17    बोझ के लायक है, कोई नरमी नहीं
18सत्यापित करें:    प्रत्येक पास memory/PORTFOLIO.md में लिखता है, पास 2 के समूह
19           एक वास्तविक साझा फ़ंक्शन या उद्देश्य मिलान द्वारा समर्थित हैं
20रोकें:      सभी चार पास पूरे होते हैं, या एक पास विफल होता है और लॉग किया जाता है,
21           कभी चुपचाप नहीं छोड़ा जाता

पास 3 वह है जो वास्तव में आपके काम करने के तरीके को बदलता है। आपको तब तक एहसास नहीं होता कि आप तीन ऐसे टूल पर निर्भर हैं जिनके मेंटेनर एक साल पहले चुप हो गए थे, जब तक कि यह आपके सामने एक सूची में न हो।

पास 3 से उत्पन्न एक जोखिम तालिका: आपके द्वारा वास्तव में उपयोग किए जा रहे टूल, उनके अपस्ट्रीम प्रोजेक्ट के अंतिम बार चलने के समय के अनुसार क्रमबद्ध।

पहले मैन्युअल संस्करण आज़माएँ?

हमेशा एक ही नियम। किसी भी चीज़ को शेड्यूल न करें जिसे आपने हाथ से साबित नहीं किया है।

1आप एक लूप में तब तक काम करेंगे जब तक कार्य मानक को पूरा न कर ले।
2
3कार्य:
4[path] में हर रिपॉजिटरी फ़ोल्डर पढ़ें। प्रत्येक के लिए, नोट करें कि वह क्या करता है,
5आपने मूल रूप से इसे क्यों लिया, क्या आप अभी भी वास्तव में इसका उपयोग कर रहे हैं,
6और अपस्ट्रीम प्रोजेक्ट में अंतिम कमिट कितने समय पहले हुआ था। फिर सभी
7रिपॉजिटरी में तुलना करें: डुप्लिकेट खोजें और ऐसी कोई भी चीज़ जिस पर आप निर्भर हैं
8और जो अपस्ट्रीम में शांत हो गई है।
9
10सफलता मानदंड (सख्त, कोई नरम पास नहीं):
11- प्रत्येक "डुप्लिकेट" एक वास्तविक मिलान फ़ंक्शन या उद्देश्य द्वारा समर्थित है,
12  न कि समान-ध्वनि वाले विवरणों से
13- प्रत्येक "अलग रखा गया" रिपो में आपके अपने प्रोजेक्ट्स में कहीं भी अंतिम
14  बार संदर्भित किए जाने के बाद के दिन शामिल हैं
15- अपस्ट्रीम जोखिम वास्तविक कमिट तिथियों पर आधारित है, अनुमानों पर नहीं
16
17लूप प्रोटोकॉल, प्रत्येक बार दोहराएँ:
181. योजना बनाएँ   - एक अगला कदम बताएँ
192. करें     - आउटपुट उत्पन्न करें या सुधारें
203. सत्यापित करें - प्रत्येक मानदंड पर 1-10 का स्कोर दें, बेहद ईमानदार रहें
214. निर्णय लें - यदि प्रत्येक मानदंड 8+ है, तो "FINAL" प्रिंट करें और रुकें
22
23नियम:
24- जब तक प्रत्येक मानदंड 8+ न हो, तब तक इसे पूर्ण न कहें
25- मुझसे प्रश्न न पूछें, एक समझदार अनुमान लगाएँ और जारी रखें
26
27शुरू करें। लूप को FINAL तक चलाएँ।

यदि डुप्लिकेट सूची या अपस्ट्रीम-जोखिम सूची आपको आश्चर्यचकित करती है, तो यह एक शेड्यूल की हकदार है। यदि यह केवल उसकी पुष्टि करती है जो आप पहले से जानते थे, तो इसे अभी तक स्वचालित न करें।

वह क्रम जो वास्तव में काम करता है?

Loop 1 को तब तक चलाएँ जब तक कि प्रत्येक क्लोन किए गए रिपॉजिटरी के पास एक वास्तविक नोट न हो, न कि एक प्लेसहोल्डर।

इसे एक या दो सप्ताह के लिए छोड़ दें। अब से आपके द्वारा लिया गया हर नया टूल स्वचालित रूप से एक नोट प्राप्त करता है।

तभी Loop 2 चालू करें। डुप्लिकेट और अपस्ट्रीम-जोखिम पास को पर्याप्त नोट्स की आवश्यकता होती है ताकि वे वास्तव में टकरा सकें।

इसे अंत में शेड्यूल करें, जब आपने इसे कम से कम दो बार हाथ से साफ चलते देखा हो।

इसकी लागत क्या है?

Loop 1 प्रति नए क्लोन पर चलता है, इसलिए यह इस बात पर निर्भर करता है कि आप वास्तव में कितना लेते हैं, एक निश्चित शेड्यूल पर नहीं। अधिकांश सप्ताहों में यह मुट्ठी भर सस्ते-मॉडल कॉल होते हैं।

Loop 2 दिन में दो बार 30+ नोट्स पर चलता है। पास 1 और पास 3 को सस्ते मॉडल पर ले जाएँ, वे लुकअप हैं, निर्णय कॉल नहीं। पास 2 और पास 4 को Sonnet पर रखें, क्योंकि एक वास्तविक डुप्लिकेट को पहचानना और एक ईमानदार पढ़ाई देना दोनों के लिए एक ऐसे मॉडल की आवश्यकता होती है जो वास्तव में तर्क कर सके कि वह क्या तुलना कर रहा है। इस तरह विभाजित करने पर, 30-रिपो संग्रह पर दिन में दो बार चलाने की लागत उस समय से कम है जो आप वही ऑडिट हाथ से करने में खर्च करेंगे।

एक बात याद रखने वाली?

एक README आपको बताता है कि एक टूल क्या करता है। यह आपको बताता है कि आपके द्वारा पाए गए 30 टूल में से कौन से आप वास्तव में उपयोग कर रहे हैं, कौन से चुपचाप एक-दूसरे की डुप्लिकेट कर रहे हैं, और कौन से आप पर निर्भर हैं जिन्हें कोई और मेंटेन नहीं कर रहा है।

मूल्य कभी भी किसी एकल टूल नोट में नहीं था। यह इस तथ्य में है कि आपके द्वारा एकत्रित की गई कोई भी चीज़ चुपचाप सड़ नहीं सकती, चुपचाप डुप्लिकेट नहीं हो सकती, या चुपचाप अप्रबंधित नहीं हो सकती, बिना किसी चीज़ के इसे लिखे जहाँ आप वास्तव में इसे देखेंगे।

पहले Loop 1 बनाएँ। इसे Loop 2 को छूने से पहले दो या तीन सप्ताह तक चलने दें। डुप्लिकेट और अपस्ट्रीम-जोखिम पास पाँच रिपॉजिटरी के साथ बेकार हैं। वे कहीं बीस से अधिक होने पर अपने लिए भुगतान करना शुरू करते हैं।

यदि आप इस तरह के और अधिक ब्रेकडाउन चाहते हैं, तो मैं हर कुछ दिनों में Telegram और X पर एक पोस्ट करता हूँ। दोनों मुफ्त।

X - https://x.com/gippp69

Telegram - https://t.me/GipArcAI