戯言と技術

技術的なまとめと株などの市場分析をベースに記事化しています。

Claude Code Game Studios でクロスワードパズルを作ってみた — /prototype の質問から完成・修正まで

13分で読めます
目次

広告

注意事項

  • 本記事の内容は試験的な実装であり、アイデアベースの検証です
  • 実務での利用を保証するものではありません
  • 実装についての責任は負いかねます。自己責任でご利用ください
  • AIの出力結果は常に検証が必要です
  • 雛形にはフック(自動で動くスクリプト)が含まれます。複製したら、使う前に .claude/ の中身を読んでください

はじめに

ゲーム開発に効く Claude の Skills まとめ で紹介した Claude-Code-Game-Studios を、実際に使ってみました。

作ったのは、IT用語をひらがなで解く日本語のクロスワードパズルです。

完成したクロスワード「こーどくろす」の画面。エディタ風のダークテーマで、左に9×9の盤、右にコメント形式のカギと50音キーが並ぶ

結果を先にまとめます。

項目結果
人がしたことゲームのアイデアを1文で伝え、7つの質問に答え、企画書に「このまま作る」と返した
ビルドにかかった時間約14分(企画書の承認から完成の報告まで)
できたもの9×9 の盤、15語、ローマ字・IME・50音キーの3通りの入力、答え合わせ、ヒント、評価
自分で遊んで見つけた不具合1件(説明ポップアップの文字の重なり)。頼んで約1分で直った
費用Claude Code が表示した API 換算の費用で約4.7ドル(契約しているプランによって違います)

記事中の出力は、すべて2026年11月21日に実際に動かしたときのものです。Claude-Code-Game-Studios は v1.3.0、Claude Code は 2.1.330 を使いました。


1. 準備する

Claude-Code-Game-Studios は、インストールするものではなく、プロジェクトの雛形です。リポジトリを複製して、その中で Claude Code を起動します。

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git crossword
cd crossword

# 自動で動く設定とフックを先に読んでおく
cat .claude/settings.json
ls .claude/hooks/

claude

必要なものは Git、Python 3、Bash、Chrome(または Edge・Chromium)です。Chrome は、作ったゲームを自動で遊んでスクリーンショットを撮るのに使われます。

ポイント: Claude Code は、必ず CLAUDE.md と project.yaml があるフォルダで起動してください。src/ などの下のフォルダで起動すると、フックや「書き込む前に確認する」の設定が読み込まれません。


2. /prototype でアイデアを伝える

起動したら、/prototype に続けて作りたいゲームを1文で書きます。

/prototype ひらがなで解く日本語のクロスワードパズル。テーマはプログラミング・IT用語。マスをクリックして文字を入力し、縦と横のカギを見ながら解く

すると、リポジトリに入っているジャンルの資料(.claude/genres/)から「word-game(言葉のゲーム)」が選ばれ、7つの質問が返ってきました。それぞれに「(標準)」の案が付いていて、「おまかせ」と答えれば標準の案で進みます。

#質問標準の案ほかの案
1盤の大きさと問題の数9×9 を1問、12〜16語7×7 を3問、だんだん難しく
2遊んだ感触解けた言葉の説明が出る「学びのある解き心地」説明なしで解くことに集中
3見た目新聞のような紙と墨の盤エディタ風のダークテーマ
4難しさと手助け答え合わせと1文字ヒント。ヒントを使うと評価が下がる手助けなし
5ゴール全部正解でクリア。時間とヒントの数を表示—
6入力のしかたIME でひらがなを打つ画面に50音ボタン(スマホ向け)、両方
7遊べる版か、仕組みの試しか最初から最後まで遊べる版入力の仕組みだけ試す版

日本語の IME をどう扱うか(質問6)まで聞かれたのが印象的でした。技術ブログなので、見た目は「エディタ風」、入力は「両方」を選び、残りは標準にしました。

1は標準、2は標準、3は(b)エディタ風のダークテーマ、4は標準、5は標準、6は両方付けてください、7は標準で。

3. 企画書(ブリーフ)を確認する

答えると、1ページの企画書が返ってきます。この時点では、まだファイルは1つも書かれていません。「このまま作る」と答えることが、作り始めてよいという許可になる仕組みです。

企画書の主な中身はこうでした(抜粋)。

# Game Brief: こーどくろす(Code Cross)

**Pitch:** コードエディタの画面で、「へんすう」「こんぱいら」などの IT 用語を
ひらがなで埋めていく、学びのあるクロスワード。

## First minute
エディタ画面が開き、カーソルは「よこ 1」の先頭のマスで点滅している。
(中略)最後の文字を入れると単語の色が変わり、
「へんすう(変数):値を保存して名前で呼び出すもの」というポップアップが出る。

## Out of scope
- もっと多くの問題とテーマ別の単語リスト → grow it
- 盤を自動で作る仕組み → add it as a feature
- 毎日の問題とスコアの共有 → needs a server: not built yet

