Lesson (강의 단원)lecturedraftTue May 12

단원 — CLAUDE.md 작성 4 원칙 (크기·구조·구체성·일관성)

별칭: 4 writing principles · size-structure-specificity-consistency

#4-principles#anthropic-official#claudemd-writing#include-exclude

요약

Anthropic 공식 — CLAUDE.md 작성 4 원칙: ① 크기 (200 줄 이하), ② 구조 (헤더·글머리), ③ 구체성 (검증 가능), ④ 일관성 (충돌 ❌).

원칙 1 — 크기 (Size)

200 줄 이하 목표
부풀려진 파일 → Claude 가 실제 지시 무시
커지면 경로 범위 규칙 / 가져오기 로 분할 (단 가져오기는 조직만, 토큰 절약 ❌)

원칙 2 — 구조 (Structure)

마크다운 헤더·글머리 그룹화
조밀 단락 ❌ → 구성된 섹션
Claude 는 독자처럼 스캔

원칙 3 — 구체성 (Specificity)

❌ 모호	✅ 구체
"코드를 제대로 포맷"	"2칸 들여쓰기 사용"
"변경 사항을 테스트"	"커밋 전 `npm test` 실행"
"파일을 정리"	"API 핸들러는 `src/api/handlers/` 에"

원칙 4 — 일관성 (Consistency)

충돌 지침 → 임의 선택
정기 검토 + 충돌 제거
모노레포 — claudeMdExcludes 로 다른 팀 파일 건너뛰기

★ 포함·제외 표 (Anthropic 공식)

✅ 포함	❌ 제외
Claude 추측 불가 Bash 명령	코드 읽어 파악 가능한 것
기본값과 다른 코드 스타일	표준 언어 규칙
테스트 지시 + 선호 러너	상세 API 문서 (대신 링크)
저장소 에티켓 (분기·PR)	자주 변경되는 정보
프로젝트 특정 아키텍처 결정	긴 설명·튜토리얼
개발자 환경 특이성 (필수 env vars)	자명한 관행 ("깨끗한 코드")
일반 함정·명백하지 않은 동작	파일별 코드베이스 설명

★ Anthropic 공식 강조 도구

"Adding emphasis (e.g., 'IMPORTANT' or 'YOU MUST') can tune your instructions to improve compliance."

→ concept/instructional-overrides 참조. 남발 ❌ (희소성이 효과).

강의 활용

Ch4 — 본 단원 전체 활용. 4 원칙 + 포함·제외 + 강조 도구.
Ch3 — 안티 패턴 (포함·제외 표의 부정적 면).

Lesson (강의 단원)lecturedraftTue May 12

단원 — CLAUDE.md 작성 4 원칙 (크기·구조·구체성·일관성)

별칭: 4 writing principles · size-structure-specificity-consistency

#4-principles#anthropic-official#claudemd-writing#include-exclude

요약

Anthropic 공식 — CLAUDE.md 작성 4 원칙: ① 크기 (200 줄 이하), ② 구조 (헤더·글머리), ③ 구체성 (검증 가능), ④ 일관성 (충돌 ❌).

원칙 1 — 크기 (Size)

200 줄 이하 목표
부풀려진 파일 → Claude 가 실제 지시 무시
커지면 경로 범위 규칙 / 가져오기 로 분할 (단 가져오기는 조직만, 토큰 절약 ❌)

원칙 2 — 구조 (Structure)

마크다운 헤더·글머리 그룹화
조밀 단락 ❌ → 구성된 섹션
Claude 는 독자처럼 스캔

원칙 3 — 구체성 (Specificity)

❌ 모호	✅ 구체
"코드를 제대로 포맷"	"2칸 들여쓰기 사용"
"변경 사항을 테스트"	"커밋 전 `npm test` 실행"
"파일을 정리"	"API 핸들러는 `src/api/handlers/` 에"

원칙 4 — 일관성 (Consistency)

충돌 지침 → 임의 선택
정기 검토 + 충돌 제거
모노레포 — claudeMdExcludes 로 다른 팀 파일 건너뛰기

★ 포함·제외 표 (Anthropic 공식)

✅ 포함	❌ 제외
Claude 추측 불가 Bash 명령	코드 읽어 파악 가능한 것
기본값과 다른 코드 스타일	표준 언어 규칙
테스트 지시 + 선호 러너	상세 API 문서 (대신 링크)
저장소 에티켓 (분기·PR)	자주 변경되는 정보
프로젝트 특정 아키텍처 결정	긴 설명·튜토리얼
개발자 환경 특이성 (필수 env vars)	자명한 관행 ("깨끗한 코드")
일반 함정·명백하지 않은 동작	파일별 코드베이스 설명

★ Anthropic 공식 강조 도구

"Adding emphasis (e.g., 'IMPORTANT' or 'YOU MUST') can tune your instructions to improve compliance."

→ concept/instructional-overrides 참조. 남발 ❌ (희소성이 효과).

강의 활용

Ch4 — 본 단원 전체 활용. 4 원칙 + 포함·제외 + 강조 도구.
Ch3 — 안티 패턴 (포함·제외 표의 부정적 면).