設計書の読み方・構成

AIドパガキ（および本リポジトリ）の技術設計ドキュメントの入り口です。

ドキュメント体系

文書	役割	更新タイミング
ゲーム説明書	プレイヤー視点の仕様。仕様検討のベース文書	遊び方・ルールを変えたいとき最初に更新
ゲーム仕様書	数値・判定・アセット一覧の正典	説明書で固めた仕様を数値に落とすとき
システム構成・エンジン設計	ROM 構成・エンジン内部構造・メモリマップ	実装構造を変えたとき
アセット・パレット規約	CHR 配置・パレット帯・スプライト制作ルール	アセット追加・規約変更のとき
ビルド手順 ほか開発・ハード文書	開発環境〜実機動作の手順	手順が変わったとき

更新フロー（仕様を固める手順）

1. ゲーム説明書 (docs/manual/) を編集   ← 遊び方・ルールのたたき台
2. 仕様書 (docs/spec/) に数値を確定     ← 判定フレーム数・スコア等の正典
3. 実装 (src/engine.s) を追従           ← 定数は engine.s 冒頭に集約済み
4. akc run -- npm run docs:deploy      ← サイト再デプロイ

変更しない確定事項（ユーザー確定要件）

• キャラアニメは 4 コマ × 5 フレーム = 20 フレーム固定・接地固定（ジャンプのみ pose_dy で Y 浮上）
• スプライトは「帯パレット先行設計 → ピクセルマップ手打ち」で制作（自動画像変換は禁止。減色ノイズで失敗実績あり）

プロジェクト概況

項目	内容
本命タイトル	AIドパガキ（issue #15）— 2026-08-01(土) デモ
凍結タイトル	Donack Adventure（issue #8/#11）— 第2弾用に仕様書を保存
開発フロー	dev-workflow スキル（issue 駆動: issue化 → 調査 → 実装 → PR → レビュー → マージ）
実機経路	Mega フラッシュライター（writer）→ 魔界島カート改造（cart-mod）→ FAMULATOR 互換機

実装状況サマリ（2026-07-28 時点）

機能	状況
リズムエンジン（コール＆レスポンス・判定・観客増減）	✅ main マージ済み
アイのダンススプライト（26 フレーム・全方向 4 コマ）	✅ v4 承認済み
ステージ背景 + 観客 BG 描画	🚧 issue #23 実装中
楽曲シーケンサ + 譜面	📋 未着手（仕様書 §6）
タイトル / ストーリー / リザルト画面	📋 未着手
実機動作	📋 フラッシュチップ到着待ち