Concept (개념)lecturedraft2026-05-12

강의안 작성 가이드 — CLAUDE.md 이해 강의

별칭: 강의안 가이드 · lecture planning guide · CLAUDE.md 강의안

#lecture-planning#claudemd#manifest#pipeline

강의안 작성 가이드 — "CLAUDE.md 파일 이해"

자리: 96_ppt_lecture/20260512 claudemd 파일 이해/강의안 작성 가이드.md 버전: v1.0 (2026-05-12 초안) 작성자: Claude (최호림 장로 지시) 갱신 정책: append-only — 작업 진행 시 §8 작업 이력에 한 줄씩 추가

0. 요약 — 본 폴더가 무엇인가

본 폴더는 강의 "CLAUDE.md 파일 이해" 의 소책자 와 PPT 를 순차적으로 생산하는 작업 공간이다.

제작 순서 ★:

먼저 소책자 (책자 형식의 강의 자료) 작성 → Ground Truth 정합
이후 소책자를 대본 골격 으로 삼아 PPT 슬라이드 작성

본 가이드는 1 단계 (소책자) 작성을 위한 SSOT 이며, 동시에 2 단계 (PPT) 의 입력 사양 이기도 하다.

0.1 ★★★ 합격 기준 (사용자 최종 명세, 2026-05-12)

"이 소책자를 보면 바이브 코딩 즉 클로드 코드를 이용한 바이브 코딩 에서의 CLAUDE.md 를 완벽하게 이해 하고 적용 할 수 있게 해 줘야 한다." — 최호림

본 합격 기준은 2 부분 모두 충족해야 한다 — 어느 하나만으로는 ❌:

합격 조건	의미	검증 방법
✅ 완벽 이해	독자가 왜 CLAUDE.md 가 헌법인가·어떻게 작동하는가·왜 잘못 쓰면 토큰 남발인가 의 전체 인과 사슬 을 스스로 설명 가능	마지막 페이지에서 3 문장으로 요약 할 수 있는가
✅ 적용 가능	독자가 오늘·이번 주·이번 달 의 구체 실행 명령 으로 자신의 프로젝트에 즉시 적용	마치며 3 단 안내문 의 모든 명령을 복사·붙여넣기 로 실행 가능

→ 본 합격 기준은 모든 챕터의 3 층 구조 (공식 인용 → 최호림 재해석 → 청중 처방) 에 반드시 다 반영 되어야 한다.

1. 강의 메타데이터

항목	값
강의 제목	CLAUDE.md 파일 이해
부제	"README 가 아니라 가드레일이다 — AI 가 실수를 반복하지 않게 만드는 영구 지시어"
강사	최호림 장로 (AI 에이전트 오케스트레이터)
형식	강의용 소책자 + PPT 슬라이드 (소책자 → PPT 순서)
청중	Vibe Coding 입문 ~ 중급 개발자 (Claude Code 실무 사용자)
작성 시작	2026-05-12
강의 표어 정합	"AI-Native Vibe Coding: No Design, No Code" — CLAUDE.md = 살아 있는 설계 문서
본 위키 트랙	VCT (Vibe Coding Tech) — Harness Engineering 의 중심축

2. ★ Ground Truth — 11 자료 (`10_source/2026/05/`)

본 강의안은 다음 SNLS 자료를 사실 기준선 으로 한다. 모든 본문·예시·인용은 이 11 자료에서 도출되어야 한다.

2.1 1 차 사실 근거 — Anthropic 공식 6 자료 + Karpathy 2 자료 + 보조 3 자료

Anthropic 공식 6 자료 (evidence_grade A_meta)

#	파일	역할
①	`2026-05-12_claude_code_memory_official_docs_snls.md`	공식 — CLAUDE.md / 자동 메모리 (`/docs/ko/memory`). 로드 메커니즘·4 작성 원칙·`/memory`·문제 해결
②	`2026-05-12_anthropic_best_practices_official_snls.md`	공식 — Claude Code 모범 사례 (`/docs/ko/best-practices`). Explore→Plan→Code→Commit, CLAUDE.md 포함·제외 표, 5 실패 패턴, 환경 구성 7 종
③	`2026-05-12_anthropic_skills_official_snls.md`	공식 — Skills (`/docs/ko/skills`). 필요 시 로드, 4 위치, frontmatter 전체, 동적 컨텍스트 주입, fork
④	`2026-05-12_anthropic_hooks_official_snls.md`	공식 — Hooks Guide (`/docs/ko/hooks-guide`). 26 이벤트, 결정론적 자동화, JSON 통신, 권한 모드
⑤	`2026-05-12_anthropic_subagents_official_snls.md`	공식 — Subagents (`/docs/ko/sub-agents`). 격리 컨텍스트, 지속 메모리, Skills preload, Fork 모드
⑥	`2026-05-12_anthropic_plugins_official_snls.md`	공식 — Plugins (`/docs/ko/plugins`). 매니페스트, 디렉토리 구조, claude-md-management 의 작동 원리
⑦	`2026-05-12_anthropic_claudemd_management_plugin_snls.md`	공식 플러그인 — claude-md-management. `claude-md-improver` 5 단계 + `/revise-claude-md` 6 단계

Karpathy 2 자료 (evidence_grade B, 공식 트윗 인용은 A 등급)

#	파일	역할
⑧	`2026-05-12_karpathy_claudemd_skills_snls.md`	Karpathy CLAUDE.md 스킬 — `forrestchang/andrej-karpathy-skills`. 4 핵심 원칙 (Think·Simplicity·Surgical·Goal-Driven). 65 줄 + 109K+ stars
⑨	`2026-05-12_karpathy_viral_thread_context_engineering_snls.md`	★ Karpathy viral thread (2026-01-26) + Context Engineering 종합. LLM=OS·Context=RAM, 4 패턴 (Write·Select·Compress·Isolate), 3 실패 모드 영문 직접 인용, LLM Wiki gist, Vibe Coding 용어 진화

보조·합성 3 자료 (evidence_grade B)

#	파일	역할
⑩	`2026-05-12_software3_maintenance_sdd_harness_snls.md`	Software 3.0 유지보수 4 기둥 — SDD · CLAUDE.md · Harness · 플러그인 통합 골격
⑪	`2026-05-12_youtube_lecture_claudemd_real_usage_snls.md`	YouTube 실무 강의 전사 (실벨 개발자) — 강의 13 절 흐름의 목차 골격

2.2 사용 원칙

본 11 자료 외부 사실 인용 시 → 출처 명시 + 별도 SNLS 추가 후 사용
자료 ① (공식 문서) 또는 ② (Best Practices) 가 최우선 — 충돌 시 항상 공식 우선
⑨ (Karpathy viral thread) 의 영문 직접 인용 은 강의의 마스터 quotable 출처
본문 워딩 80% 이상 = 위 자료에서 도출 / 20% = 본 강의 표어 정합 합성

3. ★ 소책자 구조 — 9 챕터 (들어가며 + Part 1·2·3 + 마무리)

2026-05-12 갱신 — 사용자 (최호림) 지시에 따라 16 챕터 → 9 챕터로 재구성. 다른 소책자 (book-vbc-9-chapters 등) 와 동일한 9 챕터 골격 정합.

★ 중심 메타포: CLAUDE.md = 바이브 코딩의 헌법. 4 위치 = 헌법·법률·시행령·시행규칙. 법률에 들어갈 것을 헌법에 넣지 마라 가 모든 챕터의 통합 명제.

3.0 들어가며 (Introduction) — 프로그래밍 언어의 패러다임 전환 (2~3 페이지)

서사 5 단 구조 (vibe-book-publish-edit 정합):

단	내용	주 자료
1. 역사	ENIAC 이래 폰노이만 아이디어 — 프로그래밍 언어는 컴퓨터가 이해하는 인공 언어. 사람 언어와 분리	(별도 SNLS — VCH 자료 활용)
2. 임계점	최근 AI, 특히 LLM 의 등장 → 컴퓨터가 직접 사람 언어 이해 시작 → 바이브 코딩 시대	Karpathy viral ⑨ §0.2 (80% 전환)
3. 위기	사람 언어로 시키니 경계가 사라짐 → 토큰 남발 + Context Rotting	Karpathy ⑨ §2 (LLM=OS, Context=RAM), ② §0.1
4. 해법	헌법이 필요하다 — 컴퓨터에게 지속적으로 알려주는 영구 지시어 = CLAUDE.md	⑨ §1, ⑦ ⑥
5. 안내	법률에 들어갈 것 (= README) 까지 헌법 (= CLAUDE.md) 에 넣어 버리는 잘못을 피하기 위해 본 책을 쓴다	⑪ §0.2 ("README 가 아니라 가드레일"), ② §5 (포함·제외 표)

들어가며 마침 문장: "이 책은 바이브 코딩의 헌법인 CLAUDE.md 를 어떻게 써야 하는가 와 어떻게 써서는 안 되는가 — 그 두 측면을 법체계의 비유 로 풀어낸다."

3.1 Part 1 — 왜 CLAUDE.md 인가 (도입부, ~10 페이지, 3 챕터)

Ch	제목	주 자료	페이지
Ch1	*컴퓨터가 사람 말* 을 듣기 시작한 순간 — Vibe Coding 시대의 좌절** (한국어로 답하라 했는데 영어로 답하는 Claude / 80% 에이전트 전환 / Context = RAM 비유)	⑨ §0~§2, ⑪ §0, ② §0.1	3
Ch2	★ CLAUDE.md = 바이브 코딩의 헌법 — 4 위치 ↔ 헌법·법률·시행령·시행규칙 완전 매핑 + 상위법 우선 원칙 + 8 레이어 우선순위	[[synthesis_horim_claudemd-as-constitution-of-vibe-coding]] (신규), ① §1.2, §1.7, ⑪ §1~§2	4
Ch3	*헌법은 README* 가 아니다 — 가드레일이다** — README ↔ CLAUDE.md 의 근본 차이 + 법률에 들어갈 것을 헌법에 넣지 말 것 + Karpathy 3 실패 모드 영문 직접 인용	⑪ §0.2, ⑨ §1, ② §5	3

3.2 Part 2 — 헌법을 잘 쓰는 법 (본론, ~14 페이지, 3 챕터)

Ch	제목	주 자료	페이지
Ch4	헌법 작성 4 원칙 — Anthropic 공식 + 코드로 알 수 있는 것은 쓰지 않는다 — 크기·구조·구체성·일관성 + 포함·제외 표 + IMPORTANT/YOU MUST 강조	① §1.4, ② §5, ⑪ §3~§4	5
Ch5	*★ 가장 중요한 1 줄 — 실수 즉시 반영* (최고 ROI)** + 빌드·테스트·린트 명령어 명시 (결과 품질 2~3 배)	⑪ §5~§6, ④ §2.2	4
Ch6	100 줄 넘으면 분할 — `@` 가져오기 + `.claude/rules/` + Skills · Hooks · Subagents 4 층 인프라	① §1.5, §1.8, ⑪ §7~§8, ③ §0.1, ⑤ §6	5

