오케스트레이션 5패턴 랩 — 시장 스냅샷 진화

왜 이 실습인가

오케스트레이션 개념(순차·병렬·분기·반복·오케스트레이터)은 설명만 들으면 전부 추상적입니다. Part 2의 익숙한 market-snapshot-card를 5단계로 진화시키며 같은 문제가 점점 더 튼튼해지는 과정을 직접 체감합니다.

학습 목표 (커리큘럼 대응)

커리큘럼 개념	이 랩의 Step
에이전트 루프	Step 4 (실패 재시도)
순차 흐름	Step 1 (baseline)
병렬 흐름	Step 2
분기 흐름	Step 3
오케스트레이터 역할	Step 5
컨텍스트 관리	Step 3·5 공통
출력 형식 약속	전 단계 공통
반복 개선 루프	Step 4

5단계 진화

flowchart TD
  S1["Step 1: 순차 baseline
  환율 → ETF → 카드"] --> S2["Step 2: 병렬 수집
  환율·ETF 동시 호출"]
  S2 --> S3["Step 3: 분기
  급변동 감지시 뉴스 추가"]
  S3 --> S4["Step 4: 실패 재시도
  에이전트 루프"]
  S4 --> S5["Step 5: 오케스트레이터
  상위 에이전트가 지휘"]

Step 1 — 순차 baseline (5분)

환율 → ETF → 카드 포맷을 한 줄로 이어 실행. 가장 단순한 순차 흐름. 어떤 문제가 있을까? 두 호출이 직렬이라 느리고, 한 곳이 실패하면 전체가 실패.

Step 2 — 병렬 흐름 (10분)

exchange-rate 와 etf-naver 호출을 동시에 시작. 카드 포맷은 둘 다 도착한 뒤 생성. 체감 속도 차이를 실제로 측정합니다.

• 핵심 질문: 무엇을 병렬로 할 수 있는가? (서로 의존이 없을 때)
• 금지: 서로의 결과를 기다려야 하는 건 병렬 불가

Step 3 — 분기 흐름 + 컨텍스트 관리 (10분)

환율 전일 대비 변동폭이 1% 이상 이면 web-reader로 관련 뉴스 3건을 추가 수집, 아니면 생략.

flowchart LR
  A[환율·ETF 병렬 수집] --> B{변동폭 ≥ 1%?}
  B -->|예| C[web-reader 로 뉴스 3건 추가]
  B -->|아니오| D[기본 카드]
  C --> D[카드 포맷]

• 컨텍스트 관리: 뉴스를 매번 가져오면 토큰 낭비 — 분기로 필요할 때만 주입
• 출력 형식 약속: 뉴스 섹션은 있을 때만 추가되며, 없을 때의 카드 레이아웃도 깨지지 않아야 함

Step 4 — 실패 재시도 루프 (10분)

etf-naver 호출이 5xx 응답이면 2회 재시도, 그래도 실패면 해당 섹션만 공란 + 실패 표시. 전체 카드는 계속 생성.

flowchart LR
  C[etf-naver 호출] --> X{성공?}
  X -->|예| K[정상 섹션]
  X -->|아니오, 2회 미만| C
  X -->|2회 실패| E[공란 + '조회 실패' 마크]

• 에이전트 루프의 본질: 목표가 달성될 때까지 "도구 호출을 자동 반복"
• 단순 반복이 아닌 종료 조건 + 예외 처리가 함께 있어야 루프

Step 5 — 오케스트레이터 역할 (10분)

지금까지는 스킬 안에서 순서를 정했습니다. Step 5에서는 상위 에이전트가 여러 스킬을 지휘하도록 책임을 위로 올립니다:

flowchart TD
  O[오케스트레이터 에이전트] --> S1[snapshot 스킬]
  O --> S2[news-shelf 스킬]
  O --> S3[brief-writer 스킬]
  S1 --> O
  S2 --> O
  S3 --> O
  O --> F[최종 통합 보고서]

• 오케스트레이터는 "무엇을" 할지 결정, 스킬들은 "어떻게" 할지 수행
• 역할 분리가 생기면 스킬들은 다른 맥락에서도 재사용 가능
• Track B 일일 브리핑, Track D 세법 체인이 이 구조의 확장판

토론 포인트

• 내 업무에서 오케스트레이터로 올려야 할 판단은 무엇인가? ("데이터 수집 후 언제 사람을 부르나" 등)
• 병렬·분기·재시도 중 우리 조직에 가장 부족한 패턴은?

변경 이력

• v1 (2026-04-11): 최초 작성 — Claude@IGM Cohort 1 Part 4 교보재용