docs: Instant Navigations migration plan and agent DX groundwork

AGENTS.md

@@ -29,6 +29,21 @@ Cursor rules to apply (see each file for full wording):
 
 **Project rules:** See **`.cursorrules`** for stack, architecture, tRPC/Redux boundaries, styling (MUI + Emotion, no Tailwind), testing conventions, and feature workflow. **`.cursor/rules/*.mdc`** adds always-on style rules (React hook imports, type imports, `useEffect` comments).
 
+### Instant Navigations (Next.js 16.3) — not on Pages Router yet
+
+dStruct is **Pages Router only** (`src/pages/`). **Instant Navigations** (`cacheComponents`, `partialPrefetching`, `'use cache'`, `unstable_instant`, Instant Insights) requires the **App Router** (`src/app/`). Do not enable `cacheComponents` or add `'use cache'` under `src/pages/`.
+
+Before implementing Instant Navigations, read:
+
+- `vibe-docs/Instant-Navigations-Design.md` — phased migration plan (i18n, Vercel 16.3 gate, route priorities)
+- `node_modules/next/dist/docs/01-app/02-guides/instant-navigation.md`
+- `node_modules/next/dist/docs/01-app/02-guides/migrating-to-cache-components.md`
+- `node_modules/next/dist/docs/01-app/03-api-reference/05-config/01-next-config-js/cacheComponents.md`
+
+**16.3 on Vercel:** stay on the pinned `next` version in `package.json` until preview `/api/*` routes return correct `x-matched-path` (not `/en/404`). See design doc Phase 1.
+
+**Pilot order when migrating:** marketing routes (`/`, `/privacy`, `/daily`) under `app/[lang]/` before `/playground`.
+
 ## Cursor Cloud specific instructions
 
 ### Services overview

CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.

package.json

@@ -51,62 +51,62 @@
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",
     "@datastructures-js/priority-queue": "5.3.0",
-    "@datastructures-js/queue": "4.2.1",
+    "@datastructures-js/queue": "4.3.0",
     "@emotion/cache": "^11.14.0",
     "@emotion/react": "^11.14.0",
     "@emotion/server": "^11.11.0",
     "@emotion/styled": "^11.14.1",
     "@hello-pangea/dnd": "^18.0.1",
     "@monaco-editor/react": "^4.7.0",
-    "@mui/icons-material": "^9.0.1",
-    "@mui/lab": "9.0.0-beta.3",
-    "@mui/material": "^9.0.1",
-    "@mui/x-charts": "^9.3.0",
+    "@mui/icons-material": "^9.2.0",
+    "@mui/lab": "9.0.0-beta.6",
+    "@mui/material": "^9.2.0",
+    "@mui/x-charts": "^9.10.1",
     "@next-auth/prisma-adapter": "1.0.7",
-    "@prisma/adapter-pg": "^7.8.0",
-    "@prisma/client": "7.8.0",
+    "@prisma/adapter-pg": "^7.9.1",
+    "@prisma/client": "7.9.1",
     "@react-three/drei": "^10.7.7",
-    "@react-three/fiber": "^9.5.0",
+    "@react-three/fiber": "^9.7.0",
     "@reduxjs/toolkit": "^2.11.2",
-    "@tanstack/react-query": "^5.100.11",
-    "@trpc/client": "11.17.0",
-    "@trpc/next": "11.17.0",
-    "@trpc/react-query": "11.17.0",
-    "@trpc/server": "11.17.0",
-    "@upstash/redis": "^1.37.0",
+    "@tanstack/react-query": "^5.101.4",
+    "@trpc/client": "11.18.0",
+    "@trpc/next": "11.18.0",
+    "@trpc/react-query": "11.18.0",
+    "@trpc/server": "11.18.0",
+    "@upstash/redis": "^1.38.1",
     "@vercel/analytics": "^1.6.1",
-    "@vercel/edge-config": "^1.4.3",
+    "@vercel/edge-config": "^1.5.0",
     "@vercel/speed-insights": "^1.3.1",
     "@zumer/snapdom": "^2.23.1",
     "aws-sdk": "^2.1693.0",
