# Show GN: dir2md — 코드 리포지토리를 AI가 읽을 수 있는 마크다운 설계도 생성 > Clean Markdown view of GeekNews topic #23090. Use the original source for factual precision when an external source URL is present. ## Metadata - GeekNews HTML: [https://news.hada.io/topic?id=23090](https://news.hada.io/topic?id=23090) - GeekNews Markdown: [https://news.hada.io/topic/23090.md](https://news.hada.io/topic/23090.md) - Type: show - Author: [flamehaven01](https://news.hada.io/@flamehaven01) - Published: 2025-09-15T18:31:34+09:00 - Updated: 2025-09-15T18:31:34+09:00 - Original source: [github.com/Flamehaven](https://github.com/Flamehaven/dir2md) - Points: 14 - Comments: 0 ## Summary 복잡해진 **코드베이스**와 흩어진 **설정 파일** 등이 개발자와 **AI** 모두에게 맥락 파악의 한계로 작용하는 문제를 해결하기 위해, 프로젝트 구조 전체를 **LLM 최적화**된 **마크다운 블루프린트**로 자동 변환하는 도구가 탄생했습니다. 단순 파일 트리가 아니라 의미 있는 **코드 지도**를 생성함으로써, 사람과 AI 모두가 빠르게 프로젝트를 이해할 수 있도록 돕습니다. **SimHash 기반 중복 제거**와 파일 요약, 시크릿 마스킹 등 개발 환경에 맞춘 다양한 기능이 포함되어, 레거시 코드 분석이나 **AI 에이전트용 안전 요약** 등 다양한 활용처가 기대됩니다. ## Topic Body 🙋 왜 만들었나요? 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 ## Comments _No public comments on this page._