baserCMS プラグイン バージョン移行ガイド（5.2 → 5.3）

baserCMS プラグインを 5.2系 から 5.3系へ移行する際に遭遇した baserCMS 固有の問題と修正レシピ集。バージョン別に整理して育てる。

推奨: 着手前に一度 basercms5-claude-workflow-setup（環境セットアップ）を参照し、進め方の環境（設計=superpowers brainstorming／権限整理=permissions-audit／その上での Auto mode／spec・plan の Markdown プレビュー）を整える。提案ベースで、整っていればスキップ。

収録: 5.2 → 5.3。5.3系は PHP 8.5 / CakePHP 5.2.x ベース（執筆時点で開発中）。 役割分担:

• PHP 本体起因（暗黙nullable・動的プロパティ・非正規キャスト・setAccessible・null オフセット等）→ php-migration スキル
• CakePHP 本体／関連パッケージ起因（AbstractMigration→BaseMigration・イベント戻り値・PluginCollection・TreeBehavior・ResultSet・order()/group() 等）→ cakephp-migration スキル
• ユニットテストの実行・集計・切り分け手順 → basercms-unittest スキル
• 本書は上記に当てはまらない baserCMS 固有 + プラグインのテスト基盤 に絞る。

大原則