AI-Native Vibe Coding: No Design, No Code

"15 분 만에. 알고리즘 한 줄도 직접 안 짰습니다." — 강의 시연 마무리 멘트

도입 — 추상이 손에 잡히는* 자리*

이 책 1 ~ 14 장이 원리 였다면, 15 장은 그 원리들이 한 자리에서 동시에 작동하는 시연 이다. 5 부 (DEM — Demonstration) 는 한 장뿐이다. 그러나 *이 한 장이 14 장의 모든 추상을 살아 움직이게 * 만든다.

알렉스의 4 단계 모델 (3 장) 의 2 단계 (목격) 가 정확히 이 자리에 채워진다. 직접 눈으로 보는 것 — 이게 강의의 심리적 분기점. 이 시연을 눈으로 보지 않으면 — 1 ~ 14 장의 모든 메시지가 추상에 머문다. 이 시연을 보면 — 그 다음부터는 직접 시도하지 않을 수 없게 된다.

핵심 명제 미리.

약국 4 곳의 위치 / 매출 / 고객 데이터 를 받아 → 방문 순서 최적화 + 마케팅 메시지 + 결과 보고서 → 15 분에 끝낸다. 알고리즘 직접 짜지 않는다.

이 15 분 의 비밀이 무엇인지 — 4 단계로 풀어 본다.

시연 시나리오 — 비즈니스 문제 한 줄

먼저 문제 부터 명확히.

동네 약국 4 곳의 위치 / 매출 / 고객 통계 를 받아, 방문 순서를 최적화 + 각 약국별 마케팅 메시지를 자동 생성 + 결과를 1 페이지 보고서로 정리 하는 시스템.*

이 문제를 *전통 방식으로 풀면 1 주일 * 걸린다.

데이터 파싱 — 1 일
경로 최적화 알고리즘 (TSP 변형) — 2 일
메시지 템플릿 + 데이터 결합 — 1 일
보고서 포맷 + PDF 출력 — 1 일
통합 + 디버깅 — 2 일

이 5 일짜리 작업 을 — 15 분에 끝낸다. AI 가 똑똑해서 가 아니다 (12 장 메시지 회수). 하네스 + CLAUDE.md + 서브에이전트 병렬 파견 의 결합 효과 다.

에이전트 구성 — HIAO 3 계층

13 장에서 본 HIAO (계층적 AI 에이전트 오케스트레이션) 가 실제 시스템의 모양 으로 등장한다.

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

L0 가 1 명, L1 이 1 명, L2 가 4 명 — 정확히 HIAO 1-1-4 구조. 이게 Class Diagram 으로 그리면 상속 트리 3 계층 * 과 동일. 13 장의 매핑 표가 이 자리에서 살아 움직인다.

각 워커의 역할이 명확히 분리 되어 있다. DataCollector 는 데이터만 만든다. RouteOptimizer 는 경로만 푼다. 각자의 컨텍스트가 서로 오염되지 않는다*. 이게 9 장에서 본 서브에이전트 주도 개발 의 Context Rot 차단 효과.

시연 4 단계 — 각 단계의 시간 배분

15 분을 4 단계로 나눈다.

단계 1 — CLAUDE.md 작성        (3 분)
단계 2 — Plan Mode 진입         (3 분)
단계 3 — 서브에이전트 병렬 파견  (5 분)
단계 4 — 검증 루프              (2 분)
─────────────────────────────────
                             합계 13 분
                  사전 안내 + 마무리   2 분
                             총합 15 분

각 단계를 *책에서 어떤 장의 어떤 도구가 작동하는지 * 와 함께 본다.

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

14 장의 도구 가 첫 등장. 시연자가 큰 폰트 로 화면에 띄우고 *3 분 동안 직접 적는다.

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

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

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

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

이 15 줄짜리 CLAUDE.md 가 14 장의 4 요소 (Role / Constraints / Goal / Context) 와 완벽히 매핑. 14 장 65 줄 권고 보다 훨씬 짧다 — 시연용으로 최소 만 박았다.

특히 Constraints 의 3 줄 을 주목하라. 개인정보 금지 / 의료 조언 금지 / 출처 명시 — Don't 가 본체 다. 14 장의 75 / 25 황금 비율 이 정확히 기록되어 있다. 하지 말아야 할 것 3 줄 + 해야 할 것 (Goal · Context) 4 ~ 5 줄.

이 단계가 시연 전체의 방향 을 결정 한다. 3 분의 투자 가 *나머지 12 분의 모든 결과 * 를 좌우한다. *이게 *7 장의 20 분 / 2 시간 ROI * 의 시연 사례.

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

*8 장의 계획 vs 구현 분리 * 가 Plan Mode 라는 이름으로 등장한다.

시연자의 명령:

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

