
Codexに渡す仕事は、どこで切ると流れが崩れにくいのか
Codex を使い始めると、だんだん「何ができるか」より「どこまで渡すか」で迷うようになります。
小さい修正ならいけそう。でも、少し広い仕事になると急に手触りが変わる。ここで起きているのは、能力の差というより、仕事の切り方の差だと思います。
仕事を小さくするより、境界をはっきりさせる方が先です。
OpenAI Developers の Codex use cases と AGENTS.md を並べると、この感覚はかなり整理しやすくなります。
「広い仕事」より「終わりが見える仕事」を渡す
Codex use cases に並んでいる仕事を見ると、どれも大きそうに見えるのに、実は終わり方が見えています。
pull request をレビューする
API integration を upgrade する
responsive front-end を build する
大きいコードベースを理解する
この一覧を見ると、広い仕事を渡してよさそうに見えます。でも、実際に書かれているのは「何をどこまでやるか」が見えている仕事です。

だから、渡し方のコツは「とにかく小さくする」ではなく、「終わりが見える単位にする」ことです。
たとえば、
この PR の懸念点を3つ出して
このディレクトリの役割を整理して
この画面の崩れだけ直して
このテストだけ足して
このくらいまで境界が見えていると、Codex もこちらも迷いにくくなります。
仕事を切る時は、4つだけ決める
Codex に渡す仕事を考える時、最初に全部説明しようとすると、逆に流れが崩れやすくなります。
先に決めたいのはこの4つです。
どこを見るのか
何を変えるのか
何は変えないのか
最後に何を返してほしいのか
この4つが見えていると、かなり安定します。
逆に、
全体を見ていい感じにして
必要なら何でも変えて
よしなに判断して
みたいな渡し方だと、こちらの期待もぶれやすくなります。
AGENTS.md は、毎回同じことを言わなくてよくする
OpenAI Developers の AGENTS.md guide では、リポジトリ内に AGENTS.md を置いて、プロジェクトのルールやよくある流れを書いておく考え方が案内されています。
ここがかなり大きいです。

毎回プロンプトで
テストはこれを使う
触っていいのはこの範囲
この書き方に合わせる
最後にこの形で返して
と書き直すのは重いです。AGENTS.md があると、この共通部分を repo 側に置いておけます。
すると、その時のプロンプトでは「今回どこをやるか」に集中しやすくなります。
崩れにくいのは「大きい仕事を小さく切る」より「小さい仕事をつなぐ」やり方
ここも感覚が変わりやすいところです。
最初は、大きい仕事をどう分割するかを考えがちです。でも、実際に流れが崩れにくいのは、最初から小さい仕事をいくつかつないでいくやり方です。
たとえば、
まず読む
次に懸念点を出す
そのあと直す
最後にテストする
この順で進めると、途中で止まりにくくなります。
一方で、
全部まとめて直して
ついでに設計も整理して
必要ならテストも足して
だと、一回で広がりすぎます。
だから仕事を切る時は、粒度より順番も大事です。読む -> 判断する -> 直す の順が見えていると、Codex に渡す仕事はかなり安定します。
4話目で覚えておきたいのは、境界と順番
Codex に渡す仕事を考える時、見るべきなのはこの2つです。
境界が見えているか
順番が見えているか
この2つがあると、仕事は広くても崩れにくくなります。逆に、この2つがないまま「全部やって」に近づくほど、途中の確認ややり直しが増えやすくなります。
4話目で押さえておきたいのは、Codex は何でもできるから広く渡す、ではないということです。むしろ、境界と順番が見える仕事ほど、Codex の良さが出やすい です。
次の回では、その流れの中で実際に詰まりやすい場所を見ていきます。どこで期待しすぎるのか、どこで頼み方が雑になりやすいのかを、もう少し具体に整理します。
参考にしたもの
OpenAI Developers: Codex use cases
OpenAI Developers: AGENTS.md guide
あわせて読みたい