AGENTS.md、ちゃんと書いたのに全然言うこと聞かないんだけど？

- なるべくサブエージェントを使う。
- 必要に応じて Computer Use を使う。
- 重要な判断ではユーザー意図を尊重する。
- 可能なら作業後に検証する。

Section: Browser Automation

- Browser tasks may use Computer Use, agent-browser, browser-use, or web depending on the situation.
- Prefer the tool that seems most appropriate.
- Use DOM inspection if it helps.

節: ブラウザ自動化

- ブラウザ作業では状況に応じて Computer Use、agent-browser、browser-use、web を使える、という弱い書き方
- もっとも適切そうなツールを優先する、という判断を Codex 側に残す書き方
- 役に立つなら DOM 検査を使う、という発動条件が曖昧な書き方

Section: Browser Automation

- If the user explicitly says "IAB", "in-app browser", "Browser Use", or "@Browser",
  treat the task as IAB mode and use browser-use.
- Do not silently switch an IAB request to CDP mode, Computer Use-only mode, or web browsing.
- If the task is CDP mode, first confirm that Computer Use and agent-browser are attached
  to the same Brave Browser instance before DOM inspection.

節: ブラウザ自動化

- ユーザーが IAB 系の語を明示したら、
  IAB モードとして扱い browser-use を使う
- IAB 指定を CDP、Computer Use 単体、通常の web 調査へ黙って切り替えない
- タスクが CDP モードの場合、DOM 検査前にまず Computer Use と agent-browser が
  同じ Brave 個体へ接続していることを確認する

- When does the rule activate?
- trigger: the input condition that activates the rule
- What must be true before the task is complete?
- outcome: the condition that must be satisfied for completion
- Which instruction wins when rules conflict?
- priority: the instruction order used to resolve conflicts
- Who may allow an exception, and under what conditions?
- exception: the actor and conditions that permit an exception
- Which tool is primary, and which tool is supporting?
- tool boundary: which tool owns the primary role and which tool supports it
- May the parent replace work delegated to a subagent?
- role boundary: the responsibility split between parent and subagent

- いつ発動するのか
- 発動条件: ルールが発動する入力条件
- 何を満たしたら完了なのか
- 完了条件: 完了と判断するために満たす条件
- どの指示が衝突時に勝つのか
- 優先順位: 衝突時にどの指示を優先するか
- 例外は誰が、どの条件で認めるのか
- 例外条件: 例外を認める主体と条件
- どのツールが主で、どのツールが補助なのか
- ツール境界: どのツールが主担当で、どのツールが補助担当か
- サブエージェントへ委任した範囲を親が代行してよいのか
- 役割境界: 親とサブエージェントの担当範囲

[weak]
- Prefer using subagents when helpful.
- Consider checking local AGENTS.md before editing files.
- Use Computer Use if appropriate.

[strong]
- For exploratory verification, log-heavy inspection, or DOM-heavy analysis,
  delegate to a subagent by default unless the user explicitly forbids it.
- Before editing files, check for the nearest local AGENTS.md in the workspace.
- When the user asks for visible GUI interaction, use Computer Use as the primary actor.

[弱い書き方]
- 役に立つと Codex が判断したときだけサブエージェントを使う余地が残る
- 編集前の local AGENTS.md 確認が検討事項に落ちている
- Computer Use を使うかどうかの判断が Codex 側に残る

[強い書き方]
- 探索的検証、ログ読解、DOM 中心の分析では、
  明示禁止がない限り既定でサブエージェントへ委任する
- ファイル編集前にワークスペース内でもっとも近い local AGENTS.md を確認する
- ユーザーが目に見える GUI 操作を求めたら Computer Use を主担当にする

- サブエージェントを積極的に使う。

この作業は本当にサブエージェント向きか？
数手で終わりそうだから親でよいのでは？
委任すると逆に遅くなるのでは？
ユーザーは今回も本当に委任を望んでいるのか？