Claude Code 가 코드를 즉시 짜지 않는다. 대신 계획서 를 만든다. 예시:

## 계획
1. data/pharmacies.csv 읽기 → DataCollector 호출
2. 4 약국 좌표 → MapAPI 호출 → RouteOptimizer 실행
3. 약국별 데이터 + 경로 → MessageWriter 호출 (4 회 병렬)
4. 4 메시지 + 경로 → Reporter 호출 → 1 페이지 보고서 생성

## 사용 도구
- 파일 시스템 (읽기·쓰기)
- MapAPI (외부 호출)
- Task 도구 (서브에이전트 파견)

## 승인 요청
이 계획대로 진행해도 되겠습니까?

여기서 시연자가 함께 읽으며 청중에게 보여준다. *"여기 보세요. AI 가 어떻게 일을 분해할지 를 코드 짜기 전에 사람에게 물어보고 있습니다". 청중은 처음으로 AI 와 대화 가 일어나는 모습 을 본다.

이게 *8 장의 저장소 영향 지도 * 의 시연 사례. *3 줄짜리 계획에서 잘못된 참조 즉시 발견 * 의 비용 절감 메커니즘. *잘못된 계획을 받으면 여기서 수정 * 하면 된다 — 코드 만들기 전에.

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

이 단계가 *시연의 극적인 자리 * 다. *9 장의 서브에이전트 주도 개발 + 병렬 실행 * 이 눈으로 보인다.

명령:

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

4 개 서브에이전트가 동시에 실행된다. 화면에는 4 개의 진행 막대가 각각 따로 움직인다*. 청중에게는 시각적으로 충격적 이다 — AI 가 4 명 으로 동시 에 일하고 있다.

이 병렬 의 효과가 5 일 → 5 분 의 시간 압축 이다. 순차로 하면 5 일. 병렬로 하면 1 일. AI 4 마리 동시 사용으로 또 1/4 = 6 시간. 그런데 시연은 5 분. 어떻게?

답은 — *각 서브에이전트의 컨텍스트가 깨끗 * 하기 때문이다. 이전 작업의 잘못된 가정이 묻지 않는다. 처음부터 정확하게 작업한다. 재작업 / 디버깅이 거의 없다. 그래서 시간이 기대보다 훨씬 짧게 끝난다.

이게 *7 장의 Crossbeam 2 일 * 비밀의 직접 시연. 오케스트레이션 + 병렬화 + 깨끗한 컨텍스트 의 결합 효과. 시간 압축이 우연이 아니라 시스템적 설계의 결과 라는 것을 눈으로 본다.

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

마지막 2 분. *10 장의 검증 루프 * + *9 장의 Stop Hook * 이 작동.

[Stop Hook 자동 실행]
1. 보고서 마크다운 형식 검증     ✓ pass
2. 개인정보 필터 통과 검증       ✓ pass
3. 4 약국 모두 보고서 생성 확인  ✓ pass
4. 마크다운 lint 통과            ✓ pass

✅ 모든 검증 통과 — 작업 완료

이 자동 검증이 *시연의 마지막 충격 * 이다. AI 가 "끝났다" 라고 선언하지 않는다. *시스템이 AI 의 결과를 자동으로 검증 * 한 뒤에 진짜 끝났다는 신호 를 준다.

만약 검증이 실패한다면 — 어떻게 되는가? AI 가 자동으로 재작업 모드 로 들어간다. *사람이 다시 명령할 필요 없이 * 시스템이 자체 교정. 이게 *Boris Cherny 의 "AI 가 스스로 검증하게 만드는 사람" * 의 시연 사례.

마무리 — 15 분의 의미

시연의 마지막 멘트.

"15 분 만에. 알고리즘 한 줄도 직접 안 짰습니다. 그런데 4 약국의 보고서 가 모두 생성 됐습니다."

이 한 마디가 6 장 코더 → 아키텍트 의 시연 사례 다. *시연자는 알고리즘 직접 안 짰다. 대신 CLAUDE.md 를 적었고, Plan Mode 로 검토했고, 서브에이전트를 파견했고, 검증을 확인 했다. *그게 아키텍트의 일 * 이다.

코드는 AI 가 썼다 (1·6 장 명제 회수). 설계는 시연자가 했다. 이 분리가 15 분 의 비밀.

학생 시각 — 목격 단계가 채워진다

알렉스의 4 단계 모델 (3 장) 을 다시 본다.

단계	강의·책의 어디서 채워지는가
1. 믿음	1·2 장 (거인들의 증언)
2. 목격	15 장 (이 시연)
3. 활용	8 ~ 14 장 (도구·원리)
4. 행동	16 장 (5 종 체크리스트) + 졸업 후

15 장이 2 단계 (목격) 의 자리. 직접 눈으로 본 사람만이 3·4 단계로 넘어간다*. 이 시연을 보지 않은 사람은 — 모든 게 추상 으로 남는다.

