한 줄 요약: 지피터스 22기 1주차(Vault 구축) 강의를 따라가다가 내 볼트의 깨진 위키링크 22개를 발견했고, 이틀 동안 진단 → 복구 → 허브 3개 생성 → 템플릿화까지 한 호흡에 끝냈다.
정량 결과: 위키링크 사용률 6% → 10%, 6개 허브가 모두 외부 백링크 10+ 도달,
hub-template.md공식 자산 확보, 70-collected가 처음으로 지식 그래프에 진입.
1. 소개 — 무엇을 시도했고, 왜 했나
시작점: 강의 자료를 그대로 따라가지 않기로 했다
2026년 5월 25일 월요일 아침, 지피터스 22기 1주차 강의 자료(week1-slides.html, "Vault + Claude Code")를 받았다. 강의가 제시하는 6단계 — 폴더 구조, 마크다운 4가지, 프론트매터 8필드, 백링크 그래프, 인덱스 위키, 슬래시 커맨드 — 를 내 환경과 비교해보니 흥미로운 발견이 있었다.
#
강의 제시
내 환경
평가
1
Vault 폴더 + Claude Code
~/Documents/workspace Johnny Decimal
✅ 더 진화
2
마크다운 4가지 + 프론트매터 8필드
미니멀 원칙(tags/aliases/related만)
✅ 의도적 단순화
3
백링크 그래프
zettelkasten-linker 스킬 운영 중
✅ 별도 시스템
4
하이브리드 인덱스 위키
Johnny Decimal로 변형
⚠️ 다른 방식
5
CLAUDE.md
글로벌+프로젝트 모두 정교
✅ 한 수 위
6
슬래시 커맨드 3개
50개+ 스킬 운영 중
✅ 한 수 위
강의의 표준을 그대로 따랐다면 미니멀 원칙(메모리 feedback_minimal-frontmatter.md)이 깨졌을 것이다. 표준은 출발점이지 종착점이 아니다. 그래서 옵션 B — 기존 환경에 매핑·보완 — 를 선택했다.
진짜 문제 발견
강의의 "백링크 그래프" 단계에서 내 볼트를 점검했다.
find . -name "*.md" -not -path "*/.git/*" | wc -l # 974
grep -rl "\[\[" --include="*.md" . | wc -l # 58 → 6%
974개 노트 중 위키링크 사용 파일은 단 58개(6%). 그나마도 CLAUDE.md의 "이동 이력"을 보니, 두 달 전 Johnny Decimal로 폴더 재구성을 하면서 폴더는 옮겼는데 그 폴더를 가리키는 위키링크는 옛 경로 그대로 22개가 방치돼 있었다. 5개 허브 노트(habits, philosophy, ai-automation 등) 대부분이 그래프에서 끊긴 고립 상태.
가설을 다시 세웠다: "강의를 따라가는 것보다, 내 볼트의 부채를 청소하고 운영 사이클을 정착시키는 것이 1주차의 진짜 학습이다. 4주차 MCP 시연에서 Claude가 vault를 자율 탐색하려면 그래프가 살아 있어야 한다."
2. 진행 방법 — 도구와 워크플로우
사용한 도구
Claude Code (Sonnet 4.6 1M context) — 메인 작업 파트너
zettelkasten-linker 에이전트 — 974개 노트 전수 진단 위임 (별도 context window)
Obsidian — 위키링크·그래프 시각화
bash sed/grep — 일괄 치환 + 무결성 검증
Johnny Decimal 폴더 시스템 — 내 운영 컨벤션
CLAUDE.md (글로벌+프로젝트) — 운영 원칙 영구 기록
전체 워크플로우 (이틀 8단계)
[Day 1 — 2026-05-25 (월)]
오전 ① 진단 → grep으로 깨진 링크 22개 식별 (5개 패턴)
② 복구 → sed 일괄 치환 + Daily Note 자동 연결 로직
점심 ③ baseline → 에이전트 위임 (974개 전수 스캔, 15분)
오후 ④ n=1 허브 → running-hub.md (12섹션, 723회 자산)
저녁 ⑤ n=2 허브 → gg-work-hub.md (13섹션, 경기도청 자산)
[Day 2 — 2026-05-26 (화)]
오전 ⑥ 액션 실행 → 진단 단계 1+2 (37개 링크, 90분)
오후 ⑦ 옵션 A 마무리 → 23개 추가, 100파일 도달
저녁 ⑧ n=3 템플릿화 → reading-hub.md (14섹션) + hub-template.md
Day 1 ① — 깨진 위키링크 5가지 패턴 식별
CLAUDE.md의 폴더 "이동 이력" 표를 보고 옛 경로 → 새 경로 매핑을 도출했다.
옛 경로
새 경로
발생 이유
[[30-knowledge/33-relationships/...]]
[[30-knowledge/33-knowledge-hub/...]]
폴더 통합
[[30-knowledge/36-philosophy/...]]
[[30-knowledge/34-learning/...]]
카테고리 재편
[[30-knowledge/38-habits/...]]
[[30-knowledge/33-knowledge-hub/...]]
허브로 흡수
[[40-personal/45-notes/...]]
[[40-personal/46-notes/...]]
번호 변경
[[10-projects/14-relationship-management/...]]
[[20-operations/23-networking/relationship-management/...]]
사업 운영 영역으로 이동
Day 1 ② — 일괄 치환 + Daily Note 자동 연결
# 13개 파일에 5개 패턴 일괄 치환
for f in "${files[@]}"; do
sed -i '' \
-e 's|\[\[30-knowledge/33-relationships/|\[\[30-knowledge/33-knowledge-hub/|g' \
-e 's|\[\[30-knowledge/36-philosophy/|\[\[30-knowledge/34-learning/|g' \
-e 's|\[\[30-knowledge/38-habits/|\[\[30-knowledge/33-knowledge-hub/|g' \
-e 's|\[\[40-personal/45-notes/|\[\[40-personal/46-notes/|g' \
-e 's|\[\[10-projects/14-relationship-management/|\[\[20-operations/23-networking/relationship-management/|g' \
"$f"
done
# 검증
grep -rl "\[\[30-knowledge/33-relationships" --include="*.md" . # 0개 OK
결과: 13개 파일, 23 insertions / 23 deletions, 새 경로 7개 모두 실존 확인.
동시에 .claude/commands/daily-note.md에 Daily Note 자동 위키링크 채움 로직을 추가했다.
# 어제 (YY-MM-DD(요일) 형식)
YESTERDAY_DATE=$(date -v-1d +"%y-%m-%d")
YESTERDAY_DAY=$(LC_TIME=ko_KR.UTF-8 date -v-1d +"%a" | sed 's/요일//')
# 이번 주 일요일 (YYMMDD-WXX 형식)
DOW=$(date +%w)
SUNDAY_OFFSET=$(( (7 - DOW) % 7 ))
SUNDAY=$(date -v+${SUNDAY_OFFSET}d +"%y%m%d")
WEEK_NUM=$(date -v+${SUNDAY_OFFSET}d +"%V")
인라인 템플릿에 자동 채움 섹션:
## 🔗 관련 노트
- 어제: [[26-05-24(일)]]
- 이번 주: [[260531-W22]]
5분 투자 × 365일 = 30시간 절약 — 자동화는 한 번 만들면 매일 작동한다.
Day 1 ③ — 에이전트 위임 baseline 진단
zettelkasten-linker 스킬을 직접 실행하지 않고 에이전트에 위임했다. 이유:
vault 전체 스캔은 토큰 소비가 크고 main context 오염 가능성
에이전트는 독립 context window에서 작업 후 요약만 반환
974개 파일 raw output이 main에 쏟아지지 않음
위임 프롬프트의 핵심 5가지:
배경(오전 복구 회고 경로 명시)
폴더 구조(Johnny Decimal) + 분석 제외 영역
우선순위: 허브 검증(최우선) → 40-personal → 70-collected → running
제약: 미니멀 프론트매터, 노트 수정 금지, Strong connection만
출력 형식: Executive Summary + 4 Phases + 품질 이슈 + 다음 단계
15분 대기 — 의심과 확인이 있었다. "왜 이렇게 오래 걸리지?" 사용자가 작업 중단 → 재개 지시. 사후 분석 결과:
974개 파일 전수 grep 스캔
6개 허브 각각 백링크 역추적
Strong connection 판단 위해 후보 노트 본문 읽기
보고서 272줄 작성
→ 다음번 위임 시 예상 소요 시간 사전 명시 ("974개 파일 스캔으로 약 15분 소요 예상") — 신뢰의 핵심.
검증: 에이전트 산출물을 그대로 신뢰하지 않고 두 가지 cross-check.
수치 검증: 허브 백링크 수가 실제 grep 결과와 일치하는지