obsidian-llm-wiki

Obsidian + Claude Code 로 세컨드 브레인을 운영하기 위한 구조 템플릿. 내용은 비어 있다 — 폴더 골격, 규약, 페이지 템플릿, 점검 스크립트, 오퍼레이션 스킬만 들어 있다.

LLM Wiki 패턴을 개인 경험 기록용으로 좁혀 실제로 운영한 뒤, 데이터를 빼고 구조만 추출한 것이다.

무엇이 다른가

RAG 는 질문마다 원본을 다시 검색한다. 어제 한 종합이 오늘 남지 않는다. 이 구조는 LLM 이 한 번 정리해 위키를 만들고 유지보수까지 맡는다 — 지식을 컴파일해 둔다.

이게 없으면 그냥 일지가 된다.

오퍼레이션 스킬 6종

스킬은 절차의 사본이 아니라 진입점이다 — 원문은 CLAUDE.md 에 있고 스킬이 그걸 읽고 따른다. 복사해 두면 규약을 고칠 때 스킬이 낡은 절차를 시킨다.

clone 하면 어디까지 되나

스크립트는 자기 위치로 볼트를 찾으므로 python3 scripts/lint_all.py 는 clone 직후 그냥 돈다. 안 따라오는 것은 "언제 부를지" 다 — 훅 등록(~/.claude/settings.json)과 스케줄 (~/Library/LaunchAgents/)은 볼트 밖에 살아서 git 에 담기지 않는다.

설치

1. 볼트 만들기 — GitHub 에서 「Use this template」 로 새 레포를 만든다. 반드시 Private — 위키에 개인·업무 내용이 쌓인다.

Obsidian 에서 「폴더를 보관함으로 열기」.

2. 스킬 전역 등록 — 어느 디렉토리에서든 /wiki-ingest 가 잡히게:

볼트 안에서만 쓸 거면 건너뛰어도 된다 — .claude/skills/ 에 이미 있다. 스크립트는 자기 위치로 볼트를 찾으므로 경로 설정이 필요 없지만, 스킬은 다르다 — 전역 등록한 스킬은 볼트 밖에서도 불리므로 볼트 경로를 알아야 한다. 기본값이 ~/second-brain 이니 다른 경로에 뒀으면 셸 설정에 알린다:

3. Obsidian 플러그인 3개 (설치 후 활성화까지)

• Git — 버전 관리·백업
• Terminal — 볼트 안에서 Claude Code 실행
• Tasks — 일지 체크박스 (완료 취소선 스니펫이 이걸 전제한다)

4. (선택) Web Clipper — 노트 이름 {{date|date:"YYMMDD"}}-{{title}}, 저장 위치 raw/external(논문은 raw/external/papers). git 은 파일 수정시각을 보존하지 않으므로 날짜는 파일명에 남겨야 남는다.

5. (선택) 자동화 등록 — 아래 「자동화」 참고. docs/machine-setup.md 에 절차가 있다.