J'ai trouvé plus de 30 dépôts GitHub utiles et j'ai arrêté de les perdre de vue (Claude + Obsidian, guide complet)

Je starre un repo, je le clone, je le fais fonctionner à moitié, et je passe au problème suivant. Trois mois plus tard, je retrouve le même dossier sans me souvenir pourquoi je l'ai récupéré, si je l'ai vraiment utilisé un jour, ou si j'ai cloné le même outil deux fois sous un nom différent. Passé la trentaine de repos, ça cesse d'être une blague et ça commence à coûter du temps.

Pourquoi un README par repo ne suffit pas ?

Un README vous dit ce que l'auteur a construit. Il ne dit rien sur pourquoi vous l'avez récupéré, si vous l'utilisez réellement, ou si vous avez déjà trois autres outils qui font exactement la même chose.

C'est la partie que personne n'écrit, parce que personne ne l'écrit pour des repos qui ne sont pas les siens. Vous clonez un outil utile, vous le faites tourner une fois, et le contexte du pourquoi disparaît dès que vous fermez le terminal. Multipliez ça par 30 repos qui traînent dans le même dossier et vous obtenez un cimetière que vous n'osez pas nettoyer, parce que vous n'êtes pas sûr de ce qui est essentiel et de ce qui est du poids mort.

Rien de tout ça n'apparaît dans un seul README. Ça n'apparaît que quand quelque chose lit à travers tout ce que vous avez collecté, sur un rythme régulier, sans que vous ayez à penser à vérifier.

Ce que vous obtiendrez au final ?

Un coffre, deux dossiers :

1found-tools-vault/
2├── notes/                  # une note markdown par repo récupéré
3│   ├── some-scraper-tool.md
4│   ├── some-telegram-lib.md
5│   └── ...
6└── memory/
7    └── PORTFOLIO.md         # les quatre passes inter-repos écrivent ici

Du markdown brut sur le disque. Ouvrez-le dans Obsidian, ou affichez-le depuis le terminal. Pas de base de données, rien que vous ne puissiez lire vous-même.

Comment le mettre en place ?

Sur Mac ou Linux :

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

Sur Windows, PowerShell :

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

Pointez la Boucle 1 et la Boucle 2, ci-dessous, vers ce dossier et l'installation est terminée. Tout ce qui suit est ce que vous dites à Claude de faire à l'intérieur.

La stack : les trois mêmes pièces, juste pointées vers le code des autres ?

Le coffre. Un dossier Obsidian, une note par outil que vous avez cloné, plus un dossier pour les passes inter-repos.

La source. Chaque repo qui traîne dans votre dossier de clones, que vous l'utilisiez tous les jours ou que vous ayez oublié son existence.

Le cerveau. Claude, réparti par tâche. Un modèle bon marché lit le repo et son README. Sonnet fait les jugements : est-ce un doublon de quelque chose que vous avez déjà récupéré, et est-ce que ça vaut vraiment la place sur le disque.

Boucle 1 : une note par outil, écrite par Claude, pas par vous ?

Important, avant d'exécuter ceci sur quelque chose de réel :

• Ne laissez jamais cette boucle pousser du code, installer des dépendances ou exécuter quoi que ce soit provenant de l'outil lui-même. Toujours en lecture seule.
• why_i_grabbed_it est rempli à partir de vos propres notes, commits ou utilisations ailleurs dans vos projets, pas deviné à partir du README du repo.
• Si vous ne pouvez pas dire si vous utilisez un outil, écrivez la note avec le statut unclear au lieu de la sauter.

