Next.js Upgrade Protocol

Automated and manual migration steps for Next.js version upgrades (e.g., v14 to v15).

Priority: P1 (OPERATIONAL)

Workflow: Upgrade Next.js to New Major Version

1. Check current versions of next, react, react-dom in package.json
2. Plan incremental path (e.g., v13 -> v14 -> v15; never skip majors)
3. Run codemods: npx @next/codemod@latest <transform> <path>
4. Update dependencies: See implementation examples
5. Verify async APIs: ensure cookies(), headers(), params awaited (v15+)
6. Audit fetch caching: v15 defaults to no-store; add force-cache where needed
7. Run next build and fix hydration or Turbopack errors
8. Report codemod failures or manual fixes to team

Implementation Guidelines