요약

본 단원은 강의 전체에서 유일한 라이브 시연 단원 으로, 강사가 학생들 앞에서 직접 entity/claude-code 를 구동해 약국 마케팅 에이전트 시뮬레이션을 15 분 안에 처음부터 끝까지 만들어내는 모습을 보여준다. 시연은 4 단계로 진행된다 — 먼저 CLAUDE.md 에 약국 도메인 + 금지 사항 + 검증 기준을 박아 두고, 다음으로 Plan Mode 로 작업 계획을 먼저 세운 뒤, 여러 서브에이전트 (가격 분석 / 광고 카피 / 일정 관리 등) 를 병렬로 파견 하고, 마지막으로 각 에이전트의 산출물을 검증 루프로 통과시켜 최종 보고서를 만드는 흐름이다. 본 단원의 목적은 추상적 설명 듣기 가 아니라 학생이 직접 목격 함으로써 강의 03 HRN 단원에서 박은 4 계층 하네스가 실제로 동작한다 는 점을 행동 동기로 전환 하는 것이다.

상세

시연 시나리오

동네 약국 4 곳의 위치 / 매출 / 고객 데이터 를 받아, 방문 순서 최적화 + 마케팅 메시지 자동 생성 + 결과 보고 를 수행하는 다중 에이전트 시스템.

에이전트 구성 (HIAO 3 계층)

L0 Orchestrator (메인 에이전트)
  ↓
L1 Manager (도메인별 매니저)
  ↓ 병렬 파견
L2 Workers:
  - DataCollector  (데이터 수집)
  - RouteOptimizer (방문 순서 최적화 — MapAPI 활용)
  - MessageWriter  (마케팅 메시지 작성)
  - Reporter       (결과 보고서)

시연 4 단계

단계 1: CLAUDE.md 작성 (3분)

## Role
당신은 약국 마케팅 에이전트 오케스트레이터다.

## Constraints
- 개인정보 (전화번호·주민번호) 출력 금지
- 단정적 의료 조언 금지
- 데이터 출처 항상 명시

## Goal
4 약국의 방문 순서 최적화 + 약국별 1 페이지 보고서

## Context
- 입력: data/pharmacies.csv (위치·매출·고객 통계)
- 출력: reports/{pharmacy}/report.md
- 도구: MapAPI, 텍스트 생성

단계 2: Plan Mode 진입 (3분)

"위 명세를 Plan Mode 로 검토해 주세요. 어떤 파일을 수정할 계획이고, 어떤 도구를 사용할지 승인 요청 하세요."

→ Claude Code 가 구현 계획 생성 → 사용자 승인 → 실행 단계로.

단계 3: 서브에이전트 병렬 파견 (5분)

Task 도구로 4개 서브에이전트 동시 파견:

Task(subagent_type="data-collector", ...)
Task(subagent_type="route-optimizer", ...)
Task(subagent_type="message-writer", ...)
Task(subagent_type="reporter", ...)

→ 4 결과 병합 → 최종 보고서.

단계 4: 검증 루프 (2분)

term/stop-hook 자동 실행:

• 보고서 마크다운 형식 검증
• 개인정보 필터 통과 검증
• 4 약국 모두 보고서 생성 확인

→ 실패 시 자동 재작업.

concept/harness-prompt 3단 구조 적용

이 시연 자체가 concept/harness-prompt (Role + Context + Constraints) 의 실체.

방법론

강의 진행 시퀀스 (15분):

1. 사전 안내 (1분): 시연 4 단계 미리보기.
2. 단계 1 — CLAUDE.md (3분): 화면 공유 + 큰 폰트.
3. 단계 2 — Plan Mode (3분): 계획서 함께 읽기.
4. 단계 3 — 병렬 파견 (5분): 실시간 진행 가시화.
5. 단계 4 — 검증 (2분): 자동 실행되는 모습.
6. 마무리 (1분): "15분 만에. 알고리즘 한 줄도 직접 안 짰습니다."

주의사항

• 라이브 위험 대비: 백업 시연 영상 + 백업 파일 미리 준비.
• 인터넷 의존: MapAPI 호출 등 외부 의존 — 오프라인 mock 데이터 백업.
• 시간 압박: 15분 안에 다 보여주려면 각 단계 사전 리허설 필수.
• 개인정보 주의: 가상 약국·가상 고객 데이터 사용. 실제 데이터 절대 사용 금지.
• 알렉스 4단계 의도적 충족: 시연이 곧 목격 단계. 끝에서 "오늘 행동 단계는 여러분 차례" 명시.

표어 정합

본 단원의 15 분 시연 이 강의 표어 "AI-Native Vibe Coding: No Design, No Code" 가 동시에 작동하는 자리 다. 설계 없이는 코딩이 안된다 (Thesis) — 알고리즘 한 줄도 직접 안 짰지만 CLAUDE.md / Plan Mode / 서브에이전트 / 검증 루프 4 단계가 설계의 본체. AI 에게 어떻게 일을 시키는가 (Corollary) 가 눈으로 보인다.