Claude Code로 CMDS 시스템 파일 개인화 하기

소개

ALT

한국 컴퓨터 시스템의 다이어그램

제가 구상하고 있는 저의 PKM input output 구조

시도하고자 했던 것

Gpters Study 21기 옵시디언 온보딩 과정의 일환으로, Claude Code를 활용해 나만의 CMDS 시스템 파일 5개를 자동 생성하고, 이를 기반으로 볼트 전체를 세팅해보았습니다.

단순히 템플릿을 복사하는 것이 아니라, 인터뷰 답변을 바탕으로 내 실제 활동(AI 실험 / 투자 / JSHA 병원 / 개인 성장)에 맞게 커스터마이징된 시스템 파일을 만들고 싶었습니다.

추가로, 기존 OWEN-MCP 볼트의 CLAUDE.md를 v2.0으로 업그레이드하면서 Claude 외의 다른 AI 도구(GPT, Gemini, Cursor 등)도 볼트 규칙을 이해할 수 있는 범용 가이드 체계를 구축했습니다.

왜 이 작업이 필요했는가

"시스템 파일이 정리되지 않으면, AI가 읽어도 헷갈리고, 나도 헷갈린다."

기존에 4개 파일(CLAUDE.md, OWEN-MCP.md, 🏛 OWEN-MCP Guide.md, 🏛 OWEN-MCP HQ.md)이 있었지만, 각 파일의 읽는 대상과 목적이 명확히 분리되지 않았습니다. 특히:

1. 시스템 파일 간의 역할 분리가 모호했다 — CLAUDE.md에 기술 구현과 철학이 섞여있고, 외부 AI(GPT, Gemini)가 참조할 독립 가이드가 없었습니다.

2. AGENTS.md가 없었다 — Claude Code 외의 채팅 AI가 볼트 규칙을 이해할 방법이 없어서, 매번 규칙을 수동으로 붙여넣기 해야 했습니다.

진행 방법

사용 도구: Claude Code (claude.ai/code)

Step 1. CMDS 시스템 파일 5개 생성

먼저 인터뷰 파일과 템플릿을 Claude Code에 전달하고, 개인 맞춤 시스템 파일 생성을 요청했습니다.

사용 프롬프트:

CMDS System Files_Interview.md의 답변을 읽고,
CMDS System Files_v3/ 폴더의 템플릿을 참고하여
나에게 맞는 CMDS 시스템 파일 5개를 볼트 최상위에 만들어줘.

Claude가 인터뷰 답변을 분석해서 템플릿과 비교하고, 7가지 커스터마이징 포인트를 도출해 플랜을 먼저 제안했습니다. 승인 후 5개 파일을 생성했습니다.

생성된 파일:

Step 2. 볼트 전체 자동 세팅

사용 프롬프트:

볼트 최상위에 있는 CMDS 시스템 파일 5개(CMDS.md, CLAUDE.md, AGENTS.md,
🏛 CMDS Head Quarter.md, 🏛 CMDS Guide.md)를 읽고,
그 내용을 기반으로 볼트를 세팅해줘.
폴더 구조, CMDS 카테고리 노트, 인덱스 노트, 템플릿을 만들어줘.

결과: 47개 폴더, 카테고리 노트 62개, 인덱스 노트 11개, 템플릿 6개 자동 생성
결과물은 훌륭했지만 기존의 사용하던 지식 체계를 유지하고 싶어서 기존 시스템과 비교 분석 후 추가하기로 결정했습니다.

Step 3. CLAUDE.md v2.0 업그레이드 (OWEN-MCP 볼트)

기존 CLAUDE.md와 CMDSPACE v3를 비교 분석하도록 요청하자, Claude가 먼저 분석 결과를 정리해서 도입 가치별로 분류해줬습니다.

비교 분석 결과 (Claude 제안):

🔴 즉시 도입 가치 높음

1. AGENTS.md 신규 생성

• OWEN-MCP는 CLAUDE.md만 있는데, Gemini CLI / Cursor 등 다른 AI 에이전트용 가이드가 없음

• CLAUDE.md에서 Claude 특화 내용 빼고 범용화한 AGENTS.md 만들면 멀티 에이전트 환경에 대비 가능

2. Obsidian CLI 통합 (CLAUDE.md에 추가)

