Files
svc-nav/docs/GUIDELINES.md
mikkeli 084960e41e Adopt designed front matter: typed, with staleness on plans
Replaces `type: default` — one value across every document, read by nothing,
so it discriminated nothing. Types are now reference, guidelines, plan and
report, applied to every markdown file with no exceptions for the hub.

Plans carry status and updated, reports carry date. REPOS.md already noted
that plans go stale and reports do not, but nothing made that visible: a plan
from months ago looked identical to one written today.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013kj58Jugkic783b8ZrtTVZ
2026-09-04 14:14:18 +09:00

19 lines
679 B
Markdown

---
type: guidelines
---
# Navigation service guidelines
## 1. Routing providers stay behind one interface
- Nothing outside the provider boundary may reference Valhalla types, Valhalla
URLs, or Valhalla's response shapes.
- A cloud provider (GCP or equivalent) must be addable without changes to the
bridge, the published topics, or any display.
- Local Valhalla is the default because it works with no signal; a cloud provider
is an option, never a dependency.
## 2. Guidance is published, routes are requested
- Live guidance goes onto `yukart/nav/guidance`, retained.
- Route requests are request/response and are served over HTTP, not MQTT.
## 3. To be added