kambarakun

README excerpt

# 🎵 Agentic Vibe DJ

本作は「AIが裏で次の展開をリアルタイムに生成・選択する」次世代のリズムゲームです。Gemini 3 東京ハッカソンで提示された「AI Games」の2つの定義を完全に網羅することを目的としたプロトタイプ実装です。

## 1. ハッカソン評価基準へのアプローチ

本作は、「ステートメント 1：AI を活用したゲーム」に対する完全な回答として設計されています。GoogleのAIプロダクトスイート（Gemini 2.5 Flash, Imagen 4 Fast, 生涯学習するエージェント型AIによるVibe Coding）をフル活用し、以下の審査基準を最大化します。

- デモ（50%）― 確実な動作と技術力:
  AI APIのリクエストをパラレル処理（Promise.all）し、30秒のゲームループ内に遅延なくAI生成を間に合わせるアーキテクチャを実装。さらに画像生成APIの制限やタイムアウトを検知して自動でローカルアセットを合成する「ハイブリッド・サルベージ」や「LRU輪廻フォールバック」を搭載し、本番デモで絶対にクラッシュ・黒画面化しない堅牢性を実現（Actually Works）。
- インパクト（25%）― リズムゲームの再定義:
  従来の「事前に作られた固定の譜面と背景」をなぞるだけのリズムゲームから、「プレイヤーの操作（早押し・遅押し・ミス）をリアルタイムに解析し、弱点を突くような譜面と煽りMC、専用のタイトル・背景画像を永遠に生成し続ける」無限のゲームプレイへと進化させました。
- 創造性（15%）― "Vibe Hacker" DJ AI:
  AIが単なるランダム生成ではなく、プレイヤーのプレイスタイルに応じて「Glitch Syncopation（遅延乱れ打ち）」や「Jackhammer Drive（縦連打）」などの明確な DJ Techniques を選択し、動的なコンセプト（Chill / Groove / Overdrive）に基づく総合的なVibe（演出・譜面・音楽）をハッキングしてくる独創的な表現。
- ピッチ（10%）― AIプログラミングの証明:
  開発自体をGoogle Antigravityを用いたエージェント型「Vibe coding」で実践し、短期間での超高度な実装とアセット生成（Imagenによるフォールバック画像の量産）を実現しました。

## 2. コア体験とゲームループ

ゲームは「1セグメント＝30秒」のループで進行し、AIが途切れることなく楽曲と譜面をミックスし続けます。

1. **プレイ＆解析（0〜20秒）**: 
プレイヤーがノーツを叩く。システムがリアルタイムで「精度（Accuracy）」と「操作のクセ（早押し等）」を集計。
2. **AI 先読み生成（並行処理）**: 
プレイ中、AI DJ（Gemini 2.5 Flash API）が次の30秒間の展開として、3つの候補（Chill / Groove / Overdrive）の各種パラメータ（譜面、MC、曲名）をリアルタイムで生成し、さらにプロンプトからImagen 4 Fastを用いてダイナミックな専用背景画像を裏で生成してストック（最大5曲）しておきます。
3. **ルート決定とMC（20〜28秒）**: 
直近のプレイ成績（Missの多さやEarly/Lateの偏り）に基づき、AIがプレイヤーの「弱点」を分析。それを突く（またはフォローする）DJテクニック（Neon Altern