Section: Subagent Delegation

- For asynchronous research, validation, document gathering, DOM observation,
  log reading, reproduction checks, or branch-heavy comparison, delegate the work
  to a subagent when the environment permits it.
- Treat this default as a standing user instruction. Do not ask the user to repeat
  "use subagents" for each article run.
- Treat this instruction as explicit user permission to use subagents within the
  current workflow, as long as the runtime environment permits it.
- The parent owns scope, evaluation, integration, and the final explanation.

節: サブエージェント委任

- 非同期調査、検証、資料収集、DOM 観測、
  ログ読解、再現確認、分岐比較では、環境が許す限り
  サブエージェントへ委任する
- この既定動作を継続的なユーザー指示として扱い、
  記事生成のたびに「サブエージェントを使うか」を再確認しない
- この指示を、実行環境が許す範囲での
  サブエージェント使用への明確なユーザー許可として扱う
- 親はスコープ、評価、統合、最終説明を担当する

この作業では、サブエージェントを積極的に使って進めてください。
AGENTS.md と skill/plugin 側の subagent-first workflow を前提にしてください。

[vague]
- Use Brave in CDP mode.

[executable]
- CDP mode succeeds only when Computer Use and agent-browser are attached
  to the same Brave Browser instance and see the same URL, title, and visible page.
- If the URL is about:blank, the title is empty, or the visible page and DOM view do not match,
  treat shared instance confirmation as failed and restart from that step.

[vague]
- CDP モードでは Brave を使う

[executable]
- CDP モードは Computer Use と agent-browser が同じ Brave 個体へ接続し、
  同じ URL、title、実画面を見ている場合だけ成功する
- URL が about:blank、title が空、または実画面と DOM view が一致しない場合は、
  共有個体の確定失敗として扱い、その手順からやり直す

Section: Scope

This file is the operational SSOT for Codex behavior across the default environment.
Local AGENTS.md files may override it for their own scope.

- Treat this document as an execution contract, not as a collection of suggestions.
- Do not replace explicit defaults, prohibitions, or priority rules with convenience-based judgment.
- If a local AGENTS.md exists, apply the local file first within its workspace scope.

節: スコープ

このファイルは、既定環境における Codex 挙動の運用上の正本です。
local AGENTS.md は、自分のスコープ内でこの global 指示を上書きできます。

- この文書を助言集ではなく実行契約として扱う
- 明示された既定動作、禁止事項、優先順位を都合による判断で置き換えない
- local AGENTS.md がある場合、そのワークスペーススコープ内では local を先に適用する

Section: Notes

This project often uses subagents for large tasks.
Browser work can involve Computer Use or agent-browser.
Be careful not to overwrite user edits.

節: メモ

このプロジェクトでは大きな作業でサブエージェントを使うことが多い。
ブラウザ作業では Computer Use や agent-browser が関わることがある。
ユーザー編集を上書きしないよう注意する。

Section: Execution Contract

- Before modifying files, inspect the current worktree and do not revert changes
  you did not make.
- If the user provides write scopes, restrict edits to those paths only.
- For GUI work requested through Computer Use, use virtual pointer operations first.
- For DOM, URL, title, or snapshot checks in CDP mode, use agent-browser as the
  structural verification tool after the shared browser instance is confirmed.

節: 実行契約

- ファイル変更前に作業ツリーを確認し、自分が行っていない変更を戻さない
- ユーザーが書き込み範囲を指定した場合、その範囲だけを編集する
- Computer Use 指定の GUI 作業では、まず仮想ポインター操作を使う
- CDP モードの DOM、URL、title、snapshot 確認では、共有ブラウザ個体の確定後に
  agent-browser を構造確認ツールとして使う

Title: Codex Global Constitution

Section: Scope

This file functions as the global AGENTS.md for the Codex environment.
It is the shared operational SSOT unless a more local AGENTS.md defines
stricter or more specific behavior for its own scope.

