Claude Obsidian
출처가 살아남는 옵시디언 지식 시스템
git clone https://github.com/AgriciDaniel/claude-obsidian.git자료를 넣으면 읽고 연결해서 마크다운 문서로 정리합니다. 대부분의 AI 노트 흐름은 텍스트를 저장하는 데서 끝납니다. 이쪽은 자료를 보존하고, 주장에 근거를 붙이고, 지식을 잇고, 다시 꺼내 쓰는 순환으로 짜여 있습니다. 원본은 내용 주소 방식으로 변형 없이 남고, 근거 대장에 권위와 신선도, 지지와 반박, 확신도, 검토 상태가 기록됩니다. 지지받지 못하거나 서로 어긋나는 주장은 감춰지지 않고 그대로 드러납니다. 결과물은 평범한 마크다운 디렉터리라 플러그인 캐시나 클라우드에 갇히지 않습니다. 병렬 작업자는 초안만 내고 조율자 하나가 되돌릴 수 있는 거래로 반영합니다.
판단
이럴 때 씁니다
- 읽은 자료가 요약만 남고 근거가 사라지는 것이 문제일 때
- 파일 소유권을 넘기지 않고 지식을 쌓고 싶을 때
- 옵시디언 볼트를 에이전트와 함께 관리할 때
이럴 땐 쓰지 마세요
- 빠르게 메모만 하려면 절차가 무겁습니다
- 옵시디언을 쓰지 않으면 값이 반으로 줄어듭니다
- 설정 명령마다 승인 단계를 거쳐야 합니다
차별점
- 원본을 내용 주소 방식으로 변형 없이 보존합니다.
- 근거 대장에 권위와 신선도, 지지와 반박, 확신도를 기록합니다.
- 지지 없는 주장과 어긋나는 주장을 감추지 않고 남깁니다.
- 결과가 평범한 마크다운이라 도구 없이도 읽힙니다.
워크플로
- 01저장소를 받습니다. 이 체크아웃은 볼트가 아닙니다.
- 02볼트를 따로 만들어 초기화 계획을 미리 봅니다.
- 03계획 해시를 확인하고 그 작업만 적용합니다.
- 04옵시디언에서 그 디렉터리를 엽니다.
- 05자료를 넣고 문서를 만들고 다시 꺼내 씁니다.
주요 명령
| 명령 | 설명 |
|---|---|
git clone https://github.com/AgriciDaniel/claude-obsidian.git | 제품을 받습니다. |
python3 scripts/claude-obsidian.py init "$HOME/Documents/MyKnowledgeVault" | 볼트 초기화 계획을 만듭니다. 이 단계는 아직 적용이 아닙니다. |
--approved-plan-sha256 <sha256> --apply | 계획 해시를 확인한 뒤 그 작업만 적용합니다. |
함정
설치 전에 확인하세요
- 저장소 체크아웃과 볼트는 다른 디렉터리입니다. 같은 곳에 두면 구조가 꼬입니다.
- 바꾸는 명령은 먼저 계획을 보여 주고 해시를 승인해야 적용됩니다. 한 번에 끝나지 않습니다.
- 이미 있는 볼트는 초기화가 아니라 채택 절차를 써야 합니다.
- 병렬 작업자는 초안만 내고 반영은 조율자 하나가 합니다. 동시에 쓰기를 기대하면 안 됩니다.
비교
AI 노트 도구는 대개 요약을 저장하고 원본과의 연결을 잃습니다. 이쪽은 근거가 살아남는 것을 설계 목표로 잡아 검토 상태까지 기록합니다. 절차가 늘어나는 대신 나중에 그 문서를 믿을 근거가 남습니다.
최근 변경
오래된 볼트를 옮겨 붙이는 절차를 단단히 했습니다. 파일 경로 대신 묶음 이름을 쓰는 목록이나 원본 관찰이 1024개를 넘는 경우가 대상입니다. 풀리지 않은 묶음 이름은 검토 전 수동 원본으로 남기고 대응 관계나 해시를 지어내지 않습니다.