3.3 Part 3 — 헌법을 자동으로 진화 시키기 (응용·실무, ~12 페이지, 3 챕터)

Ch	제목	주 자료	페이지
Ch7	꿀팁 1 — Karpathy 4 원칙 (Think·Simplicity·Surgical·Goal-Driven) — 65 줄 전역 헌법 + 109K stars + 3 실패 모드 대응	⑧ 전체, ⑨ §1, §4	4
Ch8	꿀팁 2 — Anthropic 공식 플러그인 — 자가 진화 CLAUDE.md — `claude-md-improver` 5 단계 + `/revise-claude-md` 6 단계 + 4 파일 점수 시연	⑦ 전체, ⑪ §11	4
Ch9	돌아온 개발자의 30 일 처방 — 한 페이지 체크리스트 6 + 30 일 워크플로우 + 경험 자본의 디지털 백업	[[synthesis_horim_4-pillars-applied-to-returning-dev]] (신규), ⑪ §12	4

3.4 마무리 (Conclusion) — 최종 명제 + 3 단 안내문 (2 페이지)

3.4.1 ★★★ 최종 명제 (사용자 명시 2026-05-12)

"마무리는 No Design, No Code 이다. 설계 없는 코드 없다. 인데, 설계의 시작 은 헌법을 설계 하는 것이고, 헌법을 고쳐 가는 것이다. 즉 CLAUDE.md 를 설계하고 최적화해 가는 과정 이다." — 최호림

3 단 논증:

1. (전제)  설계 없이는 코드 없다 = No Design, No Code = AI-Native 강의 표어
   ↓
2. (확장)  설계의 *시작* = 헌법을 설계하는 것 + 헌법을 *고쳐 가는 것*
   ↓
3. (결론)  CLAUDE.md 를 설계하고 최적화해 가는 과정 = 바이브 코딩의 *설계 그 자체*

→ 이 결론이 본 책의 모든 9 챕터를 하나로 묶는다. 챕터별 세부 적용 → 이 한 명제로 수렴.

3.4.2 3 단 안내문 (행동 지침)

vibe-book-publish-edit 의 마치며 3 단 행동 지침 패턴:

오늘 즉시 — 헌법을 세운다: 프로젝트 루트에 CLAUDE.md 생성 + 첫 1 줄 (빌드 명령) 작성
이번 주 — 헌법을 고친다: 첫 AI 실수 → 즉시 CLAUDE.md 1 줄 추가 (= 즉시 반영 ROI)
이번 달 — 헌법을 최적화한다: claude-md-improver 실행 → 점수 측정 → 분할·정리

→ 3 단계 = 설계·개정·최적화 의 입법 사이클. 입법자 = 개발자 자신.

3.4.3 마치며 마침 문장

"바이브 코딩 시대의 개발자는 코드 노동자 가 아니다 — 헌법 입법자 이다. 코드는 AI 가 쓴다. 우리는 CLAUDE.md 를 설계하고 고쳐 가는 사람들 이다. No Design, No Code — 그 설계의 출발점이자 살아 있는 형식 이 바로 CLAUDE.md 다."

→ 본 책 전체 = 이 한 문장의 근거 제시 — 9 챕터 + 들어가며·마무리 모두가 이 문장으로 수렴한다.

3.5 부록 (선택)

2026-05-12 갱신 — 사용자 지시: 토큰 부록을 맨 먼저 (부록 A) 로 이동.

부록	내용	페이지
A	★ 토큰의 본질과 미래 — 어텐션 메커니즘의 기본 단위 + 하드웨어 한계로 부각될 토큰 관리	2
B	자동 메모리 + `/memory` 사용법	2
C	문제 해결 FAQ	2
D	참고 링크 + 14 SNLS 자료 목록 (11 핵심 + 3 갭 보강)	1

부록 A 주요 내용 (사용자 명시 2026-05-12)

토큰의 정의 — 트랜스포머 (Transformer) 의 어텐션 메커니즘 (Attention Mechanism) 의 기본 단위. 입력 텍스트를 분해하는 최소 단위 (subword 또는 word piece).
어텐션 메커니즘과 토큰의 관계 — 어텐션 = 모든 토큰 쌍 사이의 관련성 계산. 토큰 수 N → 계산량 O(N²) → context window 가 곧 계산 비용 + 메모리 비용*.
★ 향후 더 중요해질 이유 — 하드웨어 공급 한계:
- LLM 모델 크기 기하급수적 증가 (수십억 → 수조 파라미터)
- 동시에 context window 확장 (4K → 200K → 1M 토큰)
- 둘 다 메모리 대역폭·용량 요구 폭증
- 그러나 HBM (High Bandwidth Memory)·D-RAM 의 물리적 생산 한계 가 단기간 해결 불가 (반도체 팹 증설 = 3~5 년)
- → 토큰 관리 = AI 엔지니어의 희소 자원 관리 (resource arbitrage)*
본 위키 VCE 트랙 연결 — Vibe Coding Economy 의 핵심 명제: AI 시대 = 메모리 반도체 슈퍼사이클. 토큰 = 수요 측, 메모리 = 공급 측. 둘 사이의 불균형 이 삼성·SK 하이닉스 슈퍼사이클 의 근거.
★ 본 책 핵심 메시지와의 연결 — 토큰이 희소 하기 때문에 CLAUDE.md 가 헌법으로서 필요. 희소 자원의 조직화 = 헌법의 본질. Karpathy 의 Context = RAM 비유 (term/context-window-as-ram) 가 물리적 하드웨어 한계로 더욱 정합.
30 일 후 행동 — 본 책 마치며의 3 단 안내문 을 실천한 독자가 다음에 읽을 자료: 30_wiki/3020_VCE_economy/ (VCE 트랙) — 토큰 → 메모리 → 산업 → 투자 의 4 층위 인과 사슬.

총 페이지 ≈ 42 페이지 (들어가며 3 + Part 1·2·3 = 36 + 마무리 2 + 부록 7).

3.6 챕터별 3 층 구조 표준

각 챕터 (Ch1~Ch9) 는 다음 3 층 구조 를 따른다 — 단순 요약 ❌, 재해석 + 처방 포함:

층	내용	출처
1. 공식 인용 (Ground Truth)	11 SNLS 의 영문·한국어 직접 인용	Anthropic 공식 + Karpathy viral
2. 최호림 재해석 (Insight)	AI-Native + 돌아온 실버 개발자 관점 통찰 — 헌법 메타포·경험 자본·30 일 학습 곡선	6 신규 synthesis 카드 + 기존 7 카드 연결
3. 청중 처방 (Application)	실버 복귀 개발자 + 후배 에게의 구체 행동 처방	30 일 워크플로우·체크리스트·실행 명령

3.7 ★ 계층 목차 + 챕터별 주요 내용 (상세)

2026-05-12 갱신 — 사용자 지시: 목차의 계층구조 + 챕터 주요 내용 표시.

