Track HiveGrid Cloud planning reference

hivegrid-cloud/docs/route-inventory.md

@@ -0,0 +1,24 @@
+# Route Inventory
+
+The web route inventory gate keeps route growth visible without pretending optional modules have been extracted.
+
+This document records the checked budget snapshot, not a route source of
+truth. For route changes, update the generated/typed inventory and rerun the
+verification command below before changing this prose.
+
+Surfaces:
+
+- `admin`: default-enabled admin host routes.
+- `tenant`: default-enabled tenant app routes.
+- `public_help_docs_internal`: core public, docs, help, health, auth, and internal utility routes.
+- `optional`: physically present routes for optional module surfaces such as workflows, portals, CRM, email marketing, AI, and knowledge base.
+
+Classifications:
+
+- `core`: required public/system routes.
+- `default-enabled`: admin and tenant routes shipped in the default app profile.
+- `optional`: optional module routes kept in the repository but tracked separately.
+
+Run `pnpm run verify:route-inventory` after route additions or removals. Budget increases should be intentional and reviewed with the surface that grew.
+
+Snapshot 2026-05-26: budgets match the current default-enabled route topology exactly for `admin` (166), `tenant` (77), and `public_help_docs_internal` (58). `optional` stays capped at 208 and `total` at 470, so new route growth must still be explicit.