"카파시는 새로운 설계 원칙 을 만든 것이 아니다. *OOP 의 핵심 원칙을 AI 에이전트 시대에 재번역 * 한 것이다."

---

도입 — 책에서 가장 손에 잡히는 한 장

이 책의 모든 장 중에 학생이 오늘 저녁부터 적기 시작할 수 있는 단 하나의 도구 — CLAUDE.md. 그래서 14 장이 *이 책의 행동 진입점 * 이다.

13 장에서 UML 3 대 다이어그램 = AI 에이전트 설계의 언어 임을 봤다. 14 장은 그 언어가 어떤 파일 형식 으로 박히는가 를 본다.

답은 단 하나의 마크다운 파일이다.

CLAUDE.md — UML Usecase + Class + Sequence 가 한 파일에 압축 된 AI 시대의 설계 문서.

이 한 파일이 Karpathy 의 65 줄짜리 CLAUDE.md 가 GitHub 10 만 스타 라는 비현실적 사례 를 만들었다. 65 줄짜리 마크다운이 왜 그토록 강력한가 — 14 장이 그 답이다.

특히 강조점 #3 — 왜 65 줄이고, 왜 100 줄은 독인가 — 이 14 장의 결정적 한 절.

---

CLAUDE.md = UML Class Diagram (충격 명제)

이 장은 충격적인 한 줄 로 시작한다.

CLAUDE.md = UML Class Diagram 의 압축형.

이게 과감한 비유 라는 것을 인정한다. 그러나 비유적 등가 에서 기능적 등가 로 — 한 단계씩 풀어 본다.

먼저 CLAUDE.md 가 정의하는 4 요소 를 본다.

이 4 요소가 *Usecase + Class + Sequence 의 압축 * 이다. 별도 다이어그램 3 장 이 아니라 — 마크다운 한 파일 에 4 가지 정보를 한꺼번에 기록한다. 이게 UML 의 진화형 이다.

여러분이 4 년 동안 OOASD 과제로 3 장의 다이어그램을 따로 그렸던 일 이 — CLAUDE.md 한 파일로 압축 된다. *시간과 도구가 다를 뿐 같은 일 * 이다.

---

Karpathy 4 원칙 = OOP 의 AI 시대 재번역

이 압축형 설계 문서 의 내부 원칙 이 무엇인가 — Andrej Karpathy 가 정리한 4 원칙 이 답이다.

이 4 원칙이 왜 강력한가 — OOP 의 SOLID 원칙과 거의 1:1 매핑 되기 때문이다. Karpathy 가 완전히 새로운 원칙을 만든 게 아니다. *2000 년대에 정착된 SOLID 원칙 을 AI 시대 어휘로 재번역 * 한 것뿐.

이게 13 장의 Isomorphism * 의 원칙 차원의 증거 다. 어휘만 바뀌었지 사고는 같다. 여러분이 SRP / OCP / ISP / DIP 를 시험에서 답할 수 있다면 — Karpathy 4 원칙도 이미 답할 수 있다. 재번역의 사전 만 들고 있으면 된다.

Karpathy 자신의 표현으로 — "새로운 원칙이 아니라 재번역 이다." 연속성 이 핵심이다. 80 ~ 90 년대 OOP 가 무너진 게 아니라 — 진화 한 것.

---

★ 정량 근거 — 왜 65 줄, 왜 100 줄은 독인가

이제 14 장의 결정적 한 절. 강조점 #3 의 자리.

학생이 가장 자주 던지는 질문 — "길게 쓰면 좋은 거 아닌가요?" 직관적으로는 길수록 자세하니까 좋아 보인다. 그러나 그 직관이 틀렸다. 이유를 세 수치 로 기록한다.

수치 1 — 권장 토큰 ≤ 2,500

2,500 토큰 ≈ 영어 1,800 단어 ≈ 한국어 1,000 ~ 1,500 자 ≈ 65 ~ 100 줄. Boris Cherny 의 직접 권유 다 (10 장). *Karpathy 의 65 줄짜리 CLAUDE.md * 가 이 권유에 정확히 맞다.

