agents-md / discovery-order · 約 8 分

探索順序

ルートとサブディレクトリで読み込みが変わることを観察します。

学習目標

グローバルは AGENTS.override.md があればそれ、なければ AGENTS.md です。プロジェクトはルートから cwd へ降り、各階層で override → AGENTS.md → fallback の順に1ファイルです。近い方が後に連結されます。 ^{[codex-agents-md]}

前提

ルート AGENTS.md があること。

なぜ必要か

支払いサービスのテストコマンドがルートの npm test と違うとき、階層で上書きします。

実行場所

実機。

codex --cd services/payments --ask-for-approval never "List the instruction sources you loaded."

--ask-for-approval は対話 CLI 専用です。codex exec -a は使わないでください。

期待: グローバル、ルート、payments の順で引用されます。

成功結果

services/payments/AGENTS.md に make test-payments があります。

失敗対処

cwd がルートのままだとネストは読みません。--cd を付けます。 ^{[codex-agents-md]}