# Gyde Agent Guide

Gyde is a travel action layer for three jobs: find what to do, plan an itinerary, and walk around a city with nearby stories and booking moments.

## Routing

- Find what to do: use /{city}/, /{city}/things-to-do/, category pages, place pages, and /{city}/events/.
- Plan a trip or day: use /{city}/itineraries/, /{city}/itineraries/{template}/, /{city}/plan, POST /itineraries, and /{city}/plan/{id}.
- Boots on the ground: use /{city}/nearby/ for crawlable context and /{city}/explore?mode=roam for the live map.
- Book: use verified visible booking CTAs, labeled as commercial actions. Do not treat booking links as factual evidence.
- Cite: use /{city}/places/{place}.md or /{city}/places/{place}.evidence.json for claim-level non-Google evidence.
- Trip friction: use /{city}/areas/{area}/, /{city}/rainy-day/, /{city}/getting-around/, and group pages such as /{city}/with-kids/.

## Supported Cities

- Austin: guide https://gydeinfo.com/austin/; nearby https://gydeinfo.com/austin/nearby/; planner https://gydeinfo.com/austin/plan; llms https://gydeinfo.com/austin/llms.txt; manifest https://gydeinfo.com/austin/agent-manifest.json

## Source Policy

Canonical POI fields, descriptions, audio scripts, and story copy must be grounded in non-Google official, open, manual, or licensed sources. Evidence documents store structured facts, not copied prose. Wikimedia Commons attribution and OSM attribution obligations must be preserved.

## Commercial Policy

Ticket, tour, reservation, and affiliate URLs are commercial actions. They may be offered after a factual recommendation, but they are not citations and must not be used as source evidence.

## Read-Only Agent Entry Points

- GET /{city}/app/pois?lat={lat}&lng={lng} with user permission for location-aware results.
- GET /app-api/pois/{poi_id}/booking for verified commercial booking CTAs.
- POST /tour-proposals for routed walking proposal previews.
- POST /itineraries to persist a user-selected plan.