Performance Notes

• 時間をかけてこれを徹底的に行う
• スピードより品質が重要
• 検証ステップをスキップしない

クイックゲーム（高速プロトタイプ）

可能な限り高速でプレイ可能なゲームプロトタイプを構築します。これは /viral-game からポーランド加工を取り除いたもので、スキャフォルディング + コアループの実装だけです。まず何かを画面に表示してから、/add-assets、/design-game、/add-audio、/game-deploy、/monetize-game を使って段階的にレイヤーを追加します。

得られるもの：

1. クリーンなアーキテクチャを持つスキャフォルディング済みのゲームプロジェクト
2. コアゲームプレイ — 入力、移動、スコアリング、ゲームオーバー条件、リスタート
3. すぐにプレイできるランニング中の開発サーバー

スキップするもの（後で必要なら実行してください）:

• /add-assets — ピクセルアート スプライト（2D）または 3D モデル
• /design-game — ビジュアルポーランド、パーティクル、トランジション
• /add-audio — 音楽とサウンドエフェクト
• /record-promo — プロモビデオキャプチャ
• /game-deploy — here.now へのデプロイ
• /monetize-game — Play.fun 統合

手順

ステップ 0: 引数をパースする

$ARGUMENTS をパースしてゲームコンセプトを決定します：

直接指定： [2d|3d] [game-name]

• エンジン: 2d（Phaser）または 3d（Three.js）。指定されない場合はデフォルトは 2d。
• 名前: ケバブケース。指定されない場合はユーザーに確認します。

ツイート URL： 引数にツイート URL（x.com/*/status/*、twitter.com/*/status/*、fxtwitter.com/*/status/*）が含まれている場合：

1. fetch-tweet スキルを使用してツイートを取得
2. デフォルトは 2D
3. ツイートからゲームコンセプトを創造的に抽象化
4. ケバブケースの名前を生成
5. 構築する内容をユーザーに伝える

Meshy API キー（3D のみ）： 3D の場合、MESHY_API_KEY を確認します。ない場合はユーザーに確認します（https://app.meshy.ai へのリンク）。モデル生成用に保存します。

ステップ 1: スキャフォルディング + 実装

インフラストラクチャ（メインスレッド）：

1. テンプレートディレクトリを探します — ~/.claude/plugins/cache/local-plugins/game-creator/*/templates/ または このプラグイン相対の templates/ をチェック
2. ターゲットディレクトリ: game-creator リポジトリ内の場合は examples/<game-name>/ に作成します。それ以外は ./<game-name>/ に作成します。
3. テンプレートをコピー：
   • 2D: templates/phaser-2d/ → ターゲット
   • 3D: templates/threejs-3d/ → ターゲット
4. package.json の名前と index.html のタイトルを更新
5. npm install を実行
6. 開発サーバーをバックグラウンドで起動（npm run dev）。まずポート可用性を確認します — ポート 3000 が使用中の場合は 3001、3002 など を試します。

ゲーム実装（Task 経由のサブエージェント）：

以下のプロンプトで Task サブエージェントを起動します：

You are building a quick game prototype. Speed is the priority — get a playable core loop working.

Project path: <project-dir> Engine: <2d|3d> Game concept: <description> Skill to load: phaser (2D) or threejs-game (3D)

Implement in this order:

1. Input (touch + keyboard from the start)
2. Player movement / core mechanic
3. Fail condition (death, collision, timer)
4. Scoring
5. Restart flow (GameState.reset() → clean slate)

Scope: 1 scene, 1 mechanic, 1 fail condition. Keep it tight.

Rules:

• All cross-module communication via EventBus
• All magic numbers in Constants.js
• No title screen — boot directly into gameplay
• No in-game score HUD — Play.fun widget handles score display
• Mobile-first input: touch + keyboard, use unified InputSystem pattern
• Import SAFE_ZONE from Constants.js — keep UI below SAFE_ZONE.TOP
• Minimum 7-8% canvas width for collectibles/hazards
• Character sizing: GAME.WIDTH * 0.12 to GAME.WIDTH * 0.15 for character-driven games
• Preserve the template's createButton() helper in GameOverScene — do NOT rewrite it
• Wire spectacle events: SPECTACLE_ENTRANCE, SPECTACLE_ACTION, SPECTACLE_HIT, SPECTACLE_COMBO, SPECTACLE_STREAK, SPECTACLE_NEAR_MISS
• Add isMuted to GameState for future audio support
• Ensure restart is clean — 3 restarts in a row should work identically

ステップ 2: 検証

サブエージェントが終了した後：

1. プロジェクトディレクトリで npm run build を実行してエラーがないか確認
2. ビルドが失敗した場合は問題を修正します（最大 2 回のリトライ）
3. Playwright MCP が利用可能な場合は、開発サーバーにアクセスしてスクリーンショットを撮り、簡単なビジュアルチェックを実施

使用例

2D ゲーム

/quick-game 2d asteroid-dodge

結果: Phaser テンプレートをコピー → プレイヤーシップ、隕石生成、衝突死亡、スコアカウンター、リスタートフローを実装 → localhost:3000 で約 2 分でサーバーが実行中。シェイプのみ、ポーランド加工なし。

ツイートから

/quick-game https://x.com/user/status/123456

結果: ツイートを取得 → ゲームコンセプトを抽象化 → ツイートコンテンツにインスパイアされたプレイ可能なプロトタイプをスキャフォルディングして実装。

トラブルシューティング

ゲームはスキャフォルディングされるが起動しない

原因： Vite 設定またはインポートパスが正しくない。 修正： vite.config.js が正しいルートを持っているか確認します。main.js が index.html で参照されているか確認します。

コアファイルが見つからない

原因： スキャフォルディングで EventBus/GameState/Constants をスキップした。 修正： すべてのゲームには core/EventBus.js、core/GameState.js、core/Constants.js が必要です。スキャフォルディングを再実行するか手動で作成します。

完了

ユーザーに次のように伝えます：

Your game is running at http://localhost:<port>. Open it in a browser to play!

To keep building, run these commands:

• /add-assets — replace shapes with pixel art sprites
• /design-game — add visual polish (particles, gradients, juice)
• /add-audio — add music and sound effects
• /game-deploy — deploy to the web
• /monetize-game — add Play.fun integration

Or run /viral-game next time for the full one-shot pipeline (assets, polish, deploy, monetize all in one go).