dir2md — génère un plan Markdown d’un dépôt de code lisible par l’IA

🙋 Pourquoi l’avoir créé ?
À mesure qu’un produit SaaS grandit, la base de code devient de plus en plus complexe,
et les répertoires imbriqués, les fichiers de configuration éparpillés et les ressources legacy deviennent des obstacles à la compréhension du contexte, aussi bien pour les développeurs que pour l’IA.

En déboguant un outil CLI d’IA basé sur Claude,
j’ai réellement vécu plusieurs situations désespérantes où, après avoir appliqué des modifications proposées en réponse à un prompt demandant une « analyse du problème »,
des fichiers importants ont été supprimés parce que la réponse ne comprenait pas correctement la structure.

Cette expérience m’a fait comprendre que le problème n’était pas le manque de documentation, mais le fait que « la structure elle-même n’apparaît pas clairement », ce qui m’a conduit à développer dir2md, un générateur de cartes Markdown centré sur la structure.

🧭 Que fait-il ?
dir2md analyse l’ensemble d’un projet afin de générer un blueprint Markdown optimisé pour les LLM, facile à comprendre aussi bien pour les humains que pour l’IA. L’objectif n’est pas de produire un simple arbre de fichiers, mais une véritable « carte du code (code map) » porteuse de sens.

🔑 Fonctionnalités principales
▫️ Analyse des répertoires basée sur .gitignore
▫️ Optimisation du résumé avec limite de tokens par fichier + échantillonnage Head/Tail
▫️ Suppression des doublons basée sur SimHash pour éliminer les fichiers similaires
▫️ Prise en charge du masquage de secrets de base (la version Pro permet des motifs avancés)
▫️ Plusieurs modes de sortie : arbre complet / résumé inline / résumé seul, etc.
▫️ Reproductible en CI/CD : --no-timestamp, --emit-manifest, etc.

✅ Quand dir2md est utile
▫️ Lorsqu’il faut comprendre rapidement une base de code legacy complexe
▫️ Pour documenter des dossiers de recherche ou des répertoires de données
▫️ Pour fournir à un agent IA des informations structurelles sûres
▫️ Lorsqu’un « résumé de l’ensemble du projet » est nécessaire dans un prompt LLM

🔗 Liens
▫️ GitHub: https://github.com/Flamehaven/dir2md
▫️ Démo web (Hugging Face): https://huggingface.co/spaces/Flamehaven/dir2md-demo
▫️ Contexte de création (Medium): https://medium.com/p/227a691a08aa