📕 소책자 "CLAUDE.md 파일 이해"
│
├─ 📖 들어가며 (8~10쪽, *대폭 확장 2026-05-12*) — 프로그래밍 언어의 패러다임 전환
│   ├─ §1 — 80 년의 침묵 (컴퓨터는 사람 말을 듣지 않았다)
│   │   ├─ §1.1 ★ 폰 노이만의 정리 (1945) — 80 년 컴퓨팅의 토대 (5 원리 + 저장 프로그램의 혁명성 + LLM 후계자)
│   │   ├─ §1.2 프로그래밍 언어의 진화 — 기계어→어셈블리→FORTRAN→C→OOP→...→자연어 (2026) 12 단계 표
│   │   ├─ §1.3 설계 도구의 진화 — 플로차트→HIPO→DFD→ERD→구조도→UML→ADR→...→CLAUDE.md 14 단계 표
│   │   ├─ §1.4 두 축의 수렴 — 자연어 + 마크다운이 *바이브 코딩* 한 점에서 만남
│   │   ├─ §1.5 미리 보기 — 1990s 설계 도구 8 종 ↔ 2026 4 층 인프라 (CLAUDE.md·Hooks·Skills·Subagents·Plugins·Memory) 완전 매핑
│   │   ├─ §1.6 폰 노이만 병목의 부활 — HBM 부족 → 토큰 희소성 → 헌법 설계가 *물리학과 만난다*
│   │   └─ §1.7 ★ 코드의 흡수 — *신경망에는 if 문이 없다* (Karpathy Software 1.0/2.0/3.0) → *헌법 = 원칙 ≠ if/for* 의 *진짜 근거*
│   ├─ §2 — 임계점 (2025-12 카파시 80% 전환)
│   ├─ §3 — 위기 (사람 말 시키니 경계 무너짐 → Context Rotting)
│   ├─ §4 — 해법 (CLAUDE.md = 헌법)
│   └─ §5 — 안내 (README/법률에 들어갈 것을 헌법에 박지 마라)
│
├─ 📘 PART 1 — 왜 CLAUDE.md 인가 (도입부, 약 10쪽)
│   │
│   ├─ Chapter 1 ─ 컴퓨터가 사람 말을 듣기 시작한 순간 (3쪽)
│   │   ├─ 1.1 한국어로 답하라 했는데 영어로 답하는 Claude (좌절의 출발점)
│   │   ├─ 1.2 Karpathy 의 80% 전환 증언 — "20년 코딩 인생 최대 변화"
│   │   ├─ 1.3 LLM = OS, Context window = RAM (Karpathy 비유, 영문 직접 인용)
│   │   ├─ 1.4 [최호림 재해석] 돌아온 개발자에게는 1990s RAM 256KB 시절의 자원 관리 본능이 자산
│   │   └─ 1.5 [처방] Context = 가장 희소한 자원이라는 인식 — `/statusline` 토큰 모니터링
│   │
│   ├─ Chapter 2 ─ ★ CLAUDE.md = 바이브 코딩의 헌법 (4쪽, 본 책 중심 챕터)
│   │   ├─ 2.1 4 위치 ↔ 한국 법체계 완전 매핑 (헌법 / 법률 / 시행령 / 시행규칙 / 행정규칙)
│   │   ├─ 2.2 상위법 우선 원칙 ↔ CLAUDE.md 우선순위
│   │   ├─ 2.3 8 레이어 컨텍스트 (아래로 갈수록 강력 — 적용 우선순위)
│   │   ├─ 2.4 두 비유의 방향 차이 명확화 (법체계 = 위 우선 / 컨텍스트 = 아래 우선)
│   │   ├─ 2.5 [최호림 재해석] 1990s UML 도 같은 역할 — 운반체만 변했다
│   │   └─ 2.6 [처방] 첫 CLAUDE.md 만들 때 4 위치 중 어디에 무엇을 둘지 결정 체크리스트
│   │
│   └─ Chapter 3 ─ 헌법은 README 가 아니다 (3쪽)
│       ├─ 3.1 ★ 한 줄 정의 — "AI 가 같은 실수를 반복하지 않게 만드는 가드레일"
│       ├─ 3.2 코드로 알 수 있는 것은 쓰지 않는다 (실벨 강의 1 원칙)
│       ├─ 3.3 Karpathy 3 실수 모드 (Silent Assumptions / Over-Engineering / Collateral Changes — 영문 인용)
│       ├─ 3.4 안티 패턴 표 — "사람 읽기 좋게" vs "AI 실수 안 하게"
│       ├─ 3.5 [최호림 재해석] AI = 자신감 있는 무능한 인턴 → 실버 = 멘토 → CLAUDE.md = 멘토 노트
│       └─ 3.6 [처방] 기존 CLAUDE.md 의 50% 줄이는 5 분 운동
│
├─ 📗 PART 2 — 헌법을 잘 쓰는 법 (본론, 약 14쪽)
│   │
│   ├─ Chapter 4 ─ 헌법 작성 4 원칙 (5쪽)
│   │   ├─ 4.1 Anthropic 공식 4 원칙 — 크기·구조·구체성·일관성
│   │   ├─ 4.2 200 줄 한계 + 부풀려진 CLAUDE.md 의 위험
│   │   ├─ 4.3 ✅ 포함 vs ❌ 제외 표 (Anthropic 공식)
│   │   ├─ 4.4 IMPORTANT / YOU MUST 강조 도구 — 권고 가중치 올리는 공식 트릭
│   │   ├─ 4.5 [최호림 재해석] 1990s 코딩 컨벤션 문서가 그대로 부활 — 다만 AI 가 독자
│   │   └─ 4.6 [처방] CLAUDE.md 가 "코드처럼" 유지보수되어야 한다는 멘탈 모델
│   │
│   ├─ Chapter 5 ─ ★ 가장 중요한 1 줄 — 실수 즉시 반영 (4쪽)
│   │   ├─ 5.1 ★ High ROI 워크플로우 — "이 실수 다시 안 하게 CLAUDE.md 에 반영해"
│   │   ├─ 5.2 빌드·테스트·린트 명령어 명시 — 결과 품질 2~3 배
│   │   ├─ 5.3 일주일 운용 효과 — CLAUDE.md 가 프로젝트에 딱 맞게 자라난다
│   │   ├─ 5.4 [최호림 재해석] 돌아온 개발자만이 빠르게 도달 가능 — "잘못된 가정의 비용" 을 몸으로 안다
│   │   └─ 5.5 [처방] 30 일 워크플로우 — Day 1·Day 7·Day 30 측정 지표
│   │
│   └─ Chapter 6 ─ 100 줄 넘으면 분할 + 4 층 인프라 (5쪽)
│       ├─ 6.1 `@path` 가져오기 — README·docs·홈 디렉토리 참조 (5 홉 깊이)
│       ├─ 6.2 `.claude/rules/` 경로별 규칙 — `paths` glob 으로 토큰 절약 핵심
│       ├─ 6.3 AGENTS.md ↔ CLAUDE.md 통합 (`@AGENTS.md` 한 줄)
│       ├─ 6.4 4 층 인프라 — Skills (필요 시 로드) + Hooks (결정론) + Subagents (격리) + Plugins (배포)
│       ├─ 6.5 [최호림 재해석] 헌법·법률·시행령 분리 = 4 층 인프라 분리와 동일 정신
│       └─ 6.6 [처방] 200 줄 넘어가는 CLAUDE.md 의 분할 작전 (코딩 스타일 → 별도 md)
│
├─ 📙 PART 3 — 헌법을 자동으로 진화시키기 (응용·실무, 약 12쪽)
│   │
│   ├─ Chapter 7 ─ 꿀팁 1 — Karpathy 4 원칙 (4쪽)
│   │   ├─ 7.1 65 줄 CLAUDE.md + 109K stars 의 사회적 함의
│   │   ├─ 7.2 Think Before Coding — Don't assume. Don't hide confusion. Surface tradeoffs.
│   │   ├─ 7.3 Simplicity First — Minimum code. 200 → 50 줄 다시 쓰기 원칙
│   │   ├─ 7.4 Surgical Changes — 변경된 모든 줄 = 사용자 요청과 직접 연결
│   │   ├─ 7.5 Goal-Driven Execution — "Define success criteria. Loop until verified."
│   │   ├─ 7.6 작동 신호 3 — diff ↓ / 재작성 ↓ / 시작 전 질문 ↑
│   │   ├─ 7.7 [최호림 재해석] 4 원칙 = 1990s 시니어가 후배에게 한 4 마디의 디지털 압축
│   │   └─ 7.8 [처방] `~/.claude/CLAUDE.md` 에 65 줄 즉시 복붙하는 명령어
│   │
│   ├─ Chapter 8 ─ 꿀팁 2 — Anthropic 공식 플러그인 (4쪽)
│   │   ├─ 8.1 claude-md-improver — 5 단계 (Discovery → Assessment → Report → Updates → Apply)
│   │   ├─ 8.2 6 기준 평가 + 등급 (A 90~100 / B 70~89 / C 50~69 / D 30~49 / F 0~29)
│   │   ├─ 8.3 4 파일 시연 — 평균 80 점 (B), P0 = 루트 우선
│   │   ├─ 8.4 /revise-claude-md — 6 단계 (Reflect → Locate → Categorize → Draft → Preview → Apply)
│   │   ├─ 8.5 두 도구의 상호 보완 — 매 세션 vs 매 월
│   │   ├─ 8.6 [최호림 재해석] CLAUDE.md 가 스스로 진화 → 멘토 자리가 디지털화
│   │   └─ 8.7 [처방] 설치 명령 + 첫 감사 실행 + 결과 해석법
│   │
│   └─ Chapter 9 ─ 돌아온 개발자의 30 일 처방 (4쪽)
│       ├─ 9.1 한 페이지 체크리스트 6 (100 줄·명령어·코드 파악 가능 내용·구체성·월 점검·즉시 반영)
│       ├─ 9.2 30 일 워크플로우 — Week 1 (1 줄 시작) → Week 2 (분할) → Week 3 (자동화) → Week 4 (감사)
│       ├─ 9.3 Software 3.0 4 기둥 — 돌아온 개발자에게는 1990s 의 등가물이 다 있다
│       ├─ 9.4 [최호림 재해석] CLAUDE.md = 경험 자본의 디지털 백업 (두 번째 두뇌)
│       ├─ 9.5 [최호림 재해석] 토큰 차익거래 — 경험 자본을 활용한 context window 최적화
│       └─ 9.6 [처방] 30 일 후 자가 점검 — Karpathy 의 "80% 에이전트" 수준 도달 측정
│
└─ 📕 마무리 (1~2쪽) — 3 단 안내문
    ├─ 1. 오늘 즉시 — 프로젝트 루트에 CLAUDE.md 생성 + 빌드 명령 1 줄
    ├─ 2. 이번 주 — 첫 AI 실수 → 즉시 CLAUDE.md 1 줄 추가
    └─ 3. 이번 달 — claude-md-improver 실행 → 점수 측정 → 분할·정리

📎 부록
   ├─ A. 자동 메모리 + `/memory` 사용법 (2쪽)
   ├─ B. 문제 해결 FAQ (2쪽)
   └─ C. 참고 링크 + 11 SNLS 자료 목록 (1쪽)

3.8 챕터 ↔ SNLS / Wiki Card 매핑 매트릭스

Chapter	주 SNLS	주 신규 Wiki Card	기존 카드 연결
들어가며 §1.1~§1.7 ★	⑫ Karpathy YC 2025, ⑨ Karpathy viral, ⑪ YouTube	entity/von-neumann (신규), term/von-neumann-bottleneck (신규), concept/code-absorption-into-neural-net (신규), term/context-window-as-ram, case/karpathy-80percent-shift	concept/software-3-0 (보강), concept/ai-native-4-stages, [[synthesis_horim_claudemd-as-constitution-of-vibe-coding]]
Ch1	⑨, ⑪, ②	case/karpathy-80percent-shift, concept/context-engineering-4-patterns	concept/context-engineering (기존)
Ch2	①, ⑪	[[synthesis_horim_claudemd-as-constitution-of-vibe-coding]], lesson/claudemd-4-locations, lesson/claudemd-8-context-layers, term/eight-context-layers	term/claude-md (보강)
Ch3	⑪, ⑨, ②	concept/claudemd-as-guardrail, [[synthesis_horim_claudemd-as-mentor-note]]	concept/claudemd-as-design-language (보강)
Ch4	①, ②, ⑪	lesson/claudemd-4-writing-principles, concept/instructional-overrides	lesson/hrn-experience-as-validator (보강)
Ch5	⑪, ④, ②	lesson/claudemd-load-mechanism, [[synthesis_horim_returning-dev-claudemd-as-second-brain]]	lesson/int-ai-native-mindset
Ch6	①, ⑤, ④, ⑥	term/skill-frontmatter-fields, term/hook-events-26, term/agent-memory, term/plugin-manifest, [[synthesis_horim_claudemd-vs-pre-uml-design]]	concept/harness-engineering
Ch7	⑧, ⑨	lesson/karpathy-4-principles, entity/karpathy, entity/forrest-chang, case/karpathy-109k-stars	synthesis/slogan-ai-native-no-design-no-code
Ch8	⑦, ⑥, ⑪	lesson/anthropic-claudemd-management, concept/self-evolving-claudemd, entity/isabella-he, case/claudemd-improver-demo-4files	(없음)
Ch9	⑪, ⑩, ⑨	lesson/claudemd-checklist-6, [[synthesis_horim_4-pillars-applied-to-returning-dev]], [[synthesis_horim_token-economy-and-experience-arbitrage]]	lesson/hrn-experience-as-validator (보강)
마무리	(전체 종합)	(전체 종합)	synthesis/slogan-ai-native-no-design-no-code

4. 작성 톤·문체 규칙

본 위키의 vibe-book-publish-edit 스킬의 최호림 v1.0 출판 톤 을 완화 적용. 본 강의 소책자는 실무 매뉴얼 톤 이 우선이다.

4.1 채택 규칙

부 → Part / 장 → Chapter 일괄 표기
시니어 → 실버 개발자 통일
새 용어는 한국어 (English) 병기 (예: 가드레일 (guardrail), 영구 지시어 (persistent instruction))
"박음" 어휘 자제 (CLAUDE.md §핵심 규칙 8 정합) — 기록·반영·추가·통과·완료 등으로 대체
짧은 핵심 인용은 영어 원문 그대로 (Karpathy 4 원칙 등)
검증 가능한 구체 예시 우선 — "테스트를 잘 짜라" ❌ / "Vitest 로 inputValidation 케이스만 mock 없이 작성" ✅

