AI 도서관 · Claude · 하네스 설정 · CLAUDE.md
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}} 자리에 내 내용을 넣어 쓰는 프롬프트입니다. 아래 버튼으로 열면 넣는 칸이 나옵니다.
도서관에서 열기 — 내 내용 넣고 복사하기