dir2md — สร้างแบบแปลน Markdown ที่ AI อ่านได้สำหรับโค้ดรีโพซิทอรี

🙋 ทำไมถึงสร้างสิ่งนี้?
เมื่อผลิตภัณฑ์ SaaS เติบโตขึ้น โค้ดเบสก็ยิ่งซับซ้อนขึ้นเรื่อย ๆ และ
ไดเรกทอรีที่ซ้อนกัน ไฟล์คอนฟิกที่กระจัดกระจาย และทรัพยากร legacy กลายเป็นอุปสรรคต่อการทำความเข้าใจบริบท ไม่ใช่แค่สำหรับนักพัฒนา แต่รวมถึง AI ด้วย

ระหว่างที่กำลังดีบักเครื่องมือ AI CLI ที่ใช้ Claude เป็นฐานอยู่จริง ๆ
ผมเคยลองนำการแก้ไขที่ถูกเสนอจากพรอมป์ที่ขอให้ "วิเคราะห์ปัญหา" ไปใช้
แล้วก็ต้องเจอสถานการณ์ชวนสิ้นหวังหลายครั้ง เมื่อไฟล์สำคัญถูกลบเพราะคำตอบนั้นยังไม่เข้าใจโครงสร้างได้ดีพอ

จากประสบการณ์นี้ ผมจึงตระหนักว่าปัญหาไม่ใช่การขาดเอกสาร แต่คือ "ตัวโครงสร้างเองไม่ได้ถูกเปิดเผยออกมา" และนั่นทำให้พัฒนา dir2md — เครื่องมือสร้างแผนที่ Markdown ที่ยึดโครงสร้างเป็นศูนย์กลางขึ้นมา

🧭 มันทำอะไรได้บ้าง?
dir2md จะสแกนทั้งโปรเจกต์เพื่อสร้างบลูพรินต์ Markdown ที่ปรับให้เหมาะกับ LLM เพื่อให้ทั้งคนและ AI เข้าใจได้ง่าย เป้าหมายไม่ใช่แค่สร้าง file tree ธรรมดา แต่คือการสร้าง "แผนที่โค้ด (code map)" ที่มีความหมาย

🔑 ฟีเจอร์หลัก
▫️สแกนไดเรกทอรีตาม .gitignore
▫️จำกัดจำนวนโทเค็นต่อไฟล์ + สรุปแบบ Head/Tail sampling
▫️ลบไฟล์ที่คล้ายกันด้วยการกำจัดข้อมูลซ้ำแบบ SimHash
▫️รองรับการมาสก์ซีเคร็ตพื้นฐาน (เวอร์ชัน Pro รองรับแพตเทิร์นขั้นสูง)
▫️โหมดเอาต์พุตหลากหลาย: ทั้ง tree / สรุปแบบ inline / เฉพาะสรุป ฯลฯ
▫️ทำซ้ำได้ใน CI/CD: --no-timestamp, --emit-manifest เป็นต้น

✅ กรณีที่ dir2md มีประโยชน์
▫️เมื่อต้องทำความเข้าใจโค้ดเบส legacy ที่ซับซ้อนอย่างรวดเร็ว
▫️เมื่อต้องจัดทำเอกสารให้โฟลเดอร์งานวิจัย/ไดเรกทอรีข้อมูล
▫️เมื่อต้องส่งมอบข้อมูลโครงสร้างที่ปลอดภัยให้ AI agent
▫️ในสถานการณ์ที่พรอมป์ LLM ต้องการ "สรุปทั้งโปรเจกต์"

🔗ลิงก์
▫️GitHub: https://github.com/Flamehaven/dir2md
▫️เว็บเดโม (Hugging Face): https://huggingface.co/spaces/Flamehaven/dir2md-demo
▫️เบื้องหลังการสร้าง (Medium): https://medium.com/p/227a691a08aa