いいと思った点は3つです。

  • 最初に入力した1文が「In your words」としてそのまま残り、書き換えられない
  • 「最初の1分で何が起きるか」が具体的に書かれていて、完成のイメージを合わせやすい
  • 推測で決めた項目に (guessed) と付いていて、どこを確認すればよいかがわかる

内容に問題がなかったので、「1. このまま作る」と答えました。


4. ビルド(約14分、人は待つだけ)

ここからは、Claude Code が1人で作業します。ログから、実際にしていたことを拾ってみます。

  1. 盤を作る小さなツールを書いた: 12語以上が交差する盤を手で並べるのは大変なので、tools/grid-gen.js を書き、乱数の種を3つ試して、いちばん良い盤(15語、交差16か所)を選んだ
  2. ゲーム本体を書いた: index.html(約880行)、問題データの puzzle.js、調整できる数値をまとめた config.js
  3. 読み直して自分で直した: ローマ字の変換、カギの当たり判定、画面の重なりなど
  4. ヘッドレスの Chrome で動かして確かめた: 起動してエラーが出ないか、キー操作に反応するか、文字がはみ出していないかを確認し、スクリーンショットを撮った
  5. 見た目を1回直した: 空きマスと黒マスの色の差が小さかったので、明るさの差を広げた
  6. 企画書の項目と照らし合わせた: 15項目すべてを「できた」と判定した

最後に、次のような「引き渡しカード」が出ました(抜粋)。

Open: prototypes/code-cross/index.html
Small check: passed boots, shot, brief words, outlines
Brief checklist: 15 of 15 pass
Fixed: 空きマスと黒マスの色の差が小さかったので、明暗をはっきりさせた
Guessed: 盤の言葉は全部で 15 語(りふぁくたりんぐ・あるごりずむ・いんすとーる など)で、
         ブリーフの例に挙げた ばぐ・ふぁいる・こんぱいら は盤に入っていない / …
Built in 13 minutes
Not yet played by a person.

「Not yet played by a person.(まだ人が遊んでいません)」 で終わるのが、このツールらしいところです。自動の確認は通っていても、「遊んで楽しいか」「本当に解けるか」は人が確かめる、という考え方です。

企画書で例に挙げた「ばぐ」「こんぱいら」が盤に入らなかったことも、隠さずに「Guessed(推測で決めたこと)」に書かれていました。

そのあと「コミットしてタグを付けますか?」と聞かれたので、お願いしました。one-shot/code-cross というタグが付き、あとで変更しても、いつでもこの状態に戻せます。


5. 自分で遊んで確かめる

カードに従って、実際に遊びました。

盤のデータを確かめる

まず、問題が正しく作られているかを Node.js で確かめました。交差するマスの文字が食い違っていないか、言葉として登録されていない文字の並びがないかを調べます。

// puzzle.js の盤を 9×9 に並べて、食い違いがないか調べる
global.window = {};
require("./puzzle.js");
const P = window.PUZZLE;
const g = [...Array(9)].map(() => Array(9).fill(null));
let bad = 0;
for (const w of P.words) {
  [...w.answer].forEach((ch, i) => {
    const r = w.r + (w.d ? i : 0), c = w.c + (w.d ? 0 : i);
    if (g[r][c] && g[r][c] !== ch) bad++; // 交差するマスで文字が違う
    g[r][c] = ch;
  });
}
console.log(g.map(row => row.map(x => x || "■").join("")).join("\n"));
console.log("problems:", bad);
へんすう■■■■い
ん■■■■あいこん
かーそる■■■■す
ん■ー■■ぱけっと
■しすてむ■■■ー
■ぇ■■■■もでる
あるごりずむ■ば■
ぷ■■ん■■■っ■
りふぁくたりんぐ■
problems: 0

15語すべてが正しく交差していました(答えが見えてしまうので、自分で解きたい人は読み飛ばしてください)。

解いてみる

index.html をブラウザで開き、カギをクリックして答えを入力していきます。言葉が埋まると色が変わり、ドキュメントのポップアップ風に用語の説明が出ます。

「へんすう」を解いたところ。変数(variable)の説明がポップアップで表示されている

入力は3通り試しました。

  • IME オフのローマ字: hennsuu と打つと「へんすう」になる。企画書になかった機能ですが、「IME オフでも入るようにした」とカードの Guessed に書かれていました
  • 画面の50音キー: 「つ」→「小」で「っ」、「く」→「゛」で「ぐ」のように、直前の文字を変えるボタンが付いている
  • IME(日本語入力): 確定した文字が1マスずつ入る

全部埋めると、ターミナル風の結果画面が出ます。ヒントなしで評価 S でした。

クリア画面。「$ node crossword.js」に続いて、15語すべて解けたこと、時間、ヒント0回、評価Sが表示されている

遊んでわかった注意点

最初、たての言葉を頭から全部入力したら、盤が1マスずれてしまいました。

原因は不具合ではなく仕様でした。カギを選ぶと、カーソルは最初の空きマスに移動します。よこの言葉で埋まっているマスは飛ばされるので、たての言葉は「残りのマスの分だけ」打てば正しく入ります。新聞のクロスワードアプリと同じ動きですが、操作説明には書かれていないので、遊ぶ人によっては戸惑うかもしれません。


