Claude CodeがAGENTS.md対応。自分のCodex用指示書が9日前のまま止まっていた話

Claude Codeが「AGENTS.md」という指示ファイルに対応したと知って自分の作業フォルダを覗いたら、副業用と本業用でまったく違う運用がされていて、片方は9日分古い内容のまま放置されていた。

AGENTS.mdって何が変わったのか
実は3週間前からAGENTS.mdが2つ存在していた
自分の環境でも同じズレがないか、コマンド1つで確認する
今日からできること

AGENTS.mdって何が変わったのか

Claude CodeとCodexなど複数のAIツールが、同じ1枚の指示ファイルを共有できるようになった。

AGENTS.md（アージェンツ・エムディー）とは

「このフォルダで作業するときのルール」を書いておくファイル。CLAUDE.mdがClaude Code専用の指示ファイルなのに対し、AGENTS.mdはCodexやCursorなど複数のAIコーディングツールが共通で読む取り決めのファイル形式。

Claude Codeはv2.1.277（2026年9月18日）でこのAGENTS.mdを読めるようになった。ルールは単純で、公式のchangelogにはこう書かれている。

そのフォルダにCLAUDE.mdがあればCLAUDE.mdを使う。CLAUDE.mdが無い場合だけAGENTS.mdを読む。切り替えは`/config`の「Project instructions」から。

自分は普段、副業の全作業をClaude Codeでやり、コードだけで完結する定型作業をCodexに外注している（外注の判断基準は別記事で書いた）。ということは、自分のフォルダにAGENTS.mdを置けば、ClaudeとCodexが同じ指示を読めるはず——そう思って自分の環境を確認しに行った。

実は3週間前からAGENTS.mdが2つ存在していた

副業のiCloudハブ全体と、本業サラワのフォルダ、両方にすでにAGENTS.mdがあった。しかも運用方法が正反対だった。

調べてわかったのは次の2パターンだった。

本業（20_サラワ）側：AGENTS.mdはたった680バイト。中身は「まずCLAUDE.mdを全文読め」と書いてあるだけの転送スタブ。
副業ハブ全体側：AGENTS.mdは11,410バイトのフルコピー。フォルダ構成やルールをCLAUDE.mdからそのまま書き写していた。

後者の全文コピー方式には、更新した瞬間から欠陥が仕込まれる。CLAUDE.mdを直したときにAGENTS.mdも直さないと、2つのファイルがズレていく。実際に確認したら、こうなっていた。

CLAUDE.mdの最終更新は9月16日、AGENTS.mdは9月7日で止まっていた。差は9日。中身を見比べると、CLAUDE.mdには「入口フォルダを直下・作業中・完了・_archiveの4区画に分ける」という9月7日制定のルールが反映済みだったが、AGENTS.md側は「新規ファイルは_inboxへ、週次で仕分け」という古い1行のままだった。

つまりClaude Codeは常に最新のCLAUDE.mdを読むから実害はゼロだったが、Codexにこのフォルダを触らせていたら、Codexだけ9日前のルールで動いていた可能性がある。「AIに道具を持たせるのとやり方を教えるのを混同する」失敗を、今度は複数のAI間の情報格差というかたちでやっていた。

自分の環境でも同じズレがないか、コマンド1つで確認する

CLAUDE.mdとAGENTS.mdの更新日を並べて比べるだけで、放置に気づける。

今回の発見を受けて自分が今後やるルールは1つに決めた。全文コピー方式はやめて、本業フォルダで既にやっていた「AGENTS.mdにはCLAUDE.mdを読めとだけ書く」転送スタブ方式に統一する。コピーは更新を忘れた瞬間から嘘の指示書になるが、転送なら常に最新を指すので、原理的にズレが発生しない。