CLAUDE.md에 적어두면 진짜 효과 보는 5줄 + 직무별 7개 (총 40줄)

CLAUDE.md 5줄 + 직무별 7개 (총 40줄)

릴스에서 보여드린 보편 5줄에 더해, 직무별로 추가하면 더 강력해지는 5줄을 7개 직무(마케터·기획·개발·디자이너·HR·영업·데이터)별로 정리했습니다. 그대로 복붙하는 7개 CLAUDE.md 템플릿 파일까지.

---

들어가며 — CLAUDE.md가 뭐고 왜 필요한가

Claude Code는 시작할 때 프로젝트 폴더 맨 위 CLAUDE.md 파일을 자동으로 읽고 적용합니다. 모든 명령에 영향을 주는 환경 파일이에요.

매 대화마다 "나는 마케터야 / 톤은 친근하게 / 결과는 한국어로" 반복하셨다면, 그 5줄을 한 번 박아두면 다음부터 자동.

근데 어떤 5줄을 적느냐가 핵심이에요. 흔한 5줄(직무·톤·형식)은 누구나 떠올릴 수 있는 일반론. 진짜 효과를 결정하는 건 추측·환각·사고를 막는 안전 5줄입니다.

---

보편 5줄 (모든 직무에 권장)

프로젝트 루트의 CLAUDE.md 파일에 그대로 복붙. 모든 프로젝트 공통이면 ~/.claude/CLAUDE.md 한 개에 박아두면 끝.

1. "확실하지 않으면 '모른다'고 말해. 검증 안 한 건 단정하지 마."

왜 효과적인가: Claude가 가장 흔히 하는 실수 = 그럴듯한 추측을 사실처럼 답하는 환각. 이 한 줄 박아두면 "확실하지 않다 / 검증해보고 알려드릴게요" 같은 표현이 자주 등장. 회의·보고서에서 추측 데이터로 깨지는 일 70% 감소.

2. "변경 전에 비슷한 패턴부터 찾아보고, 영향 범위를 한 줄로 알려줘."

왜 효과적인가: 한 군데 고치고 다른 곳 망가지는 사고 방지. Claude가 변경 전에 grep·LS로 비슷한 패턴을 먼저 탐색 → "이 변경은 X 파일에도 영향 있어요"라고 미리 알려줌.

3. "답하기 전에 헷갈리는 거 3개 먼저 질문해. 추측 X."

왜 효과적인가: 잘못 이해하고 30분 헛수고 X. 명확화가 우선. Claude가 작업 전에 "이런 뜻 맞나요?" "A인지 B인지" 묻고 시작.

4. "각 단계 끝날 때마다 한 줄로 무엇을 했는지 알려줘."

왜 효과적인가: Claude가 뭘 하고 있는지 추적 가능. 중간에 멈춰도 어디서 끊긴지 명확. 긴 작업도 진행 상황 가시화.

5. "결과 마지막에 '검증 안 된 부분'을 별도로 표시해줘."

왜 효과적인가: 회의·보고서에 가져가기 전 "이건 확인 필요" 미리 표시. 발표 자리에서 모르고 단언하다 깨지는 일 차단.

---

직무별 추가 5줄 (보편 5줄 위에 덧붙이기)

🎨 마케터 (콘텐츠·캠페인·SEO)

## 마케팅 작업 규칙

1. 카피·문구 작성 시: 타겟 페르소나·플랫폼·톤을 매번 명시. 명시 안 하면 일반 톤 X, 질문 후 시작.

2. 데이터·통계 인용 시: 출처 (URL 또는 보고서명) 옆 표시. 출처 모르면 "(출처 미확인)" 라벨.

3. 경쟁사·타사 언급 시: 비방·과장 표현 X. 공정 비교 가능한 객관 정보만.

4. SEO 키워드: 자연스럽게 본문에 녹이기. 키워드 채워 넣기 X. 사용자 검색 의도 추측 후 작성.

5. 결과물 형식 기본: 인스타 카피는 80자 이내 / 블로그는 카테고리·소제목·인용 포함 / 슬로건은 5단어 이내 + 의도 1줄 설명.

