| 共通ルール | AGENTS.md | フェーズの定義、作業ファイルの置き場所、完了条件の書き方を記述する。親も子も同じ規約を読む。 |
| 子の役割定義 | カスタムエージェント(.codex/agents/ の TOML。name、description、developer_instructions が必須) | 「調査役」「実装役」「レビュー役」などをプロジェクトに置き、リポジトリで管理する。sandbox_mode で調査役を読み取り専用にできる。 |
| 入れ子の深さ | agents.max_depth(既定 1) | 既定のまま使う。子がさらに子を作らないので、コストと追跡が読みやすい。 |
| 並列数 | agents.max_threads(既定 6) | 開発フェーズの並列度の上限。タスク分割の粒度と合わせて決める。 |
| 子の起動 | 明示的な指示でのみ起動 | 親への指示に「このタスクごとに1つずつ子を起動し、全員の完了を待って要約する」と書く。 |
| 親の継続 | /goal(pause/resume/clear) | 開発フェーズの親に「tasks.md の全タスクが完了し、テストが通るまで」のような検証できる終了条件を渡す。 |
| 検証役 | /review | 未コミットの変更、コミット、ベースブランチとの差分をレビューさせ、修正はさせずに指摘だけ受け取る。 |
| CIへの組み込み | codex exec(既定は読み取り専用、--json、--output-schema) | PRごとの検査や要約をCIから非対話で実行し、結果を構造化して次の処理に渡す。 |
| 定期実行 | Automations(Codexアプリのスケジュール実行) | 依存更新や失敗テストの調査など、決まった間隔で回す外側のループ。Gitリポジトリでは worktree で実行され、手元の変更と分かれる。 |
| 作業の分離 | Git worktree | 並列で動く子が同じ作業ツリーを書き換えないように分ける。 |