CLAUDE.md 검토은(는) 무엇을 하나요?
CLAUDE.md 파일을 실제 출력 품질을 떨어뜨리는 실패 모드를 기준으로 감사합니다.
전제: CLAUDE.md는 모든 단일 세션마다 컨텍스트에 로드되므로, 모든 줄은 영원히 매 턴마다 임대료를 벌거나 토큰을 소모합니다. 대부분의 '모델이 지시를 따르지 않는다'는 문제는 사실 지시 자체의 문제입니다.
단계
- 대상 파일을 읽습니다(기본값
./CLAUDE.md; 또한~/.claude/CLAUDE.md와 중첩된**/CLAUDE.md를 프로젝트에 있으면 확인합니다. 가장 가까운 파일이 우선합니다). - 아래 각 차원을 점수화하고 실패하는 특정 줄을 인용합니다.
- 하단의 보고서 형식으로 출력합니다. '좀 더 구체적으로 작성하세요' 같은 추상적인 조언이 아닌 구체적인 다시 쓰기를 제안합니다.
확인할 사항
구체성 — 가장 영향력이 큰 차원입니다.
- 반증할 수 없는 지시를 플래그합니다: "깨끗한 코드 작성", "모범 사례 따르기", "주의하기", "좋은 이름 사용하기".
- 모든 규칙은 diff를 읽어서 확인 가능해야 합니다.
"40줄이 넘는 함수 리팩터링"은 확인 가능하지만,"함수를 짧게 유지"는 그렇지 않습니다.
명명된 앵커.
- "설정", "우리의 API 계층", 또는 "일반적인 패턴"을 참조하는 규칙은 매 세션마다 재발견을 강요합니다. 실제 경로로 대체하세요:
src/config/env.ts,src/api/client.ts. - 언급된 모든 경로, 명령어, 파일명이 여전히 존재하는지 확인합니다. 존재하지 않는 것을 보고하세요 — 삭제된 파일을 가리키는
CLAUDE.md는 적극적으로 오해를 불러일으킵니다.
구식 정보.
- 더 이상 리포지토리와 일치하지 않는 버전 번호, 모델 이름, 도구 명령어.
- 이후 제거된 프레임워크, 스크립트, 디렉토리에 대한 지침.
package.json,Makefile,pyproject.toml또는 이와 동등한 파일에 대해 빌드/테스트/린트 명령어를 교차 확인합니다 — 잘못된 테스트 명령어는 없는 것보다 더 나쁩니다.
블로트와 임대료.
- 코드 자체에서 파생 가능한 모든 것(파일 트리 목록, 의존성 목록, 함수가 하는 일을 다시 기술). Claude는 리포지토리를 읽을 수 있습니다.
- 한 번씩 있는 작업에만 적용되는 긴 절차: 이것들은 본문이 사용될 때만 로드되는 스킬에 속하며, 매 턴마다 컨텍스트에 있지 않아야 합니다.
- 모든 소프트웨어에 적용되어 이 프로젝트에 대해 아무것도 가르쳐주지 않는 일반적인 조언.
충돌.
- 서로 모순되는 규칙, 또는 코드가 실제로 하는 것과 모순되는 규칙. 양쪽을 모두 플래그하고 어느 쪽이 우선인지 묻습니다.
- 우선 순위 문제: 중첩된
CLAUDE.md또는~/.claude/CLAUDE.md가 작성자가 예상한 것과 다르게 재정의하는 경우.
누락된 것.
- 부재 시 지적할 가치가 있는 공백:
- 테스트, 빌드, 린트 실행 방법 — 변경 사항을 자체 검증하는 데 필요한 세 가지.
- 명백하지 않은 프로젝트 제약 조건(건드리면 안 되는 디렉토리, 생성된 파일, 필수 마이그레이션 단계).
- 코드를 빠르게 읽어서는 보이지 않는 진정으로 놀라운 규칙.
출력 형식
## CLAUDE.md 검토 — <경로> (<N>줄)
**평결:** <한 문장>
### 차단
- L<n>: <인용된 줄> → <구체적인 다시 쓰기>
### 수정 가치
- L<n>: <인용된 줄> → <구체적인 다시 쓰기>
### 삭제 (모든 세션마다 컨텍스트를 소모하며 얻는 것이 없음)
- L<n>–<m>: <내용과 이유>
### 누락
- <공백> → <추가할 제안 줄>
**편집 후 예상 크기:** <N>줄 (<M>에서)
규칙
- 실제 줄 번호와 실제 텍스트를 인용하십시오. 섹션을 채우기 위해 발견 사항을 지어내지 마십시오.
- 섹션에 발견 사항이 없으면
없음.이라고 작성하십시오 — 깨끗한 파일은 유효한 결과입니다. - 다시 쓰기보다 삭제를 선호하십시오. 가장 좋은
CLAUDE.md는 사람들이 실제로 읽을 만큼 짧은 것입니다. - 요청받지 않는 한 파일을 편집하지 마십시오. 먼저 보고하십시오.