본문으로 건너뛰기

옵시디언 볼트의 CLAUDE.md에 "형광색 금지" 디자인 지침을 넣어본 이야기

공대언니

2026.08.09

📝 한줄 요약

옵시디언 볼트 루트에 이미 만들어 둔 CLAUDE.md가 정확히 무슨 역할을 하는지부터 다시 짚고, 거기에 "웹앱 만들 때 형광색 쓰지 말기"라는 디자인 지침을 새 섹션으로 추가했습니다. 지침만 던져 넣은 게 아니라, 볼트 안에 이미 있는 실제 웹페이지 파일을 찾아 색상 코드를 확인하고, 그 톤을 기준 팔레트로 못 박았습니다.

바쁘시면 이것만 읽어도 됩니다:

  • CLAUDE.md는 에이전트가 그 폴더에서 작업할 때 자동으로 읽는 "지침서"라는 걸 먼저 확인했습니다.

  • 원드라이브 안 어디에 볼트가 있는지부터 찾아야 했습니다 (경로를 몰랐습니다).

  • 기존에 만들어 둔 학과 소개 웹페이지(dept-intro/index.html)의 실제 색상 코드를 근거로 삼았습니다.

  • "형광색 금지"라는 추상적인 지침을 색상 코드·대안까지 포함한 구체적인 규칙으로 바꿔 추가했습니다.

  • 핵심은 지침을 감이 아니라 볼트 안의 실제 데이터에 근거해서 썼다는 점입니다.

🎯 이런 분들께 도움됩니다

  • 옵시디언 볼트나 프로젝트 폴더에 CLAUDE.md를 두고 AI와 협업하는 분

  • "이렇게 해줘"라는 말만으로는 매번 같은 디자인 실수가 반복돼서 지쳐본 분

  • 지침 문서를 채워야 하는데 뭘 얼마나 구체적으로 적어야 할지 감이 안 오는 분

  • 코드를 몰라도 웹페이지 톤앤매너를 관리하고 싶은 비개발자

😫 문제 상황

시작은 단순한 질문이었습니다. "옵시디언에 claude.md 파일을 만들었는데, 그 용도가 뭘까?" 만들어는 놨지만 정확히 왜 필요한 파일인지 다시 확인하고 싶었던 것입니다.

용도를 확인하고 나니 바로 다음 문제가 보였습니다. 지금 CLAUDE.md에는 폴더 구조와 파일 명명 규칙만 있을 뿐, 웹앱을 만들 때 색상을 어떻게 써야 하는지에 대한 규칙이 없었습니다. 그동안 웹페이지 작업을 시킬 때마다 "형광색은 쓰지 마세요"를 매번 말로 반복해야 했던 셈입니다.

문제는 볼트 경로부터 몰랐다는 것입니다. 원드라이브 안 어디에 있는지 정확히 기억나지 않아, 파일부터 찾아야 했습니다.

🛠️ 사용한 도구

  • Claude Code: 파일 탐색, 내용 확인, 지침 문서 편집

  • Bash 검색 (find): 원드라이브 두 계정 폴더를 뒤져 볼트와 CLAUDE.md 위치 특정

  • 기존 웹페이지 파일: dept-intro/index.html — 이미 만들어 둔 학과 소개 페이지의 실제 색상 코드를 근거 자료로 사용

  • CLAUDE.md: 지침을 실제로 기록하는 대상 파일


🔧 작업 과정

볼트가 어디 있는지부터 찾기

"원드라이브에 있어"라는 답만 가지고 시작했습니다. 원드라이브 계정이 개인용과 학교용(OneDrive - 유한대학교) 두 개로 나뉘어 있어서, 먼저 .obsidian 폴더와 claude.md 파일을 기준으로 두 계정을 모두 뒤졌습니다.

결과적으로 연구/Luke_Obsidion 폴더 안에 볼트가 있었고, 그 루트에 CLAUDE.md가 있다는 걸 확인했습니다. 같은 이름의 파일이 다른 하위 폴더(GPters 온보딩 자료)에도 하나 더 있었는데, 이건 강의 자료용 예시 파일이라 실제로 고칠 대상이 아니라는 것도 함께 걸러냈습니다.

