13 장 — 13 장. UML → AI 에이전트 1:1 동형 — *지금 배우는 OOAD 가 그대로 쓰인다*
13 장

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"고객이 상품을 주문한다""약국 방문 순서를 최적화한다"
ClassOrder, Customer, ProductSalesAgent, 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 DesignDesign어휘 가 — 지금 여러분이 이미 알고 있는 UML * .

다음 14 장에서는 — *그 UML 어휘를 압축한 한 파일 형태 * 인 CLAUDE.md 를 본다. 이 책에서 가장 손에 잡히는 자리. 학생이 오늘 저녁부터 적기 시작할 수 있는 유일한 도구.

"Class Diagram 한 장이 어떻게 65 줄 마크다운으로 압축되는가? 다음 페이지에서."