옵시디언 CMDS 5단계 설치부터 '말로 노트 열기' 완성까지

약속을 지키다 — CMDS 5단계 설치부터 '말로 노트 열기' 완성까지

소개

3월 23일, 저는 제 옵시디언 볼트를 CMDS 기준으로 분석하고 이렇게 선언했습니다.

"3단계 개선을 4/7 발표 전에 완성하겠다."

3월 25일, 이태극 스터디장님의 강의를 듣고 Local REST API 플러그인을 설치하면서 또 선언했습니다.

"전체 시스템 구현은 CMDS 기초 정리 이후로 미루겠다. CMDS 5개 항목 먼저 완성하기."

3월 28일 오늘, 그 두 가지 약속을 모두 지켰습니다.

진행 방법

Claude Code와 함께 5주간의 학습 내용을 하나씩 실행했습니다. 수업에서 배운 것을 즉시 실행하고, 이전 사례게시글에서 남긴 '앞으로 할 것'을 하나씩 지워나가는 방식으로 진행했습니다.

전체 여정 — 5주간의 이야기

1장. 3월 23일 — 내 볼트의 민낯을 봤다

CMDS 실습 시간에 제 볼트 전체를 CMDS 기준으로 분석했습니다. 결과는 참담했습니다.

발견한 문제:

• 🏛 CMDS Guide.md — 파일은 있는데 내용이 거의 비어 있음

• 사례게시글이 폴더 4곳에 흩어져 있음

• 강의 요약이 3곳에 분산되어 있음

• 파일들이 각자의 섬 — 백링크 연결 없음

그래서 3단계 계획을 세웠습니다.

마지막 줄에 이렇게 썼습니다:

"AI에 위임할 부분과 직접 개입할 부분을 명확히 설계하는 것이 핵심입니다. 이 설계를 3/24부터 시작하여 4/7 발표에서 공유하겠습니다."

2장. 3월 25일 — 강의를 듣고 딱 하나만 했다

이태극 스터디장님의 강의가 인상적이었습니다.

"말 한마디 하면 옵시디언 노트가 열린다."

저는 그 시연을 보며 충격을 받았습니다. 클릭도, 경로 입력도 없이 — 그냥 말로.

그런데 솔직하게 사례게시글에 적었습니다.

"저는 CMDS 5개 항목이 아직 제대로 정리되지 않은 상태입니다. 기초 공사도 안 된 집에 인테리어 자동화 시스템을 얹으면, 나중에 기초 공사할 때 다 뜯어야 하는 상황이 됩니다."

그래서 전체 시스템 구현은 미루고, 딱 하나만 했습니다. Local REST API 플러그인 설치.

그리고 앞으로 할 3가지를 공개적으로 선언했습니다:

1. CMDS 5개 항목 먼저 완성하기

2. CMDS 완성 후 워크스페이스 + CLI 연동 적용

3. memory → rules 승격 실험

3장. 3월 26일 — AI가 혼자 448개 파일을 정비했다

5주차 수업에서 배운 것을 바로 실행했습니다.

Claude Code에게 한마디 했습니다.

"CMDS 볼트 정비를 끝까지 완수해줘. 나한테 묻지 말고."

그리고 커피 한 잔 마시면서 지켜봤습니다.

7단계 자동 정비 결과:

YAML 보유율: 15% → 89%

저는 코딩을 모릅니다. AI가 Python 스크립트를 짜고, 실행하고, 오류를 고치면서 혼자 다 해줬습니다.

4장. 3월 28일 — 오늘, 세 가지 약속을 모두 지켰다

홍콩 출발 전날이었습니다. 짐도 싸야 했고, 은행 볼 일도 있었습니다. 그런데 마음 한구석에 걸려 있던 것들을 오늘 다 해결했습니다.

4-1. 첫 번째 약속: CMDS Guide.md 완성

🏛 CMDS Guide.md 파일은 3월 23일에 발견했을 때 거의 비어 있었습니다. CMDS 시스템의 핵심 규칙서인데, 껍데기만 있는 상태였습니다.

오늘 5개 섹션으로 완성했습니다:

이 파일 하나가 있으면 AI가 "어디에 뭘 저장해야 하는지", "어떤 태그를 달아야 하는지"를 정확히 알 수 있습니다. 제가 말 안 해도.

4-2. 두 번째 약속: '말로 노트 열기' 완성

3월 25일에 플러그인만 설치하고 멈췄던 그 작업을 오늘 완성했습니다.

문제: Local REST API 플러그인은 설치됐는데, Claude Code가 어떻게 노트를 열어야 하는지 몰랐습니다.

해결: 옵시디언 설정에서 API 키를 발급받아 CLAUDE.md에 등록했습니다.

