Codexが AGENTS.md でルールを実行しない場合は、まずスタートアップディレクトリとファイルの階層を確認し、プロンプトを繰り返し変更しないようにしてください。 Codexはグローバル構成から始まり、プロジェクトのルートディレクトリから現在の作業ディレクトリまで読み込みます。 現在のディレクトリに近いルールが優先され、TUIセッションの各実行または開始時に命令の連鎖が再構築されます。
まず、ファイルが実際に検索パス内にあることを確認してください
プロジェクトルールはGitリポジトリのルートディレクトリ、または現在のワーキングディレクトリの親ディレクトリに配置されるべきです。 リポジトリの外から始める場合や、実際の作業ディレクトリが別のサブディレクトリにある場合、Codexは編集したファイルをパスしないこともあります。 ターゲットディレクトリから始めることができます:
codex --cd services/api "列出当前生效的指令文件"プロジェクトがGitリポジトリでない場合、Codexは通常現在のディレクトリのみをチェックするため、無関係な親ディレクトリに AGENTS.md 置いて自動的に有効になると期待しないでください。
次に補償関係を確認してください
同じディレクトリ内では、AGENTS.override.mdがAGENTS.mdより優先され、Codexは1層あたり最大1つのファイルを読み取ることができます。 グローバルディレクトリ ~/.codexにはオーバーライドファイルも含まれます。 一時的なオーバーライドには適していますが、削除し忘れるとプロジェクトルールが無効に見えてしまいます。 ネストされたディレクトリ内のルールはルートディレクトリルールの後にランク付けされます。競合がある場合は、現在のディレクトリに最も近いコンテンツが優先されます。
内容が長すぎると、それもカットされます
Codexはデフォルトでサイズ制限のあるプロジェクト命令のみを読み込みます。マージされたコンテンツが上限に達すると、その後のルールはコンテキストに入り込むことはできません。 一般的な仕様をルートディレクトリに保持し、サービス固有のコマンドを対応するサブディレクトリに配置する方が、すべての要件を一つの大きなファイルにまとめるよりも通常より信頼性が高いです。
修正後は再度実行しなければなりません
AGENTS.md 実行中に継続的にホットアップデートを行う構成ではありません。 ファイルを編集した後、Codexを再起動するか、現在のTUIセッションを終了してから再開します。 カスタムの代替ファイル名を変更する場合は、そのファイル名がproject_doc_fallback_filenamesに書き込まれているかも確認してください。 最後に、Codexに有効なルールを繰り返し、プロジェクトのルートディレクトリ、グローバルCODEX_HOME、最も近いオーバーライドファイルを確認します。これら3つすべてが一貫して初めて正式なタスクが開始されます。
