trip-planner
UnverifiedEnd-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.
assets/plan.example.json
View on GitHub{
"_readme": "Runnable schema example — copy it to plan.geo.json, replace everything, keep the shape. The .geo stem matters: geocode then edits the file in place, so check/links/kml/render all read one file. The same file feeds scripts/route_tools.py (days[].stops) and scripts/render_plan.py (everything else). INVARIANT: days[].stops mirrors that day's anchors + modelled strolls in visit order — the maps and the walking total are computed from it. Two stops deliberately ship without lat/lon so `check` reports them and exits 2 until you run `geocode`; that is the intended first step, not a defect. All prices, hours and links are PLACEHOLDERS: never ship them unverified. tz: optional IANA zone — top-level default, days[].tz overrides; a plan that crosses zones stamps tz on every day before sun --write. lang: top-level \"zh\"|\"en\" — always write it; absent silently defaults to zh, wrong for every en plan. Every renderer and route_tools sun read it (--lang overrides); prefs has no lang field.",
"_readme_triggered": "Shapes that appear only when their trigger does — absent from this file on purpose, never written as empty keys: brief.driving + prefs.drivers (a self-drive option exists — phase-1-brief.md §Driving card) · prefs.languages (a guided option may be priced) · prefs.must_see (the traveller named must-sees; an entry with a view needs a must: true sub-stop with a view and a stand) · tour: true on a row + confirmed on its must sub-stops (a guided tour owns the block) · stops[].driver ∈ self | hired | taxi | tour on the drive stops of a day someone drives · days[].decision_points (a go / no-go call on the day or the evening before — route_tools.py ics writes its event) · refundable: false on a checklist or legs row (a non-refundable booking or fare) · 'On-trip re-audit · D+N' checklist rows (a trip of seven days or more) · a 'Before leaving <country>' checklist row (the traveller keeps the local number; deadline the day before the last departure from that country, after the on-trip rows) · '· independent review: …' after the self-check line + meta.review behind it (a self-drive option, a non-refundable booking or a timed check-in — the lint sees the machine-readable part: the self-drive set, refundable: false, tour: true; a timed check-in without a tour block stays procedure-only). Each is defined in references/output-template.md, except the driving card (references/phase-1-brief.md §Driving card) and the review clause (references/phase-6-assemble.md §Independent review); plan_lint.py checks the ones it can.",
"_readme_prefs": "prefs = what Phase 0 (Intake) learned or assumed, written down once so Phases 2-6 and any later replan read one place instead of re-asking. Enums: theme ∈ illustrated|clay|noir|glass|journal|zine|splash|portal (default illustrated) · pictures ∈ native|key|stock (the picture-capability check: own generator | themes/.auth_header | built-in stock kit) · travel_style ∈ public|self-drive|group-tour|mixed · scenery ⊂ nature|city|beach|forest|lake|mountain · pace = anchors per day (2/3/4) · lodging and budget are free text · notes = every inferred value, so the assumptions block at checkpoint (a) can be written from this one object. Every renderer IGNORES prefs (it is not in theme_common.PLAN_SHAPE) — the block is for the planning agent, not for the page. · drivers = [{who, licence_country (ISO2 of the country that issued the licence)}], present when a self-drive option exists — brief.driving checks each one and plan_lint then requires that card · languages = the language codes the party can follow spoken commentary in, present when a guided option may be priced · must_see = [{name, view?}], the must-sees as the traveller named them, view (free text: the picture the traveller came for) only when the draw is a picture (output-template.md §Intake prefs)",
"trip": "Example trip — 2 days",
"lang": "zh",
"tz": "Asia/Tokyo",
"prefs": {
"theme": "illustrated",
"pictures": "stock",
"travel_style": "public",
"lodging": "hotel · mid-range, refundable",
"scenery": ["city", "nature"],
"pace": 3,
"budget": "mid",
"notes": "assumed origin PVG (zh request, no origin given)"
},
"meta": {
"dates": "2026-10-05 → 2026-10-07",
"party": "1 adult",
"route": "City A → City B",
"budget_total": "PLACEHOLDER",
"fx": "1 CNY = 23.73 JPY (ECB via frankfurter.dev, 2026-07-31)",
"generated": "2026-08-01",
"self_check": "自检: 发现并修复 N 处"
},
"decisions": [
"One line per decision you made on the traveller's behalf — each one vetoable"
],
"checklist": [
{"item": "Travel-clinic consult (vaccines / prophylaxis per the health page)",
"deadline": "departure minus 4-6 weeks (NOW if inside 6 weeks) · PLACEHOLDER date",
"note": "PLACEHOLDER — agenda: the page's 'recommended for most / some travellers' rows + activity tags; the plan never doses"},
{"item": "Timed-entry ticket X", "deadline": "opens 10th of prior month",
"price": "PLACEHOLDER", "link": "https://example.org/tickets",
"note": "sells out same day"},
{"item": "T-14 re-check: hours + fees of every anchor, advisory level, visa rule",
"deadline": "T-14 · PLACEHOLDER date",
"note": "PLACEHOLDER — the anchors and legs[] numbers this T-14 row covers"},
{"item": "T-7 re-check: forecast for every base, re-apply weather rule 10",
"deadline": "T-7 · PLACEHOLDER date",
"note": "PLACEHOLDER — the bases whose forecast this T-7 row re-runs"},
{"item": "T-3 re-check: strikes / closures on the route, forecast, tickets in wallet, hours of every anchor up to T-3+14 re-read",
"deadline": "T-3 · PLACEHOLDER date", "note": "PLACEHOLDER — one line per moving day: operator + transit-notice URL"},
{"item": "T-1: eSIM live + home-number SMS, copies, cash per brief.money, cards unblocked",
"deadline": "T-1 · PLACEHOLDER date", "note": "PLACEHOLDER — eSIM provider · cash figure from brief.money · cards to unblock"}
],
"legs": [
{"type": "international flight", "date": "2026-10-05", "carrier": "PLACEHOLDER",
"from": "AAA", "to": "BBB", "dep": "18:20", "arr": "next day 13:40",
"price": "PLACEHOLDER", "bags": "23 kg included",
"link": "https://www.google.com/travel/flights", "backup": "second-best option"}
],
"days": [
{"date": "2026-10-05", "tz": "Asia/Tokyo", "city": "Kyoto", "label": "East Kyoto",
"sun": "天亮 05:28 · ☀ 05:53 / 🌇 17:38 · JST · sunrise-sunset.org",
"walking_km": {"total": 5.4,
"how": "on foot 1.7 ×1.3 + 散步 1.5 + 馆内 ~1.7"},
"ribbon": "Anchor 1 →步行10′→ Anchor 2 →步行8′→ lunch →巴士25′→ Anchor 3 →步行→ stroll",
"day_map": "PLACEHOLDER — the DAY CHAIN url from route_tools links",
"rain_alt": "indoor alternative — closure-checked for THIS date",
"late_cut": "running >1 h late → cut the stroll, then Anchor 2",
"timeline": [
{"t": "08:00-09:15", "what": "Anchor 1", "kind": "anchor", "price": "PLACEHOLDER",
"note": "opens 06:00, first hour is empty", "tag": "opener",
"sub_stops": [
{"name": "Viewpoint A", "query": "Okunoin, Kiyomizu-dera, Kyoto, Japan",
"view": "the whole stage from the far terrace", "stand": "where to stand · which way to face", "walk_min": 3,
"must": true,
"link": "https://www.google.com/maps/search/?api=1&query=Okunoin%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan"},
{"name": "Viewpoint B", "query": "Otowa Waterfall, Kiyomizu-dera, Kyoto, Japan",
"view": "from below, under the wooden stage", "stand": "where to stand · which way to face", "walk_min": 4,
"link": "https://www.google.com/maps/search/?api=1&query=Otowa+Waterfall%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan"}],
"sub_map": "https://www.google.com/maps/dir/?api=1&origin=Okunoin%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan&destination=Otowa+Waterfall%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan&travelmode=walking"},
{"t": "09:15-09:45", "what": "步行 Anchor 1→Anchor 2 0.7 km · 10分(+缓冲)",
"kind": "hop", "verify": "est",
"link": "PLACEHOLDER — per-hop url from route_tools links"},
{"t": "09:45-10:45", "what": "Anchor 2", "kind": "anchor", "price": "PLACEHOLDER",
"hours": {"text": "09:00-17:30 · last entry 17:00", "as_of": "2026-08-01",
"src": "https://example.org/anchor-2-hours"}},
{"t": "10:45-11:00", "what": "步行 Anchor 2→lunch area 0.5 km · 8分", "kind": "hop",
"verify": "est", "link": "PLACEHOLDER"},
{"t": "11:00-12:15", "what": "lunch · food area, not a named restaurant",
"kind": "meal", "tag": "swap→second food area"},
{"t": "12:15-13:00",
"what": "巴士 203(往銀閣寺道) ~25分 ¥230 · 祇園→銀閣寺道 · 下车步行8分",
"kind": "hop", "verify": "est", "link": "PLACEHOLDER"},
{"t": "13:00-14:30", "what": "Anchor 3", "kind": "anchor", "price": "PLACEHOLDER"},
{"t": "14:30-14:40", "what": "步行 Anchor 3→stroll start 0.6 km · 10分",
"kind": "hop", "verify": "est", "link": "PLACEHOLDER"},
{"t": "14:40-15:40", "what": "stroll ~1.5 km — modelled as a stop so it counts",
"kind": "free", "tag": "skippable"}
],
"stops": [
{"name": "Anchor 1", "query": "Kiyomizu-dera, Kyoto, Japan",
"lat": 34.994303, "lon": 135.784439},
{"name": "Anchor 2", "query": "Kodai-ji, Kyoto, Japan"},
{"name": "lunch area", "query": "八坂神社, 京都市東山区"},
{"name": "Anchor 3", "lat": 35.0269, "lon": 135.7984, "mode": "transit"},
{"name": "stroll midpoint", "lat": 35.0227, "lon": 135.7949}
]},
{"date": "2026-10-06", "city": "Kyoto → Osaka", "label": "移动日",
"travel_day": true,
"late_cut": "bags not stored → drop the single anchor",
"timeline": [
{"t": "08:00-09:00",
"what": "checkout · bags to station lockers (fallback: hotel storage + loop back)",
"kind": "free", "note": "large lockers gone by mid-morning in peak season",
"tag": "pinned"},
{"t": "09:15-11:31", "what": "特急/新干线 (往…方向) · A→B · 出口N", "kind": "hop",
"verify": "verified", "note": "verified timetable keeps its exact minutes",
"link": "PLACEHOLDER"},
{"t": "15:00", "what": "check-in — a move day carries ≤2 anchors only if bags are handled before the first; otherwise 1",
"kind": "free", "tag": "pinned"}
],
"stops": []}
],
"hotels": [
{"base": "Kyoto 3 nights", "area": "neighborhood name",
"why": "on the line you actually use · safe after dark · flat pavement for luggage",
"options": [
{"name": "Property 1", "band": "PLACEHOLDER/night",
"link": "https://www.booking.com/searchresults.html?ss=Kyoto&checkin=2026-10-05&checkout=2026-10-08",
"checkout": "11:00 · property FAQ · as of 2026-08",
"bag_hold": "held at the desk until 18:00 · ask at check-in"}
]}
],
"budget": [
{"cat": "flights", "per_person": "PLACEHOLDER", "total": "PLACEHOLDER",
"note": "as of 2026-08-01"},
{"cat": "buffer (10-15%)", "per_person": "PLACEHOLDER", "total": "PLACEHOLDER",
"note": "FX drift + price moves"}
],
"brief": {
"visa": "type · fee · processing days · passport-validity rule",
"emergency": "six lines: local police / ambulance / fire · home consular hotline · nearest mission per base · insurer assistance line + policy no. · lost-passport steps · 24h ER + pharmacy per base — every number as-of",
"safety": "line 0 advisory level · source · as-of, then six lines: named scams · pickpocket hotspots · taxi rule · after-dark avoid list per base · what to do when it happens · legal red lines",
"health": "five lines from one CDC / TravelHealthPro page: vaccines + consult date · vector-borne season · water and food · rabies · notice level + as-of",
"holidays": "collisions from date.nager.at + local festivals",
"weather": "temps · rain odds · daylight · mode (forecast / normals) + as-of",
"money": "five lines: refuse DCC · card FX fee → buffer · ATM fee and cap · cash number · which cards and wallets work (+ origin block)",
"connectivity": "eSIM ballpark · plug type · digital-safety line",
"insurance": "cover floor · exclusions matched by activity name · assistance hotline"
},
"unverified": [
"everything that survived two searches unverified goes here, visibly"
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |