背景

TryCheckは当初、CakePHPで開発していました。

しかし現在、PHPフレームワークのシェアはLaravelが優勢になっています。

今後開発メンバーが増えた場合の保守性や採用難易度を考えると、Laravelへ移行した方が長期的に有利だと以前から考えていました。

とはいえ、

移行コストが大きそう
既存コードの理解が重い
影響範囲が読めない

といった理由から、なかなか踏み出せずにいました。

実際には、最初は「本当に移行できるのか？」という半信半疑の状態からスタートしました。

実践したこと

今回、AI開発エージェント（Claude Code）を併用して移行を進めたところ、想像以上に現実的な作業量で前に進められました。

この記事では、実際の移行作業を整理しながら、

AIはどこで役に立ったのか
何が楽になったのか
気をつけるべきポイント

を実体験ベースでまとめます。

なぜAIを使ったのか

今回の方針はシンプルです。

CakePHPからLaravelへ移行したい

とAIに伝え、依存関係の整理や修正方針の候補を出してもらい、こちらで判断して進める方式にしました。

Claude Codeはリポジトリ全体を解析し、

依存関係
ルーティング構造
認証構造
DB設計

を横断的に把握し、移行時の判断材料を提示してくれます。

例えば、Controller間の依存関係や未使用処理の候補なども提示され、移行順序を決める際の判断材料になりました。

実際の流れ：

AIが修正方針や候補を提示
AIが移行コードを生成・修正
内容確認
承認して反映
疑問点のみ質問

AIは設計レビューやリサーチだけでなく、実際の移行コード生成や修正作業も担当しました。
ただし最終的な判断と確認は人間側で行う、という役割分担で進めました。

何をしたか（移行フェーズまとめ）

① 移行の土台づくり

Laravelベース構成作成
レイアウト／フロント基盤整備
CSSリセット・フォント統一
CakePHPフロント統合
DBスキーマ移行

② ルーティング・テンプレ・認証統合

API Routes / Web Routes統合
Bladeテンプレート移行
Laravel Auth + Sanctum導入
CakePHP互換認証構築
フォーム修正

③ セキュリティと運用面

CAPTCHA実装
エッジケース修正
バリデーション整理
既存不具合修正

④ 移行完了整理

仕様書更新
ドキュメント整理
移行完了明文化

AIなし vs AIあり（体感）

最大の差は 全体把握と移行コスト でした。

AI開発エージェントの利用では、

全体像把握が高速化される
差分抽出が早くなる
反復修正が楽になる

結果として「移行そのものの重さ」はかなり軽くなったと感じています。

項目	従来移行	AI移行
全体理解	数週間	数時間
移行作業	1週間	1日
差分把握	手作業	即時
心理的障壁	高い	低い

Claude Codeが役に立ったポイント

既存コードの読み解きが速い
依存関係や影響範囲の把握がスムーズ。
移行時の修正パターンが整理できる
ルーティング、テンプレ、認証の差分が俯瞰できる。
細かい修正の反復がラク
UI調整や軽微な修正を高速に回せる。

移行で苦労したこと①：構造差の理解

AIによる移行自体はスムーズでしたが、設計思想の差をこちらが理解するのに少々手こずりました。
以下に、CakePHPとLaravelの差を列挙します。

ORM思想の違い

CakePHP：Tableオブジェクト中心
Laravel：Model中心（Eloquent / Active Record）

CakePHPはTableクラスがクエリ発行やバリデーションの主役となることが多いですが、LaravelのEloquentはモデルインスタンスそのものがデータ操作の責務を持つActive Recordパターンです。この「ロジックを置く場所」の思想が異なるため、単純な置換では対応できませんでした。

Middleware構造

Laravelでは、認証や認可、ログなどの処理がMiddlewareへ明確に分散されます。

CakePHPにもMiddlewareは存在しますが、既存の構成（特に旧バージョンからの慣習）ではControllerの beforeFilter などに処理が集中しがちです。Laravelへの移行にあたっては、Controller中心の設計から、責務を各層へ分離させる構造へマインドセットを切り替える必要がありました。

認証構造

CakePHP：AuthComponent（旧）／Authentication plugin中心
Laravel：Guard / Provider / Middleware の多層構造

CakePHPではComponentが担っていた役割が、Laravelでは「どう認証するか（Guard）」と「どこからユーザーを取得するか（Provider）」に分離されています。この多層的な構造を正しく理解し、Laravelの流儀に合わせることが、移行作業において特に重要でした。

移行で苦労したこと②：AIがこちらの指示を素直に聞きすぎる

Claude Codeで開発をしているとついつい漫然とエンター連打で編集を承認しがちになります。

しかし、AIもたまに困った提案をしてくるので承認前にきちんと目を通しましょう。

事例１：セキュリティを犠牲にして動かそうとする

主にミドルウェア周りで、「この提案、確かに動くようになるけど、セキュリティが犠牲になのでは？」という提案を何度かされました。

おそらくこちらが「なんとか動かして欲しい」と提案すると、セキュリティ問題よりも「動くこと」を優先してしまうのでしょう。

事例２：フロントのチラつきの多発

分岐として、「未ログインユーザだったら非表示」というケースだとします。

この際に、一度表示→未ログインだから非表示、と言うフローを提案され、フロントがちらつくと言う事例が多発しました。

これについても「非表示にして」しか指示を出しておらず、AIがそれを素直に聞いてしまったことによるものと思われます。

対策：claude.mdに明記する

あれ？と思ったら都度、下記のようにclaude.mdに追記していきましょう。

セキュリティを犠牲にした編集は行わないこと
フロントのチラつきには常に留意すること

ただし明記してもおかしな挙動は0にはならないので、AIの提案内容の確認はきちんと行いましょう。

Claude Code利用時の注意

レートリミット

長時間連続利用は制限に注意が必要です。

対策：

1タスク = 作業は小さく分割する

コンテキスト圧縮後のズレ

長いセッションでは文脈がズレることがあります。

対策：

1タスク = 1コンテキスト

AI開発エージェントを使って感じた本質

従来：

全体理解だけで1週間
大量手作業でエラーが大量発生

AI開発エージェント利用：

全体像把握高速化
差分抽出即時化
修正反復可能、エラーも最小限

AIはコード生成や修正も担ってくれましたが、
実際に最も大きな変化を感じたのは、
既存システムの理解コストを劇的に下げてくれた点でした。

今後、レガシー移行は「大規模プロジェクトだから難しい」のではなく、
AIを前提にどう進めるかが重要になると感じています。

まとめ

CakePHP→Laravel移行はAI開発エージェントの利用でかなり容易になる
Claude Codeは読み解き・実装・修正すべてで有効
フレームワーク移行の心理的障壁は下がる

レガシー移行に悩んでいる場合、AI開発エージェントの利用は非常に有効な選択肢だと思います。

参考

Laravel Documentation
https://laravel.com/docs

Authentication
https://laravel.com/docs/10.x/authentication

Eloquent ORM
https://laravel.com/docs/10.x/eloquent

おまけ

本記事で触れた移行を経て、フィードバックツール「TryCheck」を先日公開しました。

CakePHPからLaravelへの移行やAI開発エージェントの知見も、このプロダクト開発の中で得られたものです。

もし興味があれば、こちらもご覧いただけると嬉しいです。
https://trycheck.jp/