6. 見つけた不具合を、頼んで直す

遊んでいて、1つ見た目の不具合を見つけました。いちばん長い言葉「りふぁくたりんぐ」の説明ポップアップで、カタカナの「リファクタリング」と「(refactoring)」が重なっていました。

修正前のポップアップ。「リファクタリング」と「(refactoring)」の文字が重なっている

そこで、遊んだ感想といっしょに、直してほしいところを伝えました。

遊びました。全部解けて、ヒントなしで評価Sでした。IME オフのローマ字入力も、
50音キーの濁点・小文字ボタンも問題なく使えました。1つだけ直してほしいです:
「りふぁくたりんぐ」を解いたときの説明ポップアップで、「リファクタリング」と
「(refactoring)」の文字が重なって読めません。長い言葉でも重ならないようにしてください。

約1分で、次の返事が来ました(要約)。

  • 原因: 太字の言葉の幅を、太字ではない文字の幅で測っていた
  • 直し方: 幅を正しく測り、1行に収まらないときだけ英語名を2行目に回す
  • 確認の範囲: 確認用の画面で撮ったが、「実際に解いて出したポップアップは撮れていないので、次に遊ぶときに見てください」

ここでも、確かめていないことを正直に書いてくれます。実際に解いて確かめると、重なりは直っていました。

修正後のポップアップ。「(refactoring)」が2行目の右側に移り、重なりがなくなっている

もう1つおもしろかったのは、感想の中で「問題なく使えた」と書いたローマ字入力と50音キーが、企画書の「Keep(変えずに残すもの)」に自動で追加されたことです。今後の変更でこの2つを壊さないように、という記録になります。

「受け入れる」と答えると、iteration 1 としてコミットされました。


できたファイル

最終的に、リポジトリには次のファイルができました。

design/game-brief.md              # 企画書(遊んだ感想と Keep も追記される)
prototypes/code-cross/
├── index.html                    # ゲーム本体(ダブルクリックで開ける)
├── puzzle.js                     # 盤・カギ・用語の説明
├── config.js                     # 評価の基準や表示時間など、調整できる数値
├── brief.md                      # 企画書の写し
├── tools/grid-gen.js             # 盤を作るためのツール(ゲームでは使わない)
├── assets/provenance.yaml        # 素材の出どころの記録
└── evidence/                     # 自動確認の結果とスクリーンショット

config.js には、評価の基準(ヒント何回までなら A か、など)やポップアップの表示時間が、最小値・最大値つきでまとまっています。「let me tune it(調整したい)」と頼むと、これらをスライダーで動かせる画面が付くそうです。

// config.js(抜粋)
window.CONFIG = {
  hint_cost: { value: 1, min: 0, max: 3, step: 0.5 },      // ヒント1回の減点
  rank_a_max: { value: 2, min: 0, max: 6, step: 0.5 },     // この点数以下なら A
  popup_seconds: { value: 7, min: 2, max: 20, step: 0.5 }, // 説明ポップアップの表示秒数
};

かかった時間と費用

手順時間人がしたこと
アイデアを伝える → 質問が出る約30秒1文を入力
質問に答える → 企画書が出る約30秒7つの質問に回答
企画書を承認 → 完成約14分待つだけ
遊んで確かめる数分遊ぶ
不具合を伝える → 修正約1分1件を説明

費用は、Claude Code が表示した API 換算の値で、全部で約4.7ドルでした。ほとんどがビルドの14分の分です。サブスクリプションのプランで使う場合は、利用量の上限に対して消費されます。


使ってみてわかったこと

よかった点

  • 質問の段階で、日本語の IME をどう扱うかまで考えてくれた
  • 企画書・コミット・変更のたびに確認があり、勝手に話が進まない
  • 推測で決めたこと、確かめていないことを、毎回はっきり書いてくれる
  • 遊んだ感想が企画書に記録され、次の変更の基準になる

気をつけたい点

  • 「Brief checklist: 15 of 15 pass」でも、文字の重なりは残っていた。最後は必ず自分で遊んで確かめる必要がある
  • カギを選んだときにカーソルが最初の空きマスへ移るなど、操作の細かい決まりは遊んでみないとわからない
  • 雛形にはフックやスクリプトがたくさん入っているので、ほかのプロジェクトとは混ぜず、新しいフォルダで使うのがおすすめ

次の一歩

引き渡しカードには、この先の進め方も書かれていました。

  • もっと多くの問題を入れる → 「grow it(育てる)」で、Vite と TypeScript のプロジェクトに作り直してから1機能ずつ足す
  • 盤を自動で作る → 育てたあとの機能として追加する
  • 毎日の問題とスコアの共有 → サーバーが必要なので、まだ作れない

試作で終わらせるか、育てるかを選べるので、まずは気軽に1本作ってみるのがよさそうです。

関連記事

参考リンク

広告

関連する記事