Skip to content

skywain/trip-planner-skill

trip-planner

Unverified

End-to-end international trip planning: turns "I want to go to X for N days" into a verified, bookable plan — route skeleton across cities, flight price scans (international + domestic legs), train-vs-fly decisions, hour-by-hour daily timelines with opening hours, dwell times, holiday collisions and tappable turn-by-turn map links (小时级行程+地图导航+离线KML), hotel shortlists by neighborhood, budget rollup, and a booking checklist with deep links. Use this whenever the user asks to plan a trip, vacation, itinerary or honeymoon, compare flight dates/prices, pick between cities or routes, schedule a travel day hour by hour, fill a spare block of time ("I'm near X with 2 free hours"), turn a finished plan into a designed page (eight themed renders: illustrated / clay / noir / glass / journal / zine / splash / portal — 插画/黏土/夜航/玻璃/手账/Zine/闪屏/穿越版), or asks 旅行规划/行程安排/机票比价/去某国玩N天怎么安排/现在有空档干嘛/把行程做成好看的网页 — even if they only mention one piece (just flights, just hotels, or just navigation), the playbook and verification rules here still apply.

FileKindSize
SKILL.mdskill md32.9 KB
assets/plan.example.jsonconfig12.1 KB
examples/README.mdmarkdown13.0 KB
examples/china-2026/china-splash.htmlother937.1 KB
examples/china-2026/china.art.jsonconfig6.4 KB
examples/china-2026/china.geo.jsonconfig58.3 KB
examples/fixtures/bad/bracketed-note.geo.jsonconfig7.8 KB
examples/fixtures/bad/brief-card-not-text.geo.jsonconfig943 B
examples/fixtures/bad/decision-point-date-two-days-before.geo.jsonconfig848 B
examples/fixtures/bad/decision-point-day-date-not-iso.geo.jsonconfig7.8 KB
examples/fixtures/bad/decision-point-no-if-no.geo.jsonconfig715 B
examples/fixtures/bad/decision-point-same-what.geo.jsonconfig8.2 KB
examples/fixtures/bad/decision-point-src-not-http.geo.jsonconfig803 B
examples/fixtures/bad/decision-point-t-not-hhmm.geo.jsonconfig764 B
examples/fixtures/bad/decision-points-null.geo.jsonconfig594 B
examples/fixtures/bad/driver-enum.geo.jsonconfig711 B
examples/fixtures/bad/driver-self-no-driving-card.geo.jsonconfig736 B
examples/fixtures/bad/driving-card-no-as-of.geo.jsonconfig861 B
examples/fixtures/bad/driving-card-no-desk.geo.jsonconfig800 B
examples/fixtures/bad/driving-card-no-legality-line.geo.jsonconfig811 B
examples/fixtures/bad/driving-card-no-verdict.geo.jsonconfig939 B
examples/fixtures/bad/driving-card-zh-verdict-trailing.geo.jsonconfig967 B
examples/fixtures/bad/hotel-checkout-null.geo.jsonconfig786 B
examples/fixtures/bad/hours-as-of-not-date.geo.jsonconfig674 B
examples/fixtures/bad/hours-bare-string.geo.jsonconfig655 B
examples/fixtures/bad/hours-src-not-http.geo.jsonconfig662 B
examples/fixtures/bad/hours-text-empty.geo.jsonconfig647 B
examples/fixtures/bad/kind-enum.geo.jsonconfig7.9 KB
examples/fixtures/bad/must-false.geo.jsonconfig914 B
examples/fixtures/bad/must-no-stand.geo.jsonconfig755 B
examples/fixtures/bad/must-no-view.geo.jsonconfig758 B
examples/fixtures/bad/must-not-boolean.geo.jsonconfig798 B
examples/fixtures/bad/must-see-unmatched.geo.jsonconfig963 B
examples/fixtures/bad/must-see-view-empty.geo.jsonconfig910 B
examples/fixtures/bad/pending-no-checklist-row.geo.jsonconfig1021 B
examples/fixtures/bad/refundable-not-boolean.geo.jsonconfig686 B
examples/fixtures/bad/rental-leg-no-driving-card.geo.jsonconfig829 B
examples/fixtures/bad/review-counts-disagree.geo.jsonconfig1.0 KB
examples/fixtures/bad/review-lens-enum.geo.jsonconfig1.1 KB
examples/fixtures/bad/review-no-driving-lens.geo.jsonconfig1.3 KB
examples/fixtures/bad/review-not-object.geo.jsonconfig611 B
examples/fixtures/bad/review-single-pass-with-counts.geo.jsonconfig1.0 KB
examples/fixtures/bad/review-two-lenses.geo.jsonconfig959 B
examples/fixtures/bad/self-drive-no-driving-card.geo.jsonconfig635 B
examples/fixtures/bad/sub-stop-no-name.geo.jsonconfig763 B
examples/fixtures/bad/sub-stop-no-query.geo.jsonconfig763 B
examples/fixtures/bad/sub-stops-null.geo.jsonconfig578 B
examples/fixtures/bad/tour-confirmed-prefix.geo.jsonconfig902 B
examples/fixtures/bad/tour-not-boolean.geo.jsonconfig562 B
examples/fixtures/bad/tour-on-day-object.geo.jsonconfig7.8 KB
examples/fixtures/bad/tour-unconfirmed.geo.jsonconfig837 B
examples/fixtures/strict/clean.plan.geo.jsonconfig4.5 KB
examples/fixtures/strict/hours-as-of-after-asof.geo.jsonconfig4.1 KB
examples/fixtures/strict/hours-missing-in-window.geo.jsonconfig4.0 KB
examples/fixtures/strict/hours-stale-as-of.geo.jsonconfig4.1 KB
examples/fixtures/strict/no-generated.geo.jsonconfig3.8 KB
examples/fixtures/strict/refundable-no-clause.geo.jsonconfig3.8 KB
examples/fixtures/strict/rows-without-clock-or-kind.geo.jsonconfig3.7 KB
examples/fixtures/strict/self-drive-not-legal-no-decision.geo.jsonconfig4.4 KB
examples/fixtures/strict/t-n-date-mismatch.geo.jsonconfig3.8 KB
examples/fixtures/strict/tour-no-review.geo.jsonconfig3.4 KB
examples/fixtures/substops.plan.geo.jsonconfig9.1 KB
examples/gates-sample.icsother11.5 KB
examples/japan-2026/japan-illustrated.htmlother1.4 MB
examples/japan-2026/japan.art.jsonconfig6.2 KB
examples/japan-2026/japan.geo.jsonconfig65.5 KB
examples/kyoto-sample.htmlother13.0 KB
examples/kyoto-sample.kmlother1012 B
examples/kyoto-sample.plan.geo.jsonconfig7.2 KB
examples/mexico-2026/mexico-journal.htmlother2.0 MB
examples/mexico-2026/mexico.art.jsonconfig9.4 KB
examples/mexico-2026/mexico.geo.jsonconfig77.1 KB
examples/morocco-2026/morocco-glass.htmlother1.3 MB
examples/morocco-2026/morocco-portal.htmlother13.8 KB
examples/morocco-2026/morocco.art.jsonconfig3.8 KB
examples/morocco-2026/morocco.geo.jsonconfig85.1 KB
examples/nordic-2026/nordic-noir.htmlother686.8 KB
examples/nordic-2026/nordic.art.jsonconfig8.7 KB
examples/nordic-2026/nordic.geo.jsonconfig58.5 KB
examples/turkey-2026/turkey-clay.htmlother1.3 MB
examples/turkey-2026/turkey.art.jsonconfig3.5 KB
examples/turkey-2026/turkey.geo.jsonconfig75.8 KB
examples/vietnam-2026/vietnam-zine.htmlother2.5 MB
examples/vietnam-2026/vietnam.art.jsonconfig10.8 KB
examples/vietnam-2026/vietnam.geo.jsonconfig85.1 KB
references/art-schema.mdmarkdown318 B
references/country-quick-notes.mdmarkdown58.6 KB
references/cover-titles.mdmarkdown10.6 KB
references/data-sources.mdmarkdown49.2 KB
references/navigation.mdmarkdown23.6 KB
references/output-template.mdmarkdown49.2 KB
references/phase-0-intake.mdmarkdown12.4 KB
references/phase-1-brief.mdmarkdown22.8 KB
references/phase-3-legs.mdmarkdown10.5 KB
references/phase-4-days.mdmarkdown13.6 KB
references/phase-6-assemble.mdmarkdown22.3 KB
references/scheduling.mdmarkdown28.8 KB
references/themes.mdmarkdown37.9 KB
scripts/build_site.pyscript47.8 KB
scripts/flight_scan.pyscript18.9 KB
scripts/plan_lint.pyscript58.4 KB
scripts/render_plan.pyscript28.2 KB
scripts/route_tools.pyscript90.0 KB

