
내 CLAUDE.md 파일은 한때 800줄의 잡음이었습니다.
요약
과도한 컨텍스트를 담은 README 파일(CLAUDE.md)의 비효율성을 지적하며, 모든 정보를 기록할 필요는 없다고 조언합니다. Claude와 같은 LLM은 코드베이스 구조나 네이밍 컨벤션을 이미 추론할 수 있으므로, 오직 모델이 알지 못하는 핵심 규칙이나 실행 명령어만 명시해야 합니다.
핵심 포인트
- 모든 정보를 기록하려는 시도는 오히려 잡음이 될 수 있습니다.
- LLM은 코드베이스 구조와 컨벤션을 이미 추론할 능력이 뛰어납니다.
- 문서화는 모델이 알지 못하는 핵심 규칙이나 실행 명령어에 집중해야 합니다.
내 CLAUDE.md는 예전에 800줄짜리 잡음이었습니다.
내가 생각해낸 모든 규칙을 하나의 파일에 쏟아부었어요. Claude가 요구하지 않은 설명들. 문서들을 설명하는 문서들… 나는 더 많은 컨텍스트가 더 많은 제어력을 의미한다고 생각했어요.
하지만 그렇지 않았어요. Claude는 어쨌든 그중 절반을 무시했습니다.
전환점은 줄을 삭제한 것이 아니었어요. 실제로 무엇이 로드되는지 이해하는 것이었습니다.
알고 보니 내가 쓴 것의 대부분은 코드베이스만 봐도 이미 명확했어요. Claude는 스택, 폴더 구조, 네이밍 컨벤션을 추론할 수 있었어요. 나는 필요하지 않은 것을 타이핑하고 있었습니다.
그것이 추론하지 못한 것은 내가 적지 않았던 단 하나의 것이었습니다: 테스트를 실행하는 정확한 명령어, 우리 팀이 몇 주 동안 논쟁했던 단 하나의 컨벤션.
그래서 저는 그것을 하나의 규칙을 중심으로 재구축했습니다. Claude가 추측할 수 없는 것만 작성하세요.
파일은 800줄에서 140줄로 줄었습니다. Claude는 더 어리숙해지지 않고, 더 날카로워졌습니다.
때로는 해결책이 더 많은 컨텍스트를 추가하는 것이 아닙니다. 당신이 쓴 것의 대부분이 애초에 읽히지 않았다는 것을 인정하는 것입니다.
당신의 CLAUDE.md에는 Claude가 이미 알고 있는 것은 무엇이 남아 있나요?
AI 자동 생성 콘텐츠
본 콘텐츠는 X @socialwithaayan (자동 발견)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기