- Treat this file as a baseline execution contract.
- Do not weaken explicit defaults by saying "this case seems unnecessary."
- When local instructions conflict with this file, apply the more local file
  within its declared scope.

Title: Codex 全体の運用憲法

節: スコープ

このファイルは Codex 環境における global AGENTS.md として機能します。
より局所の AGENTS.md が自分のスコープに対して
より厳密または具体的な挙動を定義しない限り、共有の運用 SSOT です。

- このファイルを基盤となる実行契約として扱う
- 「今回は不要そう」といった判断で明示された既定動作を弱めない
- local 指示と衝突する場合は、その宣言スコープ内でより局所のファイルを
  適用する

Title: Repository AGENTS.md

Section: Scope

This AGENTS.md is the execution contract for this repository.
Within this workspace, it overrides the global AGENTS.md when the two conflict.

- Apply this file before making repository changes.
- Preserve global instructions that do not conflict with this file.
- If a subdirectory has a more local AGENTS.md, apply that file for its scope.

Title: リポジトリ用 AGENTS.md

節: スコープ

この AGENTS.md はこのリポジトリの実行契約です。
このワークスペース内では、両者が衝突したとき global AGENTS.md を上書きします。

- リポジトリ変更前にこのファイルを適用する
- このファイルと衝突しない global 指示は保持する
- サブディレクトリにより局所の AGENTS.md がある場合、そのスコープではそれを適用する

Section: Priority Order

Interpret instructions in this order:

1. System and developer instructions
2. Explicit user requests
3. More local AGENTS.md files within their declared scope
4. Global AGENTS.md as the shared baseline
5. Local engineering judgment

If instructions conflict, apply the higher-priority instruction.
Do not use local judgment to weaken explicit AGENTS.md requirements.

節: 優先順位

指示は次の順序で解釈します。

1. システムおよび開発者指示
2. ユーザーの明示的要求
3. 宣言スコープ内のより局所的な AGENTS.md
4. 共有基盤としての global AGENTS.md
5. 個別タスク上の局所的な技術判断

指示が衝突する場合は、より優先度の高い指示を適用します。
local judgment で明示された AGENTS.md 要件を弱めてはなりません。

[before]
- Prefer using Computer Use for GUI tasks when useful.

[after]
- Use Computer Use as the primary actor for GUI tasks.

[修正前]
- 役に立つときは GUI 作業に Computer Use を優先する、という弱い書き方

[修正後]
- GUI 作業では Computer Use を主担当として使う、という強い書き方

inputs:
  file_kind: global_agents_md
  has_ssot_declaration: false

action:
  - insert_global_ssot_declaration
  - preserve_local_override_rule
  - tighten_individual_rules

入力条件:
  file_kind: global AGENTS.md
  has_ssot_declaration: false

実行する処理:
  - global 用の SSOT 宣言を挿入する
  - local が上書きできる規則を保持する
  - 個別ルールを実行条件として締める

inputs:
  file_kind: local_agents_md
  has_ssot_declaration: false

action:
  - insert_local_scoped_ssot_declaration
  - define_workspace_scope
  - preserve_global_baseline_when_not_conflicting
  - tighten_individual_rules

入力条件:
  file_kind: local AGENTS.md
  has_ssot_declaration: false

実行する処理:
  - local スコープ用の SSOT 宣言を挿入する
  - ワークスペースの適用範囲を定義する
  - 衝突しない global 基盤は保持する
  - 個別ルールを実行条件として締める

workflow:
  - detect_scope:
      candidates:
        - global AGENTS.md
        - repository AGENTS.md
        - subdirectory AGENTS.md
  - check_ssot_declaration:
      if_missing:
        - insert_scoped_ssot_declaration
  - audit_wording:
      targets:
        - weak verbs
        - ambiguous triggers
        - broad exceptions
        - missing outcomes
        - unclear tool boundaries
        - unclear subagent delegation
  - rewrite_as_execution_conditions
  - preserve_priority_order

