정의
Andrej Karpathy의 2026년 1월 불만(조용한 잘못된 가정·과복잡화·무관한 코드 손상)을 Forrest Chang이 4개 행동 규칙 CLAUDE.md로 패키징(GitHub 120,000 stars). Mnimiy가 30개 코드베이스에서 6주간 테스트 후 2026년 5월의 에이전트 오케스트레이션 문제를 다루는 8개 규칙을 추가한 12규칙 셋.
핵심 속성
- 원본 4규칙(Karpathy/Chang): ① Think Before Coding(가정 명시·트레이드오프 표면화) ② Simplicity First(문제를 푸는 최소 코드) ③ Surgical Changes(필요한 것만 건드림) ④ Goal-Driven Execution(성공 기준 정의·검증까지 반복)
- 추가 8규칙(Mnimiy): ⑤ 모델에게 비언어 작업 시키지 말 것(재시도·라우팅은 결정론적 코드로) ⑥ 하드 토큰 예산, 예외 없음 ⑦ 충돌은 평균내지 말고 표면화 ⑧ 쓰기 전에 읽기 ⑨ 테스트는 필수지만 목표는 아님 ⑩ 장기 작업엔 체크포인트 ⑪ 참신함보다 관례 ⑫ 조용히 말고 눈에 띄게 실패
- 효과: 실수율 41% → 3%. 4규칙 대비 12규칙은 컴플라이언스 오버헤드 거의 없이(78%→76%) 실수율 8%p 추가 감소 — 새 규칙이 기존 규칙과 어텐션 예산을 경쟁하지 않음
- 상한: 14규칙 초과 시 컴플라이언스 76%→52% 급락. 200라인 천장이 실재
- 원본의 침묵 지점: 장기 에이전트 작업, 멀티 코드베이스 일관성, 테스트 품질, 프로토타입 vs 프로덕션
관계
- 20260508-andrej-karpathy — 출처: 원본 4규칙의 발단이 된 인물
- 20260508-claude-md-is-persistent-context-layer — 상위개념: CLAUDE.md가 지속 컨텍스트 레이어
- 20260603-frame-claude-md-as-data-for-other-agents — 연장: CLAUDE.md를 다른 에이전트용 데이터로 보는 관점
인용
CLAUDE.md는 advisory다. Claude는 약 80% 따른다. 200라인을 넘으면 중요한 규칙이 노이즈에 묻혀 컴플라이언스가 급락한다. Karpathy의 65라인·4규칙이 바닥이고, 8규칙을 더한 것이 천장이다.