Scaffold repo: docs layout, guidelines and initial plan

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013kj58Jugkic783b8ZrtTVZ
2026-09-03 18:48:32 +09:00
commit 570a8c541d
4 changed files with 71 additions and 0 deletions
@@ -0,0 +1,18 @@
+---
+type: default
+---
+# 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