Skip to content

Add gpt 5.4 prompting guide#2494

Open
itsryu-dq wants to merge 8 commits intoopenai:mainfrom
itsryu-dq:docs/gpt-5.4-prompting-guide
Open

Add gpt 5.4 prompting guide#2494
itsryu-dq wants to merge 8 commits intoopenai:mainfrom
itsryu-dq:docs/gpt-5.4-prompting-guide

Conversation

@itsryu-dq
Copy link

Summary

This PR adds a new notebook:

examples/gpt-5/gpt-5-4_prompting_guide.ipynb

The notebook introduces practical prompting patterns for GPT-5.4 workflows, including:

  • prompt structure and verbosity control
  • scope constraints for coding and document workflows
  • tool usage and verification patterns
  • structured extraction prompts
  • long-context and compaction workflows
  • prompt migration considerations from earlier GPT-5 models

The notebook structure follows the style of the existing GPT-5.2 Prompting Guide while focusing on practical prompt design patterns for GPT-5.4.

The PR also includes the necessary registry.yaml entry so the notebook renders on the OpenAI Cookbook website.


Motivation

Developers building GPT-5-class applications often need practical guidance on how to structure prompts for complex workflows such as:

  • multi-step agent execution
  • tool-integrated pipelines
  • document analysis and structured extraction
  • long-context reasoning tasks

This notebook provides a structured set of prompt patterns and examples that developers can reuse when designing GPT-5.4 workflows.

The goal is to extend the existing GPT-5 prompting guidance in the Cookbook with a focused guide for GPT-5.4 while maintaining consistency with the structure and style of the existing GPT-5.2 guide.


For new content

ryu-omnithrex added 7 commits March 6, 2026 16:10
Improve the GPT-5.4 prompting guide notebook by expanding guidance on long-context workflows, tool usage, structured extraction, prompt migration, and evaluation practices. Align structure with existing GPT-5.x guides and strengthen practical prompting patterns for production workflows.
… guidance

Improve the GPT-5.4 prompting guide notebook by adding completion criteria, prompt pattern selection guidance, workflow prompt templates, evaluation and debugging practices, and expanded examples. Strengthen practical guidance for long-context workflows, tool-integrated execution, and production prompt design while maintaining alignment with existing GPT-5.x documentation patterns.
Repair the GPT-5.4 prompting guide notebook structure to ensure it is valid .ipynb JSON and renders correctly in GitHub diffs. Fix cell formatting, metadata, and serialization issues without changing the guide’s content.
Refine the GPT-5.4 prompting guide notebook with a final editorial pass to improve tone, consistency, and publication readiness. Tighten wording, remove overly informal phrasing, and soften any language that could imply undocumented behavior while preserving the guide’s structure and practical guidance.
@itsryu-dq
Copy link
Author

itsryu-dq commented Mar 6, 2026

This PR is ready for maintainer review.

Summary of final updates:

  • Finalized the GPT-5.4 prompting guide notebook with a full editorial pass.
  • Repaired and validated the notebook JSON structure.
  • Added the required registry.yaml entry.
  • Added an authors.yaml entry for ryu-omnithrex.
  • Verified the notebook against the repository notebook validation script.
  • Confirmed no additional repository files require updates based on the contribution guidelines.

The guide now includes:

  • practical prompt patterns for GPT-5.4 workflows
  • completion criteria and scope-discipline patterns
  • long-context, tool-usage, and structured extraction guidance
  • prompt migration and evaluation guidance
  • common failure modes, debugging guidance, and production checklist
  • worked examples and reusable prompt stacks

From my side, the PR is finalized and ready for review. Happy to make any follow-up changes if maintainers want adjustments for style or alignment.

@itsryu-dq itsryu-dq changed the title Docs/gpt 5.4 prompting guide Add gpt 5.4 prompting guide Mar 6, 2026
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