AGENTS.mdはレビュー負荷を下げるのか？AIコーディングエージェントへの指示書設計
AGENTS.mdがAI coding agentsのruntimeやtoken消費に与える研究と、Codex公式docsをもとに、レビュー負荷を下げる指示書設計を整理します。
公開 2026.06.26 / 更新 2026.06.26
この記事のポイント
- AGENTS.md研究では、AGENTS.mdの存在がruntimeや出力token削減と関連する結果が報告されている
- OpenAI Developersは、Codexが作業前にAGENTS.mdを読むと説明している
- レビュー負荷を下げるAGENTS.mdには、禁止操作、確認コマンド、完了報告、触ってよい範囲を書く
AGENTS.mdはAIへの作業前ルール
AGENTS.mdは、AIにプロジェクトの作業規約を渡すファイルです。書くべきことは長い理念ではなく、触ってよい範囲、禁止操作、確認コマンド、完了報告の型です。
## Review-saving rules
- Run npm run build and existing checks after code or article changes.
- Do not show .env, API keys, tokens, cookies, or private keys.
- Do not change package.json, lockfiles, global CSS, deploy workflows, or analytics tags unless asked.
- Report changed files, build/check results, upload/sitemap status, commit hash, and remaining risks.
- Ask before deploy, database migration, force push, destructive cleanup, or dependency install.よくある質問
この記事はAIコーディングを否定する話ですか？
否定ではありません。生成速度だけでなく、仕様、レビュー、テスト、保守、権限を含めた納品速度で見るための整理です。
CodexやClaude Codeに任せるなら何を先に決めるべきですか？
対象ファイル、触ってよい範囲、禁止操作、build/check、完了報告、差分レビュー、本番反映前の確認方法を先に決めます。
AGENTS.mdを書けばレビューを省けますか？
不要にはなりません。レビューしやすい差分を作らせる助けになりますが、最終的な差分確認と公開判断は人間側に残ります。
関連記事
- Codexの完了報告はどこを見る？build・check・diff・本番確認URLの読み方
Codexが「完了」と言ったあと、何を見るべきか。build/checkの成功、未確認事項、diff、upload、commit hash、本番確認URLを順番に読みます。
- AIにpushさせる前に見るGitHub差分レビュー｜個人開発者の安全チェック
AIにpushさせる前に、ファイル単位で何を見るか。GitHub差分、関連ファイル、package変更、secret、CI/CD、本番影響を短く確認します。