Next.js: next upgrade --agent でコーディングエージェントにバージョンアップを任せる
Next.js 16.4 で追加された npx next@canary upgrade --agent=latest は、手元のNext.jsバージョンに合わせた移行ガイド・codemod・検証手順をコーディングエージェントに渡し、アップグレード作業を任せやすくする。
どんな時に使う？
- メジャー/マイナーアップデートのたびに、リリースノートと移行ガイドを読み比べて手作業で直している
- Claude Code / Cursor 等にアップグレードを頼みたいが、古い知識で間違った書き換えをされるのが怖い
手順
- 作業ブランチを切る（
git switch -c chore/next-upgrade） - エージェントのセッション内、またはターミナルで実行:
bash
npx next@canary upgrade --agent=latest - 出力されたガイド・codemod・検証手順に沿ってエージェントに作業させる
- 最後に
next build/ テスト / 主要画面の動作確認をエージェントに実行させ、PRで差分をレビュー
注意点
- 投稿時点では canary 経由の新機能（Next.js 16.4）。フラグ名・挙動は変わる可能性があるので公式ブログ/ドキュメントで確認。
- 自動化しても、最終的な差分レビューと動作確認は人間が行う。アップグレード先は各系列の最新パッチにする。