정의
CLAUDE.md 행동 강령은 Anthropic의 Claude가 복잡한 코드베이스 내에서 작업을 수행할 때 발생하는 전형적인 실패 모드(실수)를 방지하기 위해 설계된 12가지 기술적 가드레일이다. 2026년 1월 안드레아 카파시(Andrej Karpathy)가 제안한 기초 4대 규칙에, 2026년 5월 에이전트 중심 워크플로우를 위한 8대 규칙이 추가되어 완성되었다.
핵심 속성
- 기초 4대 규칙 (코드 작성 중심):
- 코딩 전 사고: 침묵하는 가정 금지, 트레이드오프 명시.
- 단순성 우선: 오버엔지니어링 금지, 최소 기능 구현.
- 외과적 변경: 요청하지 않은 인접 코드 수정 금지.
- 목표 지향 실행: 성공 기준 정의 및 반복 검증.
- 확장 8대 규칙 (에이전트 오케스트레이션 중심):
- 언어 외 작업 금지: 결정론적 로직을 LLM 판단에 맡기지 않음.
- 엄격한 토큰 예산: 무한 루프 및 컨텍스트 덤프 방지.
- 충돌 표면화: 코드베이스 내 상충하는 패턴 발견 시 평균화하지 않고 보고.
- 선독 후작: 쓰기 전 인접 코드의 맥락을 완벽히 이해.
- 테스트의 실효성: 단순 통과가 아닌 의미 있는 검증 수행.
- 체크포인트: 다단계 작업 시 진행 상황 저장.
- 관습 준수: 새로운 패턴 도입보다 기존 컨벤션 유지 우선.
- 가시적 실패: 오류 발생 시 침묵하지 않고 명확히 노출.
관계
- 20260508-llm-wiki-pattern — 연장: Karpathy의 LLM Wiki 철학이 코드 생성 가드레일로 구체화됨.
- 20260605-agent-orchestration-requires-guardrails — 하위개념: 에이전트 중심의 실행 가이드.
인용
“CLAUDE.md는 위시리스트가 아니다. 당신이 관찰한 구체적인 실패 모드를 차단하는 행동 계약서다.”