OpenAI Codex Goals Best Practices

Reference for writing and managing Codex Goals — the persistent objective feature introduced in Codex 0.128.0. "Best practices" here means the patterns and anti-patterns that determine whether a Goal completes against the right evidence vs. silently against the wrong surface. Contains 31 rules across 8 categories, ordered by how much they affect whether a Goal completes correctly. Derived from the official OpenAI cookbook article "Using Goals in Codex".

When to Apply

Reference these guidelines when:

• Deciding whether a task warrants a /goal or a normal prompt
• Drafting or strengthening a /goal invocation
• Reviewing a Goal someone else wrote before activating it
• Debugging a Goal that completed against the wrong verification surface
• Setting up a research Goal where exact proof may not be available
• Managing Goal lifecycle (pause, resume, clear) across thread sessions
• Writing the iteration policy or blocked stop condition for a long-running Goal
• Diagnosing a Goal that hit its budget without completing

Rule Categories by Priority