CLAUDE.md 파일은 종종 AI 모델이 아닌 개발자를 위해 구성됩니다. 그 이유가 여기에 있습니다

r/ClaudeAI의 한 게시물은 CLAUDE.md 파일의 일반적인 실패 패턴을 지적합니다. 파일이 개발자가 문서화하고 싶은 내용을 기준으로 구성되어 있지만, 모델이 결정을 내리는 데 필요한 것과는 다른 문제라는 것입니다.

개발자 우선 구조

개발자를 위해 구성된 파일의 예:

## 프로젝트 소개
[3단락의 맥락]
## 기술 스택
[15개 항목]
## 목표
[5개 불릿 포인트]
## Hard 규칙   <- 47번째 줄

모델은 순차적으로 읽습니다. hard rules에 도달할 때쯤이면 이미 가정을 만들기 시작합니다. 제약 조건이 그 가정을 무시해야 한다면 모델은 어려움을 겪게 됩니다.

모델 우선 구조

게시물은 하나의 사고 모델을 제안합니다. "모델이 돌이킬 수 없는 일을 하기 3초 전에 무엇이 필요한가?"를 묻고, 그것을 먼저 배치하라는 것입니다. 더 나은 구조:

## Hard 규칙 (먼저 읽으세요)
[실제 제약 조건]
## 현재 상황
[현재 적용 중인 내용]
## 배경
[나머지]

길이 문제

4000줄짜리 CLAUDE.md는 정리된 것이 아니라 보관된 것입니다. 보관된 파일은 잘 읽히지 않습니다. 정리된 파일은 빠르게 읽힙니다. 명확성이 완전성보다 항상 중요합니다. 작성자는 묻습니다: 여러분의 CLAUDE.md 처음 20줄에는 무엇이 있나요?