references/country-quick-notes.md

View on GitHub
# Country quick notes

High-churn facts are marked ⚡ — re-verify at plan time. Everything here is a starting
point, not a source: it saves searches by telling you what to search for.

**Two directions live in this file.** Most sections are **outbound** — a Chinese
passport leaving China (visa lines say "Chinese passports need…"). The **China
(inbound)** section is the reverse: a foreign passport entering mainland China. When
the traveller is not Chinese, read the visa line of every outbound section as "check
your own passport", and use the destination-has-no-section rule below for the rest.

**Destination has no section here?** Don't improvise — work the **"Destination not
listed?" checklist** immediately below, then write what you found into a new section
here so the next run doesn't pay for it again.

## Destination not listed? — the checklist (as of 2026-08, after the Mexico / Morocco / Turkey / Vietnam tests)

Four consecutive test trips landed on countries with no section here — the whole of
Latin America, Africa, the Middle East / West Asia, and Vietnam. Every line below is
something that silently produced a *wrong plan* in at least one of those runs. Phase 1
reserves its 2-3 extra searches for the lines marked **hard**.

- [ ] **hard — Visa / entry, two official sources, dated.** Check the traveller's actual
  passport against the destination's MFA or immigration site *and* their own foreign
  ministry; write "as of <month>, verify before booking". Rules flip: Turkey went
  visa-free for Chinese ordinary passports on 2026-01-02 and the old "e-Visa" answer is
  still all over the web. **The assembler owns this line — city subagents must not
  decide visa questions** (on the Turkey test both of them returned the stale answer and
  put it first on the checklist, which is the expensive kind of wrong). The same audit
  carries the **yellow-fever certificate column** — departure country, every transit
  airport and every entry country; the passport is irrelevant to it (data-sources.md
  §Visa / entry).
- [ ] **Currency: closed or convertible, and does the FX source carry it?**
  `frankfurter.dev` carries exactly **30 currencies** (checked 2026-08: no MAD, no VND)
  and **silently drops** a symbol it doesn't have — HTTP 200, key just missing, so an
  unchecked run prices the trip in the wrong money. Count the keys you asked for.
  Fallback `open.er-api.com` (keyless), reason noted in `meta.fx`. Closed currencies
  (MAD, TND, DZD…) can't be bought before or carried out after — say so in the brief.
- [ ] **hard — Holidays: can the source see religious ones?** `date.nager.at` returns
  fixed-date **secular** holidays only. Muslim countries: Ramadan, Eid al-Fitr, Eid
  al-Adha, Islamic New Year and Mawlid all move on the Hijri calendar — one separate
  search. Same for lunar/Buddhist calendars (Tết, Songkran, Vesak). And the reverse trap:
  Día de Muertos is *not* a statutory holiday, yet flights, buses and hotels price like
  one. "The API says no holiday" is not "no crowds".
- [ ] **Regional and school holidays.** nager's `counties` field carries state-level days;
  school breaks appear in no API at all, and they are what move hotel prices.
- [ ] **hard — Time zone and DST, before any prose.** Run `route_tools sun --write`
  *first*, then write every sunrise/sunset/golden-hour line against its values — Morocco
  moved to permanent UTC+0 on 2026-09-20 and ten days of hand-written times were an hour
  out, invisible to `qc`, `check` and the renderers. Check intra-country splits too.
- [ ] **Transit card and passes, with the break-even.** Name the card (Istanbulkart,
  Suica, Opal, T-money, Rejsekort…) and say on which ride or day it pays back; price
  museum passes against the actual anchor list, not the brochure.
- [ ] **Weekly rhythms of worship and markets.** Friday midday prayer shuts mosques and
  madrasas to visitors ~12:00-14:30 across Muslim countries; Istanbul's covered bazaars
  close Sundays; museums close Monday or Tuesday; Sunday morning belongs to Mass. Fix the
  weekly pattern *before* pinning anchors — it reshuffles the whole route.
- [ ] **Local ride app, payment, SIM.** Which app actually works (Grab, BiTaksi, Bolt,
  DiDi, Uber-on-licensed-taxis), how cash-first the country really is, and whether a
  local SIM is a trap — Turkey IMEI-blocks an unregistered foreign handset after ~120
  days, so eSIM or roaming.
- [ ] **hard whenever a self-drive option exists — Driving licence: legality first, then
  the desk.** Which rule does the destination apply to a visitor's licence: the **1949
  Geneva** Convention, the **1968 Vienna** Convention, or its own statute? Federal
  countries decide per state or province (US states, Canadian provinces, Australian
  states), so a multi-state route has several answers. An IDP counts only under a
  convention the jurisdiction applies (phase-1-brief.md §Driving card); **mainland
  China is party to neither and issues no IDP** (a Hong Kong licence differs: Hong Kong
  issues 1949 Geneva IDPs ⚡) — where the law gives it no other
  route, driving or riding anything over 50 cc is unlicensed, and the insurer refuses
  the claim outright. Only then read the rental brand's terms: a desk that rents is not
  legal recognition. The card and its sources: `brief.driving` (phase-1-brief.md
  §Driving card); worked example: §USA Driving. A failed first gate is answered with
  tours, drivers, pillion seats, bicycles or transit, never "just rent a scooter".
- [ ] **Intercity ticket release windows, each with its own date on the checklist.**
  Vietnam rail 60 days, China 12306 15 days, Japan JR 1 month, Trenitalia/Italo 90-120
  days, Norway Vy ~90 — plus night-bus operators and seasonal ferry timetables.
- [ ] **hard — The headline seasonal draw vs the window.** Migration, blossom, aurora,
  whales, monsoon closures, the dry-season safari: one search at skeleton time, the
  answer written into `decisions[]` (the trip is re-shaped or the user is told what
  the window does and does not offer) — not discovered in a day plan.
- [ ] **Highest sleeping altitude and the ladder to it.** Not the highest point
  visited — the highest **bed**, and the steps up to it. See §Altitude below: this
  line reshapes the route order, so it is answered at skeleton time, not at packing
  time.
- [ ] **Travel advisory, and what the insurance must cover.** Read the traveller's own
  foreign ministry (Auswärtiges Amt, travel.gc.ca, 中国领事服务网), then check the policy
  does not exclude the thing the trip is built on — ballooning, diving, motorbike
  pillion, altitude — and that it carries repatriation where hospitals want cash up front.
- [ ] **hard — Health: vaccines, vectors, water, rabies — one CDC / TravelHealthPro
  page, dated** (→ `brief.health` five lines + the travel-clinic consult row;
  phase-1-brief.md §Health line). The plan never doses.
- [ ] **hard — Hazard season: does the window hit one?** §Hazard seasons below, then the
  live feeds (data-sources.md §Hazard feeds) → `brief.season` card + hazard gate +
  insurance deadline NOW (phase-1-brief.md §Hazard line).
- [ ] **hard — Street safety, six named lines** (the `brief.safety` template,
  output-template.md §Brief templates): ① 2-3 current scams by name — the advisory
  page's "Safety and security" section plus one `{city} scam tourists {year}` search;
  ② pickpocket hotspots by line / station / square; ③ the taxi rule (which app, the
  official airport rank, never the arrivals-hall tout); ④ the after-dark avoid list per
  base; ⑤ what to do when it happens (police report first — the report number is the
  claim key, data-sources.md §Travel insurance); ⑥ legal & customs red lines —
  output-template.md §Brief templates, `brief.safety` line 6.
- [ ] **Money lines, the universal five** (data-sources.md §FX → Money safety): refuse
  DCC · card FX fee → buffer · ATM fee and cap · cash number · which cards and wallets
  work — plus the **mainland-China origin trio** when the traveller departs from
  there: UnionPay vs Visa/MC acceptance, Alipay+ / WeChat coverage ⚡, foreign cash
  pre-ordered 1-2 days ahead.

## Altitude

- **Design the sleep ladder, not just the route.** What the body prices is the
  altitude it *sleeps* at: a high day trip from a low bed is forgiving, while raising
  the sleeping altitude by big jumps above ~2,500 m is what loses a day to headache
  and bad sleep. Order the bases so the beds climb gradually and the highest bed
  comes late — this is a route-order decision, which is why the checklist asks it at
  skeleton time.
