Track HiveGrid Cloud planning reference

hivegrid-cloud/packages/ui/docs/migration.md

@@ -0,0 +1,25 @@
+# UI Adapter Migration
+
+`@toolctrl/ui` is the package boundary for future UI primitive ownership. Phase 11 only establishes the boundary; it does not migrate existing app imports.
+
+## Category Checklist
+
+For each category:
+
+1. Inventory current app-level primitives and third-party dependencies.
+2. Pick a stable export name and props contract before moving implementation.
+3. Add the implementation under the matching `packages/ui/src/<category>.ts` entrypoint or a category-owned folder.
+4. Add package-level tests or type assertions when the export becomes non-trivial.
+5. Migrate app imports in a separate phase after the package API is reviewed.
+
+## Boundaries
+
+- `buttons`
+- `inputs`
+- `dialogs`
+- `tables`
+- `layout`
+- `navigation`
+- `feedback`
+
+Do not mix app route behavior, data loading or feature-specific orchestration into this package. Keep this layer focused on reusable UI primitives and adapter contracts.