왜 0.25% 인가 — *cache prefix 가 *매 세션 처음에 로드 * 된다. 1M context 중 *0.25% 가 항상 차지 * 한다. *늘어날수록 — AI 의 작업 공간 자체가 좁아진다.

수치 2 — 모듈 단위 25 ~ 35 줄

이게 *AI 의 집중 능력 임계점 * 이다. 25 ~ 35 줄 까지는 AI 가 한 번에 머리에 넣고 작업한다. 그 이상 은 부분만 보고 망각 한다 — Context Rot (7 장).

여러분 자신을 비유로 — 시험 직전 한 페이지짜리 요약본 이 2 페이지짜리 요약본 보다 훨씬 잘 외워진다. 이유는 동일 하다. 집중 임계점.

수치 3 — 루트 ≤ 200 줄

이게 가장 중요한 권고다. 루트 CLAUDE.md = 맵 (지도). 매뉴얼이 아니다. 어디에 무엇이 있는지 만 적고 세부 매뉴얼은 모듈별 파일 에.

비유 — *대학 도서관 입구의 안내판 * 이 모든 책의 내용을 다 담지 않는다. 어느 층에 어떤 분야의 책이 있는지 만 짧게 적는다. 그게 안내판의 역할. CLAUDE.md 도 같다.

이 3 수치 가 합쳐서 — "짧을수록 강하다" 의 정량적 근거 가 된다.

---

황금 비율 — 75% Don't / 25% Do

길이뿐 아니라 내용 비율 도 권유가 있다.