4.2 분량 규칙

본문 1 챕터 평균 2~3 페이지 (A4 11pt 줄간격 1.15)
핵심 표·다이어그램은 별도 페이지 로 (본문 분량 외 추가)
코드 블록·CLI 출력은 등폭 폰트 + 박스 처리

5. 작업 흐름 (Stage 0~6 정합)

5.1 Stage 매핑

Stage	본 소책자 작업
0. Source 수집	✅ 완료 — 5 SNLS in `10_source/2026/05/2026-05-12_*`
1. Raw 정리	(필요 시) `20_raw/2003_HRN_harness/` 에 챕터별 raw 정리
2. Wiki 카드	(선택) `30_wiki/3003_HRN_harness/` 에 재사용 가능한 카드 컴파일
3. 도메인 정합	본 가이드 §2 (Ground Truth 4+1)
4. 챕터 집필	본 폴더 `01_Booklet_Draft.md` 단일 파일 누적 (vibe-book-writer 스킬 1 챕터/회)
5. 검수 (피드백 누적)	`_feedback.md` · `_styles.md` 자동 생성
6. 산출물	본 폴더 → 소책자 PDF → PPT (`ppt-vibe-coding` 스킬)

5.2 권장 작성 순서

Step 1.  본 가이드 검토·승인 (사용자)
Step 2.  vibe-book-writer 스킬로 Ch0 → Ch1 → ... → Ch16 한 챕터씩 작성
         (매 챕터마다 사용자 피드백 → _feedback.md 누적)
Step 3.  vibe-book-publish-edit 스킬로 전체 톤 통일
Step 4.  소책자 PDF 출력 (workspace/builders/)
Step 5.  ppt-vibe-coding 스킬로 PPT 슬라이드 변환 (소책자 → 60 슬라이드)
Step 6.  PPT 검수·수정 → 최종 .pptx 출력

6. 본 폴더에 생성될 산출물 (예정)

20260512 claudemd 파일 이해/
├── 강의 안 작성 가이드.md          ← 본 파일 (SSOT)
├── 01_Booklet_Draft.md            ← Ch0~Ch16 챕터 단위 누적
├── 02_Booklet_Final.md            ← 톤 통일·교정 완료
├── 03_Booklet_v1.0.pdf            ← 출판용 PDF
├── 04_PPT_Planning_Prompt.md      ← PPT_기획_지침서_원본.md 기반 메타
├── 05_Slide_Content_and_Script.md ← 슬라이드별 상세 기획
├── 06_PPT_Slide_Build_Spec.md     ← PPT 빌더 입력 사양
├── 07_lecture_claudemd_v1.0.pptx  ← 최종 PPT
├── _feedback.md                   ← 사용자 피드백 누적 (vibe-book-writer §15)
├── _styles.md                     ← 책 전체 스타일 결정 누적
└── builders/                      ← PPT 빌더 Python 스크립트

7. 핵심 메시지 — 책 전체를 관통하는 한 줄

"CLAUDE.md 는 README 가 아니다. Claude 가 같은 실수를 반복하지 않게 만드는 가드레일 이다. 작게 유지하고, 실수가 날 때마다 채워나가는 살아 있는 문서. 그리고 이것이 바로 하네스 엔지니어링의 핵심 이다."

이 한 줄이 16 챕터 모두에 반복 변주 되어 등장한다 — 챕터마다 다른 각도로 동일한 명제 를 증명한다.

7.1 강의 표어 정합

본 소책자는 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 의 Harness Engineering 절 에 해당한다:

"설계 없이는 코딩이 안된다" → CLAUDE.md = 살아 있는 설계 문서
"AI 에게 어떻게 일을 시키는가가 곧 설계도이다" → CLAUDE.md = AI 의 행동 설계서
본 소책자는 본 위키 3 트랙 중 VCT (Vibe Coding Tech) 의 핵심 자료

8. 작업 이력

날짜	항목
2026-05-12	★ 본 폴더 신설 + 본 강의안 작성 가이드 v1.0 작성. 5 SNLS 자료 (`10_source/2026/05/2026-05-12_*`) 수집 완료 — Anthropic 공식 문서 + Karpathy 스킬 + Anthropic 공식 플러그인 + Software 3.0 종합 + YouTube 실무 강의 전사. 16 챕터 + 부록 3 구조 확정. 다음 할 일: vibe-book-writer 스킬로 Ch0 부터 챕터 단위 집필.
2026-05-12	★★ Ground Truth 5 → 11 자료로 확장. 추가: Anthropic 공식 5 종 (Best Practices / Skills / Hooks Guide / Subagents / Plugins) + Karpathy viral thread (2026-01-26) 종합 (LLM=OS·Context=RAM, 3 실패 모드 영문 직접 인용, 4 패턴 Write·Select·Compress·Isolate, LLM Wiki gist, Vibe Coding 용어 진화). 강의 4 부 (꿀팁) 의 영문 quotable 출처 확보. 가이드 §2 표를 1 차/2 차/보조 3 분류로 재구성.
2026-05-12	★★★ Stage 1~3 위키화 완료 — 11 SNLR (`20_raw/VCT_Tier1/2003_HRN_harness/`) + 25 Wiki Cards (term 7 + concept 5 + entity 2 + case 3 + lesson 7 + synthesis_horim 6) + 1 기존 보강 (`term/claude-md` 가 신규 25 카드와 양방향 연결). 사용자 발 헌법 메타포 (`synthesis_horim_claudemd-as-constitution-of-vibe-coding`) 가 본 강의 지적 DNA. 갭 보강 3 자료 (Karpathy YC 2025 keynote + AGENTS.md Linux Foundation + Boris Cherny Compounding Engineering) → 총 14 SNLS.
2026-05-12	★★★ 구조 재정의 — 16 챕터 → 9 챕터 (들어가며 + Part 1·2·3 + 마무리). 부록 A = 토큰 (트랜스포머 어텐션 + 하드웨어 한계), B·C·D 후순위. 마무리 최종 명제 박힘 — "No Design, No Code → 설계의 시작 = 헌법 설계 = CLAUDE.md 설계·최적화". 합격 기준 명문화 (§0.1): 완벽 이해 + 적용 가능 2 조건 동시 충족. 챕터별 3 층 구조 표준 (공식 인용 → 최호림 재해석 → 청중 처방). 계층 목차 + 챕터 주요 내용 + SNLS·Wiki Card 매핑 매트릭스 박힘.
2026-05-12	★★★ Stage 4~5 완료 — 본문 9 챕터 + 들어가며 + 마치며 + 부록 A·B·C·D 전체 초안 (`01_Booklet_Draft.md`, 1,597 줄 / 89KB). 톤 통일 (`02_Booklet_Final.md`): 박 동사 54 곳 일괄 교체 (박음→기록, 박힌→기록된, 박았다→정립했다 등), 박식·반박 같은 정상 단어 보호. 공학 어휘 추가 점검 0 곳 (이미 출판 톤). 다음 단계 (Stage 6 PPT) 는 사용자 검토 후 별도 세션 — 사용자 명시.
2026-05-12	★★★ 들어가며 §1 대폭 확장 — 1 페이지 → 8~10 페이지. 7 소절 구조: §1.1 폰 노이만 아키텍처 (5 원리·저장 프로그램·LLM 후계자) + §1.2 언어 진화 12 단계 표 + §1.3 설계 도구 진화 14 단계 표 + §1.4 두 축의 수렴 다이어그램 + §1.5 1990s 설계 도구 ↔ 2026 4 층 인프라 매핑 + §1.6 폰 노이만 병목의 부활 (HBM·VCE 연결) + §1.7 ★ 코드의 흡수 (Karpathy Software 1.0/2.0/3.0, 신경망에 if/for 없음, 헌법 = 원칙 ≠ if/for 의 진짜 근거). 돌아온 실버 개발자의 기억의 부활 명시. 가이드 §3.7·§3.8 갱신.
2026-05-12	★★★ 위키 backflow — 들어가며 §1 의 신규 통찰을 위키에 반영. 신규 카드 3: entity/von-neumann (1945 EDVAC·5 원리·LLM 후계자), concept/code-absorption-into-neural-net (Software 1.0/2.0/3.0·헌법 메타포의 진짜 근거), term/von-neumann-bottleneck (HBM·VCE 트랙 연결). 기존 concept/software-3-0 보강 (신규 4 카드 양방향 link). 지침·소책자·위키 세 자리 동기화 완료*.

Concept (개념)lecturedraft2026-05-12

강의안 작성 가이드 — CLAUDE.md 이해 강의

별칭: 강의안 가이드 · lecture planning guide · CLAUDE.md 강의안

#lecture-planning#claudemd#manifest#pipeline

강의안 작성 가이드 — "CLAUDE.md 파일 이해"

자리: 96_ppt_lecture/20260512 claudemd 파일 이해/강의안 작성 가이드.md 버전: v1.0 (2026-05-12 초안) 작성자: Claude (최호림 장로 지시) 갱신 정책: append-only — 작업 진행 시 §8 작업 이력에 한 줄씩 추가

0. 요약 — 본 폴더가 무엇인가

본 폴더는 강의 "CLAUDE.md 파일 이해" 의 소책자 와 PPT 를 순차적으로 생산하는 작업 공간이다.

제작 순서 ★:

먼저 소책자 (책자 형식의 강의 자료) 작성 → Ground Truth 정합
이후 소책자를 대본 골격 으로 삼아 PPT 슬라이드 작성

본 가이드는 1 단계 (소책자) 작성을 위한 SSOT 이며, 동시에 2 단계 (PPT) 의 입력 사양 이기도 하다.

0.1 ★★★ 합격 기준 (사용자 최종 명세, 2026-05-12)

"이 소책자를 보면 바이브 코딩 즉 클로드 코드를 이용한 바이브 코딩 에서의 CLAUDE.md 를 완벽하게 이해 하고 적용 할 수 있게 해 줘야 한다." — 최호림

본 합격 기준은 2 부분 모두 충족해야 한다 — 어느 하나만으로는 ❌:

합격 조건	의미	검증 방법
✅ 완벽 이해	독자가 왜 CLAUDE.md 가 헌법인가·어떻게 작동하는가·왜 잘못 쓰면 토큰 남발인가 의 전체 인과 사슬 을 스스로 설명 가능	마지막 페이지에서 3 문장으로 요약 할 수 있는가
✅ 적용 가능	독자가 오늘·이번 주·이번 달 의 구체 실행 명령 으로 자신의 프로젝트에 즉시 적용	마치며 3 단 안내문 의 모든 명령을 복사·붙여넣기 로 실행 가능

