CLAUDE.md에서 어떤 규칙을 삭제할지 어떻게 결정하시나요?
How do you decide which rules to delete from CLAUDE.md?
핵심 요약
CLAUDE.md 규칙이 너무 많아져 고민인 작성자가 규칙 관리 및 최적화 방법을 커뮤니티에 묻는 글입니다.
- 규칙 최적화 — 불필요한 규칙을 제거하고 중복을 줄여 토큰 사용량 절감
- 맥락 분리 — 프로젝트별/기능별로 .md 파일을 나누어 관리
- AI 활용 — 다른 AI 모델을 사용해 규칙의 효율성을 검토하고 압축
- 구조적 접근 — CLAUDE.md는 핵심 원칙만 담고 세부 규칙은 관련 문서로 분리
요즘 프로젝트 몇 개 돌리면서 Claude Code를 매일 쓰고 있는데, 규칙이 계속 늘어나네. 실수할 때마다 규칙을 한 줄씩 추가했거든. 결국 시작 문서(startup docs)만 37k 토큰을 잡아먹길래, 압축해서 28k까지 줄였어.
그래서 문서마다 글자 수 제한을 빡세게 걸어봤거든? 근데 이게 역효과가 나더라. 레포지토리 6개에서 체커가 문단 692개를 잡아냈는데, 그중 37%는 제한보다 20%도 안 넘은 수준이었어. 문서 경고 대부분이 그냥 노이즈라 진짜 중요한 문제들은 다 묻혀버리더라고.
그래서 이제 글자 수 제한은 치우고 짧은 가이드라인으로 바꿨어: 내용은 한곳에만 적을 것, 현재 사실만 적을 것, 그리고 문장마다 '이걸 지웠을 때 독자가 잘못된 행동을 할까?'라고 자문해 볼 것.
근데 아직도 감이 안 오는 건, 어떤 규칙이 실제로 효과가 있는지 모르겠다는 거야. 잘 작동하는 규칙이나 Claude가 원래 알아서 잘하는 규칙이나 겉보기엔 똑같거든.
너희는 이걸 어떻게 구분해? 규칙을 하나씩 지워보면서 테스트해? 아니면 규칙 덕분에 막은 문제들을 따로 기록해? 아니면 그냥 감으로 해? 마지막으로 지운 규칙은 뭐야? 그리고 그거 지우고 나서 뭐 터진 거 없었어?


