Show GN: Agent Docs for Markdown – 로컬 Markdown을 AI 에이전트용 LLM Wiki로 만드는 VS Code 확장

최근 LLM Wiki, Knowledge as Code, Context Engineering처럼 AI 에이전트가 사용할 지식을 Markdown과 파일 형태로 관리하려는 흐름이 늘고 있습니다.

LLM의 성능이 좋아져도 에이전트가 어떤 문서를 먼저 읽어야 하는지, 어느 문서가 기준 문서인지, 수정할 때 어떤 문서를 함께 확인해야 하는지 모르면 결과는 쉽게 흔들립니다.

저도 Markdown으로 리서치 노트, 기술 문서, 위키와 보고서를 관리하면서 비슷한 문제를 겪었습니다.

Markdown 파일은 많이 쌓여 있는데 AI 에이전트에게 폴더를 그대로 열어주면 다음과 같은 문제가 생겼습니다.

• 서로 연결된 문서를 놓침
• 비슷한 문서 중 무엇이 기준 문서인지 판단하기 어려움
• 깨진 링크와 고립된 문서를 그대로 사용함
• 빌드 결과물과 에이전트 설정 파일까지 함께 검색함
• 한 문서를 수정한 뒤 관련 문서의 내용이 서로 달라짐

그래서 로컬 Markdown 폴더를 AI 에이전트가 이해할 수 있는 LLM Wiki 형태로 정리해 주는 VS Code 확장인 Agent Docs for Markdown을 만들었습니다.

단순히 Markdown을 검색하거나 미리 보는 도구가 아니라, 문서 사이의 관계와 에이전트의 작업 흐름을 함께 관리하는 것을 목표로 합니다.

주요 기능은 다음과 같습니다.

• Markdown 문서와 링크 관계를 Source Graph로 인덱싱
• 특정 문서를 중심으로 관련 문서를 확장하는 Focus / Hop 탐색
• 깨진 링크, 고립 문서, 중복 생성물과 검색 제외 후보를 찾는 Workspace Cleanup Audit
• Claude, Codex, Gemini, Cursor 등에 Markdown 전용 에이전트 스킬 설치
• Markdown을 독립 실행형 HTML과 블로그용 HTML로 내보내기
• 모든 인덱스와 문서를 로컬 워크스페이스에서 관리

함께 제공하는 스킬은 역할을 두 가지로 단순화했습니다.

• markdown-manager
  문서 검색, Source Graph 탐색, 링크 점검, 기준 문서 판단과 수정 영향 범위를 확인합니다.

• markdown-writer
  리서치 노트를 보고서나 블로그 글로 재구성하고 HTML로 내보내기 전 렌더링 결과를 점검합니다.

예를 들어 에이전트에게 다음과 같이 요청할 수 있습니다.

“이 문서를 수정하기 전에 연결된 문서와 함께 확인해야 할 업데이트 범위를 알려줘.”

“이 Markdown 워크스페이스에서 깨진 링크, 고립 문서와 검색에서 제외할 폴더를 찾아줘.”

“이 리서치 노트를 임원 보고서 형태로 재구성하고 HTML 렌더링까지 점검해줘.”

VS Code에서 기존 Markdown 폴더를 열고 Agent Docs 사이드바에서 Source Graph를 생성하면 바로 사용해 볼 수 있습니다.

Markdown 폴더를 단순한 문서 저장소가 아니라, 사람과 AI 에이전트가 함께 읽고 갱신하는 로컬 LLM Wiki로 만들고 싶은 분들의 피드백을 받고 싶습니다.

GitHub:
https://github.com/sungreong/agent-docs-for-markdown