-max cookbook improvements - reduce duplication, clarify priorities #2282
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
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:
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.