📋 기획 (제안서·로드맵·요구사항)

## 기획 작업 규칙

1. 제안서·기획서: 항상 (1) 문제 정의 (2) 가설 (3) 검증 방법 (4) 예상 결과 (5) 리스크 5개 섹션.

2. KPI·수치 인용: 가설인지 검증된 데이터인지 (가설) (검증) 라벨. 출처 명시.

3. 우선순위 매길 때: ICE/RICE 같은 프레임워크 명시 후 점수. 그냥 "우선순위 높음" X.

4. 이해관계자 언급: 실명 또는 직책. 가상 인물 만들지 X.

5. 결과물 형식: 제안서는 1페이지 요약 + 본문 / 로드맵은 분기·월·주 단위 분리 / 요구사항은 사용자 시나리오 기반.

💻 개발 (코드·아키텍처·테스트)

## 개발 작업 규칙

1. 코드 변경 전: 항상 grep으로 비슷한 패턴 검색 → 영향 범위 보고 → 'go' 후 변경.

2. 테스트 코드: 새 기능 추가 시 단위 테스트 같이 작성. 엣지 케이스 5개 먼저 나열.

3. 커밋 메시지·PR: feat/fix/refactor/docs/test 접두어. 변경 이유·영향 범위 본문에.

4. 의존성 추가: 라이브러리 추가 전 라이선스·번들 사이즈·대안 라이브러리 비교 1줄.

5. 보안: 비밀키·API 키·개인정보 절대 코드에 직접 X. .env 분리. 커밋 전 점검.

🎨 디자이너 (UI/UX·시안·시스템)

## 디자인 작업 규칙

1. 시안 작성 시: 컴포넌트별 사용자 시나리오·접근성·반응형 고려사항 옆에 메모.

2. 디자인 시스템 토큰: 직접 변경 X. 변경안을 .md로 먼저 보고 후 'go'.

3. 컬러·폰트: 토큰 이름 (예: $primary-500) 사용. 헥사 직접 박지 X.

4. 컴포넌트 명세: (1) 용도 (2) 변형 (3) 상태 (4) 접근성 (5) 사용 예시 5개 섹션.

5. 사용자 리서치 인용: 인터뷰 ID·날짜·플랫폼 명시. "사용자가 말하길" 같은 일반화 X.

👥 HR (채용·평가·문서)

## HR 작업 규칙

1. 직원 정보: 이름·연락처·평가 직접 노출 X. 항상 마스킹 (예: 김OO, A씨).

2. 채용 공고·평가 작성: 차별 소지 표현 (성별·연령·종교·학벌) 자동 점검 → 보고.

3. 법률·규정 인용: 정확한 조항 번호 + 시행일. 추측 시 "(확인 필요)" 라벨.

4. 인사 기록·평가: 사실과 의견 분리. 사실은 (사실), 평가는 (의견) 라벨.

5. 결과물 형식 기본: 채용 공고는 (1) 회사 (2) 역할 (3) 자격 (4) 우대 (5) 처우 (6) 절차 / 평가는 (1) 성과 (2) 행동 (3) 협업 (4) 성장 영역.

💼 영업 (제안·CRM·고객 커뮤니케이션)

## 영업 작업 규칙

1. 고객 정보: 이름·회사·연락처·미팅 내용 절대 외부 공유 X. 마스킹 후 작업.

2. CRM 자동 업데이트 X: 변경안을 .csv 또는 .md로 출력 → 사용자 검토 후 'go'.

3. 영업 메일·제안: 격식·친근·단호 3가지 톤 선택지 제시 후 사용자 결정.

4. 가격·계약 조건: 회사 공식 가격표·계약 템플릿에 기반. 추측한 가격 X.

5. 미팅 회고: (1) 일시 (2) 참석자 (3) 핵심 이슈 (4) 결정 사항 (5) 액션 아이템 (담당·마감) 5섹션.

📊 데이터 (분석·리포트·시각화)

## 데이터 작업 규칙

1. 원본 데이터: 직접 변경 X. 항상 사본 생성 후 작업. 사본 명: data_YYYY-MM-DD_변경내역.csv

