こんにちは、hakairyuousinn です(Xアカウント)。

Claude Codeでゲームを作るとき、自分はこの順で進めています。

  1. 何を作るかを文書にする(ルール、操作、画面の流れ)
  2. 実装の指示書を書く(ファイルの役割と、終わりの条件)
  3. 実装する(自分はCodexに渡しています)
  4. 最後まで自動で遊ばせて、画面を撮って見る
  5. おかしな所を直しの指示書にして、もう一度確かめる
  6. 自分のサイトに出して、出てから見つかった不具合を直す

コードを書かせる前に、何を作るかと、どうなったら終わりかを文章にしておく。だいたいこれだけです。

狐とうそをつき合うサイコロのゲーム「Kitsune Den」は、10月27日の指示書から10月31日の公開まで、この順で作りました。

実装の指示書に書いたこと

指示書はClaudeが書きました。最初に、もう用意してあるものを並べています。背景、狐3人の立ち絵、声のファイル。それと、前に作った穴掘りゲーム「Dig It!」から写してきた、文字の切り替えと効果音の仕組み。

そのあとに、作るファイルの表と、1回の勝負の流れ。初めて遊ぶ人への案内の文も、指示書の時点で決めてあります。下の画面の「これがあなたの目。狐には見えません。」は、指示書の一文がほぼそのまま入ったものです。

Kitsune Den の最初の対局の画面。自分の5個のサイコロが青い枠で囲まれ、「これがあなたの目。狐には見えません。」という案内とOKのボタンが出ている
初めて遊ぶときに出る案内。文は指示書で決めたものです

指示書の最後には「終わりの条件」を置きます。Kitsune Den のときはこうでした。

  • ビルドが型エラーなしで通る
  • パソコンの横画面でもスマホの縦画面でも、タイトルから結果の画面、Xへの共有ボタンまで通して遊べる
  • 狐の癖を見ないで遊ぶ人が、4人の中で勝つ率が20〜40%
  • このゲームの説明書き(AGENTS.md)に、動かし方を書き足す
  • 「変えたファイルと要点」を短く報告する

勝つ率は、画面を出さずに対局だけ回して測る仕組みを、同じ指示書で作らせました。あとで1,000回やらせたら36.2%で、1回の勝負は平均9.3回戦。癖を読めば、もっと上がるように作ってあります。

エラーが出なくても画面は見る

10月28日にCodexの実装が上がってきました。終わり際に「モデルが混雑中」で止まっていたんですが、コードもビルドも、Codexが自分で書いたテストも終わっていました。

次はClaudeの番です。タイトルから結果の画面まで自動で遊ばせて、場面ごとに撮らせました。横画面の日本語と、縦画面の英語の2通り。エラーは1つも出ません。でも撮った画面には、狐の尻尾の印が顔に重なっている所などがありました。直す所は6つ。直しの指示書にしてCodexに戻したら、同じ日のうちに直りました。直す前と後の画面は「Claude CodeとCodexの違い」の記事に載せています。

地味に困ったのは、アプリの中のブラウザを裏に回すと、ゲームが1秒に1コマまで落ちること。画面は別のブラウザ(Playwright)で撮るようにしました。仕様を知らないAIに初見で遊ばせる話は「AIに自作ゲームを初見プレイさせたら、1回目は飢え死にでした」にあります。

公開した日と、そのあとの直し

10月31日に、このサイトのゲーム置き場に出しました。出すのと同じ日に直したのが、スマホだと最初に画面をタップするまで起動が止まる不具合です。狐の声を起動のときに全部読み込んでいたのをやめて、タイトルや対局の画面の裏で読むように変えました。

そのあと、11月4日に英語、11月5日に韓国語でも遊べるようにしています。言語の切り替えは、ほかのゲームと同じ仕組みにそろえました。

▶ Kitsune Den を遊ぶ(ルールとコツはこちら)