Context Vault
개인화된 지식 보관소. 웹에서 수집한 자료를 마크다운으로 정리하고, GitHub Pages(Docsify)로 웹에 공개하며, QMD로 검색 가능합니다.
Andrej Karpathy의 LLM Knowledge Base 워크플로우를 적용하여, AI 에이전트가 자동으로 지식을 수집·탐색·분석·파일링·점검합니다.
웹
jeongsk.github.io/context-vault
로컬에서 실행하기
# Docsify CLI 설치 (최초 1회)
npm i docsify-cli -g
# 로컬 서버 실행
docsify serve .또는 Obsidian에서 vault 폴더를 그대로 열면 됩니다.
Karpathy 워크플로우 (5단계)
Data Ingest → IDE → Q&A → Output → Linting → (반복)
| 단계 | 설명 | 도구 |
|---|---|---|
| Data Ingest | URL → 마크다운 노트로 자동 변환·저장 | context-vault-writer 스킬 |
| IDE | 지식 탐색 (웹 + 로컬) | Docsify, Obsidian, QMD |
| Q&A | 노트에 대해 질문하고 문서 기반 답변 | scripts/vault-qa.py |
| Output | 분석 결과를 다시 노트로 파일링 | scripts/vault-file.py |
| Linting | 위키 건강 검사 (고아 노트, 깨진 링크 등) | scripts/vault-lint.py |
상세 가이드: karpathy-workflow-guide.md
디렉토리 구조
context-vault/
├── notes/ # 수집·가공 노트 (주제별)
│ ├── ai-agents/ # 멀티에이전트, 오케스트레이션
│ ├── ai-coding/ # Claude Code, Cursor, Codex
│ ├── ai-models/ # LLM, 모델, 벤치마크
│ ├── dev-tools/ # 일반 개발 도구
│ ├── multimedia/ # TTS, ASR, 비전, 비디오
│ ├── productivity/ # 생산성 도구
│ └── misc/ # 분류 어려운 것들
├── guides/ # 가이드/튜토리얼
├── projects/ # 진행 중 프로젝트
├── scripts/ # 자동화 스크립트 (vault-lint, vault-qa, vault-file)
├── raw/ # 미가공 수집물 (원본 보관)
├── index.html # Docsify 진입점
├── _sidebar.md # Docsify 사이드바
└── AGENTS.md # 에이전트를 위한 프로젝트 가이드
노트 규칙
- 파일명:
notes/{주제}/YYYY-MM-DD-slug.md - 주제:
ai-agents,ai-coding,ai-models,dev-tools,multimedia,productivity,misc - 링크: 표준 마크다운
[text](path)만 사용 (위키링크[[ ]]금지) - 태그: 소문자, kebab-case, 영어만, 3~5개
Frontmatter
---
title: 노트 제목
created: YYYY-MM-DD
modified: YYYY-MM-DD
tags: [tag1, tag2, tag3]
source_url: https://...
publish: false
embedding_ready: false
---자동화 스크립트
Linting — 위키 건강 검사
python3 scripts/vault-lint.py고아 노트, 깨진 링크, 위키링크, 프론트매터 문제, 관련 노트 누락, 임베딩 미생성을 체크합니다.
Q&A — 지식 질의응답
python3 scripts/vault-qa.py "멀티 에이전트 오케스트레이션 방법"
python3 scripts/vault-qa.py --stats
python3 scripts/vault-qa.py --lintOutput — 결과 파일링
python3 scripts/vault-file.py --type insight --title "제목" --content "내용"
python3 scripts/vault-file.py --stats검색 (QMD)
# 인덱스 업데이트
qmd update -c context-vault
# 키워드 검색
qmd search "키워드"
# 자연어 쿼리 (임베딩 필요)
qmd query "질문"문서 플램폼 (Docsify)
- 전체 텍스트 검색
- 페이지네이션
- 이미지 확대 / 코드 복사
- 구문 강조 (Python, JS, TypeScript, Bash, YAML 등)
관련
- AGENTS.md — 에이전트를 위한 프로젝트 가이드
- Karpathy 워크플로우 적용 가이드
- QMD
- Docsify