ue5-architecture

クイックスタート

• 現在のモジュール一覧、*.Build.cs、主要なゲームプレイ／UI システムを収集します。
• コードを書く前に、目標とするモジュールグラフを 1 つ提案します。
• モジュールの責任範囲と所有権を表にまとめます。

ワークフロー

• 現在のコードベースから、ランタイム、エディター、UI、ネットワーキング、データの各モジュールを特定します。
• 各モジュールの Public API を、最小限のヘッダーと Blueprint サーフェスとして定義します。
• Private の実装境界とインクルード規則を定義します。
• モジュールごとに PublicDependencyModuleNames と PrivateDependencyModuleNames を定義します。
• 循環インクルード、リフレクション型の過剰な公開、レイヤー間参照といったリスクを報告します。

制約

• UCLASS/USTRUCT/UENUM はリフレクションが必要な場合に限って使用します。
• ヘッダーでは前方宣言を優先し、具体的なヘッダーは .cpp にインクルードします。
• 型を別のモジュールに移動する場合は、移行による影響を明記します。
• 命名は Unreal の規則（U、A、F、E のプレフィックス）に合わせます。

エラー処理

• クラスの所有権が曖昧な場合は、まずランタイムモジュールに配置し、使用状況のマッピング後に分割する TODO を記録します。
• 依存関係グラフが循環する場合は、共通コントラクトを薄い共通モジュールに切り出します。
• Build.cs の依存関係が不確かな場合は、最小限のセットを選び、直ちにコンパイルパスを検証します。

エスカレーション

• リファクタリングにアセットリダイレクター、クラス名の変更、パッケージパスの移行が必要な場合は、エスカレーションします。
• モジュール分割によって、既存コンテンツで使用されている公開 Blueprint クラスのパスが変わる場合は、エスカレーションします。