Appearance
設計書の読み方・構成
AIドパガキ（および本リポジトリ）の技術設計ドキュメントの入り口です。
ドキュメント体系
| 文書 | 役割 | 更新タイミング |
|---|---|---|
| ゲーム説明書 LP（本文） | プレイヤー視点の仕様。仕様検討のベース文書 | 遊び方・ルールを変えたいとき最初に更新 |
| ゲーム仕様書 | 数値・判定・アセット一覧の正典（v2: ノーツレーン方式） | 説明書で固めた仕様を数値に落とすとき |
| システム構成・エンジン設計 | ROM 構成・フロー状態機械・進行/隠しコマンド・サウンドドライバ | 実装構造を変えたとき |
| 実機 ROM 化ガイド ほかハード文書 | ドナー基板の ROM 載せ替え・ライター・カート改造 | 実機手順が変わったとき |
| アセット・パレット規約 | CHR 配置・パレット帯・スプライト制作ルール | アセット追加・規約変更のとき |
| ビルド手順 ほか開発・ハード文書 | 開発環境〜実機動作の手順 | 手順が変わったとき |
更新フロー（仕様を固める手順）
1. 説明書LP本文 (docs/manual/parts/lp.md) を編集 ← 遊び方・ルールのたたき台
2. 仕様書 (docs/spec/) に数値を確定 ← 判定フレーム数・スコア等の正典
3. 実装 (src/engine.s) を追従 ← 定数は engine.s 冒頭に集約済み
4. サイト再デプロイ:
akc run -- npm run docs:deploy # ドキュメントサイト
akc run -- npm run manual:deploy # 説明書LP（aidopagaki.pages.dev）変更しない確定事項（ユーザー確定要件）
- キャラアニメは 4 コマ × 5 フレーム = 20 フレーム固定・接地固定（ジャンプのみ
pose_dyで Y 浮上） - スプライトは「帯パレット先行設計 → ピクセルマップ手打ち」で制作（自動画像変換は禁止。減色ノイズで失敗実績あり）
- ストーリー等の表記は「SNS」で統一（実在サービス名は使わない）
プロジェクト概況
| 項目 | 内容 |
|---|---|
| 本命タイトル | AIドパガキ（issue #15）— 2026-08-01(土) デモ済み。以降は磨き込みと実機化 |
| ジャンル | ノーツレーン型リズムゲーム（v2。コール＆レスポンス方式から #29 で変更） |
| 凍結タイトル | Donack Adventure（issue #8/#11）— 第2弾用に仕様書を保存 |
| 開発フロー | dev-workflow スキル（issue 駆動: issue化 → 調査 → 実装 → PR → レビュー → マージ） |
| 実機経路 | NROM ドナー基板で載せ替え検証（hardware、#34）→ Mega フラッシュライター（writer）→ 魔界島カート改造（cart-mod）→ FAMULATOR 互換機 |
| 配布 ROM | aidopagaki-devNN.nes / aidopagaki-debugNN.nes の連番（最新 dev32 / debug16 = main aaedebc） |
実装状況サマリ（2026-09-02 時点）
| 機能 | 状況 |
|---|---|
| ノーツレーン・コアループ（判定・観客増減・クリア判定） | ✅ #29/#33、空振り非消費 #62 |
| タイトル → プロローグ → 入場 → 会話 → チュートリアル → 本番 → CLEAR の通しフロー | ✅ #27/#43/#60 |
| 楽曲進行（A 以上で次曲 / 全曲クリアで選曲 / エンディング）+ 進行レコード | ✅ #60 |
| イージーモード・難易度切替（タイトル ←→/SELECT） | ✅ #61 |
| 本番 STARTポーズ / ポーズ中 A+B+SELECT ランク S / チュートリアル SELECT スキップ | ✅ #66 |
| START+A+B タイトル復帰・全曲クリア裏コマンド | ✅ #60/#69 |
| 曲別譜面 4 曲 + BGM 拍同期（カウントイン 96f） | ✅ #35/#50/#52 |
| BGM サウンドドライバ（5ch・DPCM）+ ROM 5 曲 | ✅ #30/#31/#37、ネオン短縮 #64 |
| ステージ背景 + 3 段観客スタンド + テンション 4 段階 + Lv4 演出 | ✅ #38/#41 |
| アイ 26F + 歩行 v3 + ゲームオーバーうなだれ | ✅ #53/#54 |
| 講師専用スプライト + CHR ストリーミング + 入場 + セリフ声 SE | ✅ #42/#43/#49 |
| クリア画面 RANK（D〜S）+ S ランク祝賀演出 | ✅ #48/#51 |
| ppu_buf 崩壊修正（譜面末尾の休符スキャン） | ✅ #68 |
譜面メーカー Web アプリ / デバッグ ROM（make debug） | ✅ #45/#44 |
| NROM テスト ROM + 512KB フラッシュ書き込み bin | ✅ #34/#36 |
| ドキュメントサイト（VitePress + Cloudflare Pages） | ✅ #24/#71 |
| 新ロゴ合成タイトル画面 | 🚧 wip/ai-title-screen（未マージ、方針判断待ち） |
| プロローグ画像（4 ページ） | 📋 構図 v1 のみ（#55〜#58） |
| 実機動作 | 🚧 SST39SF040 書き込み・ベリファイ成功（2026-08-13）。NROM 基板への装着・起動確認（#34 STEP 5）と魔界島カート手術が残 |
| 判定音 / 決定音 SE | 📋 未実装 |