dir2md — erzeugt einen Markdown-Bauplan, den KI für Code-Repositories lesen kann

🙋 Warum wurde es entwickelt?
Mit dem Wachstum von SaaS-Produkten wurde auch die Codebasis immer komplexer,
und verschachtelte Verzeichnisse, verstreute Konfigurationsdateien und Legacy-Bestände werden nicht nur für Entwickler, sondern auch für KI zu Hindernissen beim Kontextverständnis.

Beim Debuggen eines Claude-basierten AI-CLI-Tools habe ich tatsächlich mehrmals eine frustrierende Situation erlebt:
Ich übernahm die vorgeschlagenen Änderungen aus einem Prompt mit der Bitte um „Problemanalyse“,
und durch eine Antwort, die die Struktur nicht richtig verstanden hatte, wurden wichtige Dateien gelöscht.

Durch diese Erfahrung wurde mir klar, dass das Problem nicht fehlende Dokumentation ist, sondern dass „die Struktur selbst nicht sichtbar wird“. Deshalb habe ich dir2md entwickelt — einen Markdown-Map-Generator mit Fokus auf Struktur.

🧭 Was macht es?
dir2md scannt das gesamte Projekt und erzeugt einen für LLMs optimierten Markdown-Bauplan, den sowohl Menschen als auch KI leicht verstehen können. Ziel ist nicht nur ein einfacher Dateibaum, sondern eine aussagekräftige „Code-Karte (code map)“.

🔑 Hauptfunktionen
▫️Verzeichnisscan auf Basis von .gitignore
▫️Optimierte Zusammenfassung pro Datei mit Token-Limit und Head/Tail-Sampling
▫️Entfernung ähnlicher Dateien durch Duplikaterkennung auf SimHash-Basis
▫️Unterstützung für grundlegendes Secret-Masking (in der Pro-Version auch erweiterte Muster)
▫️Verschiedene Ausgabemodi: kompletter Baum / Inline-Zusammenfassung / nur Zusammenfassung usw.
▫️In CI/CD reproduzierbar: --no-timestamp, --emit-manifest usw.

✅ Wann dir2md nützlich ist
▫️Wenn man sich schnell in einer komplexen Legacy-Codebasis zurechtfinden muss
▫️Beim Dokumentieren von Forschungsordnern oder Datenverzeichnissen
▫️Wenn man AI-Agenten sichere Strukturinformationen bereitstellen möchte
▫️Wenn in LLM-Prompts eine „Zusammenfassung des gesamten Projekts“ benötigt wird

🔗Links
▫️GitHub: https://github.com/Flamehaven/dir2md
▫️Web-Demo (Hugging Face): https://huggingface.co/spaces/Flamehaven/dir2md-demo
▫️Hintergrund zur Entstehung (Medium): https://medium.com/p/227a691a08aa