1DÉCLENCHEUR : nouveau repo cloné dans le dossier, ou une fois par jour
2ÉTAPES :
3  1. Lire le repo : README, package.json / requirements.txt, date
4     du dernier commit en amont, et vérifier s'il est référencé
5     quelque part dans vos autres projets (imports, configs, scripts)
6  2. Écrire ou mettre à jour notes/<nom-du-repo>.md avec :
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       ## Ce qu'il fait vraiment
16       ## Pourquoi je l'ai récupéré
17       ## Est-ce que je l'utilise vraiment
18VÉRIFIER : chaque champ rempli, "referenced_in_my_projects" vérifié
19           par rapport à une utilisation réelle, pas supposée
20ARRÊT : vérification réussie, ou 2 tentatives, puis signaler pour
21         révision manuelle

Cela vaut déjà le coup d'être construit même sans la Boucle 2. La première fois que vous lisez 30 de ces notes à la suite, la moitié d'entre elles vous surprendront, soit parce que vous avez oublié que vous utilisiez l'outil, soit parce que vous ne l'avez jamais fait.

Une note d'outil générée, à côté du dossier cloné réel qu'elle décrit. C'est le contexte que vous n'écririez jamais autrement.

À quoi ressemblent 30 repos trouvés une fois la Boucle 1 exécutée ?

Une liste que Claude régénère à chaque fois que vous clonez quelque chose de nouveau, extraite directement des notes :

• github.com/author/scrape-lite - en cours d'utilisation, dernier commit amont il y a 2 jours, référencé dans : projet feed-reader
• github.com/author/tg-bot-kit - en cours d'utilisation, dernier commit amont il y a 5 jours, référencé dans : deux de mes bots
• github.com/author/quick-scheduler - mis de côté, dernier commit amont il y a 41 jours, référencé dans : aucun
• github.com/author/api-wrapper-x - en cours d'utilisation, dernier commit amont il y a 1 jour, référencé dans : un projet
• github.com/author/rss-to-json - doublon, dernier commit amont il y a 3 jours, référencé dans : aucun (même fonction que scrape-lite)
• github.com/author/cheap-queue - en cours d'utilisation, dernier commit amont il y a 6 heures, référencé dans : deux projets
• github.com/author/webhook-relay-lib - mis de côté, dernier commit amont il y a 96 jours, référencé dans : aucun
• github.com/author/simple-cache - en cours d'utilisation, dernier commit amont il y a 2 jours, référencé dans : trois projets
• github.com/author/old-scraper - abandonné en amont, dernier commit amont il y a 340 jours, référencé dans : aucun
• github.com/author/notify-me - incertain, dernier commit amont il y a 12 jours, référencé dans : pas sûr
• github.com/author/token-utils - en cours d'utilisation, dernier commit amont il y a 1 jour, référencé dans : un projet
• github.com/author/quick-parser - doublon, dernier commit amont il y a 8 jours, référencé dans : aucun (même fonction que rss-to-json)
• github.com/author/tiny-orm - mis de côté, dernier commit amont il y a 55 jours, référencé dans : aucun
• github.com/author/rate-limiter - en cours d'utilisation, dernier commit amont il y a 3 jours, référencé dans : deux projets
• github.com/author/config-loader - en cours d'utilisation, dernier commit amont il y a 4 jours, référencé dans : la plupart de mes projets
• github.com/author/legacy-fetch - abandonné en amont, dernier commit amont il y a 400+ jours, référencé dans : aucun
• github.com/author/env-check - en cours d'utilisation, dernier commit amont il y a 9 jours, référencé dans : un projet
• github.com/author/pretty-logs - mis de côté, dernier commit amont il y a 70 jours, référencé dans : aucun
• github.com/author/proxy-list - incertain, dernier commit amont il y a 20 jours, référencé dans : pas sûr
• github.com/author/backoff-lib - en cours d'utilisation, dernier commit amont il y a 6 jours, référencé dans : deux projets
• github.com/author/dead-simple-db - mis de côté, dernier commit amont il y a 88 jours, référencé dans : aucun
• github.com/author/quick-hash - en cours d'utilisation, dernier commit amont il y a 1 jour, référencé dans : un projet
• github.com/author/retry-wrapper - doublon, dernier commit amont il y a 14 jours, référencé dans : aucun (même fonction que backoff-lib)
• github.com/author/format-time - en cours d'utilisation, dernier commit amont il y a 2 jours, référencé dans : la plupart de mes projets
• github.com/author/quick-mailer - mis de côté, dernier commit amont il y a 50 jours, référencé dans : aucun
• github.com/author/health-check-lib - en cours d'utilisation, dernier commit amont il y a 5 jours, référencé dans : deux projets
• github.com/author/dotenv-plus - en cours d'utilisation, dernier commit amont il y a 3 jours, référencé dans : la plupart de mes projets
• github.com/author/simple-lock - incertain, dernier commit amont il y a 30 jours, référencé dans : pas sûr
• github.com/author/old-notify - abandonné en amont, dernier commit amont il y a 500+ jours, référencé dans : aucun
• github.com/author/tiny-scheduler - doublon, dernier commit amont il y a 18 jours, référencé dans : aucun (même fonction que quick-scheduler)