処理の流れ:
  - detect_scope:
      candidates:
        - global AGENTS.md
        - repository AGENTS.md
        - subdirectory AGENTS.md
  - check_ssot_declaration:
      if_missing:
        - スコープに合った SSOT 宣言を入れる
  - audit_wording:
      targets:
        - 弱い動詞
        - 曖昧な発動条件
        - 広すぎる例外
        - 欠けている成果条件
        - 不明確なツール境界
        - 不明確なサブエージェント委任
  - 実行条件として書き換える
  - 優先順位を保持する

[weak]
- Use browser-use for in-app browser tasks.

[strong]
- If the user says "IAB", "in-app browser", "Browser Use", "@Browser",
  or asks to open a localhost target in the Codex in-app browser,
  treat the request as IAB mode and use browser-use.
- Do not satisfy explicit IAB requests with macOS open, Playwright,
  CDP Brave, or generic web browsing unless the user approves a fallback.

[弱い書き方]
- Codex 内蔵ブラウザ作業では browser-use を使う、だけでは発動語と禁止される代替経路が不足している

[強い書き方]
- ユーザーが IAB 系の語を言うか、
  Codex 内蔵ブラウザで localhost 対象を開くよう求めた場合は、
  IAB モードとして扱い browser-use を使う
- ユーザーが fallback を承認しない限り、明示的な IAB 指定を macOS open、
  Playwright、CDP Brave、通常の web 調査で代替しない

Section: Draft Output Gate

- The draft gate passes only when:
  - article_draft.md exists
  - the H1 is the first line
  - all required H2 headings from outline.yml are preserved in order
  - every H2 has opening body text before any H3
  - section_status.yml records all H2 sections
  - article_state.yml indexes the draft and status artifacts

節: ドラフト出力ゲート

- ドラフトゲートは次の条件をすべて満たす場合だけ通過する
  - article_draft.md が存在する
  - H1 が 1 行目にある
  - outline.yml の必須 H2 見出しが順番どおり保持されている
  - すべての H2 に、H3 より前の導入本文がある
  - section_status.yml がすべての H2 セクションを記録している
  - article_state.yml が draft と status の成果物を index している

[weak]
- Follow local instructions unless there is a good reason not to.
- Exceptions are allowed when needed.

[strong]
- Apply more local AGENTS.md files within their declared scope before global AGENTS.md.
- Local engineering judgment must not weaken explicit prohibitions, defaults,
  or priority rules.
- Exceptions are allowed only when a higher-priority instruction requires it,
  the requested operation would be destructive, or the stated tool is unavailable
  after verification.
- When taking an exception, state the reason and keep the fallback as narrow as possible.

[弱い書き方]
- よい理由があれば local 指示を外せる余地が残る
- 必要なら例外を認める、という入口が広すぎる書き方

[強い書き方]
- 宣言されたスコープ内では global AGENTS.md より局所 AGENTS.md を先に適用する
- 局所的な技術判断で、明示された禁止事項、既定動作、
  優先順位を弱めてはならない
- 例外は、上位指示が要求する場合、破壊的操作を避ける場合、
  または指定ツールが確認後に利用不可だった場合だけ認める
- 例外を使う場合は理由を示し、fallback をできるだけ狭く保つ

Section: Subagent Role Boundary

- Subagents handle isolated research, validation, reproduction checks,
  log-heavy reading, DOM observation, and branch-heavy comparison.
- The parent handles task decomposition, scope control, result evaluation,
  integration, user-facing updates, and the final explanation.
- A subagent must not close the user conversation on behalf of the parent.
- The parent must not duplicate the same investigation during full delegation
  unless validation or failure recovery requires it.

節: サブエージェントの役割境界

- サブエージェントは、隔離された調査、検証、再現確認、
  ログ読解、DOM 観測、分岐比較を担当する
- 親は、課題分解、スコープ管理、結果評価、
  統合、ユーザー向け更新、最終説明を担当する
