메뉴
Upgrade Next.js to the latest version following official migration guides and codemods
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | next-upgrade |
| description | Upgrade Next.js to the latest version following official migration guides and codemods |
| argument-hint | [target-version] |
Upgrade the current project to the latest Next.js version following official migration guides.
Detect current version: Read package.json to identify the current Next.js version and related dependencies (React, React DOM, etc.)
Fetch the latest upgrade guide: Use WebFetch to get the official upgrade documentation:
Determine upgrade path: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).
Run codemods first: Next.js provides codemods to automate breaking changes:
npx @next/codemod@latest <transform> <path>
Common transforms:
next-async-request-api - Updates async Request APIs (v15)next-request-geo-ip - Migrates geo/ip properties (v15)next-dynamic-access-named-export - Transforms dynamic imports (v15)Update dependencies: Upgrade Next.js and peer dependencies together. Use the project's package manager (check for bun.lock, pnpm-lock.yaml, or package-lock.json):
# Bun (this project)
bun add next@latest react@latest react-dom@latest
# npm fallback
npm install next@latest react@latest react-dom@latest
Review breaking changes: Check the upgrade guide for manual changes needed:
next.config.jsUpdate TypeScript types (if applicable):
# Bun (this project)
bun add -d @types/react@latest @types/react-dom@latest
# npm fallback
npm install @types/react@latest @types/react-dom@latest
Test the upgrade:
bun run build (or npm run build) to check for build errorsbun run dev (or npm run dev) and test key functionalitySQLAlchemy-first DB patterns, Alembic migrations, ParentChildEdges partition handling, and UDF policy
FastAPI + SQLModel conventions, request dependencies, transaction safety, and backend architecture
Next.js best practices - RSC boundaries, data patterns, async APIs, error handling, route handlers, directives, runtime selection
Auth0 scopes, recaptcha verification, and share/edit token security patterns
CMS editing/review workflows, TipTap extensions, and comment moderation
docker-compose topology, env files, local container workflows, and quality-gate commands