AI 도서관 · Claude · 하네스 설정 · CLAUDE.md

길어지면 rules/ 로 쪼개기

200줄이 넘으면 지켜지는 비율이 떨어집니다. 주제별로 나누세요

내용

📌 왜 쪼개나
CLAUDE.md 는 세션마다 통째로 맥락에 올라갑니다.
길수록 토큰을 먹고, 길수록 지켜지는 비율이 떨어집니다.
공식 문서 권장은 **200줄 이하**입니다.

[ 쪼개는 방법 ]
.claude/rules/
├── code-style.md      코드 스타일만
├── testing.md         테스트 규칙만
└── api-conventions.md API 설계 규칙만

이 파일들도 세션 시작 때 함께 읽힙니다. 나눠도 다 읽힌다는 뜻입니다.

[ 진짜 절약은 여기서 ]
특정 파일을 만질 때만 읽히게 할 수 있습니다.

---
paths:
  - "src/api/**"
---

API 라우트는 항상 입력 검증부터 한다.

이러면 src/api/ 안의 파일을 읽을 때만 이 규칙이 들어옵니다.
프런트엔드 작업 중에는 자리를 차지하지 않습니다.

[ 무엇을 어디로 ]
CLAUDE.md 에 남길 것 — 모든 작업에 해당하는 것
  빌드·테스트 명령, 절대 금지, 프로젝트 구조

rules/ 로 뺄 것 — 특정 영역에서만 필요한 것
  언어별 스타일, 특정 폴더의 규칙, 특정 작업의 절차

💡 그래도 안 줄어들면
여러 단계짜리 절차는 규칙이 아니라 스킬로 만드세요.
스킬은 필요할 때만 불려오니 평소 자리를 안 차지합니다.

[ 쪼개는 것을 시켜보는 지시문 ]
아래 CLAUDE.md 를 검토해줘.

① 모든 작업에 해당하는 것과 특정 영역에만 해당하는 것으로 나눠줘
② 특정 영역에만 해당하는 것은 어떤 paths 로 걸면 될지 제안해줘
③ 규칙이 아니라 절차에 가까운 것 — 스킬로 뺄 후보
④ 실제로 지켜지는지 확인할 수 없는 막연한 규칙

지우는 건 내가 판단할게. 분류만 해줘.

{{INPUT}}

{{INPUT}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.

근거

유형
일반 프롬프트 — 대화창에 붙여넣습니다
사용 환경
Claude Code — .claude/rules/
공식 출처
https://code.claude.com/docs/en/memory
확인일
2026-09-09 — 이후 바뀌었을 수 있습니다
도서관에서 열기 — 내 내용 넣고 복사하기