13 장. UML → AI 에이전트 1:1 동형 — *지금 배우는 OOAD 가 그대로 쓰인다*
*"여러분이 지금 OOASD 시간에 배우는 모든 것이 — AI 에이전트 설계의 언어 * 입니다."
도입 — 컴공 4 년이 재배치 되는 자리
6 장에서 *알고리즘 / OOP / DB 가 적용 위치만 바뀐다 * 는 메시지를 박았다. 13 장은 그 적용 위치 이동 의 가장 구체적 증거 를 본다.
수업 첫 질문.
*"여러분 중 OOASD (Object-Oriented Analysis & Software Design) 수업을 지금 듣고 있거나 지난 학기에 들은 사람?"
(보통 손이 대부분 올라간다. 컴공 학과 필수 또는 권장 과목이라.)
이 질문이 강력한 이유 — 이 장의 결론을 손 든 사람들에게 직접 메시지 로 박을 수 있기 때문이다.
여러분이 OOASD 시간에 배운 Usecase / Class / Sequence Diagram 이 — AI 에이전트 설계의 직접적인 언어 * 입니다.
이게 AI 시대 = 새 시대 = 모든 게 새것 이라는 흔한 오해 를 정정한다. *AI 에이전트 시대의 설계 언어는 완전히 새 것이 아니다. OOAD 의 재배치 * 다.
UML 3 대 다이어그램 ↔ AI 에이전트 1:1 매핑
핵심 표를 기록한다. Isomorphism (동형 사상) — 즉 구조가 1:1 로 대응 한다.
| UML 다이어그램 | 전통 역할 | AI 에이전트 대응 |
|---|---|---|
| Usecase Diagram | 무엇을 하는가 (기능) | Agent 목표 (Goal) 정의 |
| Class Diagram | 구조와 관계 | Agent 역할 (Role) + 도구 (Tool) |
| Sequence Diagram | 시간 흐름과 메시지 | Orchestration 흐름 |
이 표가 강력한 이유 — *세 가지 다이어그램이 AI 에이전트 설계에 그대로 매핑 * 된다는 것. 4 학년이 이미 그릴 줄 아는 그림 이 — AI 에이전트 시스템의 설계도 다.
학생 시각으로 옮기면:
- OOASD 시간에 Usecase Diagram 그리기 과제 를 했다면 — 그게 *AI 에이전트 시스템의 Goal 정의 * 다.
- OOASD 시간에 Class Diagram 그리기 과제 를 했다면 — 그게 *AI 에이전트의 Role + Tool 정의 * 다.
- OOASD 시간에 Sequence Diagram 그리기 과제 를 했다면 — 그게 *AI 에이전트들의 상호작용 흐름 설계 * 다.
*이게 *일반적인 비유가 아니라 동형 사상 * * 인 이유 — *항목이 완벽히 1:1 대응 * 하기 때문이다. 단순한 비슷함 이 아니라 수학적 동치.
실전 비유 — 약국 마케팅 에이전트 (15 장 시연 사전 노출)
추상적 매핑을 구체 사례 로 본다. 다음 15 장 시연의 시스템을 UML 으로 사전 그려 본다.
| UML 항목 | 전통 OOAD 예 | 본 시스템 (약국 에이전트) 매핑 |
|---|---|---|
| Usecase | "고객이 상품을 주문한다" | "약국 방문 순서를 최적화한다" |
| Class | Order, Customer, Product | SalesAgent, ZoneManager, Tool: MapAPI |
| Sequence | 주문 → 결제 → 배송 메시지 | 데이터 수집 → 분석 → 경로 생성 → 보고 |
이 표를 4 학년이 OOASD 과제 받았을 때 그릴 그림 과 비교해 보면 — 완전히 같은 형식. 클래스 박스, 화살표, 시간 축. 단지 이름 이 다를 뿐이다.
Customer / Order / Product 같은 데이터 객체 이름 이 *SalesAgent / ZoneManager 같은 행동 주체 이름 * 으로 바뀐다. 수동적 객체 (데이터) → 능동적 에이전트 (실행) 의 변화. 그러나 그림 그리는 방식 은 같다.
이게 14 장의 CLAUDE.md 가 곧 Class Diagram 의 압축형 이라는 명제의 직관적 근거 다 (다음 장에서 자세히).
HIAO — 계층적 AI 에이전트 오케스트레이션
이 1:1 매핑 의 전체 구조 가 HIAO (Hierarchical Intelligent Agent Orchestration). 한국어로 — 계층적 AI 에이전트 오케스트레이션.
L0 Orchestrator ←→ 최상위 Class (시스템 관리자)
↓ 지시
L1 Manager ←→ 서브 Class (도메인 관리자)
↓ 파견
L2 Worker ←→ Leaf Class (실행 단위)
이 3 계층이 Class Diagram 의 상속 트리 와 똑같다. 최상위 추상 클래스 → 중간 클래스 → 구체 구현 클래스. AI 에이전트도 그대로 다 — 오케스트레이터 → 도메인 매니저 → 실행 워커.
여러분이 *Class Diagram 에서 상속 화살표 * 그려 본 적이 있다면 — *그 화살표가 AI 에이전트의 위임 (delegation) 관계 와 완전히 같은 그림 * 이다. 상속 = 위임 이라는 매핑.
이 HIAO 가 15 장 약국 마케팅 에이전트 의 작동 골격 이다. 시연을 보면 — *오케스트레이터 1 명이 3 명의 매니저 (Zone / Sales / Map) 를 부리고, 매니저가 다시 각자의 워커들을 부린다. 트리 구조. Class Diagram 의 트리 와 동일.
OOP 5 핵심 ↔ HIAO 1:1 동형
OOP 의 5 가지 핵심 개념 이 AI 에이전트 에 어떻게 매핑되는지 표로.
| OOP 개념 | HIAO 에이전트 개념 |
|---|---|
| 클래스 상속 | 에이전트 역할 위임 |
| 인터페이스 | 에이전트 계약 (Contract) / 툴 명세 |
| 메서드 호출 | 에이전트 태스크 파견 (Dispatch) |
| 캡슐화 | 에이전트 격리 — Context Rot 방지 (7 장 참조) |
| 다형성 | 동일 인터페이스 → 다른 실행 에이전트 |
이 매핑이 너무 깔끔하다. 학생이 4 년 동안 시험 본 모든 OOP 개념 이 — *AI 에이전트 설계의 기본 어휘 * 다.
특히 캡슐화 → 에이전트 격리 → Context Rot 방지 매핑이 핵심이다. 7 장에서 본 서브에이전트 주도 개발 이 정확히 *OOP 의 캡슐화 원칙의 AI 시대 버전 * 이다. 서브에이전트가 자기 컨텍스트만 가지고 일하는 것 = 클래스가 자기 인스턴스 변수만 다루는 것. *경계의 명확함이 복잡도를 통제 * 하는 같은 원리.
다형성 → 동일 인터페이스, 다른 실행 에이전트 도 강력하다. "대화 응답 에이전트" 라는 인터페이스 에 — 친절한 에이전트 / 정중한 에이전트 / 간결한 에이전트 같은 서로 다른 구현체 를 끼울 수 있다. 같은 호출, 다른 실행 — 다형성의 정의.
업계 화답 — Sanger 의 발언
이 1:1 동형 이 학술적 우연이 아니라 업계 인식의 수렴 이라는 신호. 6 장에서 만난 Aman Sanger (Cursor 공동 창업자) 의 발언이 정확히 이 자리에 기록된다.
"개발자는 코더 (coder) 에서 시스템 아키텍트 (system architect) 로 옮겨가야 한다."
*시스템 아키텍트가 그리는 그림 * 이 정확히 UML 3 대 다이어그램 이다. Sanger 가 추상적으로 한 말 의 구체적 기술적 의미 가 13 장의 1:1 매핑이다. 두 시각이 같은 결론에서 만난다.
여러분이 Cursor / Claude Code 를 잘 쓰는 사람 의 모니터를 본 적이 있다면 — 그 사람이 코드 짜기 전에 그리는 그림 이 Class Diagram 비슷한 트리 구조 다. 친구가 그 트리 구조를 그리고 있을 때 — *Sanger 의 발언이 그 친구의 모니터에 살아 있다. *
완벽한 1:1 이 아니라는 부연
학술적 정직성을 위해 한 줄 부연한다. Isomorphism (동형 사상) 이 완벽한 1:1 은 아니다. 주요 원칙의 매핑 정도로 받아들여야 한다.
차이점:
- *클래스는 수동적 데이터 + 메서드. 에이전트는 능동적 행동 + 상태. 사고 모델이 다르다.
- *Sequence Diagram 의 동기 호출 * 이 *AI 에이전트의 비동기·병렬 호출 * 과 다르다.
- *OOP 의 컴파일 시점 결정 * 이 *AI 에이전트의 런타임 적응 * 과 다르다.
그러나 *전반 구조 — Goal / Role / Orchestration — 가 그대로 옮겨진다는 것 * 이 핵심이다. 세부 차이는 시간에 따라 좁혀진다. 1980 년대 OOP 의 컴파일 시점 결정 이 1990 년대 동적 디스패치 로 옮겨갔듯이, AI 에이전트의 패러다임 도 *기존 OOP 사고의 확장 * 으로 봐야 한다.
학생 시각 — *시험 답이 재배치 * 된다
이 장의 학생 메시지를 행동 지침 으로 기록한다.
다음 OOASD 시험을 준비할 때 — 한 가지 추가하라. *Class Diagram 한 장씩 그릴 때마다 — "이 클래스를 AI 에이전트로 바꾸면 어떤 Goal / Role / Tool 이 될까" * 한 줄 메모.
이 메모가 4 년치 OOASD 과제 를 AI 시대 설계 훈련 으로 재배치 한다. 시험 답을 적은 뒤 한 줄 더 적기.
이 한 줄 훈련이 졸업 시점에 가져갈 자산 이 된다. *입사 첫 주에 *기존 시스템의 Class Diagram 을 보고 AI 에이전트로 재해석할 수 있는 능력 * — 그게 베테랑 5 년 차의 일자리 다.
13 장 정리 — 4 부의 입구
4 부 (DSL — Design Specific Language) 는 2 장. 13 장이 입구, 14 장이 결정적 자리.
13 장의 한 줄을 기록한다.
**UML 3 대 다이어그램 = AI 에이전트 설계의 언어. 지금 OOASD 시간에 배운 게 그대로 AI 시대의 어휘 * 다
여러분에게 이게 의미하는 바 — *4 년의 컴공 공부가 낭비가 아니다. 재배치된다. 적용 위치가 바뀐다. 손에 든 도구는 같다.
표어로 닫는다.
AI-Native Vibe Coding: No Design, No Code. *— No Design 의 Design 의 어휘 가 — 지금 여러분이 이미 알고 있는 UML * .
다음 14 장에서는 — *그 UML 어휘를 압축한 한 파일 형태 * 인 CLAUDE.md 를 본다. 이 책에서 가장 손에 잡히는 자리. 학생이 오늘 저녁부터 적기 시작할 수 있는 유일한 도구.
"Class Diagram 한 장이 어떻게 65 줄 마크다운으로 압축되는가? 다음 페이지에서."