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	도시별 비용 기준표, 예산 배분 공식, 절약 전략