first commit

api/docs/README.md

@@ -0,0 +1,13 @@
+# /api/docs
+
+API-specific documentation. Scoped to the proxy — anything that only affects the server side lives here.
+
+Put here:
+
+- Endpoint request/response schemas (per role, §4)
+- Model routing table (role → model, per environment)
+- Deploy notes (localhost → homelab VPS → fly.io, §4)
+- Logging/eval-replay format (§10)
+- Auth/metering design when it lands (§4)
+
+Cross-cutting design (anything touching both client and api) goes in the root [`/docs`](../../docs), not here.