이 책의 독자에게 권고:

이 책 14 장까지 읽고 YouTube / GitHub / 공식 데모 에서 이런 시연 영상을 반드시 한 번 본다.

obra/superpowers 의 공식 데모 영상 또는 Anthropic Claude Code 공식 데모 — 어느 것이든 한 번 본다. 눈으로 본 다음 16 장으로 가야 한다.

5 부의 한 줄 — 모든 도구가 한 자리에 모인다

단계	책의 어느 도구가 작동하는가
1. CLAUDE.md 작성	14 장
2. Plan Mode	8 장 (계획 vs 구현 분리)
3. 서브에이전트 병렬	9 장 (Superpowers / 서브에이전트 / 병렬화)
4. 검증 루프 (Stop Hook)	10 장 (검증 루프) / 9 장 (Stop Hook)
전체 (HIAO 3 계층)	13 장 (UML → 에이전트)

5 부 한 장 (15 장) 이 *4 부 + 3 부 + 일부 2 부의 도구를 동시에 사용 * 한다. 이게 *시연이 책의 클라이맥스 * 인 이유.

표어로 닫는다.

AI-Native Vibe Coding: No Design, No Code. — No Design 의 함정에서 Design 의 정합 으로. 15 분의 시연이 모든 추상이 손에 잡히는 자리 로 옮겨 준다.

다음 6 부 (CLN — Conclusion) 에서 — *이 시연을 보고 내일 아침부터 무엇을 시작할지 * 를 5 종 체크리스트 로 기록한다. 이 책의 행동 단계 (4 단계) 가 시작되는 자리.

"눈으로 봤다. 이제 손 으로 옮길 차례다."

"15 분 만에. 알고리즘 한 줄도 직접 안 짰습니다." — 강의 시연 마무리 멘트

도입 — 추상이 손에 잡히는* 자리*

핵심 명제 미리.

약국 4 곳의 위치 / 매출 / 고객 데이터 를 받아 → 방문 순서 최적화 + 마케팅 메시지 + 결과 보고서 → 15 분에 끝낸다. 알고리즘 직접 짜지 않는다.

이 15 분 의 비밀이 무엇인지 — 4 단계로 풀어 본다.

시연 시나리오 — 비즈니스 문제 한 줄

먼저 문제 부터 명확히.

동네 약국 4 곳의 위치 / 매출 / 고객 통계 를 받아, 방문 순서를 최적화 + 각 약국별 마케팅 메시지를 자동 생성 + 결과를 1 페이지 보고서로 정리 하는 시스템.*

이 문제를 *전통 방식으로 풀면 1 주일 * 걸린다.

데이터 파싱 — 1 일
경로 최적화 알고리즘 (TSP 변형) — 2 일
메시지 템플릿 + 데이터 결합 — 1 일
보고서 포맷 + PDF 출력 — 1 일
통합 + 디버깅 — 2 일

에이전트 구성 — HIAO 3 계층

13 장에서 본 HIAO (계층적 AI 에이전트 오케스트레이션) 가 실제 시스템의 모양 으로 등장한다.

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

시연 4 단계 — 각 단계의 시간 배분

15 분을 4 단계로 나눈다.

단계 1 — CLAUDE.md 작성        (3 분)
단계 2 — Plan Mode 진입         (3 분)
단계 3 — 서브에이전트 병렬 파견  (5 분)
단계 4 — 검증 루프              (2 분)
─────────────────────────────────
                             합계 13 분
                  사전 안내 + 마무리   2 분
                             총합 15 분

각 단계를 *책에서 어떤 장의 어떤 도구가 작동하는지 * 와 함께 본다.

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

14 장의 도구 가 첫 등장. 시연자가 큰 폰트 로 화면에 띄우고 *3 분 동안 직접 적는다.

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

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

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

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

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

*8 장의 계획 vs 구현 분리 * 가 Plan Mode 라는 이름으로 등장한다.

시연자의 명령:

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

Claude Code 가 코드를 즉시 짜지 않는다. 대신 계획서 를 만든다. 예시:

## 계획
1. data/pharmacies.csv 읽기 → DataCollector 호출
2. 4 약국 좌표 → MapAPI 호출 → RouteOptimizer 실행
3. 약국별 데이터 + 경로 → MessageWriter 호출 (4 회 병렬)
4. 4 메시지 + 경로 → Reporter 호출 → 1 페이지 보고서 생성

## 사용 도구
- 파일 시스템 (읽기·쓰기)
- MapAPI (외부 호출)
- Task 도구 (서브에이전트 파견)

## 승인 요청
이 계획대로 진행해도 되겠습니까?

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

이 단계가 *시연의 극적인 자리 * 다. *9 장의 서브에이전트 주도 개발 + 병렬 실행 * 이 눈으로 보인다.

