LLM Wiki 시스템 전체 가이드

LLM Wiki 시스템 전체 가이드

• 카테고리: #ML(AI) #시스템 #wiki
• 태그: #obsidian #claudian #graphify #mcp #wiki #시스템설계
• 작성일: 2026-06-12
• 참조 원본: [[2026-06-12_LLMWiki-시스템-전체-가이드]]

목차

• [[#1. 핵심 요약]]
• [[#2. 상세 설명]]
  • [[#전체 폴더 구조]]
  • [[#처리 프로세스]]
  • [[#구축 과정]]
  • [[#Obsidian 플러그인]]
  • [[#플러그인 주요 설정 및 주의점]]
  • [[#gitignore 권장 설정]]
• [[#3. 연관 개념 (지식 연결)]]

1. 핵심 요약

• Obsidian + Claudian(Claude Code) 기반 개인 학습 지식 관리 시스템. /ingest·/lint·Query 세 가지 작업으로 원본 자료를 wiki 문서로 변환·관리한다.
• graphify 지식 그래프로 vault 전체 스캔 없이 관련 문서를 발견하여 토큰을 절감하는 것이 핵심 설계 원칙이다.

---

2. 상세 설명

전체 폴더 구조

Vault (D:\llmwiki\)

경로	용도
CLAUDE.md	Claude Code 행동 지침. 세션마다 참조
.schema/system_prompt.md	문서 작성 상세 지침 (카테고리 7단계, 백링크 규칙)
.schema/template_note.md	wiki 문서 작성 템플릿
.claude/settings.json	SessionStart 훅
.claude/mcp.json	MCP 서버 연결 설정 (Smart Connections, GitHub)
.claude/commands/ingest.md	/ingest 커맨드 정의 (6단계)
.claude/commands/lint.md	/lint 커맨드 정의 (graphify 기반 5단계)
raw/clippings/	웹 클리핑 (Obsidian Clipper), sub 폴더 자유 생성 (예: mysql/)
raw/pdf/	PDF 원본 (변환 후에도 유지)
raw/pdf2md/	PDF 변환 결과 — ingest 스캔 제외
raw/attachments/	Obsidian 자동 저장 첨부파일 — 스캔 제외
wiki/index.md	전체 문서 지식 지도 + 📥 원본 처리 현황(처리 추적) (세션 시작 시 필독)
wiki/log.md	변경 이력

wiki 카테고리 구조:

wiki/
├── 시스템/      ← 주요 카테고리 1
├── 프로그래밍/  ← 주요 카테고리 2
├── DBMS/        ← 주요 카테고리 3 (쿼리튜닝/, Oracle/install/ 등 sub 포함)
├── 기타(ETC)/   ← 주요 카테고리 4 (catch-all)
└── ML(AI)/      ← 독립 최상위 카테고리

외부 도구 (D:\tools\)

경로	용도
llmwiki-scripts/pdf2md.bat	PDF → Markdown 변환
graphify-tool/graphify-build.bat	지식 그래프 빌드·증분 갱신
graphify-tool/graphify-query.bat	subgraph BFS 조회
graphify-tool/graphify-explain.bat	특정 노드 상세 조회
graphify-out/graph.json	빌드된 그래프 (직접 Read 금지)
graphify-out/GRAPH_REPORT.md	그래프 요약 보고서

---

처리 프로세스

/ingest — 원본 → wiki 문서 (6단계)

1. 세션 초기화  : wiki/index.md(원본 처리 현황 포함) + system_prompt.md 읽기
2. 소스 파악    : raw/ 재귀 스캔 (attachments·pdf2md만 제외)
                  미처리 판별 = index.md "📥 원본 처리 현황" 에 없는 파일
3. PDF 변환     : pdf2md.bat PowerShell 동기 실행 (PDF인 경우만)
4. 관련 문서    : graphify-query로 연관 wiki 파일 파악 (없으면 index.md 대체)
5. 문서 작성    : template 형식으로 wiki 생성 → 백링크 업데이트
                  → index/log 갱신 + 처리 현황에 원본 등록
6. 결과 보고

★ 원본은 이동·삭제하지 않고 raw/ 최초 위치에 그대로 둡니다. (archived 이동 폐지)
raw/ 아래에는 분류용 sub 폴더를 자유롭게 생성합니다.

플래그:

• 없음: 미처리 파일만
• --confirm: 강제 재처리 (덮어쓰기)

카테고리 분류 우선순위 (7단계):

1. 쿼리튜닝 → DBMS/쿼리튜닝/
2. DB 종류 → DBMS/{DB종류}/
3. DW·분석 → DBMS/DW/
4. ML·AI → ML(AI)/
5. 시스템·인프라 → 시스템/
6. 프로그래밍 → 프로그래밍/
7. 기타 → 기타(ETC)/

sub 폴더 자동 생성: 동일 DB 종류 + 동일 태그 문서 3개 이상 시 생성 후 이동.

---

Query — 위키 질의

자연어 질문 → wiki/index.md에서 관련 문서 식별 → 해당 문서만 Read → 답변 합성.
결과를 wiki에 저장 요청 시 YYYY-MM-DD_(제목).md로 저장.

---

/lint — 품질 점검 (5단계)

1. GRAPH_REPORT.md 날짜 확인 → 오래됐으면 graphify-build.bat 실행
2. GRAPH_REPORT.md 읽기       → 고아 노드·허브 문서·Knowledge Gaps 추출
3. 심층 분석                   → graphify-query로 모순·낡은 주장·누락 교차 참조 점검
4. 보고서 작성                 → wiki/lint_report_YYYY-MM-DD.md 생성
5. log.md 기록                 → 한 줄 이력 추가

---

GitHub 자동 업로드 (Obsidian Git)

Claude Code에서 직접 업로드하지 않습니다. Obsidian Git 플러그인이 담당합니다.

• Custom base path: wiki (vault 루트가 아닌 wiki/ 폴더 기준 Git)
• 15~30분 주기 또는 편집 중지 후 자동 commit-and-push
• 대상 레포: bsshin71/wiki (Private)

---

구축 과정

PDF 변환 (pdf2md.bat)

• Python venv 독립 환경 (D:\tools\llmwiki-scripts\.venv\)
• 호출: & "D:\tools\llmwiki-scripts\pdf2md.bat" "절대경로\파일.pdf"
• 출력: raw/pdf2md/파일명.md

graphify 지식 그래프

• 설치: pip install graphifyy && graphify install
• 출력 경로 문제: --out 옵션 없음 → vault 오염 발생
• 해결: robocopy 왕복 방식 (빌드 전 캐시 복원 → 빌드 → vault 밖으로 이동·삭제)
• 그래프 갱신 주기: 세션에서 3개 이상 ingest 완료 시 또는 사용자 명시 요청 시

---

Obsidian 플러그인

플러그인	ID	핵심 용도
Claudian	realclaudian	Claude Code vault 통합. 파일 R/W·bash·멀티스텝 워크플로우
Smart Connections	smart-connections	로컬 벡터 임베딩 의미 검색. MCP로 Claude에 제공
Obsidian Git	obsidian-git	wiki/ → GitHub 자동 동기화
Calendar	calendar	날짜 기반 파일명(YYYY-MM-DD_) 체계와 연동
Markdown Formatting Assistant	obsidian-markdown-formatting-assistant-plugin	마크다운 서식 보조 툴바

---

플러그인 주요 설정 및 주의점

Claudian MCP (mcp.json):

• UI Command 필드 사용 금지 → mcp.json 직접 편집 필수
• command: nvm 심볼릭 링크 금지 → 실제 물리 경로 사용 (AppData\Local\nvm\v20.20.2\node.exe)
• mcp.json GitHub 커밋 절대 금지 (PAT 토큰 포함)

Smart Connections:

• Node.js v20 LTS 필수 (v24+ → ERR_UNSUPPORTED_ESM_URL_SCHEME)
• MCP 서버: msdanyg/smart-connections-mcp 사용 (@yejianye 버전 ESM 버그, dan6684 Python 빌드 실패)
• 임베딩 완료(smart-env/multi/*.ajson) 후 MCP 실행

Obsidian Git:

• Custom base path: wiki 필수 (vault 루트 전체가 아닌 wiki/ 폴더만 동기화)
• 설정 변경 후 Obsidian 완전 재시작 필수
• .gitignore에 .claude/, .smart-env/, .claudian/ 추가

---

.gitignore 권장 설정

.smart-env/    # 벡터 임베딩 (재생성 가능)
.claudian/     # Claudian 내부 상태
.claude/       # mcp.json PAT 토큰 포함 — 절대 커밋 금지

3. 연관 개념 (지식 연결)

• [[2026-06-05_(Claudian-Smart-Connections-MCP-설정가이드)]] — Smart Connections MCP 설치·nvm 심볼릭 링크 함정 상세
• [[2026-06-05_(Claudian-GitHub-MCP-설정가이드)]] — GitHub MCP 설치·PAT 보안 주의사항 상세
• [[2026-06-12_(LLMWiki-Graphify-통합-설정-로그)]] — graphify 도입 배경·robocopy 해결책·첫 lint 결과
• [[2026-06-12_(Obsidian-Git-플러그인-연동가이드)]] — Obsidian Git 초기 설정·Custom base path 상세