(les noms ci-dessus sont des espaces réservés, illustrant la forme de la liste, pas les outils réels)

Trente lignes, c'est rien à lire manuellement. C'est aussi assez pour remarquer que vous avez trois bibliothèques de logique de réessai distinctes qui font le même travail, et que l'un des repos dont vous dépendez réellement n'a pas eu de commit amont depuis plus d'un an.

La vue graphe du coffre une fois les 30 notes créées : chaque outil est un nœud, les doublons et les repos à usage partagé sont regroupés en clusters visibles.

Boucle 2 : les passes qui ne fonctionnent qu'une fois que vous avez collecté 30+ outils ?

Le README d'un seul outil ne peut pas vous dire ça. Seul quelque chose qui lit à travers tout ce que vous avez récupéré le peut.

1DÉCLENCHEUR : toutes les 12 heures
2ÉTAPES :
3  Passe 1, vraiment mis de côté :
4    signaler tout repo avec le statut : in-use mais non référencé dans
5    aucun de vos projets depuis 30+ jours, vérifier dans vos propres
6    repos pour une utilisation réelle, pas des suppositions
7  Passe 2, outils en double :
8    comparer "ce qu'il fait vraiment" dans toutes les notes, regrouper
9    tout ce qui résout le même problème, confirmé par des noms de
10    fonctions correspondants ou un objectif correspondant, pas
11    seulement des descriptions qui se ressemblent
12  Passe 3, risque amont :
13    signaler tout outil dont vous dépendez et dont le dernier commit
14    amont date de 120+ jours, pour savoir quelles dépendances
15    pourraient devenir obsolètes sans prévenir
16  Passe 4, la lecture honnête :
17    une ligne par outil pour savoir s'il mérite l'espace disque et
18    la charge mentale de se souvenir de son existence, sans édulcorant
19VÉRIFIER : chaque passe écrit dans memory/PORTFOLIO.md, les
20           regroupements de la Passe 2 sont appuyés par une fonction
21           ou un objectif partagé réel
22ARRÊT : les quatre passes terminées, ou une passe échoue et est
23         journalisée, jamais ignorée silencieusement

La Passe 3 est celle qui change vraiment votre façon de travailler. Vous ne réalisez pas que vous dépendez de trois outils dont les mainteneurs se sont tus il y a un an jusqu'à ce que ce soit écrit dans une liste devant vous.

Un tableau des risques généré par la Passe 3 : les outils que vous utilisez vraiment, triés par temps écoulé depuis le dernier mouvement de leur projet amont.

Essayez d'abord la version manuelle ?

Même règle que toujours. Ne planifiez rien que vous n'ayez prouvé à la main.

