본문으로 건너뛰기

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

OWEN NAM

2026.03.22

Claude Code로 CMDS 시스템 파일 개인화 하기 본문 이미지

소개

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

제가 구상하고 있는 저의 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개 파일을 생성했습니다.

생성된 파일:

파일

크기

역할

주요 커스터마이징 포인트

CMDS.md

25KB

컨텍스트 & 철학 (WHY & WHAT)

4개 Division (AI/투자/JSHA/개인), 워크플로우 5개 정의

🏛 CMDS Head Quarter.md

5.1KB

네비게이션 허브 (WHERE)

100-800 카테고리 전체 링크맵

🏛 CMDS Guide.md

12KB

운영 표준 (STANDARDS)

투자/JSHA 노트 타입, 커스텀 인덱스

CLAUDE.md

11KB

기술 구현 가이드 (HOW)

MacBook 단일 환경, Google Drive 동기화

AGENTS.md

7.6KB

외부 AI 컨텍스트 (채팅 AI용)

남승균 프로필, 4대 부문(의료/투자/AI/콘텐츠) 명시

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으로 완전 업그레이드했습니다.

새로 추가된 핵심 내용:

섹션

내용

YAML 들여쓰기 규칙

YAML = 2 spaces, Markdown body = TAB (시각적 예시 포함)

Wikilink 따옴표 규칙

YAML 내 [[]]는 반드시 "" 감싸기

AI 산출물 작성 가이드

완전한 YAML 템플릿 + 검토 후 처리 워크플로우(승인/수정통합/거부)

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

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

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


결과와 배운 점

배운 점

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

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

파일

독자

핵심 질문

CMDS.md

모든 LLM

WHY & WHAT — "이 시스템은 왜 존재하는가?"

CLAUDE.md

Claude Code

HOW — "코드로 어떻게 작업하는가?"

AGENTS.md

채팅 AI (GPT, Gemini)

CONTEXT — "이 사용자는 누구인가?"

🏛 Guide.md

사용자 + AI

STANDARDS — "규칙이 뭔가?"

🏛 HQ.md

사용자

WHERE — "어디에 있는가?"

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 프레임워크

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

oneshot 프로필 이미지
oneshot2026.03.30

베스트 발표가 스터디 때 들은 것보다 한 단계 업그레이드 되었군요. AI와 대화를 많이 해야 한다는 데 인사이트 얻었습니다.

oneshot 프로필 이미지
oneshot2026.03.24

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

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기