30'dan fazla faydalı GitHub reposu buldum ve onları kaybetmeyi bıraktım (Claude + Obsidian, Tam Kılavuz)

Bir repoyu yıldızlarım, klonlarım, yarı yarıya çalışır hale getiririm ve sonraki soruna geçerim. Üç ay sonra aynı klasörü tekrar bulurum ve neden aldığımı, gerçekten kullanıp kullanmadığımı ya da aynı tür aracı farklı bir isimle iki kez klonlayıp klonlamadığımı hatırlayamam. Otuzun üzerinde repoya ulaştığında, bu artık şaka olmaktan çıkar ve gerçek zaman kaybına dönüşür.

Repo başına bir README neden yeterli değil?

Bir README, yazarın onu ne için yaptığını söyler. Ama neden senin aldığın, gerçekten kullanıp kullanmadığın ya da zaten aynı işi yapan üç farklı aracın olup olmadığı hakkında hiçbir şey söylemez.

İşte kimsenin yazmadığı kısım bu, çünkü kimse kendine ait olmayan repolar için bunu yazmaz. Kullanışlı bir şeyi klonlarsın, bir kere çalıştırırsın ve terminali kapattığın an neden aldığının bağlamı kaybolur. Bunu aynı klasörde oturan 30 repoyla çarptığında, temizlemeye korktuğun bir mezarlık elde edersin, çünkü hangisinin yük taşıdığından, hangisinin ölü ağırlık olduğundan emin olamazsın.

Bunların hiçbiri tek bir README'de görünmez. Sadece, sen hatırlamadan, düzenli olarak, topladığın her şeyi okuyan bir şey olduğunda ortaya çıkar.

Elinizde ne olacak?

Bir kasa, iki klasör:

1found-tools-vault/
2├── notes/                  # aldığınız her repo için bir markdown notu
3│   ├── some-scraper-tool.md
4│   ├── some-telegram-lib.md
5│   └── ...
6└── memory/
7    └── PORTFOLIO.md         # dört repolar arası geçiş buraya yazılır

Diskte düz markdown. Obsidian'da açın veya terminalden cat ile görüntüleyin. Veritabanı yok, kendinizin okuyamayacağı hiçbir şey yok.

Nasıl kurulur?

Mac veya Linux'ta:

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

Windows'ta, PowerShell:

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

Aşağıdaki Döngü 1 ve Döngü 2'yi bu klasöre yönlendirin ve kurulum tamamlanmıştır. Buradan sonrası, Claude'a bu klasörün içinde ne yapmasını söylediğinizdir.

Yığın: aynı üç parça, sadece başkalarının koduna mı yönlendirilmiş?

Kasa. Bir Obsidian klasörü, klonladığınız her araç için bir not, artı repolar arası geçişler için bir klasör.

Kaynak. Klon klasörünüzdeki her repo, ister her gün kullanın ister varlığını unutun.

Beyin. İşe göre bölünmüş Claude. Ucuz model, repoyu ve README'sini okur. Sonnet karar verme işini yapar: bu, zaten aldığın başka bir şeyin kopyası mı ve gerçekten disk alanına değer mi?

Döngü 1: Claude tarafından yazılan, senin tarafından değil, her araç için bir not?

Önemli, bunu gerçek bir şey üzerinde çalıştırmadan önce:

• Bu döngünün asla kod göndermesine, bağımlılık yüklemesine veya aracın kendisinden herhangi bir şey çalıştırmasına izin vermeyin. Her zaman salt okunur.
• why_i_grabbed_it alanı, reponun kendi README'sinden tahmin edilerek değil, kendi notlarınızdan, commit'lerinizden veya projelerinizdeki diğer kullanımlardan doldurulur.
• Bir aracı kullanıp kullanmadığınızı anlayamıyorsanız, atlamak yerine notu status: unclear ile yazın.

