Claude Code 완전 가이드 · 2 min read
오케스트레이션
Command → Agent → Skill 패턴으로 복잡한 워크플로우를 구성하는 핵심 아키텍처입니다.
전체 플로우 다이어그램
+======================================================+
| ORCHESTRATION WORKFLOW |
| Command -> Agent -> Skill |
+======================================================+
+-------------------+
| 사용자 입력 |
+---------+---------+
|
v
+----------------------------------------------+
| /weather-orchestrator -- Command (진입점) |
+----------------------+------- ---------------+
|
Step 1: 사용자에게 C/F 질문
|
v
+-------------------------+
| AskUser -- 섭씨? 화씨? |
+------------+------------+
|
Step 2: Agent 도구 호출
|
v
+----------------------------------------------+
| weather-agent -- Agent |
| * skill: weather-fetcher (프리로드) |
| * Open-Meteo API -> 온도 데이터 반환 |
+----------------------+-----------------------+
|
Returns: temp + unit
|
Step 3: Skill 도구 호출
|
v
+----------------------------------------------+
| weather-svg-creator -- Skill |
| * SVG 카드 생성 + output.md 작성 |
+----------------------+-----------------------+
|
+-------+-------+
| |
v v
+------------+ +------------+
|weather.svg | | output.md |
+------------+ +------------+
컴포넌트별 역할
| 컴포넌트 | 역할 | 파일 위치 |
|---|---|---|
| Command | 진입점, 사용자 상호작용, 워크플로우 조율 | .claude/commands/weather-orchestrator.md |
| Agent | 프리로드 스킬로 데이터 수집 | .claude/agents/weather-agent.md |
| Skill (프리로드) | API 호출 지침 (에이전트 지식) | .claude/skills/weather-fetcher/SKILL.md |
| Skill (직접 호출) | SVG 렌더링, 파일 출력 | .claude/skills/weather-svg-creator/SKILL.md |
핵심 설계 원칙
- 두 가지 스킬 패턴 — 프리로드(Agent Skill)와 직접 호출(Skill)을 모두 활용
- Command가 오케스트레이터 — 사용자 상호작용과 워크플로우 조율 담당
- Agent는 데이터 수집 — 프리로드 스킬을 활용한 전문 작업
- Skill은 출력 생성 — 독립적으로 데이터를 받아 결과물 생성
- 단일 책임 — 수집(Agent) -> 렌더링(Skill) 분리