Travel Planner

---
name: travel-planner
description: "여행 계획의 목적지분석부터 현지정보까지 전 과정을 에이전트 팀이 협업하여 생성하는 풀 파이프라인. '여행 계획 짜줘', '일본 여행 일정', '유럽 배낭여행', '제주도 2박3일', '해외여행 준비', '여행 예산', '숙소 추천', '여행 일정표', '현지 맛집', '여행 코스 추천' 등 여행 계획·일정·예산 관련 요청에 이 스킬을 사용한다. 기존 일정이 있으면 분석이나 개선을 지원한다. 단, 항공권·숙소 실시간 예약 대행, 비자 신청 대행, 여행사 패키지 비교는 이 스킬의 범위가 아니다."
---

# Travel Planner — 여행 계획 풀 파이프라인

목적지분석→일정→숙소→예산→현지정보를 에이전트 팀이 협업하여 한 번에 생성한다.

## 실행 모드

**에이전트 팀** — 4명이 SendMessage로 직접 통신하며 교차 검증한다.

## 에이전트 구성

| 에이전트 | 파일 | 역할 | 타입 |
|---------|------|------|------|
| destination-analyst | `.claude/agents/destination-analyst.md` | 목적지 리서치, 관광지, 안전정보 | general-purpose |
| itinerary-designer | `.claude/agents/itinerary-designer.md` | 일별 일정, 동선 최적화, 숙소 | general-purpose |
| budget-manager | `.claude/agents/budget-manager.md` | 예산 산출, 비용 비교, 절약 팁 | general-purpose |
| local-guide | `.claude/agents/local-guide.md` | 교통, 맛집, 문화, 긴급 정보 | general-purpose |

## 워크플로우

### Phase 1: 준비 (오케스트레이터 직접 수행)

1. 사용자 입력에서 추출한다:
    - **목적지**: 국가/도시 (미확정 시 조건으로 추천)
    - **기간**: 며칠, 출발·도착일
    - **인원**: 혼자/커플/가족/친구 + 인원수
    - **예산** (선택): 총 예산 또는 예산 수준 (절약/보통/럭셔리)
    - **여행 스타일** (선택): 힐링/액티비티/문화/미식
    - **특별 요청** (선택): 꼭 가고 싶은 곳, 제외 사항
2. `_workspace/` 디렉토리를 프로젝트 루트에 생성한다
3. 입력을 정리하여 `_workspace/00_input.md`에 저장한다
4. 요청 범위에 따라 **실행 모드를 결정**한다

### Phase 2: 팀 구성 및 실행

| 순서 | 작업 | 담당 | 의존 | 산출물 |
|------|------|------|------|--------|
| 1 | 목적지 분석 | analyst | 없음 | `_workspace/01_destination_analysis.md` |
| 2 | 일정 설계 + 숙소 | designer | 작업 1 | `_workspace/02_itinerary.md`, `_workspace/03_accommodation.md` |
| 3a | 예산 계획 | budget | 작업 1, 2 | `_workspace/04_budget.md` |
| 3b | 현지 정보 | guide | 작업 1, 2 | `_workspace/05_local_guide.md` |

작업 3a(예산)와 3b(현지정보)는 **병렬 실행**한다.

**팀원 간 소통 흐름:**
- analyst 완료 → designer에게 관광지·소요시간·운영시간 전달, budget에게 물가·환율 전달, guide에게 문화·안전 정보 전달
- designer 완료 → budget에게 일별 비용·숙소 예산 전달, guide에게 일별 방문 지역·이동 구간 전달
- budget 완료 → guide에게 결제 수단 정보 전달
- guide 완료 → 일정과 맞지 않는 정보 발견 시 designer에게 조정 요청

### Phase 3: 통합 및 최종 산출물

1. `_workspace/` 내 모든 파일을 확인한다
2. 일정-예산-현지정보 간 일관성을 확인한다
3. 최종 요약을 사용자에게 보고한다:
    - 목적지 분석 — `01_destination_analysis.md`
    - 일정표 — `02_itinerary.md`
    - 숙소 가이드 — `03_accommodation.md`
    - 예산 계획 — `04_budget.md`
    - 현지 가이드 — `05_local_guide.md`

## 작업 규모별 모드

| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |
|----------------|----------|-------------|
| "여행 전체 계획 짜줘" | **풀 파이프라인** | 4명 전원 |
| "일본 어디가 좋을까" | **목적지 추천 모드** | analyst 단독 |
| "파리 3박4일 일정만" | **일정 모드** | analyst + designer |
| "여행 예산만 계산해줘" | **예산 모드** | budget 단독 |
| "현지에서 필요한 정보" | **가이드 모드** | guide 단독 |
| "이 일정 개선해줘" (기존 파일) | **분석 모드** | designer + budget |

**기존 파일 활용**: 사용자가 기존 일정을 제공하면, `_workspace/02_itinerary.md`로 복사하고 designer를 건너뛴다.

## 데이터 전달 프로토콜

| 전략 | 방식 | 용도 |
|------|------|------|
| 파일 기반 | `_workspace/` 디렉토리 | 주요 산출물 저장 및 공유 |
| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |

파일명 컨벤션: `{순번}_{에이전트}_{산출물}.{확장자}`

## 에러 핸들링

| 에러 유형 | 전략 |
|----------|------|
| 웹 검색 실패 | 일반 지식 기반 작업, "최신 정보 확인 필요" 명시 |
| 목적지 미확정 | 사용자 조건 기반 3곳 비교 추천 |
| 예산 초과 | 절약형 대안 제시 + 우선순위 조정 |
| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 보고서에 누락 명시 |
| 일정-정보 불일치 | designer에게 조정 요청 (최대 2회) |

## 테스트 시나리오

### 정상 흐름
**프롬프트**: "커플 여행으로 도쿄 4박5일 여행 계획 짜줘. 예산 200만원, 미식 여행 위주로"
**기대 결과**:
- 목적지 분석: 도쿄 관광지, 미식 명소, 입국 요건, 최적 방문 시기
- 일정: 5일 일정, 미식 중심 동선, 츠키지/시부야/신주쿠 등 지역별 구성
- 숙소: 동선 중심부 숙소 3곳 추천 + 예약 팁
- 예산: 200만원 내 배분 (항공/숙소/식비/교통), 절약·보통·럭셔리 비교
- 현지 가이드: 교통(Suica), 맛집 리스트, 일본어 기본 표현, 긴급 연락처

### 기존 파일 활용 흐름
**프롬프트**: "이 일정 예산 맞는지 확인하고 현지 정보 추가해줘" + 일정 파일 첨부
**기대 결과**:
- 기존 일정을 `_workspace/02_itinerary.md`로 복사
- budget + guide 투입: 예산 산출 + 현지 정보 생성

### 에러 흐름
**프롬프트**: "동남아 어디가 좋을까, 예산 100만원 이내, 혼자 3박4일"
**기대 결과**:
- 목적지 미확정 → analyst가 조건 기반 3곳 비교 (베트남/태국/필리핀 등)
- 각 목적지별 예상 비용·장단점 비교표 제공
- 사용자 선택 후 풀 파이프라인 진행 (또는 최추천 목적지로 자동 진행)

## 에이전트별 확장 스킬

| 에이전트 | 확장 스킬 | 용도 |
|---------|----------|------|
| itinerary-designer | `route-optimizer` | 동선 최적화, 교통수단 비교, 시간 블록 배분 |
| budget-manager | `budget-calculator` | 도시별 비용 기준표, 예산 배분 공식, 절약 전략 |