Skip to content

Conversation

@bculleec
Copy link

@bculleec bculleec commented Dec 9, 2025

Summary

This PR refactors and tightens the Codex CLI prompting guide to reduce duplication, clarify priority rules, and improve internal consistency. The goal is to make the guidance easier to apply in practice while preserving its intent: an autonomous, action-oriented coding agent that delivers correct, end-to-end results.

Motivation

The previous version of the guide contained overlapping directives, repeated principles, and ambiguous priority relationships. These changes streamline the structure, collapse redundant guidance, and clarify ownership, execution flow, and tool usage expectations. This improves readability, predictability, and long-term maintainability of the cookbook.


For new content

When contributing new content, read through our contribution guidelines, and mark the following action items as completed:

  • I have added a new entry in registry.yaml (and, optionally, in authors.yaml) so that my content renders on the cookbook website.
    Not applicable for this PR.

  • I have conducted a self-review of my content based on the contribution guidelines:

    • Relevance: This content is related to building with OpenAI technologies and is useful to others.
    • Uniqueness: I have searched for related examples in the OpenAI Cookbook and verified that this content adds guidance not already covered.
    • Spelling and Grammar: I have checked for spelling and grammatical issues.
    • Clarity: I have done a final read-through to ensure the guide is well-organized and easy to understand.
    • Correctness: The information included accurately reflects intended Codex CLI usage and best practices.
    • Completeness: The guide fully explains expectations and constraints without relying on external context.

We will rate each of these areas on a scale from 1 to 4, and will only accept contributions that score 3 or higher on all areas. Refer to the contribution guidelines for more details.

Updated guidelines for tool usage, code implementation, and editing constraints in the Codex Max Prompting Guide. Enhanced clarity on expectations for autonomy, correctness, and user interaction.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant