VS Code Agent Docs for Markdown 설치: Source Graph로 문서 연결 확인하기

Markdown 문서가 수십 개로 늘어나면 AI 에이전트가 기준 문서를 놓치기 쉽습니다. Agent Docs for Markdown은 로컬 폴더를 인덱싱해 VS Code 안에 Source Graph를 만드는 확장입니다. 설치 뒤 첫 그래프와 정리 보고서까지 만드는 경로만 적습니다.

직접 실행해 보지는 않았습니다. 공식 한국어 README와 VS Code Marketplace를 확인했습니다. 제 기준으로는 Markdown 파일을 그대로 두면서 에이전트가 읽을 순서를 잡고 싶을 때 쓸 만합니다.

1. 설치 대상

확장 기능은 Markdown 파일, 내부 링크, 외부 URL, 이미지 참조를 로컬 인덱스에 기록합니다. 기준 문서와 연결 문서를 그래프로 찾는 용도입니다. 데이터는 워크스페이스의 .mps/source-graph.sqlite에 저장된다고 공식 README에 적혀 있습니다.

문서가 몇 개 없고 연결 관계도 단순하다면 굳이 설치할 이유가 없습니다. 반대로 운영 문서, 리서치 노트, 에이전트 지침이 한 저장소에 섞여 있다면 정리 범위를 먼저 확인하기 좋습니다. 자동화 흐름을 문서로 관리한다면 Tasker와 n8n 연동 기록처럼 구성 요소가 많은 작업에서 활용할 수 있습니다.

2. VS Code 확장 설치

VS Code Quick Open에서 아래 명령을 입력합니다.

ext install datanewbie-labs.markdown-agent-docs

설치가 끝나면 Markdown 폴더를 워크스페이스로 열고 Activity Bar에서 Agent Docs를 선택하시면 됩니다. Marketplace 식별자는 datanewbie-labs.markdown-agent-docs입니다.

여기까지가 설치입니다.

3. Source Graph 생성

Command Palette에서 Agent Docs: Open Source Graph를 실행합니다. 사이드바의 Open Graph를 눌러도 같은 화면이 열립니다.

노드를 고른 뒤 Focus를 누르면 선택 문서 주변만 남습니다. 다른 노드를 선택하고 Hop +를 누르면 기존 그래프를 유지한 채 해당 가지를 더 펼칩니다. 처음부터 모든 파일을 읽히기보다 기준 문서 주변을 좁혀 보는 쪽이 낫습니다.

그래프가 있다고 기준 문서가 자동 확정되는 것은 아닙니다. 링크 방향과 실제 문서 역할은 사람이 확인해야 합니다.

4. 정리 후보 확인

Run Workspace Audit를 실행하면 깨진 링크, 고립 문서, 중복 스킬 사본, .mpsignore 후보를 확인합니다. 빌드 산출물이나 에이전트 설정 복사본이 검색 결과를 채우는 상황을 줄이는 단계입니다.

보고서에서 제외 근거가 분명한 항목만 선택해 적용하시면 됩니다. 고립 문서는 삭제 대상이 아니라 링크가 없는 문서라는 뜻이므로 내용을 먼저 읽어야 합니다. 여기서 성급히 일괄 삭제하지 마십시오.

5. 에이전트 스킬 연결

Command Palette에서 Agent Docs: Install or Export Skills를 실행한 뒤 Install recommended Manager + Writer skills를 고릅니다. 대상은 .claude/skills, .agents/skills, .codex/skills, .gemini/skills, .cursor/skills 중 사용하는 에이전트 폴더로 정해주시면 됩니다.

• markdown-manager: 검색, 링크, 그래프, 수정 영향 범위 확인.
• markdown-writer: 문서 작성, 재구성, HTML 렌더 점검.

문서 수정 전에는 아래처럼 범위를 먼저 요청하는 방식이 맞습니다.

Use markdown-manager.
이 문서를 수정하기 전에 연결 문서와 업데이트 범위를 알려줘.

확인

VS Code를 다시 연 뒤 Agent Docs: Open Source Graph를 실행합니다. 그래프에 Markdown 노드가 보이고 워크스페이스에 .mps/source-graph.sqlite가 생성되면 첫 인덱싱 상태입니다.