CLAUDE.mdは目次だけにする（ルールと手順は別ファイルに置く）

同じプロジェクトを2台の PC で触っています。片方で決めたことを、もう片方の AI が知らない。この状態を一度作ってしまうと、面倒なことになります。

対策は単純でした。指示書には「どこを読むか」しか書かない。

指示書に全部書くと、3つの問題が出る

実際の構成（指示書はこの表だけ）

指示書に書くのは「どこに何があるか」。中身はすべて git の中に置く。

指示書の本体は、この表と「最初に読む」の指定だけです。22行に収まっています。

ルールは、事故が起きてから1行ずつ足す

最初に立派なルール集を書いても、ほとんど使われませんでした。いま残っているルールは、ほぼ全部が実際に踏んだ失敗から増えたものです。

ルールを足すときは、なぜそう決めたのか（何が起きたのか）を一緒に書くようにしています。理由が書いていないルールは、状況が変わったときに外していいのか判断できません。

手順書には「終わりの条件」を書く

手順を並べるだけだと、どこまでやれば終わりなのかが曖昧になります。各工程に、終わったと言える条件を付けました。

この形にしてから、「だいたいできました」で止まることが無くなりました。条件を満たしたかどうかは、AI 自身が判定できます。

ゲーム1本につき、仕様書1枚

ゲームを作るときに AI へ渡すのは、92行の仕様書1枚です。中身はこうなっています。

1. 1

   何を作るか（ひとことで）

   ジャンル・操作・1プレイの長さ
2. 2

   動作環境

   エンジンの版・対象プラットフォーム・画面の向き
3. 3

   ゲーム内容

   v1 で作るものだけ。やらないことも書く
4. 4

   作り方の約束

   遊びのルールはエンジンから切り離す、シーンはコードから作る、素材ファイルを使わない、など
5. 5

   品質の条件（合格ライン）

   容量・起動時間・fps・テストの件数・遊べること。数字で書く
6. 6

   段階

   各段階の終わりに、テスト・計測・記録を残す

いちばん効くのは4番目です。ここに作り方の制約を書いておくと、AI は毎回その形で書いてきます。あとから直すより、最初に1行書くほうが圧倒的に安いです。

Codex 側（AGENTS.md）について

Codex では AGENTS.md が同じ役割を担います。考え方（目次だけにして、中身は共有のファイルに置く）はそのまま使えるはずですが、このプロジェクトではまだ作っていないので、実測としては書けません。作ったら追記します。

まとめ

• 指示書は目次だけにする。このプロジェクトでは22行
• 中身は git で管理するファイルに置き、1つの事柄の正本を1か所に決める
• セッションが変わったら最初に読むファイルを決めておく（＝引き継ぎの手間が消える）
• ルールは事故が起きてから1行足す。理由（何が起きたか）も一緒に書く
• 手順書には工程ごとに「終わりの条件」を書く。AI が自分で判定できる形にする
• ゲームは仕様書1枚。作り方の制約を先に書くのがいちばん安い