-    "axios": "1.16.1",
+    "axios": "1.19.0",
     "clsx": "^2.1.1",
     "cookie": "^1.1.1",
     "cookies-next": "^6.1.1",
     "formik": "^2.4.9",
     "graphql": "16.14.0",
-    "joi": "^18.1.2",
-    "monaco-editor": "^0.55.1",
-    "next": "16.2.6",
-    "next-auth": "4.24.14",
+    "joi": "^18.2.3",
+    "monaco-editor": "^0.56.0",
+    "next": "16.2.12",
+    "next-auth": "4.24.15",
     "notistack": "^3.0.2",
     "overlayscrollbars": "^2.14.0",
     "overlayscrollbars-react": "^0.5.6",
     "pyodide": "^0.29.3",
-    "react": "19.2.6",
-    "react-dom": "19.2.6",
+    "react": "19.2.8",
+    "react-dom": "19.2.8",
     "react-redux": "^9.3.0",
-    "react-resizable-panels": "^4.11.1",
-    "react-virtuoso": "^4.18.7",
+    "react-resizable-panels": "^4.12.2",
+    "react-virtuoso": "^4.18.11",
     "redux": "^5.0.1",
     "redux-logger": "^3.0.6",
-    "sanitize-html": "^2.17.3",
-    "sharp": "^0.34.5",
+    "sanitize-html": "^2.17.6",
+    "sharp": "^0.35.3",
     "short-uuid": "^6.0.3",
     "slugify": "^1.6.9",
     "superjson": "2.2.6",
     "symbol-observable": "^4.0.0",
-    "three": "^0.183.2",
+    "three": "^0.185.1",
     "three-stdlib": "^2.36.1",
     "typesafe-i18n": "^5.27.1",
     "yup": "^1.7.1",
@@ -119,7 +119,7 @@
     "@graphql-codegen/typescript": "^4.1.6",
     "@graphql-codegen/typescript-operations": "^4.6.1",
     "@graphql-codegen/typescript-react-apollo": "^4.4.1",
-    "@next/eslint-plugin-next": "^16.2.6",
+    "@next/eslint-plugin-next": "^16.2.12",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@testing-library/dom": "^10.4.1",
@@ -131,11 +131,11 @@
     "@types/babel__traverse": "^7.28.0",
     "@types/minimist": "^1.2.5",
     "@types/node": "^22.19.17",
-    "@types/react": "^19.2.15",
-    "@types/react-dom": "^19.2.3",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
     "@types/redux-logger": "^3.0.13",
     "@types/sanitize-html": "^2.16.1",
-    "@types/three": "^0.173.0",
+    "@types/three": "^0.185.3",
     "@types/uuid": "^10.0.0",
     "@vitejs/plugin-react": "^5.2.0",
     "@vitest/coverage-v8": "5.0.0-beta.3",
@@ -145,9 +145,9 @@
     "dotenv": "^17.4.0",
     "es-guard": "^1.20.0",
     "esbuild": "^0.28.1",
-    "eslint": "^10.4.0",
+    "eslint": "^10.8.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-prettier": "^5.5.6",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-testing-library": "^7.16.2",
     "gltfjsx": "^6.5.3",
@@ -156,15 +156,15 @@
     "lint-staged": "^15.5.2",
     "minimist": "^1.2.8",
     "next-router-mock": "^1.0.5",
-    "prettier": "3.8.3",
-    "prisma": "7.8.0",
+    "prettier": "3.9.6",
+    "prisma": "7.9.1",
     "raw-loader": "^4.0.2",
     "resize-observer-polyfill": "^1.5.1",
-    "sass": "1.90.0",
-    "semantic-release": "^25.0.3",
-    "tsx": "^4.21.0",
+    "sass": "1.102.0",
+    "semantic-release": "^25.0.8",
+    "tsx": "^4.23.5",
     "typescript": "6.0.3",
-    "typescript-eslint": "^8.59.4",
+    "typescript-eslint": "^8.66.0",
     "vite": "^6.4.2",
     "vitest": "5.0.0-beta.3",
     "vitest-canvas-mock": "^1.1.4"