dir2md — menghasilkan cetak biru Markdown agar AI dapat membaca repositori kode

🙋 Mengapa dibuat?
Seiring produk SaaS berkembang, codebase menjadi semakin kompleks,
dan direktori bertingkat, file konfigurasi yang tersebar, serta aset lama menjadi hambatan untuk memahami konteks, bukan hanya bagi developer tetapi juga bagi AI.

Saat melakukan debugging pada alat AI CLI berbasis Claude,
saya beberapa kali mengalami situasi yang menyedihkan ketika perbaikan yang disarankan berdasarkan prompt "analisis masalah" diterapkan,
lalu file penting terhapus karena respons tersebut tidak benar-benar memahami strukturnya.

Melalui pengalaman ini, saya menyadari bahwa masalahnya bukan kurangnya dokumentasi, melainkan "struktur itu sendiri tidak terlihat"; dari situlah saya mengembangkan dir2md — generator peta Markdown yang berfokus pada struktur.

🧭 Apa yang dilakukan?
dir2md memindai seluruh proyek untuk menghasilkan cetak biru Markdown yang dioptimalkan untuk LLM agar mudah dipahami baik oleh manusia maupun AI. Tujuannya bukan sekadar membuat file tree sederhana, melainkan membangun "peta kode (code map)" yang bermakna.

🔑 Fitur utama
▫️ Pemindaian direktori berbasis .gitignore
▫️ Batas token per file + sampling Head/Tail untuk optimasi ringkasan
▫️ Penghapusan duplikasi berbasis SimHash untuk menghilangkan file serupa
▫️ Dukungan masking rahasia dasar (versi Pro mendukung pola lanjutan)
▫️ Beragam mode output: tree penuh / ringkasan inline / hanya ringkasan, dll.
▫️ Dapat direproduksi di CI/CD: --no-timestamp, --emit-manifest, dll.

✅ Kapan dir2md berguna
▫️ Saat perlu memahami codebase lama yang kompleks dengan cepat
▫️ Saat mendokumentasikan folder riset/direktori data
▫️ Saat memberikan informasi struktur yang aman kepada agen AI
▫️ Saat prompt LLM memerlukan "ringkasan seluruh proyek"

🔗 Tautan
▫️ GitHub: https://github.com/Flamehaven/dir2md
▫️ Demo web (Hugging Face): https://huggingface.co/spaces/Flamehaven/dir2md-demo
▫️ Latar belakang pembuatannya (Medium): https://medium.com/p/227a691a08aa