- **Cap the first day at altitude.** Arriving high (CDMX 2,240 m, Lijiang 2,400 m,
  Cusco 3,400 m): one light anchor, no stair-heavy sight, no same-day push higher.
  The energy-curve rule (scheduling.md rule 6) tightens at altitude; it never relaxes.
- **Diamox lead time is a doctor's question.** The plan writes "the traveller asks
  their doctor about acetazolamide, N days before the climb" and puts the consult
  date on the checklist — it never doses or prescribes.
- **Insurance reads altitude sickness as illness, not accident** — and many policies
  also cap covered altitude at 3,000-4,000 m. Check the policy's altitude ceiling
  against the trip's highest point, and that illness cover (not just accident cover)
  is real, before buying — see data-sources.md §Travel insurance.

## Travel clinic

The Diamox rule, generalised to every vaccine and prophylaxis: **the plan writes the
consult date and the agenda; it never doses or prescribes.** Consult = departure − 4 to
6 weeks (rabies pre-exposure needs two doses in 7 days, Japanese encephalitis two in
28, hepatitis A ≥ 2 weeks, malaria prophylaxis starts 1-2 days to 1-2 weeks before
depending on the drug — all reasons the row sits early in the urgency sort). Agenda =
the health page's "recommended for most / some travellers" rows + the route's activity
tags (rural nights, hiking, animal contact, altitude, diving). The yellow-fever
certificate has its own lead time: 10 days after the jab (phase-1-brief.md §Health
line). Typhoid / hepatitis A "recommended for most travellers" and ORS in the kit are
agenda items, not plan prescriptions.

## Medicines in luggage

Feeds `brief.safety` line 6, Legal & customs red lines (output-template.md §Brief
templates). Same rule as
§Travel clinic: **the plan copies the official rule with its source and date; it never
advises on a drug's use.**
- **Copy the destination's own rule, dated**: the customs authority's or health
  ministry's "bringing medicines" page — the personal-use quantity cap, which
  ingredients are banned or need advance permission, and the form if one exists. One
  entry per destination on that line, with URL and as-of ⚡.
- **Prescription medicines**: original labelled packaging, plus the prescription or a
  doctor's letter in English (or the destination's language), quantity within the cap.
- **Check common remedies by ingredient, not brand**: cold, cough and herbal medicines
  that are ordinary at home can be controlled abroad — stimulant ingredients
  (pseudoephedrine, ephedra), opioids (codeine, opium-containing remedies), animal
  parts under CITES. Worked example — Japan: the health ministry's Narcotics Control
  Department lists pseudoephedrine as a stimulants' raw material and codeine as a
  narcotic: a product at or below the strength threshold (pseudoephedrine 10 %,
  codeine 1 % ⚡) falls under the ordinary personal-use cap, above it advance permission
  is needed (ncd.mhlw.go.jp, as of 2026-10 ⚡); read the box's ingredient list against that list
  before packing.

## Hazard seasons

Window ∩ season ≠ ∅ → `brief.season` card + hazard gate + insurance deadline NOW +
exposed bookings refundable + one buffer day at the peak (phase-1-brief.md §Hazard
line). Months are the usual season, all ⚡ — the official source column is what the
gate re-reads.

| region | hazard | months | official source | plan action |
|---|---|---|---|---|
| Japan · Taiwan · Philippines · Vietnam · Hong Kong · S China | typhoon | Jul-Oct, peak Aug-Sep | JMA · CWA · PAGASA · HKO · NCHMF | ferries, islands and Shinkansen days refundable; +1 buffer day |
| US Gulf + SE coasts · Caribbean · Mexico Caribbean | Atlantic hurricane | 1 Jun-30 Nov, peak Aug-Oct | NOAA NHC | same; cruise / island days keep a backup date |
| Mexico Pacific · Central America Pacific | East Pacific hurricane | May-Nov | NOAA NHC · SMN | same |
| India · Bangladesh · Sri Lanka SW · Thailand · Myanmar | monsoon floods | Jun-Oct | IMD · TMD | rail / road days with a fly-over fallback; rule 10 rain |
| Central Vietnam (Huế-Hội An-Đà Nẵng) | floods | Oct-Dec | NCHMF | the evacuation plan in the city section (§Vietnam) |
| Northern Australia | cyclone + stinger season | Nov-Apr | BoM | reef days weather-backed; stinger suits |
| US West · Canada West · SE Australia · Mediterranean (GR/ES/PT/IT/FR) · Chile | wildfire + smoke | Jul-Oct N · Dec-Mar S · Jul-Sep Med | national fire service; AirNow / air-quality index | park days droppable; smoke = indoor rain_alt |
| Middle East · Mediterranean · South Asia | heat ≥ 38 °C | Jul-Aug · Apr-Jun | national met office | scheduling.md rule 10 heat, every day |
| Iceland · Italy (Etna, Stromboli) · Indonesia · Hawaii · Japan · Guatemala · Philippines | volcano | year-round | USGS HVO · INGV · PVMBG · JMA | base-rate rule (phase-4-days.md); gate on the observatory's alert level |
| Japan · Taiwan · Turkey · Indonesia · Chile · Peru · Mexico · Italy · NZ · Nepal | earthquake / tsunami | year-round | USGS feed · JMA | one `brief.season` line: coastal bases know the high ground |
| Alps · Nordic · Hokkaido · Rockies · Andes passes | avalanche + winter road closures | Nov-Apr | road authority (Vegvesen, NEXCO …) | mountain legs with a rail or fly alternative |
| > 66°N | polar night · midnight sun | late Nov-mid Jan · Jun-Jul | — | a plan shaper, not a hazard: daylight in every day header, rule 10 cold |
| Southern hemisphere | seasons reversed | Dec-Feb = summer | — | check the season card against the month, not the name |

## Japan
- Hazards: typhoon season Jul-Oct, peak Aug-Sep (JMA) — island, ferry and Shinkansen
  days refundable with one buffer day; earthquakes year-round (JMA / USGS feed) —
  §Hazard seasons.
- Entry: most treaty passports get 90-day visa-free stamps ⚡; **Chinese passports
  need a visa** — the JAPAN eVISA (single-entry tourism, 15/30-day stays) covers
  mainland residents ⚡, and there is no transit-without-visa landing for PRC
  passports: airside-only connections are fine, but stepping landside (e.g. to
  re-check bags on separate tickets) needs the visa. Every passport: **Visit Japan
  Web** (services.digital.go.jp, as of 2026-10 ⚡) pre-registers immigration + customs
  before the flight — optional (the paper forms are still accepted ⚡) but faster at
  the gates; a checklist row. A multiple-entry visa carries its
  own conditions (some bind the first entry) — read them on the visa and copy them
  onto the checklist.
- Transit: Suica/ICOCA in Apple Wallet works for visitors ⚡; Google Maps transit is
  reliable countrywide.
- JR Pass: since the Oct-2023 price hike the nationwide pass usually LOSES on the
  Tokyo–Kyoto–Osaka golden route — do the arithmetic vs Smart-EX singles ⚡. Regional
  passes (JR West/Kansai etc.) still often win.
- Shinkansen: Smart-EX app/site or Klook; reserved seats fine 1-3 days out except peaks.
- Sell-outs to check early: Ghibli Museum (sales open the 10th of the prior month,
  JST), Ghibli Park, teamLab, Shibuya Sky sunset slots, Pokémon Café, Nintendo Museum ⚡.
- Peaks to avoid or book months ahead: Golden Week (Apr 29–May 5), Obon (~Aug 11-16),
  New Year (Dec 29–Jan 3), cherry-blossom Kyoto weekends.
- Closures: many museums close Mondays; when Monday is a national holiday they close
  Tuesday instead.
- Cash still matters at small restaurants and shrines; 7-Eleven ATMs take foreign cards.
- **Tax-free becomes a refund at departure from 2026-11-01 (JNTO, as of 2026-10 ⚡).**
  For purchases from that date, tax-free shops charge the tax-inclusive price; within
  90 days of purchase, take the passport and every item of the purchase, unused, to the
  tax-free kiosk in the international departure lobby **before bag drop**; once customs
  confirms the export, the shop refunds. Sealed bags are no longer required. Each
  receipt is checked on its own: one item missing or used voids the refund for that
  whole receipt, so ring up consumables apart from goods that leave Japan unopened.
- **The Japanese-market version (as of 2026-10 ⚡)**: 「医薬部外品」 on the box
  confirms the domestic version; its absence proves nothing — most cosmetics are
  化粧品. Compare the full JAN barcode with the brand's Japanese site (why not the
  prefix: data-sources.md §Shopping requests).
