03-실전

03. 실전 — 60줄짜리 CLAUDE.md 만들기

단계 1. 정체성 한 단락

• 우리 프로젝트가 무엇인지 한 문장.
• 출력 언어, 베이스 패턴, 빌드 시스템.

본 위키 자체의 CLAUDE.md 첫 절이 바로 그 본보기다 — “claude-cowork-playbook / 영문 sources → 한국어 wiki / OMC 멀티 에이전트 / 출력 언어 한국어”.

단계 2. “절대 규칙” 번호 매기기

규칙은 명령형 문장으로, 번호를 붙여 인용하기 쉽게 만든다.

## 절대 규칙
1. wiki/** 출력은 무조건 한국어.
2. sources/** 본문은 수정 금지.
3. 영문 인용 시 원문 + 한국어 의역 병기.

번호가 있어야 검토 패스에서 “절대 규칙 #3 위반” 같이 정확히 가리킬 수 있다.

단계 3. “절대 금지” 분리

긍정 규칙과 부정 규칙을 섞으면 서로 잡아먹는다. 별도 절(## 절대 금지)에 모은다.

단계 4. 라우팅 표

“어떤 작업 → 어디로 위임”을 한 표로. 모델 라우팅(haiku/sonnet/opus)도 같이.

단계 5. 트리거 명령

자주 쓰는 슬래시/매직 키워드 한 묶음을 코드 펜스로. 사람도 보고, 모델도 학습한다.

단계 6. 자기 시연 한 줄

이 위키 CLAUDE.md 마지막 절은 “이 프로젝트는 자기 시연이다 — 가르치는 패턴을 빌드 자체가 사용해야 한다” 다. 디렉티브 안에 메타 원칙을 한 줄 박아 두면 후속 변경이 메타 원칙을 위반할 때 모델이 먼저 알아차린다.

안 해도 되는 것

• 린터 흉내 내기 금지. “Don’t make Claude a linter.” 포매팅은 결정적 도구가 한다.
• 자동 생성 금지. “Hand-craft your file — it’s the highest leverage point of the harness.” — “손으로 만들어라. 하네스의 가장 큰 레버리지 지점이다.”
• 쪼개진 메모 백 개보다 한 페이지짜리 한 개가 낫다.