지금 CLAUDE.md에 뭐가 적혀 있는지 먼저 읽기

바로 내용을 추가하지 않고, 기존 CLAUDE.md 전체를 먼저 읽었습니다. 폴더 지도, 명명 규칙, 새 노트 만들 때의 기준까지는 잘 정리돼 있었지만, 디자인이나 코드 스타일에 대한 섹션은 전혀 없었습니다. 빈 자리가 어딘지 확인한 뒤에야 어디에 새 섹션을 넣을지 판단할 수 있었습니다.

"형광색 금지"를 감이 아니라 근거로 뒷받침하기

여기서 그냥 "형광색 쓰지 마세요"라고만 적으면 기준이 모호합니다. 그래서 볼트 안에서 실제로 쓰고 있는 웹페이지 파일(dept-intro/index.html)을 찾아 색상 코드를 뽑아봤습니다.

확인해보니 이미 남색(#1a3a5c), 블루(#2e6da4), 오렌지(#f0a500) 톤의 차분한 팔레트를 쓰고 있었습니다. "형광색을 쓰지 마라"는 말에 "대신 이런 톤을 써라"는 실제 근거가 생긴 셈입니다.

새 섹션을 만들어 지침 추가하기

이 내용을 바탕으로 CLAUDE.md에 "웹앱 개발 시 디자인 가이드라인" 섹션을 새로 만들었습니다. 세 줄로 구성했습니다.

  1. 형광색 금지 — 예시 색상 코드까지 명시

  2. 선호 톤 — 기존 페이지에서 실제로 쓰인 색상 코드를 참고 팔레트로 지정

  3. 강조가 필요할 때의 대안 — 채도를 낮추거나 명도 대비, 폰트 굵기로 강조하라는 구체적 대체 방법


✅ 결과

이전과 이후

항목

이전

이후

CLAUDE.md 안 디자인 규칙

없음

별도 섹션으로 존재

"형광색 금지" 기준

매번 말로 반복

문서에 고정, 색상 코드까지 명시

선호 팔레트

암묵적 (기억에만 존재)

기존 페이지 색상 코드로 명문화

강조 표현 방법

정해진 게 없음

채도·명도·굵기 대안 제시

볼트 경로

정확히 모름

확인 완료, 재사용 가능

결과물

  • 볼트와 CLAUDE.md 정확한 위치 확인 완료

  • "웹앱 개발 시 디자인 가이드라인" 섹션 추가 완료

  • 형광색 금지 + 대안 팔레트 + 강조 대체 방법까지 3줄 규칙으로 정리

  • 이 사례글 작성 완료

💬 이 과정에서 배운 인공지능 활용 팁

효과적이었던 것

  1. 지침을 적기 전에 기존 자료부터 근거로 찾기

    • "형광색 쓰지 마세요"보다 "지금 쓰고 있는 이 색을 기준으로 삼으세요"가 훨씬 구체적입니다.

    • 볼트 안에 이미 있는 파일(dept-intro/index.html)을 근거로 쓰니 지침에 설득력이 생겼습니다.

  2. 바로 고치지 않고 기존 문서를 먼저 읽기

    • CLAUDE.md 전체를 먼저 읽고 빈 자리를 확인한 뒤에 섹션을 추가했습니다.

    • 덕분에 기존 폴더 지도나 명명 규칙과 겹치지 않게 자연스럽게 이어붙일 수 있었습니다.

  3. 경로를 모를 땐 특징적인 파일/폴더로 좁혀서 찾기

    • 원드라이브 전체를 뒤지는 대신 .obsidian 폴더, claude.md처럼 특징적인 이름으로 좁혀서 찾았습니다.

조심할 점

  1. 같은 파일명(CLAUDE.md)이 여러 폴더에 있을 수 있으니, 어떤 파일이 "진짜 작업 대상"인지 구분해야 합니다.

  2. 지침은 금지 규칙만 적기보다 "대신 이렇게 하라"는 대안까지 같이 적어야 실제로 지켜집니다.

  3. 원드라이브처럼 계정이 여러 개인 환경에서는 경로 탐색에 시간이 걸릴 수 있다는 걸 감안해야 합니다.

🌍 다른 업무에 적용한다면?

이번 방식은 디자인 규칙 말고 다른 종류의 "암묵적 기준"을 문서화할 때도 그대로 쓸 수 있습니다.

예를 들어 문서 톤앤매너, 이메일 서식, 발표 자료 폰트 규칙 같은 것도 같은 흐름으로 정리할 수 있습니다.

  1. 지금 규칙이 어디에 있는지(또는 없는지) 확인

  2. 기존에 이미 쓰고 있는 실제 사례를 근거로 수집

  3. 금지 사항과 대안을 함께 명문화

  4. 기존 지침 문서의 적절한 위치에 이어붙이기

  5. 다음번엔 같은 지침을 반복 설명하지 않고 문서를 참조

이 순서만 지켜도 지침이 매번 말로 반복되는 일을 줄일 수 있습니다.

🚀 앞으로의 계획

다음 단계는 이 지침이 실제로 지켜지는지 새 웹앱을 만들 때 검증하는 것입니다.

예를 들면 이런 흐름입니다.

  • 다음 웹페이지 작업 요청 시 CLAUDE.md의 디자인 가이드라인이 실제로 반영되는지 확인합니다.

  • 필요하면 팔레트나 금지 색상 목록을 더 구체화합니다.

  • 디자인 외에 코드 스타일, 폰트, 레이아웃 규칙도 같은 방식으로 하나씩 채워 넣습니다.

이렇게 되면 CLAUDE.md가 단순한 폴더 지도를 넘어, 이 볼트에서 나오는 모든 결과물의 톤앤매너를 관리하는 기준 문서가 됩니다.

📋 재사용 가능한 요청문

요청문 1: 지침 문서의 용도 확인하기

[파일 이름]이 정확히 어떤 역할을 하는 파일인지 설명해줘.
내가 헷갈리고 있는 부분이 있는지도 같이 짚어줘.

요청문 2: 근거 있는 지침 추가하기

[지침 문서]에 [규칙]을 추가하고 싶어.
그냥 규칙만 적지 말고, 이 폴더/프로젝트 안에 이미 있는 실제 사례를 찾아서 근거로 삼아줘.
금지 사항뿐 아니라 대안도 같이 적어줘.

요청문 3: 작업 과정을 사례글로 만들기

방금 진행한 작업을 지피터스에 올릴 활용 사례 게시글로 정리해줘.
문제 상황, 시행착오, 결과를 이야기 형식으로 풀어줘.

🖼️ 추천 이미지

  • 문제 상황 섹션: 기존 CLAUDE.md에 디자인 규칙이 없는 상태를 보여주는 파일 캡처

  • 작업 과정 섹션: dept-intro/index.html의 색상 코드가 보이는 화면

  • 결과 섹션: 새로 추가된 "웹앱 개발 시 디자인 가이드라인" 섹션 캡처

📌 마무리

이번 작업의 핵심은 "형광색을 쓰지 마라"는 규칙 자체가 아닙니다.

그 규칙을 감이 아니라 볼트 안에 이미 있는 실제 데이터(기존 웹페이지 색상 코드)에서 끌어와, 다음에도 참조할 수 있는 문서로 고정했다는 점입니다.

지침 문서를 잘 쓰는 사람은 "규칙을 나열하는 사람"이 아니라 "이미 있는 근거를 찾아 규칙으로 바꾸는 사람"입니다. 이번 작업은 그 흐름을 작게 완성한 사례입니다.

1

함께 이야기해요 1

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

박승현 프로필 이미지
박승현2026.08.11

역시 원래 공부하시는(?) 분들이 옵시디언이든 PKM이든 금방 적용하시는 것 같아요. Llm이 원래 금지규칙은 잘 안지켜서 대신 할 지침을 적는게 더 효과적이라는 이야기를 들은 적이 있는데, 직접 확인 하셨네요.

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

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

이런 사례도 있어요

사례 전체 보기