- Luggage on move days: takkyubin (ヤマト等) hotel→hotel is usually **next-day** — book
  it the evening before and keep an overnight kit; station coin lockers, especially the
  large ones at Kyoto/Tokyo/Shinjuku, are gone by mid-morning in peak season.
- **IC cards** (added 2026-08 after the London→Japan test): Suica / PASMO / ICOCA are
  interchangeable nationwide for metro, JR local, buses and konbini — one card, any
  region. Visitors: Apple Wallet Suica/PASMO (top up with a foreign card ⚡, no
  physical card needed) or a Welcome Suica at the airport ⚡ (physical-card sales were
  rationed 2023-24 and still come and go — check). An IC card does **not** cover
  Shinkansen reserved seats or limited-express surcharges: those are separate tickets.
- **Shinkansen booking window**: JR reservations (Smart-EX / EX app, JR West/East
  sites, station counters) open **1 month before the travel date at 10:00 JST** ⚡ —
  earlier for nothing. Ordinary days: 1-3 days out is fine; koyo weekends, Golden
  Week, Obon and the New-Year run sell the good trains on day one. Suitcases over
  **160 cm** (L+W+H) on the Tokaido/Sanyo/Kyushu Shinkansen need the free
  "oversized baggage" seat reservation ⚡ or you pay a fee on board — say so on
  every Shinkansen move day.
- **Autumn (紅葉) season**: Kyoto colour peaks roughly mid-to-late November ⚡ (the
  koyo forecast pages move it by a week each year — verify in September). Temple
  night illuminations (Kiyomizu, Eikan-dō, Kōdai-ji…) run fixed date windows and
  ticket separately ⚡. **Labour Thanksgiving Day, 23 November** is a national
  holiday — when it lands on a Monday, Monday-closed museums close **Tuesday**
  instead (rule above), and the three-day weekend is a domestic-crowd peak.
- **Geocoding Japanese places is unreliable** — Nominatim is weak on Japanese names,
  and *wrong* is worse than *missing*: on the 2026 test `Gōra Station` resolved
  ~600 m off and `Sannenzaka` landed on a guesthouse named after the street, both
  silently. Hand-fill `lat/lon` for anything you already know (temples, stations,
  markets), read every resolved `display_name` against the query, and re-query
  with the Japanese name (`強羅駅`, `産寧坂`) before trusting a hit — see
  navigation.md "Geocoding discipline".
- Street safety: crime is low; the real risks are bicycles on pavements, the last
  train's drunk crowd, and left-side traffic when crossing — these are lines ② and ④
  of the six-line `brief.safety` template; the other four lines are still written,
  mostly "none of note", never imported warnings.

## Korea
- Google Maps directions are crippled — plan with Naver Map (EN ok) or Kakao Map.
- T-money card everywhere; KTX via Korail site/app ⚡.
- DMZ tours book out ~1 week and require the passport on the day.
- Street safety: low crime; the risks are late-night drinking districts and taxis
  refusing short rides (Kakao T solves the second) — lines ② ④ of the six-line
  `brief.safety` template; the other four are written short ("none of note").

## Thailand / SE Asia
- Grab is the city-transport default; 12go.asia for intercity bus/train/ferry.
- Temples: shoulders/knees covered; temples take the opener slot — scheduling.md rule
  10 (heat) triggers most days of the year here.
- Onward-ticket rules enforced unevenly ⚡ — check before booking one-ways.
- **Vietnam has its own section below** — the visa, licence and FX traps there are not
  generic to the region.

## Vietnam (as of 2026-08, after the Shenzhen→Vietnam test)
- **e-Visa from the government portal only — `evisa.gov.vn`**: US$25 single / US$50
  multiple, up to **90 days**, **3-5 working days** (7-10 in peak) ⚡, all nationalities
  including Chinese passports. The first screen of search results is agencies charging
  US$20-60 on top, so name the official site. The approval is a **PDF you must print** —
  the counter wants paper. Submit ~3 weeks out. Never fill the form for the user.
