CodexのAGENTS.mdは長いほどいい？GPT-6公式ガイドで学ぶ指示の整理術

Codexにたくさん指示を書いたのに、なぜか仕事が遅い。 そんなとき、さらに説明を足す前に確認したいのが「その指示、毎回必要？」という疑問です。

OpenAIは2026年10月2日に公開したGPT-6ファミリーの実践ガイドで、Skills、AGENTS.md、作業ごとのプロンプトを整理し、何を自律実行してよいか、何をもって完了とするかを明確にすることを勧めています。

これは「長い指示は全部ダメ」という話ではありません。重要なのは、必要な情報を必要なときに読み、安全に進める境界を残すことです。

この記事では公式資料をもとに、初めてCodexでプロジェクトを動かす人にも分かるように整理します。2026年10月17日時点の公開情報に基づく解説であり、ここで紹介する改善効果をRossy Laboratoryが独自に計測したものではありません。

まず3種類の「指示書」を分けて考えよう

Codexを使うと、指示がいくつかの場所に分散しがちです。

種類	主な役割	例
`AGENTS.md`	リポジトリで繰り返し守る約束	変更対象の範囲、テスト方針、重要な禁止事項
Skills	特定の仕事をするときに呼び出す手順	リリースノート作成、特定形式の資料作成
今回のプロンプト	いま達成したい仕事	「この画面の表示崩れを修正して」

リポジトリとは、プログラムや関連ファイルをまとめて管理する場所のこと。 AGENTS.md はCodexが認識する任意の指示ファイルで、すべてのプロジェクトに必須というわけではありません。OpenAI Cookbookでも、目的やコーディング規約、テスト基準、参照資料などを置く例が示されています。

😺「じゃあ、全部AGENTS.mdに書けば忘れなくて済むのでは？」

🐈‍⬛「毎回読む必要がない説明まで詰め込むと、かえって作業の邪魔になることがあるよ」

公式が指摘する問題①：関係ない資料を毎回読ませる

OpenAI Developersの2026年9月11日の記事は、ちょっとした修正のたびに大量の設計書を読むよう要求することを、見直すべき例として挙げています。

たとえば、次のようなルールです。

見直し前

作業を始める前に、architecture.md、database.md、
deployment.mdを必ずすべて読む。

見直し後の例

サービスの境界を変更するときはarchitecture.mdを参照する。
DBスキーマを変更するときはdatabase.mdを参照する。
公開準備をするときはdeployment.mdを参照する。

変更したのは資料の中身ではなく、読む条件です。小さな文言修正とデータベース移行では、必要な知識が違います。

ただし、依存関係が複雑なプロジェクトや危険な操作を含む工程では、事前確認が必要な場合もあります。安全上必須の確認まで削ることを勧めているわけではありません。

問題②：Skillの説明が広すぎる

Skillは、特定の作業で使う説明や補助ファイルをまとめたものです。OpenAIは、Skillの説明文が長すぎたり、利用条件が広すぎたりすると、Codexが適切なSkillを選びにくくなる可能性を説明しています。

たとえば、データベース移行専用のSkillなら、

広すぎる説明：「データベースに関する作業で使う」
絞った説明：「マイグレーションの追加・変更・公開手順の確認時に使う」

という違いがあります。

マイグレーションとは、データベースの構造を変更する作業のこと。単に検索用SQLを読むだけなのに、構造変更用の大きな手順書を読み込む必要はありません。

公式は、Skillの入口を短くし、詳しい手順は必要になったときだけ別ファイルから読む**段階的な情報開示（progressive disclosure）**も推奨しています。

問題③：「どこまでやれば完了か」が書かれていない

AIに「バグを直して」と頼んだ場合、コードを書き換えた時点で止まるのか、テストして結果を確認するまで進めるのかは、依頼文だけでは曖昧です。

そこで役立つのが完了条件です。

対象：設定画面の保存ボタンが反応しない問題
変更範囲：設定画面と関係するテストのみ

完了条件：
1. 原因を確認して修正する
2. 関係するテストを実行する
3. 失敗した場合は原因を調べ、対象範囲で再修正する
4. 変更したファイルとテスト結果を報告する

公開、課金操作、外部サービスの設定変更は行わない。
必要になったら作業を止めて確認する。

この例なら、やってよいことと確認が必要なことが分かれています。

OpenAIのガイドも、実装だけでなく動作確認や失敗時の修正まで求める場合は、その範囲を明示するよう勧めています。ただし「すべての操作を自動承認する」という意味ではありません。

安全な自律実行と、勝手に進めてはいけない操作

初心者が特に区別したいのは、作業を途中で止めないことと承認なしに何でもすることは別だという点です。

たとえば、使い捨てのテストデータを使うローカルテストは、条件が確認できていれば自律実行しやすい作業です。一方、本番データの削除、公開先の変更、課金につながる操作は別の判断が必要です。

自律実行の候補	明示的な確認を残したい操作
許可された範囲のコード調査	本番データの削除
安全なローカルテスト	外部公開や本番反映
変更箇所の差分確認	課金・権限・秘密情報の変更
テスト結果の報告	指示された範囲外への変更

これはOpenAIの説明をもとにした運用例で、全プロジェクトに共通する自動許可リストではありません。実際には組織のポリシーや実行環境の制限が優先されます。

今日できる、AGENTS.mdの小さな整理

大改造は不要です。まずは今の指示書を開き、次の3点を点検してみましょう。

1. 「毎回必ず読む」を探す。 その資料が必要になる作業条件を具体的に書けないか確認します。

2. 同じ内容が複数箇所にないか探す。 AGENTS.md、Skill、今回のプロンプトで同じ指示が繰り返されていたら、役割に応じて整理します。ただし、安全上の制約は抜け落ちないようにします。

3. 完了条件を1行追加する。 たとえば「修正後、関連テストを実行し、変更点と結果を報告する」。これだけでも依頼の終点が明確になります。

最初から全ファイルを整理する必要はありません。小さなタスクを1件選び、変更前後で何を読んだか、何を確認できたかを比べる方が実践的です。

まとめ：指示を減らすのではなく、届く場所を整える

2026年10月のGPT-6公式ガイドが示す方向は、単純な「短文プロンプト最強説」ではありません。

長く守るルールはAGENTS.mdへ、特定作業の手順はSkillsへ、今回のゴールはプロンプトへ。 そして、どこまで自分で進めてよいか、何が終われば完了なのかを明確にすることです。

Codexが思ったように進まないとき、モデルを変更する前に、まず指示の置き場所を見直す価値があります。