Roadtrip Navigator

# RoadTrip Navigator

Turn **"start + days"** or **"an existing route"** into a road trip you can
actually drive: paced into days, with overnight stops, fuel/charging, park
reservations, seasonal road risks, and a map-first single-file HTML page.

North American road trips revolve around the **car**, not flights: *how many
hours do we drive today, where do we sleep, will we make it on the fuel/charge
we have, and is the road even open.* That focus is what this skill adds on top
of a generic "list of attractions."

## When to use

Use this skill whenever the request is about driving a multi-stop trip in the
US / Canada / Mexico (see `read-when` triggers). If the user only wants a single
city guide or a flight itinerary, this is not the right skill.

## Two entry modes

Detect the mode up front (see `scripts/helper.py` for the heuristic):

- **Light mode (plan it for me):** user gives a start, a rough region or
  destination, day count, and party/vehicle. → Run the full 7-step workflow,
  designing the route yourself.
- **Heavy mode (verify my route):** user pastes/links/screenshots an existing
  route. → Skip route invention. Parse their route into the schema, then
  *verify and fill gaps*: driving segmentation, overnight realism, fuel/charge
  coverage, reservation countdown, seasonal closures, and produce the page.

When unsure which mode, ask one short question. Otherwise infer and proceed.

## The five things that make this more than a list