← ブログに戻る
Ai読了目安 13 分

49 の agent、74 の skill、そして作る前に聞くスタジオ

公開日 2026年11月8日
49 の agent、74 の skill、そして作る前に聞くスタジオ

今月の GitHub ウィークリーランキングには、Claude Code をよりきれいなインターフェースで包むリポジトリが並んでいる。Donchitos/Claude-Code-Game-Studios がやっているのは、それほど流行らない方向だ。セッションに組織図を渡す。このリポジトリはテンプレートであって、アプリではない。clone してルートで Claude Code を開くと、アシスタントはファイル管理の作法と、誰が何を決めてよいかという規則と、74 個のスラッシュコマンドを引き継ぐ。1 週間で約 5,700 スターを獲得し、現在は 36,845。

見出しの数字は 49 の agent、74 の skill、15 の hook、14 のルール、62 のドキュメントテンプレート。agent の数は最も水増ししやすいので、この数字がいちばん面白くない部分になる。読む価値があるのは、偽装しにくいところだ。エスカレーション経路を持つ委譲モデルと、subagent が指示どおりに動いたかを検査する hook。

三つの階層と、それぞれの理由

49 の agent はスタジオの形に並べられている。

第 1 階層は 3 人のディレクター、creative-director、technical-director、producer。第 2 階層は部門リードで、game-designer、lead-programmer、art-director、audio-director、narrative-director、qa-lead、release-manager、localization-lead。第 3 階層は 30 人ほどの専門家で、ゲームプレイ、エンジン、AI とネットワークのプログラミング、レベルと経済の設計、テクニカルアート、サウンドデザイン、執筆、世界観、UX、プロトタイピング、パフォーマンス、DevOps、分析、セキュリティ、QA、アクセシビリティ、live ops、コミュニティを担当する。

互いにどう話すかの規則は README に明記されていて、多くのマルチ agent 構成より厳しい。

縦の委譲だけ。ディレクターからリードへ、リードから専門家へ。横の相談は認めるが、同じ階層の agent は領域をまたいで拘束力のある決定を下せない。意見が割れたら共通の親へエスカレーションする。設計の議論は creative-director、技術の議論は technical-director が引き取る。部門をまたぐ変更は producer を通す。そして、明示的な委譲がない限り、agent は自分の領域の外のファイルを編集しない。

最後の規則が実務では効く。マルチ agent の失敗は推論の失敗ではなく、範囲の失敗であることが多い。照明のバグを直すよう言われた agent が、ついでにセーブシステムを書き換える。領域の境界を文章にして、委譲の手続きを踏むリードに守らせる。乱暴な対処だが、効く。

モデルの階層は予算の話

各 agent は frontmatter でモデルを宣言する。3 人のディレクターは Opus を要求する。lead-programmer と 15 人の専門家は Sonnet を名指しする。残りの 30 人は、あなたのセッションが動かしているモデルを引き継ぐ。

README はこの点について珍しいほど率直だ。階層は役割の序列として扱い、請求計画として扱うな。スタジオの大半は、あなたがすでに持っているモデルで動くからだ。agent フレームワークのコスト話としては誠実な部類に入る。実際に払うのは 1 セッション分と、その後のすべてを決める判断に対する数回の Opus 呼び出しで、そこに金を置くのは筋が通る。

hook が実際に検査していること

15 の hook がセッションのイベントで動く。名指しする価値があるのは 2 つ。

`log-agent.sh` と `log-agent-stop.sh` は subagent の開始と停止で監査ログを書く。これは記帳で、コストは低い。

`validate-agent-artifact.sh` が面白い。agent が停止するときに発火し、その subagent が指示書で名指しされたファイルを一度も書いていなければ警告する。小さな検査で、狙いは具体的な故障だ。並列 agent を動かしたことのある人なら誰でも出会う。subagent は成功を報告し、オーケストレーターは次へ進み、ファイルは存在しない。stop イベントで捕まえるのが正しい。親がまだ文脈を持っていて、再ディスパッチできる最後の瞬間だからだ。

残りの hook は commit、push、アセットの変更、設計ドキュメントの読み書き、レジストリ、セッションのライフサイクルを覆う。任意のツールがなくても hook は静かに劣化するが、意図的な例外が 1 つある。データ JSON をステージした commit は、Python がないとブロックされる。バリデータが動かないからだ。

