docs: add staged build verification steps to migration prompt Phase 4

Static checks (lint, build, tsc) alone cannot catch runtime failures such as
ESM module eager evaluation, .env loading issues, and Docker path resolution
problems — all of which were discovered during v3 implementation (documented
in .kiro/specs plan.md task 12).

Add Phase 4-3 with progressive verification stages:
- 4-3a: lint → build (static checks)
- 4-3b: local Docker image build + docker run artifact inspection
- 4-3c: local migration execution against real DSQL cluster
- 4-3d: local dev server + browser verification

Also fix Phase 3 checkpoint ordering to lint → build (detect DSQL
incompatible patterns before attempting build).

Author: konokenj

.serverless-full-stack-webapp-starter-kit/docs/v3.0.0/migration-prompt.ja.md

@@ -248,8 +248,8 @@ bash scripts/dsql.sh delete --region <region>
 
 ### チェックポイント
 
-- `pnpm run build` が終了コード 0
 - `pnpm run lint` が終了コード 0（oxlint が DSQL 非互換パターンを検出しないことを確認）
+- `pnpm run build` が終了コード 0
 - Prisma の import が残っていない（`rg '@prisma|from.*prisma' --type ts` が結果なし）
 - 開発用 DSQL クラスタでマイグレーションが成功し、アプリが動作する
 
@@ -277,6 +277,68 @@ webapp と async-job の Dockerfile を v3 のパターンに更新する。v3 
 - `cd apps/cdk && pnpm run build` が終了コード 0
 - `pnpm run test` が終了コード 0（CDK テストがある場合）
 
+### 4-3. 段階的ビルド・動作確認
+
+静的チェック（lint, build, tsc）だけでは不十分。ESM モジュールの即時評価、環境変数の読み込み、Docker 内のパス解決、Lambda ランタイムの挙動など、ビルドが通っても実行時にクラッシュする問題が多い。以下の順序で段階的に検証し、各段階で問題を発見・修正してから次に進むこと。
+
+#### 4-3a. lint → build
+
+```bash
+pnpm run lint
+pnpm --filter webapp run build
+cd apps/cdk && pnpm run build
+pnpm run test   # CDK テストがある場合
+```
+
+#### 4-3b. ローカル Docker イメージビルド
+
+Dockerfile が正しく動作するか、CDK を通さずに直接確認する。pnpm workspaces + Docker の組み合わせは罠が多い（`--filter` の推移的依存解決、`.dockerignore` の読み込み、esbuild の外部パッケージ解決）。
+
+```bash
+# async-job
+docker build --platform linux/arm64 -f apps/async-job/Dockerfile -t test-async-job:local .
+docker run --rm --entrypoint /bin/sh test-async-job:local -c "ls -la /var/task/"
+
+# dsql-migrator
+docker build --platform linux/arm64 -f apps/cdk/lib/constructs/dsql-migrator/Dockerfile -t test-migrator:local .
+docker run --rm --entrypoint /bin/sh test-migrator:local -c "ls -la /var/task/ && cat /var/task/migrations/*.sql"
+
+# webapp（CodeBuild で実行されるため手元では省略可。ただし Dockerfile の構文エラーは確認できる）
+docker build --platform linux/arm64 -f apps/webapp/Dockerfile -t test-webapp:local .
+```
+
+確認事項:
+- esbuild の出力が `.mjs` 拡張子であること
+- `@aws/aurora-dsql-node-postgres-connector` がバンドルに含まれていること（`--external:@aws-sdk/*` で除外されないこと）
+- migrations/ ディレクトリが正しくコピーされていること
+
+CDK と同じビルドプロセスを再現する場合は `cdk synth` 後に `cdk.out/manifest.json` → `dockerImages` でアセットハッシュを取得し、`cd cdk.out/asset.<hash> && docker build --platform linux/arm64 -f <Dockerfile相対パス> -t test:local .` でビルドできる。
+
+#### 4-3c. ローカルマイグレーション実行
+
+実際の DSQL クラスタに対してマイグレーションを実行する。ビルドが通っても、ESM モジュールの即時評価や `.env` の読み込みでクラッシュする可能性がある。
+
+```bash
+pnpm --filter @repo/db run migrate
+```
+
+確認事項:
+- マイグレーションが成功し、`_migrations` テーブルにレコードが挿入されること
+- 再実行で冪等（既に適用済みのマイグレーションがスキップされること）
+
+#### 4-3d. ローカルデバッグサーバー + ブラウザ確認
+
+`apps/webapp/.env.local` に実際の Cognito / DSQL / AppSync の値を設定し、ローカルサーバーを起動してブラウザで操作する。
+
+```bash
+cd apps/webapp && pnpm run dev
+```
+
+確認事項:
+- サインインページが表示されること
+- Cognito Managed Login でログインできること
+- Todo の CRUD（作成・完了・編集・削除）が動作すること
+
 ## Phase 5: データベース移行（Aurora Serverless v2 → DSQL）
 
 このフェーズはデータ損失を防ぐため段階的な CDK デプロイが必要。**Phase 5-1 と 5-3 の2回のデプロイを1回にまとめないこと** — RETAIN を設定せずに Aurora v2 リソース定義を削除すると、CloudFormation がクラスタを削除し本番データが失われる。Phase 5-1 で RETAIN を設定してから初めて、Phase 5-3 でリソース定義を安全に削除できる。