Show GN: dir2md — 코드 리포지토리를 AI가 읽을 수 있는 마크다운 설계도 생성

🙋 왜 만들었나요?
SaaS 제품이 커지면서 코드베이스는 점점 복잡해졌고,
중첩된 디렉토리, 흩어진 설정 파일, 레거시 자산들은 개발자뿐 아니라 AI에게도 맥락 인식의 장애물이 됩니다.

실제로 Claude 기반 AI CLI 도구를 디버깅하던 중,
"문제 분석"을 요청한 프롬프트에 따라 제안된 수정을 적용했다가,
구조를 제대로 이해하지 못한 응답으로 인해 중요 파일이 삭제되는 절망적 상황을 몇 번 겪었습니다.

이 경험을 통해, 문제는 문서 부족이 아니라 '구조 자체가 드러나지 않는 것'임을 깨달았고, dir2md — 구조 중심 마크다운 맵 생성기를 개발하게 되었습니다.

🧭 무엇을 하나요?
dir2md는 프로젝트 전체를 스캔하여, 사람이든 AI든 쉽게 이해할 수 있도록 LLM 최적화 마크다운 블루프린트를 생성합니다. 단순한 파일 트리가 아닌, 의미 있는 "코드 지도(code map)"를 만드는 것이 목표입니다.

🔑 주요 기능
▫️.gitignore 기반 디렉토리 스캔
▫️ 파일당 토큰 제한 + Head/Tail 샘플링으로 요약 최적화
▫️ SimHash 기반 중복 제거로 유사 파일 제거
▫️ 기본 시크릿 마스킹 지원 (Pro 버전은 고급 패턴 가능)
▫️ 출력 모드 다양: 전체 트리 / 인라인 요약 / 요약 전용 등
▫️ CI/CD에서 재현 가능: --no-timestamp, --emit-manifest 등

✅ dir2md가 유용한 경우
▫️복잡한 레거시 코드베이스를 빠르게 파악해야 할 때
▫️연구 폴더/데이터 디렉토리를 문서화할 때
▫️AI 에이전트에게 안전한 구조 정보를 제공할 때
▫️LLM 프롬프트에서 “프로젝트 전체 요약”이 필요한 상황

🔗링크
▫️GitHub: https://github.com/Flamehaven/dir2md
▫️ 웹 데모 (Hugging Face): https://huggingface.co/spaces/Flamehaven/dir2md-demo
▫️ 제작 배경 (Medium): https://medium.com/p/227a691a08aa