- **Driving licence — the trap that voids the insurance.** Vietnam recognises only IDPs
  issued under the **1968 Vienna Convention**; **China is not a party and issues no IDP**,
  so riding anything over 50 cc is unlicensed driving — fines to ₫5 M and, far worse,
  **the travel/medical policy refuses the claim in full**. The obvious answer ("rent a
  scooter") is wrong: pillion tours with a licensed driver, or a bicycle — say why in
  `decisions` and `brief.safety`.
- **VND is not in frankfurter.dev and the API drops it silently** — `symbols=VND,USD`
  returns HTTP 200 with only USD, so an unchecked run quietly prices the trip in dollars.
  Use `open.er-api.com` and count the keys. Mental rate ₫10,000 ≈ ¥2.6 (2026-08 ⚡).
- **Night trains: `dsvn.vn`**, the official railway site — cheaper than agents, foreign
  passports can book, passport at the counter. **Sales open 60 days ahead** ⚡: that date
  goes on the checklist. Hanoi→Đà Nẵng **SE** (SE19 dep ~19:50, arr ~12:35 next day,
  15.5-17 h ⚡, soft sleeper US$45-55 pp) kills a hotel night, a flight and a travel day —
  but only on that leg; Đà Nẵng→Saigon is a 1 h 20 flight against 15 h of rail.
- **Hạ Long: 2D1N boat vs day trip is arithmetic, not taste.** The day trip spends ~6 h on
  the road for ~4 h of water; the overnight buys sunset, stars and the morning bay and
  replaces a Hanoi hotel night, at US$105-160 pp + US$20-40 transfer ⚡ (~13% of a
  mid-budget trip). Lan Hạ Bay: same class, US$20-50 less, fewer boats. Confirm transfers
  included, big bags on board (they are), kayak included.
- **December is three climates in one trip**: Hanoi/Hạ Long 19-24 °C, one rain day in ten;
  **Hội An / Đà Nẵng 24-26 °C with rain on all ten days, ~137 mm** — the tail of the
  central wet season, so both Hội An days need a rain plan *and* a "Thu Bồn floods the old
  town → move the block north to Đà Nẵng" escape; Saigon 28-31 °C dry with afternoon
  showers. Sunset ~17:15-17:35 mid-December — nothing outdoors after 17:00.
- Holidays: four statutory days (1 Jan, 30 Apr, 1 May, 2 Sep) plus **Tết** on the lunar
  calendar, so most windows are clear — but Christmas, *not* a holiday, packs the church
  districts on 24-25 Dec, and December opens the western high season (boats and Hội An
  homestays +15-30% over November ⚡). Hội An's lantern night is the 14th of the **lunar**
  month — check the lunar date, not the guidebook photo.
- Money and apps: cash society (street food, basket boats, markets, xe ôm); ATM fees
  ₫50-165k or 2-5% with ₫2-5 M local-bank caps → fewer, larger withdrawals. **No tipping
  culture**, but ₫50-100k lands well with boat crew and drivers. **Grab** is the ride/food
  default. ₫20,000 and ₫500,000 are both blue polymer notes: count the zeros.
- Streets: the motorbike flow does not stop — cross at a steady, straight, unhurried pace
  and let it part around you; stopping mid-road is the dangerous move. Phone-snatching
  from bikes is the real Saigon risk. Low-cost domestic carriers sell **bare fares with no
  checked bag** — buy the 20 kg at ticketing, it doubles at the airport.

## Italy / Spain / France
- Rail: book Trenitalia/Italo, Renfe, SNCF directly 2-4 months out — high-speed fares
  rise as buckets sell. Omio/Trainline acceptable when foreign cards fail; small markup.
- Sell-outs: Uffizi & Accademia, Colosseum underground, Vatican early entry, Alhambra
  (often 2-4 weeks!), Sagrada Família, Louvre timed entry, Eiffel summit.
- State museums close Mon or Tue (varies); free first Sundays = the worst crowds
  (Vatican Museums: last Sunday). Churches shut to tourists during Mass and commonly
  12:00-15:00; shops and small venues keep siesta hours ~13:30-17:00 in Spain and
  small-town Italy.
- City tourist tax is collected at the hotel, sometimes cash-only — put it in the budget.
- August: locals on holiday — Paris/Madrid partially shut, coasts jammed ⚡.
- Street safety (`brief.safety` lines ① ②, all ⚡ — re-check against the advisory
  page): Rome — Termini and metro lines A / B, buses 64 and 40, the "friendship
  bracelet" and petition-clipboard scams; Barcelona — La Rambla and metro L3, the
  "bird-dropping" distraction; Paris — metro line 1, RER B from CDG, the "gold ring"
  and petition scams; everywhere, taxis only from the official rank or the app.

## Italy — Rome / Florence / Venice specifics (as of 2026-08, after the Singapore→Italy test)
- Entry: **Singapore (and most treaty) passports are Schengen visa-free, 90 days in
  any 180**; Chinese passports need a Schengen visa from the country of main stay
  (see Nordic). Two schedule-shaping rules on top of the visa question: **EES**
  (biometric entry/exit registration, live since 2026-04-10 ⚡ — first-time entry
  takes face + four fingerprints, budget +60 min at the border) and **ETIAS**
  (official line: launches Q4 2026, mandatory from 2027-01-01 ⚡) — a trip in that
  window gets a "re-check the official ETIAS page 1 month before departure" checklist
  item, not a guess either way.
- **Closure days differ by museum, not by city**: Uffizi, Accademia, Galleria
  Borghese, Capitoline Museums, Doge's Palace side rooms → **Monday**; **Peggy
  Guggenheim (Venice) → Tuesday**; Vatican Museums → Sunday (except the free last
  Sunday); Colosseum/Forum open daily. The Italy test's worst self-check catch was a
  Tuesday rain alternative pointing at the Peggy Guggenheim — run every rain/swap
  target through the same day-of-week check as the anchors, and put the Monday
  closure day to work as the transfer day.
- **Rail release windows**: Trenitalia (Frecciarossa/Frecciargento) opens sales
  roughly **90-120 days out** and Italo about the same ⚡ — Super Economy buckets on
  Rome–Florence–Venice can be a third of the walk-up fare and are gone weeks ahead
  in October; book the exact train (seat reservation is compulsory on the Frecce),
  and expect foreign cards to fail sometimes → Omio/Trainline as fallback with markup.
- **Venice access fee** (Contributo di Accesso): day-visitors pay on a published
  calendar of peak dates (spring–summer weekends and holidays; €5 booked ahead,
  higher if paid late ⚡ — the calendar changes every year), overnight guests are
  exempt but must hold the exemption/hotel registration. Look up the year's date list
  on the Comune's official page and say for each Venice day whether it is a fee day.
  Also: no vaporetto in the small hours — an early VCE departure needs a **pre-booked
  water taxi** (~€100-150 ⚡) written into the plan the night before.
- **Holy days and dress**: churches keep to the Mass schedule (Sunday morning is for
  worshippers; feast days such as 1 Nov, 8 Dec and Easter week close museums or shift
  hours ⚡), and enforce the dress code at the door — St Peter's, the Duomo of
  Florence and San Marco turn away shoulders/knees/hats. Every worship-site block
  carries the one-line dress note (scheduling.md Traps).

## USA (as of 2026-08)
- Hazards: Atlantic hurricanes Jun-Nov on the Gulf and SE coasts (NOAA NHC), wildfire
  smoke Jul-Oct in the West (AirNow), winter road closures in the Rockies / Sierra —
  §Hazard seasons; the volcano gate on a Hawaii trip is the worked example of a
  hazard gate.
- Entry: VWP/ESTA covers treaty passports only — **Chinese passports need a B1/B2
  visa** (Beijing interview waits run weeks-months ⚡) **plus current EVUS enrollment**
  on 10-year visas ⚡. On any US trip, visa status is the first intake question.
- **Driving — two gates, legality first (as of 2026-10 ⚡).** **Gate 1, the law**:
  whether a visitor may drive on a foreign licence is **state law, state by state** —
  the answer for one state says nothing about the next. Worked example: **Hawaii** —
  the Honolulu licensing office's published guidance lets a visitor 18+ drive on a
  licence from a country that ratified the **1949 Geneva Convention**, with the
  passport, for up to one year after US entry; a licence from a non-party (mainland
  China) is therefore not valid there, and there is no IDP to fix it. Source per
  state: the state or county licensing page, with the traveller's own consulate notice
  for that state as a cross-check, dated, into `brief.driving`. **Gate 2, the desk** — each brand's
  published US policy for a licence not in English or not in Latin script, read
  2026-10: Hertz and Dollar — IDP *recommended* to aid translation; Thrifty — IDP
  *required* for any licence not in English; Enterprise and National — IDP *required*
  for non-Latin script, a professional typed translation accepted where the home
  country cannot issue an IDP; Budget — the licence "needs to be written in the Roman
  alphabet", otherwise an IDP as well; Avis — accepts licences from 1949 Geneva or 1943
  Inter-American convention countries (or with US reciprocity); SIXT — an official
  translation for countries that issue no IDP (search snippet — confirm on the page);
  Alamo not checked. Read the pickup location's own terms and get the branch's answer
  in writing. **A desk that rents to you does not make the driving legal** — a brand
  that only *recommends* an IDP rents to a licence a Geneva-only state does not
  recognise: a traffic stop can be a criminal charge, not just a ticket (Hawaii: up to
  $1,000 and/or 30 days, HRS §286-136 ⚡), and the damage waiver and the travel policy normally require a *valid*
  licence, so a crash can go uninsured (quote both clauses — phase-1-brief.md §Driving
  card). Car essential outside
  NYC/SF/Boston/Chicago/DC; city parking $40-70/night.
- **Road rules that differ from home (as of 2026-10 ⚡).** Right turn on red after a
  full stop unless a sign forbids it — except **New York City** (forbidden unless a
  sign allows it) and **Washington DC** (banned citywide since 2025, enforced where
  signed), and some city centres with local bans. Red-light and speed cameras are set
  state by state and county by county. A camera ticket reaches the rental company,
  which charges an admin fee and either bills the fine to the renter's card or
  transfers the ticket to the renter where the jurisdiction allows it.
- Parks: entrance fees are per **vehicle** (~$35); 3+ parks → an annual pass wins,
  but the $80 America the Beautiful is **residents-only since 2026** ⚡ —
  non-residents see the surcharge bullet below for the $250 pass that replaces it. Timed-entry policy
  changes per park per year ⚡ (Yosemite dropped its system for 2026; Yellowstone
  has never had one — check each park). In-park lodges and gateway towns sell out
  and close seasonally ⚡.
- **Non-resident park surcharge (2026-01-01 ⚡)**: non-US residents 16+ pay
  **$100/person at 11 flagship parks** (Acadia, Bryce, Everglades, Glacier, Grand
  Canyon, Grand Teton, Rocky Mountain, Sequoia/Kings Canyon, Yellowstone,
  Yosemite, Zion — no park outside these 11 charges it); the $250 non-resident
  annual pass waives it, admitting the whole private vehicle at per-vehicle parks
  or the holder + 3 adults at per-person parks, so it wins from the 2nd park even
  solo ($135×2 > $250). Tour smallprint now reads "park fees included **for US
  residents**" — that wording excludes the surcharge; ask who collects it. **On a
  commercial tour** (NPS "Nonresident fees on commercial tours" FAQ, as of 2026-10 ⚡):
  every non-resident passenger 16+ owes the $100 unless a pass covers them; one
  pass covers its holder + 3 others aged 16+ on the tour; whether a fellow passenger's
  free slot is applied to you the FAQ does not say — ask the operator; a pass held by a tour-company employee is not valid;
  the operator reports non-resident and pass-holder counts to the fee collector before
  the gate — so "pass holder: yes / no" goes in the first message to the operator
  (data-sources.md §Group tours).
- Bags ⚡: domestic carriers don't weigh carry-ons (size 22×14×9 in only) but
  charge ~$35-45 **per checked bag per one-way** (connections included; separate
  tickets and directions are what multiply) — so one case beats two across a
  multi-leg itinerary; CN/JP carriers on the international bookends DO weigh cabin
  bags (5-10 kg), so "carry-on only" dies at international check-in, not domestic.
  UA Basic Economy is personal-item-only on domestic/short-haul Latin America
  routes (long-haul international keeps the carry-on).
- **Phone ⚡**: US tour operators, motels and drivers confirm by **voice call or SMS
  to a US number**, so a data-only eSIM is not enough (data-sources.md §Group tours);
  the home number must still receive SMS as well (`brief.connectivity`). Keep two
  numbers apart: a short-lived **trip number** (store prepaid, dropped after the
  trip) and — only if the traveller wants a US number long-term — a **keeper** that
  works over Wi-Fi Calling abroad. Bind long-term US accounts (bank, ride apps,
  ticketing) **only to the keeper**: a lapsed prepaid number is reissued to someone
  else. Some eSIMs activate only on a US network after landing — an activation error
  at home can be expected; read the carrier's activation page before relying on it.
  What needs the traveller in the US (as of 2026-10 ⚡): the carrier asks for an
  emergency (E911) street address before Wi-Fi Calling turns on — set it before flying
  home; a US-region App Store account without a US card is created only from inside
  the US; moving Google Play to the US needs presence there and a US payment method,
  then locks for 90 days. Retail memberships and online marketplaces are opened from
  home; a bank account is not a trip errand.
- Hotels ⚡: resort strips (Waikiki, Las Vegas) carry resort/urban fees of
  $30-56/night plus ~19% taxes — sometimes inside the list price, sometimes at the
  property; quote the checkout all-in (data-sources.md §Hotels), and expect NYC
  boutiques to do the same with "urban" fees.
- **Hawaii shopping (as of 2026-10 ⚡)**: the town duty-free store closed in January
  2026; airport duty-free for international departures continues under a new operator
  since 2026-04 — not a reason to shop in town. Luxury brands carry no island discount.
  US-model iPhones from the 14 on have no SIM tray (handset line, phase-1-brief.md §The
  fact lines). Local produce costs less at supermarkets than at the resort-strip
  convenience chains. Anything else: data-sources.md §Shopping requests, against the
  traveller's home market.
- Lookalike names bite bookings: **JAC** (Jackson Hole, WY) vs **JAX**
  (Jacksonville, FL) is one airport-code letter; Columbus OH vs GA, Jackson
  WY/MS/TN; SFO searches on aggregators mix in OAK/SJC departures. Booking links
  in the plan carry the state (see output-template.md §Booking-artifact conventions).
- Booking forms: **KTN = a US trusted-traveler number** (TSA PreCheck / Global
  Entry) — leave it blank; never the passport number. (A mismatched KTN is
  silently ignored, so the mistake is harmless — but it buys nothing, and the
  passport goes only in the travel-documents section at check-in.)
- Sports tickets: marquee fixtures (Messi, playoffs) run 3-10× ⚡;
  kickoff times can shift for TV after on-sale ⚡. Where to buy and the purchase traps:
  data-sources.md §Venues, tours, tickets.
- Distances are the trap — one region per 10-15 days.

## Mexico — CDMX / Oaxaca, Día de Muertos (as of 2026-08, after the Berlin→Mexico test)
- Entry: German and most EU/UK/US/CA/AU/JP passports are **visa-free for tourism up to
  180 days**; passport valid ≥6 months, a national ID card is not accepted. Chinese
  passports need a Mexican visa *or* qualify on a valid US/Schengen/UK/CA/JP visa ⚡ —
  verify, this is one of the routes that changes.
- **There is no paper FMM by air any more.** Entry is the digital **FMMd**: biometric
  passports use the **E-Gate at AICM**, and what you leave with is a printed slip and/or a
  stamp carrying the entry date and days granted — photograph it, and pull the FMMd PDF
  from the INM site if you need to prove status for a car rental or hotel ⚡. Sites selling
  an "FMM tourist card" for a flight are selling the land-border form.
- **Día de Muertos (1-2 Nov) is NOT a statutory holiday** — nager.at returns zero federal
  holidays across the window (nearest: Revolution Day, 16 Nov) — yet domestic flights, ADO
  buses and Oaxaca hotels fill and price like one. "No holiday" is not "no crowds".
- **The two cities peak on different nights**, which is what makes a combined route work:
  CDMX takes the Saturday Reforma parade, the Coyoacán ofrendas and the marigold canyon at
  the **Mercado de Jamaica** in the last week of October; Oaxaca takes 1 Nov (Angelitos,
  Comparsa de Catrinas, first vigils) and 2 Nov (panteones fill from the afternoon,
  comparsas after dark). ⚡ **The CDMX parade date is published only ~6 weeks out**
  (cultura.cdmx.gob.mx — unpublished on 2026-08-15; historically a Saturday in the window)
  → build the day so it works either way, with a swap tag and a rain_alt, not a guess.
- **Oaxaca 1-5 Nov is the hardest booking on the trip**: the trade line is "book by May",
  by August the centro is largely gone and rates run 2-3× ⚡. Take Jalatlaco or the Santo
  Domingo fringe rather than holding out for the Zócalo.
- CDMX↔Oaxaca: **fly (1 h 05) rather than ADO (6.5-7 h)** on festival days — ADO GL/Platino
  stays as the comfortable budget backup, booked at ado.com.mx, never a reseller. 1 Nov is
  one of the busiest domestic flying days of the Mexican year ⚡.
- **INAH raised admissions on 1 January 2026** and adjusts every January: foreign-visitor
  rate at flagship sites ~MX$210 ⚡, with separate local pricing. Museo Frida Kahlo (Casa
  Azul) is **online timed tickets only — no door sales**, closed Mondays.
- Closure days are per museum: Monday for Antropología, Bellas Artes and Casa Azul;
  **Tuesday** for the Museo Vivo del Muralismo at the SEP. Run rain alternatives through
  the same day-of-week check as the anchors.
- **Uber and DiDi have been barred from AICM pickups since March 2026** ⚡ — authorised
  sitio taxis at the airport, app cars everywhere else, never a street taxi at arrivals.
- Cash for markets, cemeteries, colectivos, comparsa stalls, church donations and every
  tip; bank ATMs (Santander/Banorte/BBVA), and decline the machine's own currency
  conversion. Tipping 10-15% — check whether *propina* is already on the bill.
- Altitude and cold nights: CDMX sits at 2,240 m, so the first day feels thin and the
  nights want a jacket; Monte Albán at midday has no shade. Late Oct – early Nov is the
  dry sweet spot (~24/10 °C, near-zero rain, ~11 h of daylight).
- Manners at the cemeteries: a family occasion, not a show — ask before photographing, buy
  candles and marigolds at the gate stalls, don't step over a grave. Comparsa routes and
  cemetery hours are set locally days ahead ⚡: ask the hotel, don't promise a time.
  Travel-medical insurance **with repatriation** is not the line to skip — private
  hospitals expect cash on the spot and consular help is billed back.

## Australia (as of 2026-08)
- Entry: the ETA (subclass 601) and eVisitor (651) are for listed passports only —
  **Chinese passports need Visitor visa subclass 600** (tourist stream, online via
  ImmiAccount, immi.homeaffairs.gov.au; fee ~AUD 200 ⚡ — the site 403s scrapers, read
  it in the browser pane). Processing: 90% of applications in **~33 days** ⚡ (official
  processing-time page) — for a trip 6-8 weeks out this is the tightest deadline in
  the whole plan and goes to the top of the checklist. Passport valid for the stay;
  no onward-ticket rule, but be ready to show one.
- **Daylight saving splits the country**: NSW/VIC/ACT/SA/TAS switch on the **first
  Sunday of October** (02:00 → 03:00; ends first Sunday of April); **QLD, NT and WA
  do not**. From that Sunday, Sydney/Melbourne run 1 h ahead of Brisbane/Cairns —
  re-check every SYD↔QLD flight, tour pickup and phone-call time across the switch,
  and fetch sun times on both sides of it (scheduling.md rule 7).
- Public holidays are **state-level** — nager.at returns them with a `counties`
  field, read it: the **first Monday of October** is Labour Day in NSW/ACT/SA *and*
  King's Birthday in QLD (a double long weekend; long-weekend hotel/tour surge in
  both states). Melbourne Cup Day (first Tuesday of November) is VIC-only.
