【結論】解決策 / 実行コマンド
新規プロジェクトではClaude Codeに構成を推測させる前に、フレームワーク公式ジェネレーターで土台を作る方が再現性があります。
既存プロジェクトの移動では、構成案、依存関係、import更新、テストを段階的に実行します。
# ターミナルで実行：Next.js公式ジェネレーターで初期化
npx create-next-app@latest my-app --typescript
cd my-app
# ターミナルで実行：基準点を保存
git init && git add . && git commit -m "chore: initialize project"
# ターミナルで実行：計画モードで起動
claude --permission-mode plan具体的な手順・設定方法
現状の責務と依存方向を調査し、移動候補一覧を作ります。
一度に全体を動かさず、機能またはディレクトリ単位で移行します。
移動後にimport、テスト、ビルド、ルーティングを確認します。
実践プロンプト / 活用テクニック
# 起動後のセッション内で入力
現在のsrc構成を調査し、責務の重複と循環依存を報告してください。
まだファイルは移動しないでください。
移行案には旧パス、新パス、修正が必要なimport、検証コマンドを含めてください。注意点・よくあるエラーと対処法
「ベストな構成」は規模、チーム、フレームワークで異なります。
ファイル移動はGit履歴、設定、テストfixture、動的importを壊す場合があります。
生成物や依存ディレクトリは通常Git管理外ですが、存在しない.claudeignoreを必須設定として案内しないでください。