つまずきは要件の一覧にある

セットアップは README の 4 行で、そのうち 1 行が警告だ。

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
claude

そのあと `/start` と入力する。システムはあなたがどの段階にいるかを聞き、皆目見当がつかない状態から既存プロジェクトまでを振り分け、ワークフローへ導く。`/setup-engine godot 4.7`、`/brainstorm`、`/project-stage-detect` へ直接飛ぶこともできる。

警告はこうだ。`CLAUDE.md` と `project.yaml` のあるフォルダで Claude Code を起動すること。`src/` で起動すると、プロジェクトの hook、deny ルール、先に聞く権限モードがすべて飛ばされる。構造を一切持たないアシスタントが手に入り、それを知らせるものは何もない。

依存は Git、Claude Code(ネイティブのインストーラが推奨。`npm install -g @anthropic-ai/claude-code` は Node 22+ で動く)、Python 3、Bash。Python 3 は見た目ほど任意ではない。すべての skill と hook がこれを通して `project.yaml` を読み、Python がないとすべての設定が黙って既定値に戻る。黙ったフォールバックはクラッシュより悪い。スタジオは間違った設定のまま動き続け、ルールが発火しないと気づくまで誰も気づかない。jq は hook の検証用に推奨されている。

主な開発環境は Windows 10 と Git Bash で、hook は macOS 標準の bash 3.2 と Linux でも試されている。`notify.sh` は Windows で PowerShell を使ってトースト通知を出し、他のプラットフォームでは何もしない。デスクトップ通知は今のところ Windows だけだ。

9 人のエンジン専門家、必要なのは 1 人

テンプレートには Godot 4、Unity、Unreal Engine 5 の agent セットが同梱されている。それぞれにリード 1 人と副専門家が付く。Godot は GDScript、シェーダー、GDExtension。Unity は DOTS/ECS、シェーダーと VFX、Addressables、UI Toolkit。Unreal は GAS、Blueprints、レプリケーション、UMG/CommonUI。

3 つとも 1 つのリポジトリに置くのは妥当な保険で、その代わり決して読み込まないテキストを大量に抱えることになる。README のカスタマイズの章は、不要な agent ファイルは削除しろと言っている。正しい助言であり、誰もやらない作業でもある。

自律ではない部分

README はこれがオートパイロットではないと明言していて、協働プロトコルもそれを裏づける。agent は提案の前に聞く。2 から 4 の選択肢をトレードオフ付きで出す。決めるのはユーザーだ。確定前に草稿を見せる。承認なしには何も書かない。`guided` と `autonomous` モードは確認の一部を速度と引き換えにし、README は自動モードへの経路を自身のセットアップ文書に委ねている。

フレームワーク自体のテストハーネスもある。`studio-tests/` は 74 の skill と 49 の agent を、カテゴリごとのルーブリックと振る舞い仕様付きで目録化する。`/skill-test` は 7 項目のコンプライアンス検査を持つ静的リンター、カテゴリのルーブリック、仕様のアサーションを走らせる。`/skill-improve` はテスト、修正、再テストのループを回し、スコアが上がらなければ差し戻す。ゲームとは別にフレームワークを試すことが、これを編集可能に保つ規律になる。

これは何のためのものか

README は小見出しの中で、自分に気まずい問いを投げている。これはゲームを作るのか、ドキュメントを作るのか。62 のドキュメントテンプレートと、あらゆるマイルストーンにゲートを備えたテンプレートは、個人開発はコードではなくプロセスで死ぬという側に賭けている。その賭けは妥当だ。AI 支援の個人プロジェクトが壊れるとき、よくあるのは記録されなかったハードコードされたマジックナンバー、3 改訂前のゲームを説明している設計ドキュメント、スモークチェックを誰も走らせなかったせいで壊れたチュートリアルを抱えたビルドだ。

49 の agent はそれを直さない。ゲームプレイのコードが編集されたときに発火するパス限定のルール、ビルド前に必ず走る `/smoke-check`、バリデータが動かないときに commit を止める hook の方が見込みがある。ここで本当に面白いのは、誰かが組織図を書き残したことだ。専門家がエスカレーションして待たなければならない部分まで含めて。

関連記事