1TETİKLEYİCİ:   klasöre yeni repo klonlandığında veya günde bir kez
2ADIMLAR:
3  1. Repoyu oku: README, package.json / requirements.txt, son
4     upstream commit tarihi ve diğer projelerinizde herhangi bir
5     yerde referans verilip verilmediğini kontrol edin (import'lar, config'ler, script'ler)
6  2. notes/<repo-name>.md dosyasını şununla yaz veya güncelle:
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       ## Gerçekte ne yapıyor
16       ## Neden aldım
17       ## Gerçekten kullanıyor muyum
18DOĞRULA:    her alan doldurulmuş, "referenced_in_my_projects" gerçek
19           kullanıma göre kontrol edilmiş, varsayılmamış
20DUR:        doğrulama geçtiğinde veya 2 denemede, ardından manuel inceleme için işaretle

Bu tek başına, Döngü 2 olmasa bile kurmaya değer. Bunlardan 30 tanesini arka arkaya ilk okuduğunuzda, yarısı sizi şaşırtacak, ya aracı kullandığınızı unuttuğunuz için ya da hiç kullanmadığınız için.

Tanımladığı gerçek klonlanmış klasörün yanında, oluşturulmuş bir araç notu. Bu, aksi halde asla yazmayacağınız bağlamdır.

Döngü 1 çalıştıktan sonra 30 bulunan repo gerçekte neye benziyor?

Claude'ın her yeni bir şey klonladığınızda, notlardan çekerek yeniden oluşturduğu bir liste:

• github.com/author/scrape-lite - kullanımda, son upstream commit 2 gün önce, referans: feed-reader projesi
• github.com/author/tg-bot-kit - kullanımda, son upstream commit 5 gün önce, referans: iki botumda
• github.com/author/quick-scheduler - rafa kaldırıldı, son upstream commit 41 gün önce, referans: yok
• github.com/author/api-wrapper-x - kullanımda, son upstream commit 1 gün önce, referans: bir projede
• github.com/author/rss-to-json - kopya, son upstream commit 3 gün önce, referans: yok (scrape-lite ile aynı iş)
• github.com/author/cheap-queue - kullanımda, son upstream commit 6 saat önce, referans: iki projede
• github.com/author/webhook-relay-lib - rafa kaldırıldı, son upstream commit 96 gün önce, referans: yok
• github.com/author/simple-cache - kullanımda, son upstream commit 2 gün önce, referans: üç projede
• github.com/author/old-scraper - upstream terk edildi, son upstream commit 340 gün önce, referans: yok
• github.com/author/notify-me - belirsiz, son upstream commit 12 gün önce, referans: emin değilim
• github.com/author/token-utils - kullanımda, son upstream commit 1 gün önce, referans: bir projede
• github.com/author/quick-parser - kopya, son upstream commit 8 gün önce, referans: yok (rss-to-json ile aynı iş)
• github.com/author/tiny-orm - rafa kaldırıldı, son upstream commit 55 gün önce, referans: yok
• github.com/author/rate-limiter - kullanımda, son upstream commit 3 gün önce, referans: iki projede
• github.com/author/config-loader - kullanımda, son upstream commit 4 gün önce, referans: projelerimin çoğunda
• github.com/author/legacy-fetch - upstream terk edildi, son upstream commit 400+ gün önce, referans: yok
• github.com/author/env-check - kullanımda, son upstream commit 9 gün önce, referans: bir projede
• github.com/author/pretty-logs - rafa kaldırıldı, son upstream commit 70 gün önce, referans: yok
• github.com/author/proxy-list - belirsiz, son upstream commit 20 gün önce, referans: emin değilim
• github.com/author/backoff-lib - kullanımda, son upstream commit 6 gün önce, referans: iki projede
• github.com/author/dead-simple-db - rafa kaldırıldı, son upstream commit 88 gün önce, referans: yok
• github.com/author/quick-hash - kullanımda, son upstream commit 1 gün önce, referans: bir projede
• github.com/author/retry-wrapper - kopya, son upstream commit 14 gün önce, referans: yok (backoff-lib ile aynı iş)
• github.com/author/format-time - kullanımda, son upstream commit 2 gün önce, referans: projelerimin çoğunda
• github.com/author/quick-mailer - rafa kaldırıldı, son upstream commit 50 gün önce, referans: yok
• github.com/author/health-check-lib - kullanımda, son upstream commit 5 gün önce, referans: iki projede
• github.com/author/dotenv-plus - kullanımda, son upstream commit 3 gün önce, referans: projelerimin çoğunda
• github.com/author/simple-lock - belirsiz, son upstream commit 30 gün önce, referans: emin değilim
• github.com/author/old-notify - upstream terk edildi, son upstream commit 500+ gün önce, referans: yok
• github.com/author/tiny-scheduler - kopya, son upstream commit 18 gün önce, referans: yok (quick-scheduler ile aynı iş)

(yukarıdaki isimler yer tutucudur, listenin şeklini gösterir, gerçek araçları değil)

Otuz satırı manuel olarak okumak hiçbir şeydir. Aynı zamanda, aynı işi yapan üç ayrı yeniden deneme mantığı kütüphanesine sahip olduğunuzu ve gerçekten bağımlı olduğunuz repolardan birinin bir yıldan uzun süredir upstream commit'i almadığını fark etmek için de yeterlidir.

30 notun tümü mevcut olduğunda kasanın grafik görünümü: her araç bir düğüm, kopyalar ve ortak amaçlı repolar görünür kümeler halinde çekilir.

Döngü 2: Yalnızca 30'dan fazla araç topladıktan sonra çalışan geçişler?

Tek bir aracın README'si size bunu söyleyemez. Bunu ancak aldığınız her şeyi okuyan bir şey söyleyebilir.

1TETİKLEYİCİ:   her 12 saatte bir
2ADIMLAR:
3  Geçiş 1, gerçekten rafa kaldırıldı:
4    status: in-use olan ancak 30+ gündür projelerinizin hiçbirinde
5    referans verilmeyen herhangi bir repoyu işaretleyin, gerçek kullanım
6    için kendi repolarınızla çapraz kontrol edin, varsayımlarla değil
7  Geçiş 2, kopya araçlar:
8    tüm notlarda "gerçekte ne yaptığını" karşılaştırın, aynı sorunu
9    çözen her şeyi gruplayın, eşleşen fonksiyon adları veya eşleşen
10    amaç ile onaylanmış, sadece benzer sesli açıklamalar değil
11  Geçiş 3, upstream riski:
12    bağımlı olduğunuz ve son upstream commit'in 120+ gün önce olduğu
13    herhangi bir aracı işaretleyin, böylece hangi bağımlılıkların
14    uyarı vermeden bayatlayabileceğini bilirsiniz
15  Geçiş 4, dürüst okuma:
16    her araç için disk alanına ve varlığını hatırlamanın zihinsel
17    yüküne değip değmediğine dair bir satır, yumuşatma yok
18DOĞRULA:    her geçiş memory/PORTFOLIO.md'ye yazar, Geçiş 2'nin
19           gruplandırmaları gerçek bir paylaşılan fonksiyon veya amaç
20           eşleşmesi ile desteklenir
21DUR:        dört geçişin tümü tamamlandığında veya bir geçiş başarısız
22           olup günlüğe kaydedildiğinde, asla sessizce atlanmaz

Geçiş 3, iş yapış şeklinizi gerçekten değiştirendir. Bakımcıları bir yıl önce sessizliğe gömülen üç araca bağımlı olduğunuzu, önünüzdeki bir listede oturana kadar fark etmezsiniz.

Geçiş 3'ten oluşturulmuş bir risk tablosu: gerçekten kullandığınız araçlar, upstream projelerinin en son ne zaman hareket ettiğine göre sıralanmış.

Önce manuel sürümü dene?

Her zamanki kural. Elle kanıtlamadığın hiçbir şeyi zamanlama.

1Görev çıtayı karşılayana kadar bir döngü içinde çalışacaksınız.
2
3GÖREV:
4[path] içindeki her repo klasörünü okuyun. Her biri için, ne yaptığını,
5onu neden aldığınızı, hala gerçekten kullanıp kullanmadığınızı ve
6upstream projesinin en son ne zaman commit yaptığını not edin. Ardından
7tüm repolar arasında karşılaştırma yapın: kopyaları ve bağımlı olduğunuz
8ancak upstream'in sessiz kaldığı her şeyi bulun.
9
10BAŞARI KRİTERLERİ (katı, yumuşak geçiş yok):
11- her "kopya", benzer sesli açıklamalarla değil, gerçek bir eşleşen
12  fonksiyon veya amaç ile desteklenir
13- her "rafa kaldırılmış" repo, kendi projelerinizde en son ne zaman
14  referans verildiğine dair gün sayısını içerir
15- upstream riski, varsayımlara değil, gerçek commit tarihlerine dayanır
16
17DÖNGÜ PROTOKOLÜ, her turda tekrarla:
181. PLANLA   - sonraki tek adımı belirtin
192. YAP      - çıktıyı üretin veya iyileştirin
203. DOĞRULA  - her kriteri 1-10 arası puanlayın, acımasızca dürüst olun
214. KARAR VER - her kriter 8+ ise, "FINAL" yazdırın ve durun
22
23KURALLAR:
24- Her kriter 8+ olana kadar asla bitmiş saymayın
25- Bana soru sormayın, mantıklı bir varsayım yapın ve devam edin
26
27Başlayın. FINAL olana kadar döngüyü çalıştırın.

Kopya listesi veya upstream-risk listesi sizi şaşırtırsa, bir zamanlama hak eder. Sadece zaten bildiklerinizi onaylıyorsa, henüz otomatikleştirmeyin.

Gerçekten işe yarayan sıra?

Döngü 1'i, klonlanmış her reponun bir yer tutucu değil, gerçek bir notu olana kadar çalıştırın.

Bir veya iki hafta bekletin. O andan itibaren aldığınız her yeni araç otomatik olarak bir not alır.

Ancak o zaman Döngü 2'yi açın. Kopya ve upstream-risk geçişlerinin gerçekten çarpışması için yeterli nota ihtiyacı vardır.

En son zamanlayın, elle en az iki kez temiz çalıştığını izledikten sonra.

Maliyeti nedir?

Döngü 1, her yeni klon başına çalışır, bu nedenle sabit bir programla değil, gerçekte ne kadar aldığınıza göre ölçeklenir. Çoğu hafta bu, bir avuç ucuz model çağrısıdır.

Döngü 2, 30'dan fazla not arasında günde iki kez çalışır. Geçiş 1 ve Geçiş 3'ü ucuz modele taşıyın, bunlar arama, karar verme değil. Geçiş 2 ve Geçiş 4'ü Sonnet'te tutun, çünkü gerçek bir kopyayı tespit etmek ve dürüst bir okuma yapmak, karşılaştırdığı şey hakkında gerçekten akıl yürütebilen bir model gerektirir. Bu şekilde bölündüğünde, 30 repoluk bir koleksiyonda günde iki çalıştırma, aynı denetimi elle bir kez yapmak için harcayacağınız zamandan daha azına mal olur.

Hatırlanması gereken bir şey?

Bir README size bir aracın ne yaptığını söyler. Bu size, bulduğunuz 30 araçtan hangilerini gerçekten kullandığınızı, hangilerinin sessizce birbirini kopyaladığını ve hangilerine bağımlı olduğunuzu ancak artık kimsenin bakımını yapmadığını söyler.

Değer, hiçbir zaman tek bir araç notunda değildi. Önemli olan, topladığınız hiçbir şeyin, onu gerçekten göreceğiniz bir yere yazılmadan sessizce çürüyememesi, sessizce kopyalanamaması veya sessizce bakımsız kalamamasıdır.

Önce Döngü 1'i kurun. Döngü 2'ye dokunmadan önce iki veya üç hafta çalışmasına izin verin. Kopya ve upstream-risk geçişleri beş repoyla işe yaramaz. Yirmiyi geçtikten sonra kendilerini amorti etmeye başlarlar.

Bunun gibi daha fazla detaylı analiz isterseniz, her iki günde bir Telegram ve X'te yayınlıyorum. İkisi de ücretsiz.

X - https://x.com/gippp69

Telegram - https://t.me/GipArcAI