→ 본 합격 기준은 모든 챕터의 3 층 구조 (공식 인용 → 최호림 재해석 → 청중 처방) 에 반드시 다 반영 되어야 한다.

1. 강의 메타데이터

항목	값
강의 제목	CLAUDE.md 파일 이해
부제	"README 가 아니라 가드레일이다 — AI 가 실수를 반복하지 않게 만드는 영구 지시어"
강사	최호림 장로 (AI 에이전트 오케스트레이터)
형식	강의용 소책자 + PPT 슬라이드 (소책자 → PPT 순서)
청중	Vibe Coding 입문 ~ 중급 개발자 (Claude Code 실무 사용자)
작성 시작	2026-05-12
강의 표어 정합	"AI-Native Vibe Coding: No Design, No Code" — CLAUDE.md = 살아 있는 설계 문서
본 위키 트랙	VCT (Vibe Coding Tech) — Harness Engineering 의 중심축

2. ★ Ground Truth — 11 자료 (`10_source/2026/05/`)

본 강의안은 다음 SNLS 자료를 사실 기준선 으로 한다. 모든 본문·예시·인용은 이 11 자료에서 도출되어야 한다.

2.1 1 차 사실 근거 — Anthropic 공식 6 자료 + Karpathy 2 자료 + 보조 3 자료

Anthropic 공식 6 자료 (evidence_grade A_meta)

#	파일	역할
①	`2026-05-12_claude_code_memory_official_docs_snls.md`	공식 — CLAUDE.md / 자동 메모리 (`/docs/ko/memory`). 로드 메커니즘·4 작성 원칙·`/memory`·문제 해결
②	`2026-05-12_anthropic_best_practices_official_snls.md`	공식 — Claude Code 모범 사례 (`/docs/ko/best-practices`). Explore→Plan→Code→Commit, CLAUDE.md 포함·제외 표, 5 실패 패턴, 환경 구성 7 종
③	`2026-05-12_anthropic_skills_official_snls.md`	공식 — Skills (`/docs/ko/skills`). 필요 시 로드, 4 위치, frontmatter 전체, 동적 컨텍스트 주입, fork
④	`2026-05-12_anthropic_hooks_official_snls.md`	공식 — Hooks Guide (`/docs/ko/hooks-guide`). 26 이벤트, 결정론적 자동화, JSON 통신, 권한 모드
⑤	`2026-05-12_anthropic_subagents_official_snls.md`	공식 — Subagents (`/docs/ko/sub-agents`). 격리 컨텍스트, 지속 메모리, Skills preload, Fork 모드
⑥	`2026-05-12_anthropic_plugins_official_snls.md`	공식 — Plugins (`/docs/ko/plugins`). 매니페스트, 디렉토리 구조, claude-md-management 의 작동 원리
⑦	`2026-05-12_anthropic_claudemd_management_plugin_snls.md`	공식 플러그인 — claude-md-management. `claude-md-improver` 5 단계 + `/revise-claude-md` 6 단계

Karpathy 2 자료 (evidence_grade B, 공식 트윗 인용은 A 등급)

#	파일	역할
⑧	`2026-05-12_karpathy_claudemd_skills_snls.md`	Karpathy CLAUDE.md 스킬 — `forrestchang/andrej-karpathy-skills`. 4 핵심 원칙 (Think·Simplicity·Surgical·Goal-Driven). 65 줄 + 109K+ stars
⑨	`2026-05-12_karpathy_viral_thread_context_engineering_snls.md`	★ Karpathy viral thread (2026-01-26) + Context Engineering 종합. LLM=OS·Context=RAM, 4 패턴 (Write·Select·Compress·Isolate), 3 실패 모드 영문 직접 인용, LLM Wiki gist, Vibe Coding 용어 진화

보조·합성 3 자료 (evidence_grade B)

#	파일	역할
⑩	`2026-05-12_software3_maintenance_sdd_harness_snls.md`	Software 3.0 유지보수 4 기둥 — SDD · CLAUDE.md · Harness · 플러그인 통합 골격
⑪	`2026-05-12_youtube_lecture_claudemd_real_usage_snls.md`	YouTube 실무 강의 전사 (실벨 개발자) — 강의 13 절 흐름의 목차 골격

2.2 사용 원칙

본 11 자료 외부 사실 인용 시 → 출처 명시 + 별도 SNLS 추가 후 사용
자료 ① (공식 문서) 또는 ② (Best Practices) 가 최우선 — 충돌 시 항상 공식 우선
⑨ (Karpathy viral thread) 의 영문 직접 인용 은 강의의 마스터 quotable 출처
본문 워딩 80% 이상 = 위 자료에서 도출 / 20% = 본 강의 표어 정합 합성

3. ★ 소책자 구조 — 9 챕터 (들어가며 + Part 1·2·3 + 마무리)

2026-05-12 갱신 — 사용자 (최호림) 지시에 따라 16 챕터 → 9 챕터로 재구성. 다른 소책자 (book-vbc-9-chapters 등) 와 동일한 9 챕터 골격 정합.

★ 중심 메타포: CLAUDE.md = 바이브 코딩의 헌법. 4 위치 = 헌법·법률·시행령·시행규칙. 법률에 들어갈 것을 헌법에 넣지 마라 가 모든 챕터의 통합 명제.

3.0 들어가며 (Introduction) — 프로그래밍 언어의 패러다임 전환 (2~3 페이지)

서사 5 단 구조 (vibe-book-publish-edit 정합):

단	내용	주 자료
1. 역사	ENIAC 이래 폰노이만 아이디어 — 프로그래밍 언어는 컴퓨터가 이해하는 인공 언어. 사람 언어와 분리	(별도 SNLS — VCH 자료 활용)
2. 임계점	최근 AI, 특히 LLM 의 등장 → 컴퓨터가 직접 사람 언어 이해 시작 → 바이브 코딩 시대	Karpathy viral ⑨ §0.2 (80% 전환)
3. 위기	사람 언어로 시키니 경계가 사라짐 → 토큰 남발 + Context Rotting	Karpathy ⑨ §2 (LLM=OS, Context=RAM), ② §0.1
4. 해법	헌법이 필요하다 — 컴퓨터에게 지속적으로 알려주는 영구 지시어 = CLAUDE.md	⑨ §1, ⑦ ⑥
5. 안내	법률에 들어갈 것 (= README) 까지 헌법 (= CLAUDE.md) 에 넣어 버리는 잘못을 피하기 위해 본 책을 쓴다	⑪ §0.2 ("README 가 아니라 가드레일"), ② §5 (포함·제외 표)

3.1 Part 1 — 왜 CLAUDE.md 인가 (도입부, ~10 페이지, 3 챕터)

Ch	제목	주 자료	페이지
Ch1	*컴퓨터가 사람 말* 을 듣기 시작한 순간 — Vibe Coding 시대의 좌절** (한국어로 답하라 했는데 영어로 답하는 Claude / 80% 에이전트 전환 / Context = RAM 비유)	⑨ §0~§2, ⑪ §0, ② §0.1	3
Ch2	★ CLAUDE.md = 바이브 코딩의 헌법 — 4 위치 ↔ 헌법·법률·시행령·시행규칙 완전 매핑 + 상위법 우선 원칙 + 8 레이어 우선순위	[[synthesis_horim_claudemd-as-constitution-of-vibe-coding]] (신규), ① §1.2, §1.7, ⑪ §1~§2	4
Ch3	*헌법은 README* 가 아니다 — 가드레일이다** — README ↔ CLAUDE.md 의 근본 차이 + 법률에 들어갈 것을 헌법에 넣지 말 것 + Karpathy 3 실패 모드 영문 직접 인용	⑪ §0.2, ⑨ §1, ② §5	3

3.2 Part 2 — 헌법을 잘 쓰는 법 (본론, ~14 페이지, 3 챕터)

Ch	제목	주 자료	페이지
Ch4	헌법 작성 4 원칙 — Anthropic 공식 + 코드로 알 수 있는 것은 쓰지 않는다 — 크기·구조·구체성·일관성 + 포함·제외 표 + IMPORTANT/YOU MUST 강조	① §1.4, ② §5, ⑪ §3~§4	5
Ch5	*★ 가장 중요한 1 줄 — 실수 즉시 반영* (최고 ROI)** + 빌드·테스트·린트 명령어 명시 (결과 품질 2~3 배)	⑪ §5~§6, ④ §2.2	4
Ch6	100 줄 넘으면 분할 — `@` 가져오기 + `.claude/rules/` + Skills · Hooks · Subagents 4 층 인프라	① §1.5, §1.8, ⑪ §7~§8, ③ §0.1, ⑤ §6	5

3.3 Part 3 — 헌법을 자동으로 진화 시키기 (응용·실무, ~12 페이지, 3 챕터)

Ch	제목	주 자료	페이지
Ch7	꿀팁 1 — Karpathy 4 원칙 (Think·Simplicity·Surgical·Goal-Driven) — 65 줄 전역 헌법 + 109K stars + 3 실패 모드 대응	⑧ 전체, ⑨ §1, §4	4
Ch8	꿀팁 2 — Anthropic 공식 플러그인 — 자가 진화 CLAUDE.md — `claude-md-improver` 5 단계 + `/revise-claude-md` 6 단계 + 4 파일 점수 시연	⑦ 전체, ⑪ §11	4
Ch9	돌아온 개발자의 30 일 처방 — 한 페이지 체크리스트 6 + 30 일 워크플로우 + 경험 자본의 디지털 백업	[[synthesis_horim_4-pillars-applied-to-returning-dev]] (신규), ⑪ §12	4

3.4 마무리 (Conclusion) — 최종 명제 + 3 단 안내문 (2 페이지)

3.4.1 ★★★ 최종 명제 (사용자 명시 2026-05-12)

"마무리는 No Design, No Code 이다. 설계 없는 코드 없다. 인데, 설계의 시작 은 헌법을 설계 하는 것이고, 헌법을 고쳐 가는 것이다. 즉 CLAUDE.md 를 설계하고 최적화해 가는 과정 이다." — 최호림

3 단 논증:

1. (전제)  설계 없이는 코드 없다 = No Design, No Code = AI-Native 강의 표어
   ↓
2. (확장)  설계의 *시작* = 헌법을 설계하는 것 + 헌법을 *고쳐 가는 것*
   ↓
3. (결론)  CLAUDE.md 를 설계하고 최적화해 가는 과정 = 바이브 코딩의 *설계 그 자체*

→ 이 결론이 본 책의 모든 9 챕터를 하나로 묶는다. 챕터별 세부 적용 → 이 한 명제로 수렴.

3.4.2 3 단 안내문 (행동 지침)

vibe-book-publish-edit 의 마치며 3 단 행동 지침 패턴:

