Synthesis (종합)lecturedraftTue May 12
CLAUDE.md ↔ 1990s UML 비교 — 기능은 같고 운반체만 변했다
별칭: claudemd-vs-uml · design-language-evolution · runtime-vehicle-change
#horim-insight#uml-history#design-language#runtime-evolution#returning-developer
한 줄 명제
CLAUDE.md 는 새로운 것 이 아니다. 1990s UML·HIPO·ERD 와 같은 기능 (설계의 외재화·팀 공유·검증 기준) — 다만 운반체가 마크다운으로 변했고, 독자가 AI 로 변했다.
역사적 비교표
| 시대 | 설계 언어 | 운반체 | 독자 | 검증 |
|---|---|---|---|---|
| 1970s | HIPO 차트 | 종이·마이크로필름 | 인간 | 검토 회의 |
| 1980s | DFD·ERD | 종이·CASE 도구 | 인간 | 워크스루 |
| 1990s | UML | Rational Rose·종이 | 인간 | 코드 리뷰 |
| 2000s | XP·Scrum 의 생략 | (구두·화이트보드) | 인간 (팀) | TDD |
| 2010s | API 명세 (OpenAPI) | YAML/JSON | 인간 + 도구 | 자동 테스트 |
| 2026 | CLAUDE.md | 마크다운 | AI (Claude) | AI 자기 검증 |
→ 기능 은 동일. 운반체·독자 만 변화.
★ 돌아온 개발자만이 볼 수 있는 통찰
후배는 UML 본 적 없음. 그래서 CLAUDE.md 를 완전히 새로운 것 으로 학습. 돌아온 개발자는 UML 시절 모든 설계 원칙 을 안다 → CLAUDE.md 학습 시간 단축.
4 원칙의 역사적 등가물
lesson/claudemd-4-writing-principles 의 4 원칙 = UML 시절에도 동일:
| 원칙 | 1990s UML | 2026 CLAUDE.md |
|---|---|---|
| 크기 | "UML 다이어그램 한 페이지 1 view" | 200 줄 이하 |
| 구조 | "패키지 다이어그램 → 클래스 → 시퀀스" | 마크다운 헤더 계층 |
| 구체성 | "추상 클래스는 italic" | "2 칸 들여쓰기" |
| 일관성 | "ER 모델과 클래스 도메인 일치" | 충돌 제거 |
→ 돌아온 개발자는 4 원칙을 체화 한 상태. 학습 곡선이 거의 0.
★ Karpathy 의 Software 3.0 정합
entity/karpathy YC 2025 keynote:
"가장 핫한 새 프로그래밍 언어는 영어."
→ 설계 언어도 영어로 진화. UML 기호 → 마크다운·자연어. 기호·문법은 바뀌어도 기능은 동일.
강의 활용
- Ch1 — 들어가며에 돌아온 개발자에게 친숙한 도입.
- Ch4 §4.5 — 4 원칙의 1990s 등가물 표.
- Ch6 §6.5 — 헌법·법률 분리 = UML 의 Package·Class·Sequence 분리 와 동일 정신.
- 마치며 — 돌아온 개발자의 유리한 위치* 재확인.