1Vous travaillerez en boucle jusqu'à ce que la tâche réponde aux critères.
2
3TÂCHE :
4Lire chaque dossier de repo dans [chemin]. Pour chacun, noter ce qu'il fait,
5pourquoi vous l'avez récupéré à l'origine, si vous l'utilisez toujours
6réellement, et depuis combien de temps le projet amont a fait son dernier
7commit. Ensuite, comparer entre tous les repos : trouver les doublons et
8tout ce dont vous dépendez et qui est devenu silencieux en amont.
9
10CRITÈRES DE SUCCÈS (stricts, pas de passes molles) :
11- chaque "doublon" est appuyé par une fonction ou un objectif
12  correspondant réel, pas des descriptions qui se ressemblent
13- chaque repo "mis de côté" inclut le nombre de jours depuis votre
14  dernière référence dans vos propres projets
15- le risque amont est basé sur les dates de commit réelles, pas des
16  suppositions
17
18PROTOCOLE DE BOUCLE, répéter à chaque tour :
191. PLANIFIER   - énoncer la seule prochaine étape
202. FAIRE       - produire ou améliorer la sortie
213. VÉRIFIER    - noter 1-10 sur chaque critère, être impitoyablement honnête
224. DÉCIDER     - si chaque critère est 8+, afficher "FINAL" et arrêter
23
24RÈGLES :
25- Ne jamais considérer comme terminé tant que chaque critère n'est pas 8+
26- Ne me posez pas de questions, faites une supposition raisonnable et continuez
27
28Commencez. Exécutez la boucle jusqu'à FINAL.

Si la liste des doublons ou la liste des risques amont vous surprend, elle mérite d'être planifiée. Si elle confirme juste ce que vous saviez déjà, ne l'automatisez pas encore.

L'ordre qui fonctionne réellement ?

Faites tourner la Boucle 1 jusqu'à ce que chaque repo cloné ait une vraie note, pas un espace réservé.

Laissez reposer une semaine ou deux. Chaque nouvel outil que vous récupérez obtient automatiquement une note à partir de là.

Ce n'est qu'ensuite que vous activez la Boucle 2. Les passes de doublons et de risques amont ont besoin d'assez de notes pour réellement entrer en collision.

Planifiez-la en dernier, après l'avoir vue s'exécuter proprement à la main au moins deux fois.

Combien ça coûte ?

La Boucle 1 s'exécute par nouveau clone, donc elle évolue avec ce que vous récupérez réellement, pas selon un horaire fixe. La plupart des semaines, ça représente quelques appels de modèle bon marché.

La Boucle 2 s'exécute deux fois par jour sur 30+ notes. Déplacez les Passes 1 et 3 sur le modèle bon marché, ce sont des recherches, pas des jugements. Gardez les Passes 2 et 4 sur Sonnet, car repérer un vrai doublon et faire une lecture honnête nécessitent un modèle qui peut réellement raisonner sur ce qu'il compare. Réparti ainsi, deux exécutions par jour sur une collection de 30 repos coûte moins cher que le temps que vous passereriez à faire le même audit à la main une fois.

La seule chose à retenir ?

Un README vous dit ce qu'un outil fait. Ce système vous dit lequel des 30 outils que vous avez trouvés vous utilisez réellement, lesquels se dupliquent silencieusement, et lesquels vous dépendez et que personne ne maintient plus.

La valeur n'a jamais été dans une seule note d'outil. Elle est dans le fait que rien de ce que vous avez collecté ne peut pourrir silencieusement, se dupliquer silencieusement, ou devenir non maintenu silencieusement sans que quelque chose l'écrive là où vous le verrez réellement.

Construisez la Boucle 1 d'abord. Laissez-la tourner pendant deux ou trois semaines avant de toucher à la Boucle 2. Les passes de doublons et de risques amont sont inutiles avec cinq repos. Elles commencent à être rentables au-delà de vingt.

Si vous voulez d'autres analyses comme celle-ci, j'en publie une tous les deux ou trois jours sur Telegram et X. Les deux sont gratuits.

X - https://x.com/gippp69

Telegram - https://t.me/GipArcAI