| 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: 준비 (오케스트레이터 직접 수행)
- 사용자 입력에서 추출한다:
- 목적지: 국가/도시 (미확정 시 조건으로 추천)
- 기간: 며칠, 출발·도착일
- 인원: 혼자/커플/가족/친구 + 인원수
- 예산 (선택): 총 예산 또는 예산 수준 (절약/보통/럭셔리)
- 여행 스타일 (선택): 힐링/액티비티/문화/미식
- 특별 요청 (선택): 꼭 가고 싶은 곳, 제외 사항
_workspace/ 디렉토리를 프로젝트 루트에 생성한다
- 입력을 정리하여
_workspace/00_input.md에 저장한다
- 요청 범위에 따라 실행 모드를 결정한다
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: 통합 및 최종 산출물
_workspace/ 내 모든 파일을 확인한다
- 일정-예산-현지정보 간 일관성을 확인한다
- 최종 요약을 사용자에게 보고한다:
- 목적지 분석 —
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 | 도시별 비용 기준표, 예산 배분 공식, 절약 전략 |