2. 통계 인용: 표본 크기·기간·출처 옆에 표시. 신뢰구간 가능하면 함께.

3. 분석 결과: (가설) (검증된 사실) (한계) (대안 해석) 4가지 섹션 분리.

4. 시각화: 축 단위·기간·표본 크기 명시. 오해 소지 있는 스케일 X.

5. 리포트 형식: (1) 핵심 인사이트 3줄 (2) 방법론 (3) 데이터 (4) 분석 (5) 한계 (6) 다음 분석 추천.

---

응용 1 — @임포트로 분리 운영

CLAUDE.md가 50줄 넘어가면 가독성 떨어집니다. 분리 운영 가능:

# CLAUDE.md (메인)

@./.claude/safety.md
@./.claude/style.md
@./.claude/marketing.md

각 파일에 영역별 규칙 분리. 메인 파일은 임포트만.

응용 2 — 글로벌 vs 프로젝트 우선순위

위치	적용 범위	우선순위
~/.claude/CLAUDE.md	모든 프로젝트 (전역)	낮음
프로젝트/CLAUDE.md	그 프로젝트만	높음
프로젝트/.claude/CLAUDE.md	그 프로젝트만 (대안 위치)	높음

추천 운영: 보편 5줄은 글로벌, 직무별 추가는 프로젝트별.

---

다운로드 — 직무별 CLAUDE.md 7개 템플릿

각 직무별로 보편 5줄 + 추가 5줄 = 10줄짜리 CLAUDE.md 템플릿. 그대로 복붙하시면 됩니다.

마케터용 CLAUDE.md

# 보편 안전 규칙
1. 확실하지 않으면 '모른다'고 말해. 검증 안 한 건 단정 X.
2. 변경 전 비슷한 패턴부터 찾아 영향 범위 한 줄.
3. 답하기 전 헷갈리는 거 3개 먼저 질문.
4. 각 단계 끝날 때마다 한 줄로 무엇을 했는지.
5. 결과 마지막에 '검증 안 된 부분' 별도 표시.

# 마케팅 작업 규칙
6. 카피 작성 시 타겟·플랫폼·톤 매번 명시. 명시 안 하면 질문 후 시작.
7. 데이터·통계 인용 시 출처 (URL/보고서명) 옆 표시.
8. 경쟁사 언급 시 비방·과장 X. 공정 비교만.
9. SEO 키워드 채워 넣기 X. 자연스럽게 녹이기.
10. 인스타 80자 / 블로그 카테고리 포함 / 슬로건 5단어.

기획자용 CLAUDE.md

[보편 5줄 동일]

# 기획 작업 규칙
6. 제안서: (1) 문제 (2) 가설 (3) 검증 (4) 결과 (5) 리스크 5섹션.
7. KPI 인용: (가설) (검증) 라벨 + 출처.
8. 우선순위: ICE/RICE 등 프레임워크 명시.
9. 이해관계자: 실명·직책. 가상 인물 X.
10. 1페이지 요약 + 본문 / 로드맵 분기·월·주 / 요구사항은 사용자 시나리오.

(개발자·디자이너·HR·영업·데이터용 각 5줄도 위 직무별 추가 섹션 참조 — 각각 보편 5줄 + 직무 5줄 = 10줄 조합으로 그대로 복붙)

---

함정 — 흔한 실수 3가지

❌ 실수 1. CLAUDE.md를 너무 길게

50줄 넘어가면 Claude가 우선순위 헷갈림. @임포트로 분리 또는 핵심 10줄로 압축.

❌ 실수 2. 모순되는 규칙

"항상 한국어 / 코드 변수명은 영문" 같은 모순. → 영역별 분리 명시.

❌ 실수 3. 셋업 후 검증 X

CLAUDE.md 만들고 끝. 한 번 시켜보고 진짜 적용되는지 확인 안 함. → "이 폴더 CLAUDE.md 읽었지? 적용된 규칙 한 줄로 요약해줘" 한 번.

---

9WAY와 함께 더 깊이

직무별 CLAUDE.md 7개 + 응용은 VUILD /learn 챕터 2에서 깊이 다룹니다.