- **School holidays** move prices and reef-boat availability more than public
  holidays: NSW spring break runs the last week of September into the first ~2 weeks
  of October (2026: 28 Sep–9 Oct ⚡, education.nsw.gov.au); QLD's is a week earlier
  (⚡ qed.qld.gov.au). Not visible in any holiday API — one search per state.
- Sydney transit: **Opal card or just tap a contactless card/phone** on trains, ferries,
  light rail, buses (transportnsw.info); daily/weekly caps apply automatically. Blue
  Mountains by train from Central (~2 h, Opal) — no car needed for Sydney + Blue
  Mountains. Cairns: day tours include hotel pickup; no useful transit.
- **Seasonal shutdowns are real and per-venue** — Skyrail Rainforest Cableway runs
  reduced loops / full closure days for maintenance in some spring windows ⚡
  (skyrail.com.au notices page); Kuranda Scenic Railway likewise. Check the official
  page for the exact dates before pinning any Kuranda day.
- Great Barrier Reef boats (Cairns/Port Douglas): outer-reef pontoon days are
  **date-sensitive** — capacity, weather cancellations, and stinger season from ~Nov
  ⚡; book the specific date and keep the next day free as weather backup. Prices on
  operator sites (sunlover.com.au, quicksilver-cruises.com…) beat aggregators.
