プロジェクト名は BlockPuzzle(ローカルパス・Bundle ID)、ストア表示名は PieceZen。仕様書ではストア名で統一。

概要

アプリの目的

8×8グリッドにブロックピース(19種類・回転対応)を配置してラインを揃えて消すブロックパズル。 コンボ・パーフェクトクリア・アンドゥ・リワード広告での救済機能で再プレイ性を高めた設計。

全体仕様書

画面遷移図
全画面の遷移マップ
データモデル
SwiftData @Model + 状態管理
エラー設計
例外パターン一覧
ロギング方針
Logger カテゴリ
ASOキーワード戦略
App Store最適化
用語集・ドメイン辞書
ドメイン用語の正典

画面仕様書

ホーム
タイトル画面
PZ-HOME-01
ゲーム
メインゲーム画面
PZ-GAME-01
ゲーム終了
救済リワード広告含む
PZ-OVER-01
設定
サウンド・テーマ・課金
PZ-SET-01
統計
スコア推移グラフ
PZ-STATS-01
Paywall
広告除去IAP
PZ-PAY-01

機能仕様書

v4.0 リブランディング企画書「脳活ピース」(最新戦略)
DL 0問題を受けてシニア層向けボケ防止アプリへ全面ピボット。改名・UI刷新・ASO全面更新の段階計画
REBRANDv4.02026年6月〜
ゲームロジック
配置・消去・スコア・コンボ
広告制御
Banner / Interstitial / Rewarded
StoreKit課金
広告除去IAP
サウンド
activePlayers配列で安全再生
ハプティクス
UIFeedbackGenerator
ストリーク
連続プレイ日数
v2.0 大型アップデート企画書「静謐ドーパミン」(v3.0改訂)
v2.0=コアループ磨き / v2.1=メタ継続層構築 / v2.2=触感磨き込み / v2.3=コンテンツ拡張 の4段構成
FEAT-V2-ROADMAPv3.02026年6月〜2027Q1
ゲーム性レビュー(GPT-5 / 2026-05-12)
「コアは成立済み、メタ継続層が弱い」と診断。v3.0 改訂の主因。デイリーチャレンジ・実績・統計強化を推奨
GAME-DESIGNGPT-5
v2.0 UXレビュー(GPT-5 / 2026-05-12)
UX/ドーパミン設計レビュー。Near Miss・期待形成・終了画面の不足を指摘(v2.2 で反映)
UX-REVIEWGPT-5