★ CLAUDE.md = 바이브 코딩의 헌법 — 4 위치 ↔ 헌법·법률·시행령·시행규칙 완전 매핑
별칭: claudemd 헌법 · 헌법 메타포 · constitution-metaphor
★ 한 줄 명제 (사용자 발화, 2026-05-12)
"CLAUDE.md 의 이해와 이것이 일반적인 헌법·법률·시행령·시행규칙과 같은 계층 구조 처럼 바이브 코딩에서의 헌법적 역할 이라는 것이 맞다." — 최호림
본 시너지 카드는 사용자의 통찰을 4 위치 + 8 레이어 우선순위 + Karpathy LLM=OS 의 공식 자료 와 완전 정합 시킨다.
★ 4 위치 ↔ 한국 법체계 완전 매핑
| CLAUDE.md 위치 | 한국 법체계 등가 | 특징 일치점 |
|---|---|---|
관리 정책 CLAUDE.md/Library/Application Support/.../etc/claude-code/CLAUDE.mdC:\Program Files\ClaudeCode\CLAUDE.md | 헌법 (憲法) | 모든 하위 우선 + 개별 사용자 제외 불가 (claudeMdExcludes 적용 ❌) |
프로젝트 CLAUDE.md./CLAUDE.md | 법률 (法律) | 팀 공유 (git 체크인) + 프로젝트 전체 구속 |
사용자 CLAUDE.md~/.claude/CLAUDE.md | 시행령 (施行令, 대통령령) | 개인 환경 적용 + 모든 프로젝트 횡단 |
로컬 CLAUDE.md./CLAUDE.local.md | 시행규칙 (施行規則, 부령) | 특정 환경 구체 운영 + gitignored |
.claude/rules/<path>.md | 행정규칙·고시 (告示) | 특정 영역만 (glob 패턴) |
| AGENTS.md (60K+ projects) | 국제법·조약 | 도구 중립적, Linux Foundation 표준 |
→ 법체계 상위법 우선 원칙 ↔ CLAUDE.md 우선순위 정확 일치.
★ 두 비유의 방향 차이 (강의 핵심 주의)
| 비유 | 우선순위 방향 |
|---|---|
| 법체계 (이 카드) | 위 우선 (헌법 > 법률 > 시행령) |
| 8 레이어 컨텍스트 (term/eight-context-layers) | 아래 우선 (서브디렉토리 > 전역) |
이유: 법체계는 입법 단계 관점 (헌법이 모법). 8 레이어는 실행 단계 관점 (마지막에 도착한 지침이 우선). 두 관점이 상보적.
★ 왜 헌법 이 읽기 위한 문서가 아닌가? (법률에 들어갈 것을 헌법에 넣지 마라)
사용자 명시 (들어가며 ⑤): "리드미 (법률) 에 들어갈 것까지 헌법에 넣어 버리는 일을 안 하기 위해 이것이 필요하다."
헌법의 본질:
- 짧다 (200 줄 ↔ 헌법 130 조)
- 추상적·원칙적 (구체 실행 ❌)
- 모든 하위법의 해석 기준*
- 개정이 어려움 — 신중하게 작성
→ CLAUDE.md 가 부풀려진 가장 일반적 이유 = 법률에 들어갈 디테일 을 헌법에 박는 잘못.
예시:
| ❌ 헌법에 들어가면 안 되는 것 | ✅ 헌법에 들어가야 하는 것 |
|---|---|
| 특정 API 의 사용법 (법률) | "외부 API 사용 시 인증 토큰은 환경 변수" (원칙) |
| 특정 함수의 매개변수 설명 (시행령) | "코드 변경 시 반드시 npm test 통과" (헌법) |
| 디렉토리 구조 설명 (시행규칙) | "auth/ 폴더는 보안팀 승인 없이 수정 ❌" (헌법) |
★ Karpathy LLM = OS 와의 깊은 정합
entity/karpathy 의 LLM = OS, Context = RAM (term/context-window-as-ram) 비유:
| 운영체제 | LLM |
|---|---|
| OS 의 시스템 파일·설정 파일 | CLAUDE.md |
| OS 의 프로세스 우선순위 | 4 위치 우선순위 |
| OS 의 RAM 관리 | Context window 관리 |
| OS 의 권한 시스템 | Permission modes (term/permission-modes) |
→ OS 가 시스템 파일 없이 작동 못 하듯, LLM 도 CLAUDE.md (헌법) 없이 폭주. No Design, No Code 의 물리적 근거.
★ 강의 표어 No Design, No Code 의 최종 정합
본 시너지 카드 + 마치며 최종 명제 ([[synthesis_horim_token-economy-and-experience-arbitrage]] 등과 함께):
1. (전제) 설계 없이는 코드 없다 = No Design, No Code
↓
2. (확장) 설계의 *시작* = 헌법을 설계하는 것 + 헌법을 *고쳐 가는 것*
↓
3. (결론) CLAUDE.md 를 *설계하고 최적화해 가는 과정* = 바이브 코딩의 *설계 그 자체*
→ 바이브 코딩 시대의 개발자 = 헌법 입법자. 코드 노동자 ❌.
강의 활용
- Ch2 — 본 카드의 전체 활용. 강의의 중심 챕터.
- 들어가며 ④·⑤ — 헌법 필요성 + "리드미와 헌법 분리" 안내.
- 마치며 최종 명제 — 설계 = 헌법 설계 = CLAUDE.md 설계.
- 부록 A 토큰 — 희소 자원의 헌법적 조직화 정당화.
본 카드의 위상
본 시너지 카드는 본 강의 전체의 통합 명제. 9 챕터 + 들어가며 + 마치며 모두가 이 카드의 부분 적용*.
→ 본 카드 = 본 강의의 지적 DNA.