Performance Notes

• 時間をかけて丁寧に進める
• スピードより品質を重視
• 検証ステップをスキップしない

フィーチャーの追加

ゲームに新しい機能を追加します。追加したい内容をプレーンな日本語で説明するだけで（例：「ダブルジャンプのパワーアップを追加」「ハイスコアのリーダーボードを追加」）、ゲームの既存パターンに従って機能が構築されます。

手順

ユーザーが追加したいのは: $ARGUMENTS

ステップ 1: コードベースを理解する

• package.json を読んでエンジン（Three.js または Phaser）を確認
• src/core/Constants.js を読んで既存の設定を確認
• src/core/EventBus.js を読んで既存のイベントを確認
• src/core/GameState.js を読んで既存の状態を確認
• src/core/Game.js（または GameConfig.js）を読んで既存のシステム配線を確認
• 既存のシーンとゲームプレイファイルを読んで何が既に構築されているかを理解

ステップ 2: 機能を計画する

コードを書く前に、計画をプレーンな日本語で説明してください：

1. 何をするのか: プレイヤーの視点から機能を説明
2. どのように機能するか: 作成される新しいファイル、イベント、設定をリストアップ
3. 何に影響するか: 機能を配線するために小さな変更が必要な既存ファイルをリストアップ

その後、技術的に必要なものを決定します：

• 新しいモジュールファイルとディレクトリ構造内の場所
• EventBus の Events enum に追加する新しいイベント
• Constants.js に追加する新しい定数
• GameState.js に追加する新しい状態
• Game オーケストレーターに配線する方法

ステップ 3: 実装する

以下のルールを厳密に従ってください：

1. 正しい src/ サブディレクトリに新しいモジュールを作成
2. すべての新しいイベントを EventBus.js の Events enum に追加
3. すべての設定値を Constants.js に追加（ハードコーディングされた値はゼロ）
4. 新しい状態ドメインを GameState.js に追加
5. 新しいシステムを Game.js に配線（インポート、インスタンス化、ループ内での更新）
6. すべての他のシステムとの通信に EventBus を使用
7. プロジェクト内の既存のコードスタイルとパターンに従う

ステップ 4: 検証する

• npm run build を実行してエラーがないか確認
• 機能が既存のシステムを破壊することなく統合されたか確認
• 循環依存が導入されていないか確認
• イベントリスナーが適切にクリーンアップされているか確認（必要に応じて）
• 追加されたものをプレーンな日本語で要約

トラブルシューティング

機能追加後にゲームが動かなくなった

原因: 新しいコードが既存の EventBus イベントまたは GameState フィールドと競合している。 修正: EventBus.js でイベント名の衝突をチェック。GameState.reset() で新しい状態フィールドがデフォルト値を持つことを確認。

機能は動くが既存のゲームプレイが壊れた

原因: 共有定数またはコリジョングループを変更した。 修正: 既存の定数を変更するのではなく、新しい定数を追加。変更後に元のゲームプレイをテスト。

出力

ユーザーに以下を伝えてください：

1. 機能が何をするか（プレイヤーの視点から）
2. 作成または変更されたファイル
3. テスト方法 — 「npm run dev を実行して [特定のアクション] を試してください」

使用例

パワーアップを追加する

/add-feature ランダムにスポーンするスピードブーストパワーアップを追加

結果: src/entities/PowerUp.js を作成、EventBus に POWER_UP イベントを追加、Constants.js にスポーンタイミングと持続時間を追加、Game.js に配線。プレイヤーがパワーアップを取得 → 8秒間スピードが2倍になる。

スコアリング機構を追加する

/add-feature 素早くスコアしたときにスコアが増加するコンボマルチプライヤーを追加

結果: comboMultiplier と comboTimer を GameState に追加、スコアリングシステムにコンボロジックを作成、UI更新用に COMBO_CHANGED イベントを追加。

ヒント

このコマンドは何度でも実行して、機能を追加し続けることができます。各機能は前の機能に基づいて構築されます。

ゲームプレイに満足したら、ビジュアルをポーランド仕上げするには /game-creator:design-game、音楽とサウンドエフェクトを追加するには /game-creator:add-audio、完全な品質チェックを行うには /game-creator:review-game を実行してください。