• CMDSPACE에는 obsidian search, obsidian backlinks, obsidian property:set, obsidian orphans 등 실용적인 CLI 섹션이 있음

• OWEN-MCP CLAUDE.md에 이 섹션이 없어서 Claude가 Obsidian 네이티브 기능을 활용 못하고 있음

3. 시스템 파일 버전 관리

• 모든 시스템 파일에 버전 번호 + 마지막 수정일 + 백업 경로 명시

🟡 중간 우선순위

4. Decision Tree — AI가 어느 가이드 파일을 읽어야 할지 한눈에 보이는 결정 트리

이 분석을 보고 1, 2, 3번 + Decision Tree 적용을 결정했습니다.

업데이트 내용:

• 버전 배너 추가 (🔄 Last Updated: 2026-03-18 | v2.0)

• AI 도구 선택 Decision Tree 추가

• Obsidian CLI 섹션 추가

• AI4PKM CLI 섹션 추가

Step 4. 외부 AI용 컨텍스트 문서 v2.0 업그레이드

사용 프롬프트:

그러면 외부 AI가 이 문서만 보면 옵시디언 문서 작성 규칙을 이해할 수 있는 거야?

Claude가 솔직하게 "아직 부족하다"고 답하며 빠진 항목들을 짚어줬고, AI4PKM-Context-for-External-AI.md를 🏛 OWEN-MCP Guide.md와 통합해 v2.0으로 완전 업그레이드했습니다.

새로 추가된 핵심 내용:

Step 5. Obsidian 단축키 모음 신규 작성

스터디에서 배운 단축키를 포함하여 10개 카테고리, 60개+ 단축키를 체계적으로 정리한 가이드를 새로 작성했습니다.

특히 Alt+Cmd+C(경로 복사)는 Claude Code와 연동할 때 필수적인 단축키입니다.

결과와 배운 점

배운 점

1. 시스템 파일은 "읽는 사람"을 명확히 나눠야 한다

v3의 가장 좋은 점은 파일별 독자를 명확히 구분한 것입니다:

2. "점진적 공개(Progressive Disclosure)"가 핵심이다

AI에게 모든 규칙을 한꺼번에 주면 컨텍스트가 낭비됩니다. 필요한 파일만 참조하게 하는 것이 효율적입니다. 예를 들어 Claude Code에는 CLAUDE.md만 자동 로딩하고, GPT에게는 AGENTS.md + AI4PKM Context만 주는 식입니다..

꿀팁

• 인터뷰 파일을 먼저 작성하는 것이 핵심입니다. Claude가 인터뷰 답변을 분석해서 템플릿과 비교하고, 개인화 포인트를 스스로 도출해줍니다. 개인화 하는 것이 핵심입니다.

• 플랜모드로 실행하여 플랜 제안 → 승인 → 실행 순서로 진행해서, 큰 작업도 안전하게 처리할 수 있었습니다.

• "이 문서만 보면 AI가 이해할 수 있어?"라고 물으면 Claude가 스스로 부족한 부분을 진단해줍니다. 품질 검증용 프롬프트로 유용합니다.

시행착오

• 처음에 새 볼트를 만들까 고민 — 기존 볼트를 버리고 v3 기반 새 볼트를 만들까 고민했지만, "한번에 너무 많은 것을 고치려고 하면 안 된다"는 원칙에 따라 기존 볼트에 v3 요소를 점진적으로 이식하는 방향을 선택했습니다.

앞으로의 계획

• CMDS v3 리서치 파이프라인 스킬 만들어보기 — 여러 AI 모델을 동시 활용하는 심층 리서치 자동화

• 카테고리 노트(📖, 📚) 재정비 — 기존 노트들의 CMDS 프로퍼티를 일괄 업데이트

• OpenClaw를 통해 웹크리핑, 유튜브 요약 등 웹기반 문서를 md 파일로 정리하고 원본 링크를 연결하는 워크플로우 완성하기

• 다운로드 폴더의 PDF, PPT, Image 파일등을 MD 파일로 정리하고 원본은 구글드라이브로 옮기는 스킬 개선

도움 받은 글

• CMDS System Files_v3 템플릿 — 구요한님 제공 (21기 스터디 자료)

• CMDS System Files_Interview.md — 인터뷰 기반 개인화 시스템 생성 가이드

• 21기 스터디 1주차 강의

• AI4PKM 프레임워크