Next.js App Router
対応するバージョンと設定を維持してください。サーバーレンダリングと直接的なサーバー読み取りは適切な場所で優先し、インタラクティブでライブなブラウザ動作が必要な場所ではそのままにしておきます。
コンテキストの確立
package.json、ロックファイル、ルートフォルダ、next.config.*、およびプロジェクトの指示を確認します。インストールされている Next.js/React のバージョン、App Router と Pages Router のどちらを使用しているか、ランタイム/デプロイメントの制約、および Cache Components が有効かどうかを特定します。モノレポでは、影響を受けるアプリからこれらを解決します。単に例に合わせるためだけにパッケージをアップグレードしたり機能を有効にしたりしないでください。
利用可能な場合は、Next.js 16.2+ で node_modules/next/dist/docs/ にバンドルされているバージョンに一致したドキュメントを優先します。それ以外の場合は、対応するバージョンの公式ドキュメントを参照してください。ライブドキュメントは新しいマイナーバージョンを説明している可能性があります。API のバージョン履歴と設定を確認してから使用してください。安定した API、実験的なオプション、非推奨、およびプロジェクトの慣習を区別してください。
関連するリソースの選択
タスクに必要なリソースのみを読み取り、バージョンや動作が不確かな場合は公式リンクに従ってください。
| タスク | リソース |
|---|---|
| サーバー/クライアントの境界、構成、シリアル化 | Server Components |
| 読み取り、ストリーミング、ブラウザデータ、アクション、HTTP エンドポイント | Data fetching |
| 既存のキャッシュモード、Cache Components、プライベート/リモートキャッシュ、無効化 | Caching |
| レイアウト、動的ルート、検索、パラレル/インターセプトルート | Routing |
| リクエストのリダイレクト/リライトと楽観的な認証ゲート | Proxy |
| 想定されるエラー、ローディング、リカバリ、404 レスポンスセマンティクス | Error handling |
| メタデータのエクスポート、継承、SEO 統合 | Metadata |
| 画像/フォントの設定とロードのトレードオフ | Assets |
| Pages から App への段階的移行 | Migration |
| 意図的なメジャー/マイナーアップグレード | Version changes |
決定の優先順位付け
- シークレットとユーザーデータを保護します。データの近くで読み取り/ミューテーションを認証および承認し、信頼できない入力を検証し、個人データが誤って共有されたキャッシュに入らないようにします。プロキシと UI の可視性だけでは不十分な認証です。
- バージョンとレンダリングモード間で正確性を維持します。非同期リクエスト API、キャッシュの前提条件、ルート規則、およびリカバリプロパティは、インストールされているバージョン/設定に依存します。
- 実証されたウォーターフォールと不要なクライアントコードを削除します。独立した作業を並列化し、有用な UI を維持する Suspense 境界を選択します。クライアントフェッチは、ポーリング、ブラウザのみの状態、およびインタラクティブな更新のために適切なままです。
- キャッシュ、プリフェッチ、およびアセットヒントを、フレッシュネス、デプロイメント、および測定された動作に合わせて調整します。これらはすべての App Router アプリの前提条件ではなく、選択です。
サーバー専用の作業には Server Components を使用します。インタラクションのために有用なモジュール境界で 'use client' を追加します。これはリーフである必要はありません。UI ミューテーションには適切な場合に Server Action を、HTTP コントラクト（ブラウザクライアントを含む）には Route Handler を使用します。どちらも認可の代わりにはなりません。
実際の変更の検証
利用可能な場合は、影響を受けるアプリの既存の型チェック、リント、およびビルドコマンドを実行します。失敗する可能性のある動作をテストします：認証された直接リクエスト、ユーザー間の分離、ミューテーション後のフレッシュネス、ハード/ソフトナビゲーション、エラー、およびローディング。インポート、認証ヘルパー、または永続性がプレースホルダーである場合に、スニペットをプロダクション対応と呼んではいけません。何を実行し、何が未テストのままかを明記します。
レビューの場合は、修正可能な障害とそのバージョン/設定範囲を先頭に挙げます。オプションの改善と正確性の問題を区別します。実装の場合は、選択した境界/キャッシュモード、変更された動作、および検証について説明します。
ソースレビューは範囲が限定されており、包括的な認定ではありません。正規のリンク、該当するバージョン/設定、確認済みのセクション、上流の日付、およびフレッシュネスポリシーについては、SOURCES.md を参照してください。リポジトリのパイロットレビュー/評価記録はメンテナンスの証拠であり、実行時には必要ありません。