📋가이드

Claude 코딩 실수를 41%에서 11%로 줄인 12가지 규칙

Karpathy의 4가지 CLAUDE.md 규칙에 8가지를 추가하여 AI 코딩 품질을 극적으로 개선한 템플릿

#Claude#프롬프트엔지니어링#코딩#CLAUDE.md

개요

2026년 1월, Andrej Karpathy가 Claude의 코드 작성 문제점을 지적했습니다. 조용히 잘못된 가정을 하거나, 과도하게 복잡하게 만들거나, 건드리지 말아야 할 코드를 수정하는 문제였죠.

Forrest Chang이 이를 4가지 행동 규칙으로 정리해 CLAUDE.md 파일로 만들었고, 첫날 5,828개의 스타를 받으며 2026년 가장 빠르게 성장한 단일 파일 저장소가 되었습니다.

▸

실수율 감소: 40% → 3% 미만

▸

30개 코드베이스: 에서 6주간 테스트

▸기존 4개 규칙에 **8개 규칙 추가**하여 총 12개 규칙 완성

▸조용히 가정하지 않고 명시적으로 밝히기

▸트레이드오프 표면화

▸추측 전에 질문하기

▸더 간단한 접근법이 있으면 제안

▸문제를 해결하는 최소한의 코드

▸추측성 기능 금지

▸한 번만 쓰는 코드에 추상화 금지

▸꼭 필요한 부분만 수정

▸불필요한 코드 건드리지 않기

원본 4가지 규칙은 2026년 1월의 코드 작성 문제를 해결했지만, 5월에는 새로운 문제들이 등장했습니다:

▸에이전트 충돌

▸훅 캐스케이드

▸스킬 로딩 충돌

▸세션 간 끊어지는 멀티스텝 워크플로우

1.과도한 정보: 4,000+ 토큰으로 부풀리면 준수율 30%로 하락

2.완전 생략: 매번 프롬프트로 5배 토큰 낭비

3.한 번 복사 후 방치: 2주 후 조용히 작동 중단

▸

65줄, 4개 규칙: 이 기본

▸200줄 이상 시 준수율 급격히 하락

▸Claude의 CLAUDE.md 준수율은 약 **80%**

▸중요 규칙이 잡음에 묻히지 않게 간결하게 유지

CLAUDE.md는 AI 코딩 스택에서 가장 과소평가된 파일입니다. 12가지 규칙을 적용하면 일관성 있고 고품질의 코드를 생성할 수 있으며, 세션 간 일관성도 유지됩니다.