오늘 즉시 — 헌법을 세운다: 프로젝트 루트에 CLAUDE.md 생성 + 첫 1 줄 (빌드 명령) 작성
이번 주 — 헌법을 고친다: 첫 AI 실수 → 즉시 CLAUDE.md 1 줄 추가 (= 즉시 반영 ROI)
이번 달 — 헌법을 최적화한다: claude-md-improver 실행 → 점수 측정 → 분할·정리

→ 3 단계 = 설계·개정·최적화 의 입법 사이클. 입법자 = 개발자 자신.

3.4.3 마치며 마침 문장

"바이브 코딩 시대의 개발자는 코드 노동자 가 아니다 — 헌법 입법자 이다. 코드는 AI 가 쓴다. 우리는 CLAUDE.md 를 설계하고 고쳐 가는 사람들 이다. No Design, No Code — 그 설계의 출발점이자 살아 있는 형식 이 바로 CLAUDE.md 다."

→ 본 책 전체 = 이 한 문장의 근거 제시 — 9 챕터 + 들어가며·마무리 모두가 이 문장으로 수렴한다.

3.5 부록 (선택)

2026-05-12 갱신 — 사용자 지시: 토큰 부록을 맨 먼저 (부록 A) 로 이동.

부록	내용	페이지
A	★ 토큰의 본질과 미래 — 어텐션 메커니즘의 기본 단위 + 하드웨어 한계로 부각될 토큰 관리	2
B	자동 메모리 + `/memory` 사용법	2
C	문제 해결 FAQ	2
D	참고 링크 + 14 SNLS 자료 목록 (11 핵심 + 3 갭 보강)	1

부록 A 주요 내용 (사용자 명시 2026-05-12)

토큰의 정의 — 트랜스포머 (Transformer) 의 어텐션 메커니즘 (Attention Mechanism) 의 기본 단위. 입력 텍스트를 분해하는 최소 단위 (subword 또는 word piece).
어텐션 메커니즘과 토큰의 관계 — 어텐션 = 모든 토큰 쌍 사이의 관련성 계산. 토큰 수 N → 계산량 O(N²) → context window 가 곧 계산 비용 + 메모리 비용*.
★ 향후 더 중요해질 이유 — 하드웨어 공급 한계:
- LLM 모델 크기 기하급수적 증가 (수십억 → 수조 파라미터)
- 동시에 context window 확장 (4K → 200K → 1M 토큰)
- 둘 다 메모리 대역폭·용량 요구 폭증
- 그러나 HBM (High Bandwidth Memory)·D-RAM 의 물리적 생산 한계 가 단기간 해결 불가 (반도체 팹 증설 = 3~5 년)
- → 토큰 관리 = AI 엔지니어의 희소 자원 관리 (resource arbitrage)*
본 위키 VCE 트랙 연결 — Vibe Coding Economy 의 핵심 명제: AI 시대 = 메모리 반도체 슈퍼사이클. 토큰 = 수요 측, 메모리 = 공급 측. 둘 사이의 불균형 이 삼성·SK 하이닉스 슈퍼사이클 의 근거.
★ 본 책 핵심 메시지와의 연결 — 토큰이 희소 하기 때문에 CLAUDE.md 가 헌법으로서 필요. 희소 자원의 조직화 = 헌법의 본질. Karpathy 의 Context = RAM 비유 (term/context-window-as-ram) 가 물리적 하드웨어 한계로 더욱 정합.
30 일 후 행동 — 본 책 마치며의 3 단 안내문 을 실천한 독자가 다음에 읽을 자료: 30_wiki/3020_VCE_economy/ (VCE 트랙) — 토큰 → 메모리 → 산업 → 투자 의 4 층위 인과 사슬.

총 페이지 ≈ 42 페이지 (들어가며 3 + Part 1·2·3 = 36 + 마무리 2 + 부록 7).

3.6 챕터별 3 층 구조 표준

각 챕터 (Ch1~Ch9) 는 다음 3 층 구조 를 따른다 — 단순 요약 ❌, 재해석 + 처방 포함:

층	내용	출처
1. 공식 인용 (Ground Truth)	11 SNLS 의 영문·한국어 직접 인용	Anthropic 공식 + Karpathy viral
2. 최호림 재해석 (Insight)	AI-Native + 돌아온 실버 개발자 관점 통찰 — 헌법 메타포·경험 자본·30 일 학습 곡선	6 신규 synthesis 카드 + 기존 7 카드 연결
3. 청중 처방 (Application)	실버 복귀 개발자 + 후배 에게의 구체 행동 처방	30 일 워크플로우·체크리스트·실행 명령

3.7 ★ 계층 목차 + 챕터별 주요 내용 (상세)

2026-05-12 갱신 — 사용자 지시: 목차의 계층구조 + 챕터 주요 내용 표시.

📕 소책자 "CLAUDE.md 파일 이해"
│
├─ 📖 들어가며 (8~10쪽, *대폭 확장 2026-05-12*) — 프로그래밍 언어의 패러다임 전환
│   ├─ §1 — 80 년의 침묵 (컴퓨터는 사람 말을 듣지 않았다)
│   │   ├─ §1.1 ★ 폰 노이만의 정리 (1945) — 80 년 컴퓨팅의 토대 (5 원리 + 저장 프로그램의 혁명성 + LLM 후계자)
│   │   ├─ §1.2 프로그래밍 언어의 진화 — 기계어→어셈블리→FORTRAN→C→OOP→...→자연어 (2026) 12 단계 표
│   │   ├─ §1.3 설계 도구의 진화 — 플로차트→HIPO→DFD→ERD→구조도→UML→ADR→...→CLAUDE.md 14 단계 표
│   │   ├─ §1.4 두 축의 수렴 — 자연어 + 마크다운이 *바이브 코딩* 한 점에서 만남
│   │   ├─ §1.5 미리 보기 — 1990s 설계 도구 8 종 ↔ 2026 4 층 인프라 (CLAUDE.md·Hooks·Skills·Subagents·Plugins·Memory) 완전 매핑
│   │   ├─ §1.6 폰 노이만 병목의 부활 — HBM 부족 → 토큰 희소성 → 헌법 설계가 *물리학과 만난다*
│   │   └─ §1.7 ★ 코드의 흡수 — *신경망에는 if 문이 없다* (Karpathy Software 1.0/2.0/3.0) → *헌법 = 원칙 ≠ if/for* 의 *진짜 근거*
│   ├─ §2 — 임계점 (2025-12 카파시 80% 전환)
│   ├─ §3 — 위기 (사람 말 시키니 경계 무너짐 → Context Rotting)
│   ├─ §4 — 해법 (CLAUDE.md = 헌법)
│   └─ §5 — 안내 (README/법률에 들어갈 것을 헌법에 박지 마라)
│
├─ 📘 PART 1 — 왜 CLAUDE.md 인가 (도입부, 약 10쪽)
│   │
│   ├─ Chapter 1 ─ 컴퓨터가 사람 말을 듣기 시작한 순간 (3쪽)
│   │   ├─ 1.1 한국어로 답하라 했는데 영어로 답하는 Claude (좌절의 출발점)
│   │   ├─ 1.2 Karpathy 의 80% 전환 증언 — "20년 코딩 인생 최대 변화"
│   │   ├─ 1.3 LLM = OS, Context window = RAM (Karpathy 비유, 영문 직접 인용)
│   │   ├─ 1.4 [최호림 재해석] 돌아온 개발자에게는 1990s RAM 256KB 시절의 자원 관리 본능이 자산
│   │   └─ 1.5 [처방] Context = 가장 희소한 자원이라는 인식 — `/statusline` 토큰 모니터링
│   │
│   ├─ Chapter 2 ─ ★ CLAUDE.md = 바이브 코딩의 헌법 (4쪽, 본 책 중심 챕터)
│   │   ├─ 2.1 4 위치 ↔ 한국 법체계 완전 매핑 (헌법 / 법률 / 시행령 / 시행규칙 / 행정규칙)
│   │   ├─ 2.2 상위법 우선 원칙 ↔ CLAUDE.md 우선순위
│   │   ├─ 2.3 8 레이어 컨텍스트 (아래로 갈수록 강력 — 적용 우선순위)
│   │   ├─ 2.4 두 비유의 방향 차이 명확화 (법체계 = 위 우선 / 컨텍스트 = 아래 우선)
│   │   ├─ 2.5 [최호림 재해석] 1990s UML 도 같은 역할 — 운반체만 변했다
│   │   └─ 2.6 [처방] 첫 CLAUDE.md 만들 때 4 위치 중 어디에 무엇을 둘지 결정 체크리스트
│   │
│   └─ Chapter 3 ─ 헌법은 README 가 아니다 (3쪽)
│       ├─ 3.1 ★ 한 줄 정의 — "AI 가 같은 실수를 반복하지 않게 만드는 가드레일"
│       ├─ 3.2 코드로 알 수 있는 것은 쓰지 않는다 (실벨 강의 1 원칙)
│       ├─ 3.3 Karpathy 3 실수 모드 (Silent Assumptions / Over-Engineering / Collateral Changes — 영문 인용)
│       ├─ 3.4 안티 패턴 표 — "사람 읽기 좋게" vs "AI 실수 안 하게"
│       ├─ 3.5 [최호림 재해석] AI = 자신감 있는 무능한 인턴 → 실버 = 멘토 → CLAUDE.md = 멘토 노트
│       └─ 3.6 [처방] 기존 CLAUDE.md 의 50% 줄이는 5 분 운동
│
├─ 📗 PART 2 — 헌법을 잘 쓰는 법 (본론, 약 14쪽)
│   │
│   ├─ Chapter 4 ─ 헌법 작성 4 원칙 (5쪽)
│   │   ├─ 4.1 Anthropic 공식 4 원칙 — 크기·구조·구체성·일관성
│   │   ├─ 4.2 200 줄 한계 + 부풀려진 CLAUDE.md 의 위험
│   │   ├─ 4.3 ✅ 포함 vs ❌ 제외 표 (Anthropic 공식)
│   │   ├─ 4.4 IMPORTANT / YOU MUST 강조 도구 — 권고 가중치 올리는 공식 트릭
│   │   ├─ 4.5 [최호림 재해석] 1990s 코딩 컨벤션 문서가 그대로 부활 — 다만 AI 가 독자
│   │   └─ 4.6 [처방] CLAUDE.md 가 "코드처럼" 유지보수되어야 한다는 멘탈 모델
│   │
│   ├─ Chapter 5 ─ ★ 가장 중요한 1 줄 — 실수 즉시 반영 (4쪽)
│   │   ├─ 5.1 ★ High ROI 워크플로우 — "이 실수 다시 안 하게 CLAUDE.md 에 반영해"
│   │   ├─ 5.2 빌드·테스트·린트 명령어 명시 — 결과 품질 2~3 배
│   │   ├─ 5.3 일주일 운용 효과 — CLAUDE.md 가 프로젝트에 딱 맞게 자라난다
│   │   ├─ 5.4 [최호림 재해석] 돌아온 개발자만이 빠르게 도달 가능 — "잘못된 가정의 비용" 을 몸으로 안다
│   │   └─ 5.5 [처방] 30 일 워크플로우 — Day 1·Day 7·Day 30 측정 지표
│   │
│   └─ Chapter 6 ─ 100 줄 넘으면 분할 + 4 층 인프라 (5쪽)
│       ├─ 6.1 `@path` 가져오기 — README·docs·홈 디렉토리 참조 (5 홉 깊이)
│       ├─ 6.2 `.claude/rules/` 경로별 규칙 — `paths` glob 으로 토큰 절약 핵심
│       ├─ 6.3 AGENTS.md ↔ CLAUDE.md 통합 (`@AGENTS.md` 한 줄)
│       ├─ 6.4 4 층 인프라 — Skills (필요 시 로드) + Hooks (결정론) + Subagents (격리) + Plugins (배포)
│       ├─ 6.5 [최호림 재해석] 헌법·법률·시행령 분리 = 4 층 인프라 분리와 동일 정신
│       └─ 6.6 [처방] 200 줄 넘어가는 CLAUDE.md 의 분할 작전 (코딩 스타일 → 별도 md)
│
├─ 📙 PART 3 — 헌법을 자동으로 진화시키기 (응용·실무, 약 12쪽)
│   │
│   ├─ Chapter 7 ─ 꿀팁 1 — Karpathy 4 원칙 (4쪽)
│   │   ├─ 7.1 65 줄 CLAUDE.md + 109K stars 의 사회적 함의
│   │   ├─ 7.2 Think Before Coding — Don't assume. Don't hide confusion. Surface tradeoffs.
│   │   ├─ 7.3 Simplicity First — Minimum code. 200 → 50 줄 다시 쓰기 원칙
│   │   ├─ 7.4 Surgical Changes — 변경된 모든 줄 = 사용자 요청과 직접 연결
│   │   ├─ 7.5 Goal-Driven Execution — "Define success criteria. Loop until verified."
│   │   ├─ 7.6 작동 신호 3 — diff ↓ / 재작성 ↓ / 시작 전 질문 ↑
│   │   ├─ 7.7 [최호림 재해석] 4 원칙 = 1990s 시니어가 후배에게 한 4 마디의 디지털 압축
│   │   └─ 7.8 [처방] `~/.claude/CLAUDE.md` 에 65 줄 즉시 복붙하는 명령어
│   │
│   ├─ Chapter 8 ─ 꿀팁 2 — Anthropic 공식 플러그인 (4쪽)
│   │   ├─ 8.1 claude-md-improver — 5 단계 (Discovery → Assessment → Report → Updates → Apply)
│   │   ├─ 8.2 6 기준 평가 + 등급 (A 90~100 / B 70~89 / C 50~69 / D 30~49 / F 0~29)
│   │   ├─ 8.3 4 파일 시연 — 평균 80 점 (B), P0 = 루트 우선
│   │   ├─ 8.4 /revise-claude-md — 6 단계 (Reflect → Locate → Categorize → Draft → Preview → Apply)
│   │   ├─ 8.5 두 도구의 상호 보완 — 매 세션 vs 매 월
│   │   ├─ 8.6 [최호림 재해석] CLAUDE.md 가 스스로 진화 → 멘토 자리가 디지털화
│   │   └─ 8.7 [처방] 설치 명령 + 첫 감사 실행 + 결과 해석법
│   │
│   └─ Chapter 9 ─ 돌아온 개발자의 30 일 처방 (4쪽)
│       ├─ 9.1 한 페이지 체크리스트 6 (100 줄·명령어·코드 파악 가능 내용·구체성·월 점검·즉시 반영)
│       ├─ 9.2 30 일 워크플로우 — Week 1 (1 줄 시작) → Week 2 (분할) → Week 3 (자동화) → Week 4 (감사)
│       ├─ 9.3 Software 3.0 4 기둥 — 돌아온 개발자에게는 1990s 의 등가물이 다 있다
│       ├─ 9.4 [최호림 재해석] CLAUDE.md = 경험 자본의 디지털 백업 (두 번째 두뇌)
│       ├─ 9.5 [최호림 재해석] 토큰 차익거래 — 경험 자본을 활용한 context window 최적화
│       └─ 9.6 [처방] 30 일 후 자가 점검 — Karpathy 의 "80% 에이전트" 수준 도달 측정
│
└─ 📕 마무리 (1~2쪽) — 3 단 안내문
    ├─ 1. 오늘 즉시 — 프로젝트 루트에 CLAUDE.md 생성 + 빌드 명령 1 줄
    ├─ 2. 이번 주 — 첫 AI 실수 → 즉시 CLAUDE.md 1 줄 추가
    └─ 3. 이번 달 — claude-md-improver 실행 → 점수 측정 → 분할·정리

