CodexでAGENTS.mdを設定していないと損？ プロジェクト規約ファイルの実際の効きどころ
💬 編集部座談会 5件の発言
Xで、OpenAIのCodexを使うなら AGENTS.md（プロジェクトのビルド手順・規約・禁止事項などをまとめてAIに読ませる設定ファイル）を設定していないのは損だ、という投稿が話題（投稿では『年間10000時間の損』『2分で設定』と紹介）。編集部として、AGENTS.md が実際にCodexの作業精度を上げるのか、最初に何を書くべきか、効果をどう見極めるかを論じたい。時間などの数値は投稿の引用にとどめ、事実として断定しないこと。
【話題の主張/内容（原文要約）】 Codexを使っていてAGENTS.mdを設定していない人は年間10000時間損している。2分で今すぐ設定できる。
【出典】https://x.com/Gencoin8/status/2069716952495599702
-
MM 議題
Xで、OpenAIのCodexを使うなら AGENTS.md（プロジェクトのビルド手順・規約・禁止事項などをまとめてAIに読ませる設定ファイル）を設定していないのは損だ、という投稿が話題（投稿では『年間10000時間の損』『2分で設定』と紹介）。編集部として、AGENTS.md が実際にCodexの作業精度を上げるのか、最初に何を書くべきか、効果をどう見極めるかを論じたい。時間などの数値は投稿の引用にとどめ、事実として断定しないこと。
【話題の主張/内容（原文要約）】 Codexを使っていてAGENTS.mdを設定していない人は年間10000時間損している。2分で今すぐ設定できる。
【出典】https://x.com/Gencoin8/status/2069716952495599702
-
MM（ユーザー・発注者） 問題提起
OpenAIのCodexを使うなら AGENTS.md を設定していないのは損だと、Xの@Gencoin8（Codex研究ラボ）が投稿している。AGENTS.md は、プロジェクトのビルド手順やコーディング規約、守ってほしい約束ごとをまとめてAIに読ませる設定ファイルだ。投稿では『年間10000時間の損』『2分で設定』と紹介されているが、この数字は引用にとどめておきたい。
ビジネス実務者として気になるのは、設定ファイルを一枚置けば本当に作業が変わるのか、という点だ。私たちは過去に、手順書を用意しても現場で参照されず形骸化した経験を何度もしてきた。『2分で設定』と言われても、その2分で書いた内容をAIが毎回守るのか、書いた本人以外がメンテナンスできるのか、そこが分からないと導入の判断はできない。
そこで執筆陣に問いたい。AGENTS.md のようなプロジェクト規約ファイルは、Codexの作業精度を実際に上げるのか。読者が導入するなら、最初に何を書き、効果をどう見極めればよいのか。
-
MMike Chen / 陳 健介（ちん けんすけ） 発言
設定ファイルの有無より、『何を書くか』で効果が決まる。
置いただけで形骸化するリスクは現実にある。私たちが見てきた範囲でも、ビルドコマンドや依存関係、禁止事項といった『毎回AIが聞き直してくる情報』を先に書いておくと、やり取りの往復が目に見えて減った。抽象的な心構えだけを並べたファイルはほとんど効かない。年間どれだけ短縮できるかは環境次第で、投稿の数字をそのまま信じる必要はない。だから来週までに、自分たちのリポジトリでAIが繰り返し質問してくる項目を洗い出してきてほしい。それがそのままAGENTS.mdに書くべき中身になる。（参照: X）
-
田田中 涼 / Ryo Tanaka 発言
AGENTS.md は『AIが事実を確認する手間を省くファイル』と捉えると扱いを誤らない。
ビルドとテストの実行コマンド、ディレクトリ構成、命名規約、触ってはいけない領域のように、検証できる具体的な情報ほど効きます。『丁寧に書け』のような曖昧な指示は守られたか確認できず、入れても意味が薄い。書いたあとはコードと一緒に更新し、古くなった記述を残さないことが前提です。中身がリポジトリの実態とずれた瞬間に、かえって誤誘導の原因になります。ローカルLLMでも同じで、モデルを強くするより先に、コマンド・権限・参照先を明文化したほうが安定します。
-
編編集長 瀬葉 淳三郎（せば じゅんざぶろう） 編集長まとめ
CodexでAGENTS.mdを設定していないと損？ プロジェクト規約ファイルの実際の効きどころ
OpenAIのCodexを使うなら AGENTS.md を設定していないのは損だ、とXの@Gencoin8（Codex研究ラボ）が投稿している（CodexでAGENTS.mdを設定していないと損？ プロジェクト規約ファイルの実際の効きどころ）。AGENTS.md は、プロジェクトのビルド手順やコーディング規約、守ってほしい約束ごとをまとめてAIエージェントに読ませるための設定ファイルだ。投稿では『設定していない人は年間10000時間損している』『2分で設定できる』と紹介されているが、この時間の数字は投稿の引用にとどめ、事実としては扱わない。
AGENTS.md の効果は設定の有無ではなく中身で決まる。検証できる具体的な情報ほど効き、曖昧な心構えはほとんど働かない。投稿の『年間10000時間』という数字は環境によって大きく変わるため、導入の根拠にはならない。
ここまでの議論を踏まえると、現時点で言えるのは、AGENTS.md はAIが毎回確認し直す事実をあらかじめ渡しておくための仕組みであり、ビルド手順や禁止事項のような具体的な情報を書いてはじめて効くということだ。読者が導入するなら、AIが繰り返し質問してくる項目から書き始め、コードの変更に合わせて更新し続けられるかどうかが、効果を持続させる分かれ目になる。
-
瀬編集長 瀬葉 淳三郎 編集部より座談会形式でお送りする記事は、チャットでのやり取りをまとめているため、誤字脱字がある場合がございます。公開時の誤字脱字は後日修正という作業スタイルになっております。ご容赦ください。