# CLAUDE.md에 추가한 것
- URL: https://127.0.0.1:27124/
- API Key: [발급받은 키]
- 트리거 규칙: "XXX 노트 열어줘" → curl 명령으로 자동 실행

테스트 결과:

저: "홈 노트 열어줘"
Claude Code가 curl 명령 실행
옵시디언에서 🏠 홈.md 자동으로 열림

처음에 HTTP로 연결했다가 실패했고 (HTTPS였습니다), API 키를 빠뜨렸다가 403 오류도 봤습니다. 두 번 막혔고 두 번 고쳤습니다.

그리고 열렸습니다.

4-3. 세 번째 약속: memory → rules 승격

Claude Code의 memory에 그동안 자동으로 쌓인 내용들이 있었습니다. 중요한 규칙인데 별도로 선언되지 않은 것들.

오늘 이것들을 CLAUDE.md의 영구 규칙으로 올렸습니다:

memory는 AI가 자동으로 쓰는 수첩입니다. rules는 AI가 항상 먼저 읽는 매뉴얼입니다. memory에 있는 것은 AI가 때에 따라 기억하거나 못 기억할 수 있습니다. rules에 있는 것은 매번 정확하게 실행합니다.

핵심 인사이트

인사이트 1. "기초 없이 얹으면 안 된다"를 실천했다

3월 25일 강의 직후, 자동화 전체를 따라 하고 싶은 마음이 굴뚝같았습니다. 그런데 "CMDS 기초부터"라고 스스로 브레이크를 걸었습니다.

그게 맞았습니다.

지금 '말로 노트 열기'가 제대로 작동하는 이유는 — GUIDE.md가 있어서 AI가 볼트 구조를 알고, rules에 트리거가 등록되어 있어서 자동으로 실행되기 때문입니다. 기초가 없었으면 겉모양만 따라 하고 제대로 작동하지 않았을 겁니다.

인사이트 2. 공개 선언이 실행을 만든다

사례게시글에 "앞으로 할 것"을 적는 행위가 의외로 강력했습니다. 그냥 머릿속 계획이었으면 흐지부지됐을 겁니다. 공개적으로 선언하니까 "지켜야 한다"는 압박이 생겼고, 결국 다 했습니다.

스터디의 진짜 힘은 여기 있는 것 같습니다. 내용을 배우는 것만이 아니라, 배운 것을 실행하고 공개하는 사이클.

인사이트 3. AI는 수행자, 나는 설계자

이 과정에서 제가 직접 코딩한 것은 단 하나도 없습니다. Python 스크립트도, curl 명령도, YAML 구조도 — 다 AI가 했습니다.

그런데 무엇을 만들어야 하는지, 왜 그것이 필요한지, 어느 단계에서 해야 하는지 — 이것은 제가 결정했습니다.

AI는 수행자이고, 저는 설계자입니다. 이 역할 분담을 이번 5주 동안 몸으로 배웠습니다.

지금 내 볼트는

3월 23일 이전과 비교:

마무리

사실 오늘은 내일 홍콩 출발이라 짐을 싸야 하는 날이었습니다. 그런데 이 작업들이 자꾸 마음에 걸렸습니다.

"출발 전에 끝내자."

그리고 끝냈습니다.

오늘 새벽 제 꿈(꿈기록#149)에서도 "발표 준비 못 하고, 환전도 못 하고" 불안하게 깼습니다. 무의식은 늘 뭔가 못 한 것을 끄집어냅니다. 그 불안이 오늘 이 작업들을 완성하게 만든 것일 수도 있겠습니다.

끝나고 나니 홍콩에 편하게 갈 수 있을 것 같습니다.

"완성된 볼트 = Claude의 장기 기억. 홍콩에서 돌아와도 모든 것이 그 자리에 있다."

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

클코라는 착하고 유능한 직원을 얻은 느낌이다.

아이디어를 내고 말만 하면 다 해준다.

과정 중에 어떤 시행착오를 겪었나요?

클로드코드가 옵시디언 파일을 열어 주었었는데, 어제 옵시디언이 닫혀 새로 열어서인지 클로드코드가 자신은 손이 없어서 파일을 여는 기능이 없다고 빠득빠득 우기는 것이였습니다. 이 내용을 잊고 있다가 하뚱님이 나의 사례게시글에 답변을 달아주어 다시 제글을 읽어보고 LOCAL REST API를 넣었더니 클로드코드가 옵시디언 파일을 열어 보여주는 것이였습니다.

도움 받은 글 (옵션)

구요한님 이태극님 강의

이전 편:

• 지피터스_사례게시글_CMDS실습_분석_설계 — 3월 23일, CMDS 분석과 설계

• 지피터스_사례게시글_ClaudeCode옵시디언연동자동화 — 3월 25일, 강의 후 첫 시도

• 지피터스_사례게시글_5주차_CMDS볼트정비자동화 — 3월 26일, 448개 파일 정비