- Money: cards everywhere, cash nearly unnecessary; tipping not expected. UV index
  is extreme even in spring — scheduling.md rule 10 (heat) triggers on UV ≥ 8, so
  hikes take the opener slot with shade / hat / water in the day note.

## Nordic — Norway first; Sweden / Denmark / Finland notes (as of 2026-08)
- Entry: all four are Schengen. **Chinese passports need a Schengen visa, lodged with
  the country of main stay** (most nights; ties → first entry) — Norway via
  VFS Global for the Norwegian embassy (udi.no); ~15 calendar days nominal, apply
  4-8 weeks out ⚡. Travel insurance ≥ €30k mandatory for the application.
- Rail: **Vy** (vy.no) — Oslo–Bergen line **minipris** fares open ~90 days ahead ⚡
  and sell in buckets; the Bergen Railway + Flåm Railway (Flåmsbana, visitflam.com)
  are the classic pairing. Sweden: SJ (sj.se); Denmark: DSB (dsb.dk); Finland: VR
  (vr.fi). Oslo airport → city: **Flytoget 19-20 min** (flytoget.no) or the ordinary
  Vy regional train at half the price, ~23 min — do NOT trust distance-based transit
  estimates here.
- **Fjord boats thin out fast in autumn**: Flåm–Gudvangen (Nærøyfjord) and similar
  cruises drop to reduced timetables around **1 Sep – 15 Oct** and many stop
  mid-October ⚡ (norwaysbest.com / the operator's own timetable). Verify the sailing
  for the *specific date* before pinning a Norway-in-a-nutshell day; the whole day
  hangs on one departure.
- Museums: many close **Mondays** (Oslo and Bergen both) — never put a museum in a
  Monday's rain alternative without checking. Opening hours shorten from October.
- Money: **effectively cashless** — card/phone everywhere including buses and public
  toilets; keep no NOK/SEK/DKK cash. Norway is outside the EU: **tax-free refund on
  purchases ≥ NOK 315** per shop per day (Global Blue / Planet, refund at departure).
- **Autumn school break (høstferie) is invisible to holiday APIs** — Norway has no
  public holiday in October, yet hotels and cabins price up by region: **Oslo /
  eastern fylker take week 40, Bergen / Vestland week 41** ⚡ (dates per fylke on
  the county or kommune school calendar; Sweden's höstlov is week 44, Denmark's
  efterårsferie week 42, Finland's syysloma weeks 42-43 by region). One search per
  fylke you sleep in; expect prices up and family attractions busy.
- **Aurora honesty**: at 60°N (Oslo, Bergen, Flåm) in early October, a single-night
  sighting needs Kp≥6 — roughly 5-10% per night. Say so; sell it as a bonus with a
  "look north after 22:00 if the sky is clear" note, not as an itinerary item.
  Real aurora trips go to Tromsø (69°N) from late September.
- Sun and weather: 60°N early October ≈ 07:20 sunrise / 18:50 sunset and losing ~5
  min a day; Bergen averages >200 rain days a year — every Bergen day gets an indoor
  rain alternative and the fjord day gets a weather-backup date.
- Regional notes: Stockholm — SL tap-to-ride, archipelago boats also seasonal ⚡;
  Copenhagen — Rejsekort or contactless, city very bikeable; Helsinki — HSL app,
  ferry to Tallinn is a valid day trip.
- Street safety: very low crime; the hazards are ice on pavements (Oct-Apr), the
  midnight-sun / polar-night sleep disruption, and hiking weather turning in an hour —
  lines ② and ④ of the six-line `brief.safety` template; the other four are written
  short ("none of note"), never imported warnings.

## Turkey (as of 2026-08, after the Shanghai→Turkey test)
- **Entry — this one flipped recently. Chinese ordinary passports have been visa-free
  since 2026-01-02**, tourism and transit, ≤90 days in any 180 ⚡. Two official sources
  agree (Turkish MFA visa page; Chinese embassy in Ankara notice of 2026-01-12), checked
  2026-08 — **verify again before booking**; the old "e-Visa, and only if you already hold
  a Schengen/US/UK visa" answer is dead but still everywhere online, and work/study still
  need a visa. Passport ≥6 months + a blank page; the border may spot-check a printed
  return ticket, hotel bookings, itinerary and a physical credit card. **The assembler
  decides this line, not the city subagents** — both of them returned the stale answer.
- Holidays: nothing statutory in early October — Republic Day is **29 Oct**, Ramadan 2026
  fell in March. On a Chinese Golden Week trip the pressure is all on the outbound ticket,
  not on the ground ⚡. Watch instead for event weeks that move one town's beds (Cappadocia
  Ultra-Trail, mid-October, date published late ⚡).
- **Istanbulkart**: ~165 TL card fee (non-refundable) + top-up, on metro, tram, bus, ferry
  and funicular; a ride is ~42-46 TL against ~60 TL for a single ⚡, so it pays back on the
  4th ride — at 2-4 rides a day, top up per ride rather than buying a daypass.
- Tickets run through **muze.gov.tr**. Hagia Sophia charges foreigners separately for the
  **upper-gallery visitor route** (~€25 ⚡) and the Istanbul Museum Pass does **not** cover
  it; Topkapı is one combined ticket with the Harem included (~2,750 TL ⚡), closed
  Tuesdays. Price **Museum Pass Türkiye / Cappadocia** against the real anchor list ⚡.
- **Weekly rhythm**: Friday midday prayer closes working mosques to visitors — Hagia Sophia
  before 12:00, Blue Mosque after ~14:45 — and **Kariye/Chora closes to visitors all
  Friday**. The **Grand Bazaar and Spice Bazaar close on Sundays**.
- **Balloons (Cappadocia)**: book 4-8 weeks out ($320-450 pp ⚡). The call is made at
  03:00-05:00 and flights are scrubbed for wind >10 km/h, rain, fog, snow or storms →
  **100% refund or a free move to the next morning**, so the route must hold a **second
  Cappadocia dawn as the standby window** and the operator must be told which evening you
  leave. October is the golden month and also the windy one.
- **Night buses** (obilet.com; Kamil Koç / Süha / Metro / Pamukkale Turizm) save a hotel
  night and a whole day. Pin down three things: whether you change at the Nevşehir
  *otogar*, whether the free *servis* shuttle is included, and the real arrival time.
  Station **emanet** left-luggage exists at most otogars but hours and price need
  confirming on arrival ⚡ — the whole post-night-bus day hangs on it.
- Domestic flights fill what rail doesn't: IST→Nevşehir (NAV) or Kayseri (ASR) for
  Cappadocia, Denizli (DNZ)→IST for Pamukkale. ⚠️ **AJet flies DNZ into Sabiha Gökçen
  (SAW), not IST** — with a European-side hotel that is the wrong airport.
- **Phone: eSIM or roaming, not a local SIM** — Turkey **IMEI-blocks** an unregistered
  foreign handset after ~120 days on a Turkish SIM ⚡. Google Maps works normally, so the
  skill's map deep links are fine; expect occasional throttling of social platforms, and
  venue Wi-Fi that wants a Turkish number.
- Money: the lira inflates fast — don't pre-buy cash. Cards are near-universal (UnionPay is
  not: carry Visa/Mastercard); withdraw at Ziraat / İş Bankası and **always choose to be
  charged in lira**, never the machine's own conversion. Cash for bazaar haggling, dolmuş,
  çay, toilets and tips (restaurants 5-10%).
- Dress and terrain: mosques want covered knees and a headscarf for women, shoes off at the
  door; Pamukkale's travertines are **barefoot-only** (dry bag + quick towel); Uçhisar
  castle has no railings and the Red Valley sand is loose. Check the insurance does **not**
  exclude ballooning — many basic policies do, and it is the centrepiece of the trip.

## Morocco (as of 2026-08, after the Toronto→Morocco test)
- Entry: Canadian, EU, UK, US, AU/NZ and Japanese passports are **visa-free for 90 days**;
  Chinese passports too ⚡ — verify. Passport valid ≥6 months beyond departure; the only
  paperwork is the arrival card handed out on the aircraft, and the one thing to check is
  that you actually got the stamp.
- **MAD is a closed currency** — you cannot buy it before you go or change it back after
  you leave. Draw cash in the CMN arrivals hall and spend the last of it at the airport.
  **frankfurter.dev does not carry MAD** (30-currency list) → `open.er-api.com`, keyless,
  with the reason written into `meta.fx`.