📎 부록
   ├─ A. 자동 메모리 + `/memory` 사용법 (2쪽)
   ├─ B. 문제 해결 FAQ (2쪽)
   └─ C. 참고 링크 + 11 SNLS 자료 목록 (1쪽)

3.8 챕터 ↔ SNLS / Wiki Card 매핑 매트릭스

Chapter	주 SNLS	주 신규 Wiki Card	기존 카드 연결
들어가며 §1.1~§1.7 ★	⑫ Karpathy YC 2025, ⑨ Karpathy viral, ⑪ YouTube	entity/von-neumann (신규), term/von-neumann-bottleneck (신규), concept/code-absorption-into-neural-net (신규), term/context-window-as-ram, case/karpathy-80percent-shift	concept/software-3-0 (보강), concept/ai-native-4-stages, [[synthesis_horim_claudemd-as-constitution-of-vibe-coding]]
Ch1	⑨, ⑪, ②	case/karpathy-80percent-shift, concept/context-engineering-4-patterns	concept/context-engineering (기존)
Ch2	①, ⑪	[[synthesis_horim_claudemd-as-constitution-of-vibe-coding]], lesson/claudemd-4-locations, lesson/claudemd-8-context-layers, term/eight-context-layers	term/claude-md (보강)
Ch3	⑪, ⑨, ②	concept/claudemd-as-guardrail, [[synthesis_horim_claudemd-as-mentor-note]]	concept/claudemd-as-design-language (보강)
Ch4	①, ②, ⑪	lesson/claudemd-4-writing-principles, concept/instructional-overrides	lesson/hrn-experience-as-validator (보강)
Ch5	⑪, ④, ②	lesson/claudemd-load-mechanism, [[synthesis_horim_returning-dev-claudemd-as-second-brain]]	lesson/int-ai-native-mindset
Ch6	①, ⑤, ④, ⑥	term/skill-frontmatter-fields, term/hook-events-26, term/agent-memory, term/plugin-manifest, [[synthesis_horim_claudemd-vs-pre-uml-design]]	concept/harness-engineering
Ch7	⑧, ⑨	lesson/karpathy-4-principles, entity/karpathy, entity/forrest-chang, case/karpathy-109k-stars	synthesis/slogan-ai-native-no-design-no-code
Ch8	⑦, ⑥, ⑪	lesson/anthropic-claudemd-management, concept/self-evolving-claudemd, entity/isabella-he, case/claudemd-improver-demo-4files	(없음)
Ch9	⑪, ⑩, ⑨	lesson/claudemd-checklist-6, [[synthesis_horim_4-pillars-applied-to-returning-dev]], [[synthesis_horim_token-economy-and-experience-arbitrage]]	lesson/hrn-experience-as-validator (보강)
마무리	(전체 종합)	(전체 종합)	synthesis/slogan-ai-native-no-design-no-code

4. 작성 톤·문체 규칙

본 위키의 vibe-book-publish-edit 스킬의 최호림 v1.0 출판 톤 을 완화 적용. 본 강의 소책자는 실무 매뉴얼 톤 이 우선이다.

4.1 채택 규칙

부 → Part / 장 → Chapter 일괄 표기
시니어 → 실버 개발자 통일
새 용어는 한국어 (English) 병기 (예: 가드레일 (guardrail), 영구 지시어 (persistent instruction))
"박음" 어휘 자제 (CLAUDE.md §핵심 규칙 8 정합) — 기록·반영·추가·통과·완료 등으로 대체
짧은 핵심 인용은 영어 원문 그대로 (Karpathy 4 원칙 등)
검증 가능한 구체 예시 우선 — "테스트를 잘 짜라" ❌ / "Vitest 로 inputValidation 케이스만 mock 없이 작성" ✅

4.2 분량 규칙

본문 1 챕터 평균 2~3 페이지 (A4 11pt 줄간격 1.15)
핵심 표·다이어그램은 별도 페이지 로 (본문 분량 외 추가)
코드 블록·CLI 출력은 등폭 폰트 + 박스 처리

5. 작업 흐름 (Stage 0~6 정합)

5.1 Stage 매핑

Stage	본 소책자 작업
0. Source 수집	✅ 완료 — 5 SNLS in `10_source/2026/05/2026-05-12_*`
1. Raw 정리	(필요 시) `20_raw/2003_HRN_harness/` 에 챕터별 raw 정리
2. Wiki 카드	(선택) `30_wiki/3003_HRN_harness/` 에 재사용 가능한 카드 컴파일
3. 도메인 정합	본 가이드 §2 (Ground Truth 4+1)
4. 챕터 집필	본 폴더 `01_Booklet_Draft.md` 단일 파일 누적 (vibe-book-writer 스킬 1 챕터/회)
5. 검수 (피드백 누적)	`_feedback.md` · `_styles.md` 자동 생성
6. 산출물	본 폴더 → 소책자 PDF → PPT (`ppt-vibe-coding` 스킬)

5.2 권장 작성 순서

Step 1.  본 가이드 검토·승인 (사용자)
Step 2.  vibe-book-writer 스킬로 Ch0 → Ch1 → ... → Ch16 한 챕터씩 작성
         (매 챕터마다 사용자 피드백 → _feedback.md 누적)
Step 3.  vibe-book-publish-edit 스킬로 전체 톤 통일
Step 4.  소책자 PDF 출력 (workspace/builders/)
Step 5.  ppt-vibe-coding 스킬로 PPT 슬라이드 변환 (소책자 → 60 슬라이드)
Step 6.  PPT 검수·수정 → 최종 .pptx 출력

6. 본 폴더에 생성될 산출물 (예정)

