Codex

手順: Codex 初期設定（リポ）

構築順（公式）: AGENTS.md → Skills → MCP → Subagents

1. ルートに AGENTS.md（短い索引）→ サンプル
2. tasks/todo.md
3. .agents/skills/<name>/SKILL.md（長い手順）
4. （任意）.codex/config.toml — プロジェクト上書き
5. （任意）MCP — Skill の SKILL.md に利用ツールを宣言

project/
├── AGENTS.md
├── tasks/todo.md
├── .agents/skills/deploy/SKILL.md
├── .codex/config.toml          # 任意
└── src/feature-x/AGENTS.md     # この cwd 用の追加規約

# .codex/config.toml（例）
[project]
approval_policy = "suggest"   # 慣れたら "auto"（Git 追跡ブランチ上のみ）

手順: 典型ワークフロー（Codex）

出典: customization

A. Issue → 実装 → PR

1. GitHub Issue の Acceptance Criteria を tasks/todo.md に転記
2. Codex に Issue URL + @AGENTS.md + @tasks/todo.md
3. 差分を suggest モードで 1 ファイルずつ承認
4. CI green → PR 作成（push は許可後）

Issue #42 を実装。AGENTS.md と tasks/todo.md に従う。
Done when: CI の rspec job green。docs/invoice-export/02_design.md と整合。

B. サブフォルダ作業

cwd: src/feature-x/
→ AGENTS.md（ルート）を読んだあと src/feature-x/AGENTS.md を追加適用

公式対応と配置

公式 BP → 本リポの対応（一覧）

公式	手順
AGENTS 階層	初期設定 · ツリー
Skills 段階ロード	SKILL.md サンプル
承認モード	approval_policy = suggest から開始
CI 失敗	/fix-ci（Cursor 併用時）· ログ URL を渡す

手順: セッション引き継ぎ

1. 新規スレッド
2. tasks/todo.md + 変更対象パスを列挙
3. モジュール固有ルールはそのフォルダの AGENTS.md を参照させる

配置ツリー（Codex）

project/
├── AGENTS.md
├── tasks/todo.md
├── .agents/skills/deploy/SKILL.md
├── .codex/config.toml
└── src/feature-x/AGENTS.md