Travel Itinerary Planner

Create end-to-end travel plans from minimal user input and output a polished, image-ready itinerary in Markdown.

Quick Start

1. Collect minimum inputs: destination, start date, end date.
2. Collect high-impact optional inputs: origin city, travelers, budget level, pace, interests, hard constraints.
3. Generate a base draft:

python scripts/build_trip_plan.py \
  --destination "Kyoto, Japan" \
  --start-date 2026-04-03 \
  --end-date 2026-04-08 \
  --origin "Shanghai, China" \
  --travelers 2 \
  --budget-level standard \
  --pace balanced \
  --focus "food,history,photo spots" \
  --cover-image "<trusted-https-cover-image-url>" \
  --image-url "<trusted-https-image-url-1>" \
  --image-url "<trusted-https-image-url-2>"

4. Enrich the draft with current facts and concrete bookings.

Workflow

1) Confirm Inputs

Collect at least:

• Destination
• Absolute start/end dates (YYYY-MM-DD)

Collect when available:

• Origin city and preferred transportation
• Number of travelers and trip style (solo/couple/family/friends)
• Budget level (economy|standard|premium) and currency
• Pace (relaxed|balanced|intense)
• Interests (food,museum,nature,shopping,...)
• Constraints (mobility, dietary, child-friendly, no driving, etc.)

If user gives relative time (for example "next Friday"), convert to exact calendar dates before planning.

2) Verify Time-Sensitive Facts

Do not rely on stale assumptions for travel. Verify:

• Weather forecast and seasonal conditions
• Attraction opening hours / closure dates
• Train/flight/ferry schedules and transfer durations
• Visa/entry policy and passport validity notes (if cross-border)
• Major local events that impact crowds, ticketing, or hotel prices

Use primary sources first (official attractions, airlines/rail operators, tourism boards).
Use references/research-checklist.md as a pre-flight checklist.

3) Build Base Itinerary

Run scripts/build_trip_plan.py to generate a structured draft with:

• Trip summary
• Day-by-day plan blocks
• Budget estimate table
• Logistics and booking checklist
• Risk and fallback section
• Image slots and gallery section

4) Make It Image-Rich

Include visual content directly in Markdown:

• Cover image at top
• 1-2 images for each major destination area/day cluster
• Caption each image with what it represents and why it is relevant

Use absolute local paths for local files, or HTTPS URLs for web images.

5) Final QA Before Sending

Check:

• Daily pace is feasible (travel time between activities is realistic)
• Any reservation-required activities are explicitly labeled
• Budget numbers match trip length and traveler count
• Uncertain facts are tagged for re-check instead of presented as certain

Use references/output-spec.md as the final acceptance rubric.

Safety Guardrails