Module · Codex Engineer
Planning with Codex
Break the request down, scope the change, and hand the agent a task it can finish.
TOPIC 01
Plan Decomposition
A request becomes a list of steps, and a list of steps becomes a reviewable plan.
What you'll practice
- Break a Request Into Steps — guided · beginner
- Review a Plan Before the Edits Start — practice · intermediate
A command you'll meet
cat ~/codex/plans/plan.yamlThe plan is the cheapest place to catch a wrong turn. Open the task below for the full walkthrough.
Hands-On Tasks in This Topic (2)
Break a Request Into Steps
A big request handed to an agent in one go produces a big diff nobody reviewed. Write the plan that breaks it into steps you can check.
Review a Plan Before the Edits Start
A plan is a claim about what the change will do. Read it the way you would read a pull request - against the codebase it claims to change.
TOPIC 02
Scoping the Change
How small a task should be, and how to write the prompt that says so.
What you'll practice
- Set the Boundaries of a Change — practice · intermediate
- Write the Task Prompt — challenge · advanced
A command you'll meet
cat ~/codex/prompts/task.mdA prompt is a contract with an agent. Open the task below for the full walkthrough.
Hands-On Tasks in This Topic (2)
Set the Boundaries of a Change
The smaller the change, the shorter the review and the fewer the regressions. Write the scoping rules your team applies to every agent task.
Write the Task Prompt
The prompt is the whole specification the agent works from. Write the template that leaves nothing to guess.