- **Clocks: Morocco left permanent UTC+1 for permanent UTC+0 on 2026-09-20** (tzdata
  2026c) ⚡ — the old Ramadan-only shift is gone. On the test, sunrise/sunset written from
  general knowledge was an hour off for all ten days and nothing in `qc`/`check` caught it:
  **run `sun --write` before any golden-hour prose**, and re-check the offset nearer the
  date. Early-to-mid November: sunrise 06:37-07:00, sunset 17:18-17:39 → golden hour from
  ~16:50, dark by ~18:05. Desert nights ~12 °C; the Rif (Chefchaouen) is where the rain is.
- **date.nager.at returns only fixed-date secular holidays for Morocco** (Green March
  6 Nov, Independence Day 18 Nov) and **lists no Islamic feast at all** — Ramadan, Eid
  al-Fitr, Eid al-Adha, the Islamic New Year and Mawlid need a separate Hijri-calendar
  search ⚡. The Marrakech film festival (late Nov ⚡) doubles hotel rates while being no
  holiday at all.
- **Friday is the weekly rule**: midday prayer closes Bou Inania and similar madrasas and
  mosques to visitors and slows everything ~12:00-14:30 — pin the Fes medina day to a
  Thursday and let Friday be the moving day.
- Intercity: **ONCF** rail (oncf.ma) — Casablanca airport is on the line, so the arrival-day
  run south is a train at a fifth of a private transfer. **CTM** (ctm.ma) and **Supratours**
  are the reserved-seat coaches with a luggage hold; local buses reserve nothing.
  Chefchaouen has neither airport nor rail — the exit is a bus, or Tangier + one flight.
- **Marrakech→Fes across the High Atlas is a 3-day private-car job**, not a shared minibus:
  Tizi n'Tichka, the Dades hairpins and the Erg Chebbi sunrise are exactly the stops a
  17-seat group tour drives past. Get three things in writing: (a) it **ends in Fes**, not
  back in Marrakech; (b) a private vehicle; (c) which camp ("luxury" = ensuite tent).
  Merzouga→Fes is a real **7.5-8 h** ⚡, not the 6 h operators quote. At the camp there is
  no mains power and no signal — charge in Merzouga, carry a battery, and leave the big bag
  padlocked at the auberge with only a daypack on the camel.
- Money and manners: cash for souks, petit taxis, tannery terraces, camel guides and every
  photograph. Tipping is structural and always in dirham: MAD 10-20 porter, 20-50 terrace,
  100-150 half-day guide, 300-500 for the desert driver at the end. Bargain in the souks,
  not in shops with marked prices.
- Medina friction: unofficial "guides" at the Fes gates and the tanneries, and the
  taxi-meter argument — agree the price first or insist on the meter; "la, shukran" and
  keep walking, engaging does not work. GPS drifts badly under the reed-roofed souks, so
  offline maps and the trip KML matter here more than usual.
- Connectivity and cover: eSIM on **INWI or Maroc Telecom** (they have the Atlas road and
  Merzouga; Orange is city-only), plugs C/E at 220 V. Insurance needs **medical
  evacuation** — hospitals expect immediate cash payment, and two nights of this route are
  4+ hours from a major hospital.

## China (inbound) — foreign passport entering mainland China (as of 2026-08, after the NYC→Xi'an/Beijing test)
- **Visa — check the category before anything else.** The much-advertised **240-hour
  visa-free transit** requires an onward ticket to a **third** country/region within
  240 h; a **US round trip (JFK→PEK→JFK) does NOT qualify** → an **L (tourist) visa**
  via the Chinese Visa Application Service Center of the home country (in-person
  fingerprints for most applicants, ~4 working days regular service, US passports
  usually get 10-year multi-entry ⚡). Many European, Australian, NZ, Korean and
  Japanese passports currently have a **unilateral 30-day visa-free** entry ⚡ — those
  lists change every few months, so confirm on the embassy site, not a blog. Passport
  valid ≥6 months. Hotels register foreign guests with the police — pick hotels that
  accept foreigners (nearly all chains do; some budget/local ones don't ⚡).
- **Real-name ticketing everywhere.** Rail, flagship museums, the Great Wall and the
  Forbidden City sell only against a passport number, tickets are non-transferable,
  and the passport itself is the ticket at the gate. Four different pre-sale clocks
  ⚡ run in parallel — put each on the checklist with its own date:
  1. **Rail (12306)**: sales open **15 days** ahead of departure, released in
     station-specific batches during the day (08:00-18:00 China time) — the
     Xi'an↔Beijing HSR (¥515 second class, 4.5-6 h ⚡) fills on peak weekends.
  2. **Forbidden City**: **7 days ahead at 20:00** on the palace's official channel
     (site / WeChat mini-program), passport-numbered, capped daily; **closed
     Mondays** (except national holidays). Weekend and holiday slots go in minutes.
  3. **Great Wall (Badaling / Mutianyu)**: real-name timed reservation, released ~7
     days ahead ⚡; Mutianyu is the calmer choice, Badaling has the train.
  4. **Terracotta Army / Shaanxi History Museum / National Museum**: real-name
     reservation windows of ~7 days ⚡ (Shaanxi History Museum is free and the
     hardest slot in Xi'an — reserve the minute it opens or take the paid Tang mural
     ticket). Put the flagship on a **weekday**; the China test reversed its route
     to land the Wall on a Monday and the Forbidden City on a Tuesday for this reason.
- **12306 works only in a browser for foreign users** (12306.cn/en; register with
  passport, verification once — sometimes at the station window; foreign
  Visa/Mastercard accepted since 2023 ⚡). Trip.com resells with a small fee and takes
  any card — the fallback when 12306 rejects the card. No 12306 MCP → the browser
  pane, per data-sources.md.
- **The Great Firewall shapes the plan.** Google Maps/Search/Gmail/Drive, WhatsApp,
  Instagram, X and most Western news are blocked; **every Google Maps deep link the
  skill emits is dead on the ground in China**. Three-part fix, all in the plan:
  (a) **roaming eSIM/SIM from home** (Airalo/Holafly-type or the home carrier's
  roaming) — traffic tunnels via the home network so Google works; a **local China
  SIM or hotel Wi-Fi does not**; put the eSIM at the top of the checklist;
  (b) build the map links with `route_tools.py links --provider amap` (or `apple` —
  Apple Maps works in China on Amap data) — see navigation.md "Google Maps is
  unavailable in some destinations"; (c) **the trip KML in Organic Maps** (offline,
  no network at all) is the hard fallback and goes into the footer of every China
  plan. Name 高德 (Amap, has an English mode ⚡) and 百度 as the local apps; Google
  Translate is blocked too — Apple Translate / an offline pack.
- **Payment**: Alipay and WeChat Pay accept a **foreign Visa/Mastercard/Amex** bound
  in the app (International version: single payment ≤ US$5,000, ~3% fee above ¥200
  ⚡) — set both up before departure and test with a small top-up. Foreign cards at
  POS terminals are rare outside international hotels; keep some cash (legal tender,
  taxis and small vendors must accept it) from a Bank of China / ICBC ATM. Metro:
  the Alipay/WeChat transit code or a Yikatong (Beijing) card; Didi has an English
  mode inside Alipay.
- **Winter opening hours switch in mid-November** — a real collision the holiday API
  can't see: the Forbidden City goes to winter hours on **1 Nov** (last entry
  ~15:40 ⚡); the **Terracotta Army and Mutianyu switch on 16 Nov** (closing an hour
  earlier ⚡); many parks and gardens follow. A trip straddling those dates has two
  sets of hours — put the switch date on the day cards, and sunset (17:00 in
  Beijing by mid-Nov) closes outdoor sights before the ticket does.
- **HSR practicalities**: no checked luggage — one big suitcase per person fits the
  end-of-carriage racks (first come), the overhead takes ~24"; **airport-style
  security X-ray at the station entrance plus a passport ID gate** (foreign passports
  usually go through the **manned** lane, not the e-gate ⚡) — arrive 45-60 min
  before departure, and note that stations are enormous (Beijing West, Xi'an North:
  10-15 min walk gate to platform). Boarding gates close ~5 min before departure.
- Holidays: **National Day Golden Week 1-7 Oct** and Spring Festival are the two
  weeks not to be in China as a tourist; nager.at lists them, but the shifted
  working days (weekend make-up workdays) around them are not obvious — check the
  State Council notice ⚡. Beijing/Xi'an in November: dry, cold, occasional smog days.

## General route math
- 10-15 days ≈ 8-13 usable days ≈ 2-4 bases; 2-3 bases beats 4 for almost everyone.
- Every hotel change costs ~half a day. Every intercity move costs its duration + 2 h.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall