Assume first. Show your work. Book the flight.

references/branding.md

1. Logo
2. Origin quote
3. Workflow diagram
4. Key concepts

• Yes → Skip straight to Step 2 with their input
• No → Display:

Where are you headed? Just describe your trip naturally:

"I need to fly to Tokyo next month for a week"
"London to Paris, March 15-18, 2 adults"
"Cheapest flights to Barcelona in April"

• Origin: LHR
• Class: Economy
• Passengers: 1 adult
• Budget: Flexible
• Stops: Any
• Currency: GBP

undefined

Nice — that's your first search done.

Want to save your preferences so next time is faster? Quick 5 questions:

1. What's your home airport? (e.g. LHR, JFK, LAX)

2. Any preferred airlines? (comma-separated, or "none")

3. Default budget range per person? (e.g. "under 500", "flexible", "100-300")

4. Preferred class? (economy / premium economy / business / first)

5. Preferred booking platform? (skyscanner / google-flights / kayak)

• home_airport: "LHR"
• preferred_airlines: []
• budget: "flexible"
• class: "economy"
• platform: "skyscanner"

.claude/trip-planner.md

Saved to .claude/trip-planner.md

Run /trip-planner anytime — just describe where you want to go.

1. Parse intent from natural language
2. Load config for defaults
3. Run Assumption Engine (fill all gaps)
4. Search for flights
5. Present recommendations with booking links

• Destination(s) — city names, airport codes, or countries
• Dates — explicit dates, relative dates ("next month"), or vague ("in April")
• Budget — explicit amounts or qualifiers ("cheap", "under 300")
• Class — economy, premium economy, business, first
• Passengers — number and type (adults, children, infants)
• Preferences — direct flights, specific airlines, time of day, layover preferences
• Multi-city — detect "A → B → C → A" or "then" patterns

.claude/trip-planner.md

references/config-guide.md

• name: ""
• home_airport: "LHR"
• class: "economy"
• budget: "flexible"
• currency: "GBP"
• stops: "any"
• preferred_airlines: []
• platform: "skyscanner"

1. Explicit user input — what they said in this message
2. Config file defaults — from

   .claude/trip-planner.md

3. Contextual inference — smart guesses based on trip type:
   • City break (European short-haul) → 3-4 days
   • Intercontinental → 7-10 days
   • Weekend trip → Friday-Sunday
   • "Holiday" / "vacation" → 7 days
   • Month mentioned but no dates → middle of month, flexible
4. Smart defaults — final fallback:
   • 1 adult
   • Economy
   • Flexible budget
   • Any stops
   • Home airport from config (or LHR)
   • Dates: 4 weeks from today, 7 days duration

date

undefined

assets/templates/trip-recommendation.md

• Best Value — best balance of price, duration, and convenience
• Cheapest — lowest price regardless of convenience
• Fastest — shortest total travel time

Want to adjust anything? I can re-search with different dates, budget, or preferences.

• Map to primary airport code(s)
• For cities with multiple airports, include all (e.g. London → LHR/LGW/STN, Tokyo → NRT/HND, New York → JFK/EWR/LGA)
• For countries or regions, map to capital or most common tourist airport

• Always use

  date

  command for current date
• "Next month" → 1st of next month + duration
• "In March" → March 15 (mid-month) + duration, flag as flexible
• "March 15" → exact date + duration
• "March 15-18" → exact range
• "Next weekend" → upcoming Friday-Sunday
• No dates at all → 4 weeks from today + duration based on trip type

https://www.skyscanner.net/transport/flights/{origin}/{dest}/{depart_date}/{return_date}/?adults={n}&cabinclass={class}&currency={currency}

• Dates:

  YYMMDD

  (e.g.

  260315

  for March 15, 2026)
• Origin/dest: airport codes lowercase (e.g.

  lhr

  ,

  nrt

  )
• Cabin class:

  economy

  ,

  premiumeconomy

  ,

  business

  ,

  first

https://www.google.com/travel/flights?q=flights+from+{origin}+to+{dest}+on+{date}

• "flights {origin} to {dest} {month} {year} price"

• "cheap flights {origin} to {dest} {month} {year}"

• "{airline} {origin} {dest} {month} {year} fare"

  (if preferred airline set)

• Airlines operating the route
• Approximate price ranges
• Flight duration and stop information
• Any deals or sales mentioned

WebFetch

• If successful: Extract specific flight options with prices
• If blocked/failed: Gracefully fall back to WebSearch data. Do not retry or error — just note that prices are approximate

• Deduplicate by airline + route + approximate time
• Sort into three categories: Best Value, Cheapest, Fastest
• Include direct booking URL for each option
• Flag any data as "approximate" if from WebSearch only vs live pricing

1. Decompose into individual legs
2. Search each leg independently (can run WebSearch queries in parallel)
3. Present combined itinerary overview + per-leg options
4. Calculate total cost across all legs
5. Provide individual booking links per leg AND a combined multi-city search link

• Assume everything, show everything. Never ask a question when you can make a reasonable assumption. Always show what you assumed so the user can correct.
• One hard requirement: destination. Everything else has a default. A user saying "flights to Tokyo" is enough to produce a full recommendation.
• Value first, setup later. Search before asking for configuration. Onboarding creates value immediately.
• Corrections over questions. Present assumptions, let user fix what's wrong. Faster than asking upfront.
• Show your sources. Every assumption in the card has a "Source" column. Every price has a booking link.
• Graceful degradation. If WebFetch fails, fall back to WebSearch. If WebSearch is sparse, still show what you have with booking links.
• Always get current date. Run

  date

  command — do not rely on system date or knowledge cutoff.
• Multi-city is first-class. Not an afterthought. Decompose, search per-leg, present combined.