20260512 claudemd 파일 이해/
├── 강의 안 작성 가이드.md          ← 본 파일 (SSOT)
├── 01_Booklet_Draft.md            ← Ch0~Ch16 챕터 단위 누적
├── 02_Booklet_Final.md            ← 톤 통일·교정 완료
├── 03_Booklet_v1.0.pdf            ← 출판용 PDF
├── 04_PPT_Planning_Prompt.md      ← PPT_기획_지침서_원본.md 기반 메타
├── 05_Slide_Content_and_Script.md ← 슬라이드별 상세 기획
├── 06_PPT_Slide_Build_Spec.md     ← PPT 빌더 입력 사양
├── 07_lecture_claudemd_v1.0.pptx  ← 최종 PPT
├── _feedback.md                   ← 사용자 피드백 누적 (vibe-book-writer §15)
├── _styles.md                     ← 책 전체 스타일 결정 누적
└── builders/                      ← PPT 빌더 Python 스크립트

7. 핵심 메시지 — 책 전체를 관통하는 한 줄

"CLAUDE.md 는 README 가 아니다. Claude 가 같은 실수를 반복하지 않게 만드는 가드레일 이다. 작게 유지하고, 실수가 날 때마다 채워나가는 살아 있는 문서. 그리고 이것이 바로 하네스 엔지니어링의 핵심 이다."

이 한 줄이 16 챕터 모두에 반복 변주 되어 등장한다 — 챕터마다 다른 각도로 동일한 명제 를 증명한다.

7.1 강의 표어 정합

본 소책자는 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 의 Harness Engineering 절 에 해당한다:

"설계 없이는 코딩이 안된다" → CLAUDE.md = 살아 있는 설계 문서
"AI 에게 어떻게 일을 시키는가가 곧 설계도이다" → CLAUDE.md = AI 의 행동 설계서
본 소책자는 본 위키 3 트랙 중 VCT (Vibe Coding Tech) 의 핵심 자료

8. 작업 이력

날짜	항목
2026-05-12	★ 본 폴더 신설 + 본 강의안 작성 가이드 v1.0 작성. 5 SNLS 자료 (`10_source/2026/05/2026-05-12_*`) 수집 완료 — Anthropic 공식 문서 + Karpathy 스킬 + Anthropic 공식 플러그인 + Software 3.0 종합 + YouTube 실무 강의 전사. 16 챕터 + 부록 3 구조 확정. 다음 할 일: vibe-book-writer 스킬로 Ch0 부터 챕터 단위 집필.
2026-05-12	★★ Ground Truth 5 → 11 자료로 확장. 추가: Anthropic 공식 5 종 (Best Practices / Skills / Hooks Guide / Subagents / Plugins) + Karpathy viral thread (2026-01-26) 종합 (LLM=OS·Context=RAM, 3 실패 모드 영문 직접 인용, 4 패턴 Write·Select·Compress·Isolate, LLM Wiki gist, Vibe Coding 용어 진화). 강의 4 부 (꿀팁) 의 영문 quotable 출처 확보. 가이드 §2 표를 1 차/2 차/보조 3 분류로 재구성.
2026-05-12	★★★ Stage 1~3 위키화 완료 — 11 SNLR (`20_raw/VCT_Tier1/2003_HRN_harness/`) + 25 Wiki Cards (term 7 + concept 5 + entity 2 + case 3 + lesson 7 + synthesis_horim 6) + 1 기존 보강 (`term/claude-md` 가 신규 25 카드와 양방향 연결). 사용자 발 헌법 메타포 (`synthesis_horim_claudemd-as-constitution-of-vibe-coding`) 가 본 강의 지적 DNA. 갭 보강 3 자료 (Karpathy YC 2025 keynote + AGENTS.md Linux Foundation + Boris Cherny Compounding Engineering) → 총 14 SNLS.
2026-05-12	★★★ 구조 재정의 — 16 챕터 → 9 챕터 (들어가며 + Part 1·2·3 + 마무리). 부록 A = 토큰 (트랜스포머 어텐션 + 하드웨어 한계), B·C·D 후순위. 마무리 최종 명제 박힘 — "No Design, No Code → 설계의 시작 = 헌법 설계 = CLAUDE.md 설계·최적화". 합격 기준 명문화 (§0.1): 완벽 이해 + 적용 가능 2 조건 동시 충족. 챕터별 3 층 구조 표준 (공식 인용 → 최호림 재해석 → 청중 처방). 계층 목차 + 챕터 주요 내용 + SNLS·Wiki Card 매핑 매트릭스 박힘.
2026-05-12	★★★ Stage 4~5 완료 — 본문 9 챕터 + 들어가며 + 마치며 + 부록 A·B·C·D 전체 초안 (`01_Booklet_Draft.md`, 1,597 줄 / 89KB). 톤 통일 (`02_Booklet_Final.md`): 박 동사 54 곳 일괄 교체 (박음→기록, 박힌→기록된, 박았다→정립했다 등), 박식·반박 같은 정상 단어 보호. 공학 어휘 추가 점검 0 곳 (이미 출판 톤). 다음 단계 (Stage 6 PPT) 는 사용자 검토 후 별도 세션 — 사용자 명시.
2026-05-12	★★★ 들어가며 §1 대폭 확장 — 1 페이지 → 8~10 페이지. 7 소절 구조: §1.1 폰 노이만 아키텍처 (5 원리·저장 프로그램·LLM 후계자) + §1.2 언어 진화 12 단계 표 + §1.3 설계 도구 진화 14 단계 표 + §1.4 두 축의 수렴 다이어그램 + §1.5 1990s 설계 도구 ↔ 2026 4 층 인프라 매핑 + §1.6 폰 노이만 병목의 부활 (HBM·VCE 연결) + §1.7 ★ 코드의 흡수 (Karpathy Software 1.0/2.0/3.0, 신경망에 if/for 없음, 헌법 = 원칙 ≠ if/for 의 진짜 근거). 돌아온 실버 개발자의 기억의 부활 명시. 가이드 §3.7·§3.8 갱신.
2026-05-12	★★★ 위키 backflow — 들어가며 §1 의 신규 통찰을 위키에 반영. 신규 카드 3: entity/von-neumann (1945 EDVAC·5 원리·LLM 후계자), concept/code-absorption-into-neural-net (Software 1.0/2.0/3.0·헌법 메타포의 진짜 근거), term/von-neumann-bottleneck (HBM·VCE 트랙 연결). 기존 concept/software-3-0 보강 (신규 4 카드 양방향 link). 지침·소책자·위키 세 자리 동기화 완료*.

강의안 작성 가이드 — "CLAUDE.md 파일 이해"

0. 요약 — 본 폴더가 무엇인가

0.1 ★★★ 합격 기준 (사용자 최종 명세, 2026-05-12)

1. 강의 메타데이터

2. ★ Ground Truth — 11 자료 (10_source/2026/05/)

2.1 1 차 사실 근거 — Anthropic 공식 6 자료 + Karpathy 2 자료 + 보조 3 자료

Anthropic 공식 6 자료 (evidence_grade A_meta)

Karpathy 2 자료 (evidence_grade B, 공식 트윗 인용은 A 등급)

보조·합성 3 자료 (evidence_grade B)

2.2 사용 원칙

3. ★ 소책자 구조 — 9 챕터 (들어가며 + Part 1·2·3 + 마무리)

3.0 들어가며 (Introduction) — 프로그래밍 언어의 패러다임 전환 (2~3 페이지)

3.1 Part 1 — 왜 CLAUDE.md 인가 (도입부, ~10 페이지, 3 챕터)

3.2 Part 2 — 헌법을 잘 쓰는 법 (본론, ~14 페이지, 3 챕터)

3.3 Part 3 — 헌법을 자동으로 진화 시키기 (응용·실무, ~12 페이지, 3 챕터)

3.4 마무리 (Conclusion) — 최종 명제 + 3 단 안내문 (2 페이지)

3.4.1 ★★★ 최종 명제 (사용자 명시 2026-05-12)

3.4.2 3 단 안내문 (행동 지침)

3.4.3 마치며 마침 문장

3.5 부록 (선택)

부록 A 주요 내용 (사용자 명시 2026-05-12)

3.6 챕터별 3 층 구조 표준

3.7 ★ 계층 목차 + 챕터별 주요 내용 (상세)

3.8 챕터 ↔ SNLS / Wiki Card 매핑 매트릭스

4. 작성 톤·문체 규칙

4.1 채택 규칙

4.2 분량 규칙

5. 작업 흐름 (Stage 0~6 정합)

5.1 Stage 매핑

5.2 권장 작성 순서

6. 본 폴더에 생성될 산출물 (예정)

7. 핵심 메시지 — 책 전체를 관통하는 한 줄

7.1 강의 표어 정합

8. 작업 이력

강의안 작성 가이드 — "CLAUDE.md 파일 이해"

0. 요약 — 본 폴더가 무엇인가

0.1 ★★★ 합격 기준 (사용자 최종 명세, 2026-05-12)

1. 강의 메타데이터

2. ★ Ground Truth — 11 자료 (10_source/2026/05/)

2.1 1 차 사실 근거 — Anthropic 공식 6 자료 + Karpathy 2 자료 + 보조 3 자료

Anthropic 공식 6 자료 (evidence_grade A_meta)

Karpathy 2 자료 (evidence_grade B, 공식 트윗 인용은 A 등급)

보조·합성 3 자료 (evidence_grade B)

2.2 사용 원칙

3. ★ 소책자 구조 — 9 챕터 (들어가며 + Part 1·2·3 + 마무리)

3.0 들어가며 (Introduction) — 프로그래밍 언어의 패러다임 전환 (2~3 페이지)

3.1 Part 1 — 왜 CLAUDE.md 인가 (도입부, ~10 페이지, 3 챕터)

3.2 Part 2 — 헌법을 잘 쓰는 법 (본론, ~14 페이지, 3 챕터)

3.3 Part 3 — 헌법을 자동으로 진화 시키기 (응용·실무, ~12 페이지, 3 챕터)

3.4 마무리 (Conclusion) — 최종 명제 + 3 단 안내문 (2 페이지)

3.4.1 ★★★ 최종 명제 (사용자 명시 2026-05-12)

3.4.2 3 단 안내문 (행동 지침)

3.4.3 마치며 마침 문장

3.5 부록 (선택)

부록 A 주요 내용 (사용자 명시 2026-05-12)

3.6 챕터별 3 층 구조 표준

3.7 ★ 계층 목차 + 챕터별 주요 내용 (상세)

3.8 챕터 ↔ SNLS / Wiki Card 매핑 매트릭스

4. 작성 톤·문체 규칙

4.1 채택 규칙

4.2 분량 규칙

5. 작업 흐름 (Stage 0~6 정합)

5.1 Stage 매핑

5.2 권장 작성 순서

6. 본 폴더에 생성될 산출물 (예정)

7. 핵심 메시지 — 책 전체를 관통하는 한 줄

7.1 강의 표어 정합

8. 작업 이력

2. ★ Ground Truth — 11 자료 (`10_source/2026/05/`)

2. ★ Ground Truth — 11 자료 (`10_source/2026/05/`)