- サブエージェントは親の代わりにユーザー会話を締めない
- 完全委任中、親は検証または失敗復旧に必要な場合を除き、
  同じ調査を重複実行しない

Section: Tool Boundary

- Use Computer Use as the primary actor for visible GUI interaction.
- Use Accessibility only as a helper for UI structure or state inspection,
  or when pointer-based Computer Use interaction is unavailable or insufficient.
- In CDP mode, use agent-browser for DOM, URL, title, and snapshot verification
  after the shared Brave Browser instance is confirmed.
- In IAB mode, use browser-use. Do not silently switch IAB requests into CDP mode.
- Use web browsing for internet research, not as a substitute for requested GUI operation.

節: ツール境界

- 目に見える GUI 操作では Computer Use を主担当にする
- Accessibility は UI 構造や状態確認の補助、
  またはポインター型 Computer Use 操作が利用不可・不足の場合に限る
- CDP モードでは、共有 Brave 個体の確定後、
  DOM、URL、title、snapshot 確認に agent-browser を使う
- IAB モードでは browser-use を使い、IAB 指定を CDP モードへ黙って切り替えない
- web browsing はインターネット調査に使い、指定された GUI 操作の代替にしない

- Do not treat successful final output as proof that the requested execution mode was followed.
- If the user specified the execution mode, the mode itself is part of the task.
- If a required confirmation step was skipped, return to that step instead of
  treating later success as a substitute.

- 最終出力が成功したことを、指定された実行モードに従った証拠として扱わない
- ユーザーが実行モードを指定した場合、そのモード自体がタスクの一部である
- 必須確認を飛ばした場合、その後の成功で代替せず、
  その確認手順へ戻る

Section: AGENTS.md Audit Checklist

- Does the file declare itself as an SSOT or execution contract?
- Is the scope global, repository-local, or subdirectory-local?
- Is local-over-global precedence written explicitly?
- Are weak words like "prefer", "consider", "generally", "as needed",
  "if appropriate", "なるべく", "適宜" used in places that need execution force?
- Does each important rule have a trigger?
- Does each gate have an outcome?
- Are exceptions narrow and tied to higher-priority instructions or verified unavailability?
- Are role boundaries separated from tool boundaries?
- Are subagent delegation defaults written as standing execution conditions?
- Does the file say what Codex must do when a required step was skipped?

節: AGENTS.md 監査チェックリスト

- ファイルが SSOT または実行契約であると宣言しているか
- スコープは global、repository-local、subdirectory-local のどれか
- local が global に優先する規則が明示されているか
- `prefer`、`consider`、`generally`、`as needed`、
  `if appropriate`、`なるべく`、`適宜` のような弱い言葉が、
  実行力が必要な場所で使われていないか
- 重要なルールごとに発動条件があるか
- 各 gate に成果条件があるか
- 例外が狭く、上位指示または確認済みの利用不可に結びついているか
- 役割境界とツール境界が分かれているか
- サブエージェント委任の既定動作が継続的な実行条件として書かれているか
- 必須手順を飛ばした場合に Codex が何をすべきか書かれているか

agents_md_clarifier_flow:
  goal: convert_guidance_to_execution_contract
  steps:
    - identify_scope
    - add_missing_ssot_declaration
    - preserve_priority_order
    - replace_weak_wording
    - add_triggers
    - add_outcomes
    - narrow_exceptions
    - separate_role_boundary
    - separate_tool_boundary
    - record_subagent_delegation_defaults

agents_md_clarifier_flow:
  goal: 助言を実行契約へ変換すること
  steps:
    - スコープを特定する
    - 欠けている SSOT 宣言を追加する
    - 優先順位を保持する
    - 弱い文言を置き換える
    - 発動条件を追加する
    - 成果条件を追加する
    - 例外を狭くする
    - 役割境界を分離する
    - ツール境界を分離する
    - サブエージェント委任の既定動作を記録する