명령:

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

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

마지막 2 분. *10 장의 검증 루프 * + *9 장의 Stop Hook * 이 작동.

[Stop Hook 자동 실행]
1. 보고서 마크다운 형식 검증     ✓ pass
2. 개인정보 필터 통과 검증       ✓ pass
3. 4 약국 모두 보고서 생성 확인  ✓ pass
4. 마크다운 lint 통과            ✓ pass

✅ 모든 검증 통과 — 작업 완료

마무리 — 15 분의 의미

시연의 마지막 멘트.

"15 분 만에. 알고리즘 한 줄도 직접 안 짰습니다. 그런데 4 약국의 보고서 가 모두 생성 됐습니다."

코드는 AI 가 썼다 (1·6 장 명제 회수). 설계는 시연자가 했다. 이 분리가 15 분 의 비밀.

학생 시각 — 목격 단계가 채워진다

알렉스의 4 단계 모델 (3 장) 을 다시 본다.

단계	강의·책의 어디서 채워지는가
1. 믿음	1·2 장 (거인들의 증언)
2. 목격	15 장 (이 시연)
3. 활용	8 ~ 14 장 (도구·원리)
4. 행동	16 장 (5 종 체크리스트) + 졸업 후

15 장이 2 단계 (목격) 의 자리. 직접 눈으로 본 사람만이 3·4 단계로 넘어간다*. 이 시연을 보지 않은 사람은 — 모든 게 추상 으로 남는다.

이 책의 독자에게 권고:

이 책 14 장까지 읽고 YouTube / GitHub / 공식 데모 에서 이런 시연 영상을 반드시 한 번 본다.

obra/superpowers 의 공식 데모 영상 또는 Anthropic Claude Code 공식 데모 — 어느 것이든 한 번 본다. 눈으로 본 다음 16 장으로 가야 한다.

5 부의 한 줄 — 모든 도구가 한 자리에 모인다

단계	책의 어느 도구가 작동하는가
1. CLAUDE.md 작성	14 장
2. Plan Mode	8 장 (계획 vs 구현 분리)
3. 서브에이전트 병렬	9 장 (Superpowers / 서브에이전트 / 병렬화)
4. 검증 루프 (Stop Hook)	10 장 (검증 루프) / 9 장 (Stop Hook)
전체 (HIAO 3 계층)	13 장 (UML → 에이전트)

5 부 한 장 (15 장) 이 *4 부 + 3 부 + 일부 2 부의 도구를 동시에 사용 * 한다. 이게 *시연이 책의 클라이맥스 * 인 이유.

표어로 닫는다.

AI-Native Vibe Coding: No Design, No Code. — No Design 의 함정에서 Design 의 정합 으로. 15 분의 시연이 모든 추상이 손에 잡히는 자리 로 옮겨 준다.

"눈으로 봤다. 이제 손 으로 옮길 차례다."

15 장. 약국 마케팅 에이전트 — 위키 한 카드를 15 분 만에 시스템으로

도입 — 추상이 손에 잡히는* 자리*

시연 시나리오 — 비즈니스 문제 한 줄

에이전트 구성 — HIAO 3 계층

시연 4 단계 — 각 단계의 시간 배분

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

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

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

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

마무리 — 15 분의 의미

학생 시각 — 목격 단계가 채워진다

5 부의 한 줄 — 모든 도구가 한 자리에 모인다

15 장. 약국 마케팅 에이전트 — 위키 한 카드를 15 분 만에 시스템으로

도입 — 추상이 손에 잡히는* 자리*

시연 시나리오 — 비즈니스 문제 한 줄

에이전트 구성 — HIAO 3 계층

시연 4 단계 — 각 단계의 시간 배분

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

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

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

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

마무리 — 15 분의 의미

학생 시각 — 목격 단계가 채워진다

5 부의 한 줄 — 모든 도구가 한 자리에 모인다

도입 — 추상이 손에 잡히는 자리

시연 시나리오 — 비즈니스 문제 한 줄

에이전트 구성 — HIAO 3 계층

시연 4 단계 — 각 단계의 시간 배분

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

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

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

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

마무리 — 15 분의 의미

학생 시각 — 목격 단계가 채워진다

5 부의 한 줄 — 모든 도구가 한 자리에 모인다

도입 — 추상이 손에 잡히는 자리

시연 시나리오 — 비즈니스 문제 한 줄

에이전트 구성 — HIAO 3 계층

시연 4 단계 — 각 단계의 시간 배분

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

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

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

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

마무리 — 15 분의 의미

학생 시각 — 목격 단계가 채워진다

5 부의 한 줄 — 모든 도구가 한 자리에 모인다

도입 — 추상이 손에 잡히는* 자리*

도입 — 추상이 손에 잡히는* 자리*