75% 는 하지 마라 (Don't / 안티패턴), 25% 만 해라 (Do).

이 비율이 역설적 이다. 해라가 더 많아야 자연스럽지 않나? 라고 생각하기 쉽다. 그러나 10 장 (Boris) 의 명제로 다시 본다.

"실무에서는 Claude 가 잘하는 일을 더 잘하게 만드는 것보다 하면 안 되는 일을 못 하게 막는 것 이 훨씬 중요할 때가 많다."

비대칭성이 이유다. 잘하는 일을 더 잘하게 = 점진적 이득. 하지 말아야 할 일을 못 하게 = 재앙 차단 = 극단적 이득. 재앙 한 번이 일상의 평균보다 압도적으로 비싸다.

4 장의 7 건 사고가 모두 이 비대칭의 사례다. DB 삭제 한 번이 100 시간을 날리는 비대칭. 인증 역전 한 번이 170 개 앱을 깨는 비대칭.

CLAUDE.md 실전 예시:

# 절대 금지
- 마이그레이션 파일은 사용자 승인 없이 수정하지 않는다
- 프로덕션 DB 관련은 절대 자동 실행하지 않는다
- auth/ 폴더는 *건드리지 않는다* (기존 구현 보존)

# 새 기능 구현 전 필수
- 반드시 *테스트 전략* 을 먼저 설명한다

Don't 3 줄 + Do 1 줄 = 75 : 25. Boris 의 권유에 정확히 맞다.

---

분석 마비 (Analysis Paralysis) 경고

여기서 학생이 가장 자주 빠지는 함정 한 가지를 명시적으로 경고 한다.

이 책을 읽고 300 줄 CLAUDE.md 를 작성하지 마라. 그게 분석 마비 (Analysis Paralysis) 다.

길게 적을수록 좋다 는 직관에 빠지면 — 3 수치를 모두 위반한다. 결과는?

이 함정이 무서운 이유 — *겉으로는 *책의 권유를 잘 따르는 것처럼 보이기 때문 *. 길고 자세한 설계 문서 = 진지한 사람 처럼 보인다. 실제로는 — 문서를 만드느라 일이 안 되는 함정.

이걸 Karpathy 의 반대 경로 * 로 보라. Karpathy 의 65 줄짜리 CLAUDE.md 가 GitHub 10 만 스타. 길어서 유명해진 게 아니다 — 짧아서 유명해졌다. 압축된 결정만 기록되어 있어서 — 읽는 사람이 3 분 안에 모든 결정을 본다*. 그래서 재사용된다.

학생을 위한 3 단계 진입 가이드:

1 일차: CLAUDE.md *3 줄* 적기 (Goal / Don't 한 줄 / Verification 한 줄)
1 주차: 5 줄 ~ 10 줄로 확장
1 개월차: 50 줄 ~ 100 줄 (모듈별 분산 시작)

절대 처음부터 100 줄 이상 쓰지 마라. *경험이 누적되며 자연스럽게 늘어나야 * 한다 — *11 장의 경험 외재화 * 의 자연스러운 결과로.

---

65 줄짜리 CLAUDE.md — Karpathy 사례

이 책에서 유일한 영웅 사례. Andrej Karpathy 의 GitHub 저장소 의 CLAUDE.md.

65 줄. GitHub 10 만 스타.

이 사례가 강력한 이유 — Karpathy 같은 위대한 인물이 길게 쓸 수 있는 사람 인데도 65 줄로 끝낸 점. 의도적으로 짧게 만들었다. *그것 자체가 디자인 결정 * 이다.

내용 구성을 보면 — Don't 가 거의 절반, Do 와 Context 가 나머지. Boris 의 75 / 25 권유와 정확히 맞다. 경험이 한 줄씩 기록되어 있다. 길게 풀어서 설명하는 원리 는 없다. 압축된 결정만 기록되어 있다.

여러분의 첫 CLAUDE.md 는 이 65 줄을 모방 하라. 그게 최선의 시작점 이다.

---

다른 도구의 등가물 — 형식만 다를 뿐

CLAUDE.md 가 Anthropic Claude Code 전용 형식 인데, 다른 도구도 같은 자리에 같은 파일이 있다.

세 파일이 *서로 다른 이름이지만 같은 일 * 을 한다. 영구 지시어 (persistent instructions) — 매 세션 처음에 자동 로드되는 AI 의 행동 규약.

*형식이 도구마다 다르지만 원리는 동일 *. 14 장의 모든 메시지 가 세 도구 모두에 적용 된다. Cursor 를 쓰는 학생도 14 장을 읽고 .cursorrules 를 65 줄로 적기 시작할 수 있다.

---

위키와의 연결 — 본 강의 LLMWiki 의 위치

이 책 14 장이 추천하는 도구 가 — *이 책 자체의 기반 시스템 * 이다. 본 강의의 LLMWiki 가 정확히 17 장 (서문 포함) + 부록 6 종 + 적용 카드들 = 모두 CLAUDE.md / WIKI_CLAUDE.md / WIKI_GUIDE.md 같은 영구 지시어 시스템 위에 컴파일 됐다.

이 책을 어떻게 만드는지 의 메타 사례 가 책 자체 다. *학생이 졸업작품에서 CLAUDE.md 를 적용 하면 이 책 같은 영구 산출물 을 만들 수 있다. 그게 *책이 비어 있지 않다 는 증거.

---

14 장 정리 — 행동 진입점

14 장의 한 줄을 기록한다.

CLAUDE.md = AI 시대의 압축형 설계 문서. UML 의 진화형. 짧을수록 강하다. 오늘 저녁부터 3 줄 부터 시작하라.

행동 지침 으로 닫는다.

오늘 저녁:    GitHub Karpathy CLAUDE.md 65 줄 검색해서 보기
이번 주:     진행 중인 과제 하나에 *3 줄* CLAUDE.md 적기
이번 학기:   학기말까지 *50 줄* 까지 늘리기
졸업 시:     입사 첫 주에 *기존 CLAUDE.md 읽고 자기 모듈에 *3 줄* 추가*

이 4 단계가 *14 장의 완성된 행동 경로 * 다.

표어로 닫는다.

AI-Native Vibe Coding: No Design, No Code. — No Design 의 Design 의 형식 이 — CLAUDE.md. 길게 쓰지 마라. 짧게 쓰는 자가 강하다.

다음 15 장에서는 — *지금까지의 모든 원리가 실제로 어떻게 작동하는지 의 시연 * 을 본다. 약국 마케팅 에이전트 시뮬레이션 — 위키 한 카드를 5 종 PPT 로 자동 생성 하는 라이브 데모.

"이 모든 게 어떻게 한 자리에 모이는가? 다음 페이지에서 직접 보인다."