openai · paytonison · Sep 27, 2025
diff --git a/AGENTS.md b/AGENTS.md
@@ -11,7 +11,7 @@ Use a virtual environment to isolate dependencies:
 - `python .github/scripts/check_notebooks.py` to validate notebook structure before pushing
 
 ## Coding Style & Naming Conventions
-Write Python to PEP 8 with four-space indentation, descriptive variable names, and concise docstrings that explain API usage choices. Name new notebooks with lowercase, dash-or-underscore-separated phrases that match their directory—for example `examples/gpt-5/prompt-optimization-cookbook.ipynb`. Keep markdown cells focused and prefer numbered steps for multi-part workflows. Store secrets in environment variables such as `OPENAI_API_KEY`; never hard-code keys inside notebooks.
+Write Python to PEP 8 with four-space indentation, descriptive variable names, and concise docstrings that explain API usage choices. Name new notebooks with lowercase, dash-or-underscore-separated phrases that match their directory—for example `examples/prompting/prompt-optimization-cookbook.ipynb`. Keep markdown cells focused and prefer numbered steps for multi-part workflows. Store secrets in environment variables such as `OPENAI_API_KEY`; never hard-code keys inside notebooks.
 
 ## Testing Guidelines
 Execute notebooks top-to-bottom after installing dependencies and clear lingering execution counts before committing. For Python modules or utilities, include self-check cells or lightweight `pytest` snippets and show how to run them (for example, `pytest examples/object_oriented_agentic_approach/tests`). When contributions depend on external services, mock responses or gate the cells behind clearly labeled opt-in flags.

diff --git a/...ce_your_prompts_with_meta_prompting.ipynb → ...ce_your_prompts_with_meta_prompting.ipynb b/...ce_your_prompts_with_meta_prompting.ipynb → ...ce_your_prompts_with_meta_prompting.ipynb
diff --git a/examples/Optimize_Prompts.ipynb → examples/prompting/Optimize_Prompts.ipynb b/examples/Optimize_Prompts.ipynb → examples/prompting/Optimize_Prompts.ipynb
diff --git a/examples/Prompt_Caching101.ipynb → examples/prompting/Prompt_Caching101.ipynb b/examples/Prompt_Caching101.ipynb → examples/prompting/Prompt_Caching101.ipynb
diff --git a/examples/Prompt_migration_guide.ipynb → ...es/prompting/Prompt_migration_guide.ipynb b/examples/Prompt_migration_guide.ipynb → ...es/prompting/Prompt_migration_guide.ipynb
diff --git a/examples/Realtime_prompting_guide.ipynb → .../prompting/Realtime_prompting_guide.ipynb b/examples/Realtime_prompting_guide.ipynb → .../prompting/Realtime_prompting_guide.ipynb
diff --git a/...t_writing_using_a_multi-step_prompt.ipynb → ...t_writing_using_a_multi-step_prompt.ipynb b/...t_writing_using_a_multi-step_prompt.ipynb → ...t_writing_using_a_multi-step_prompt.ipynb
diff --git a/...p_prompt_with_older_completions_API.ipynb → ...p_prompt_with_older_completions_API.ipynb b/...p_prompt_with_older_completions_API.ipynb → ...p_prompt_with_older_completions_API.ipynb
diff --git a/examples/Whisper_prompting_guide.ipynb → ...s/prompting/Whisper_prompting_guide.ipynb b/examples/Whisper_prompting_guide.ipynb → ...s/prompting/Whisper_prompting_guide.ipynb
diff --git a/examples/gpt-5-codex_prompting_guide.ipynb → ...ompting/gpt-5-codex_prompting_guide.ipynb b/examples/gpt-5-codex_prompting_guide.ipynb → ...ompting/gpt-5-codex_prompting_guide.ipynb
diff --git a/examples/gpt-5/gpt-5_prompting_guide.ipynb → ...les/prompting/gpt-5_prompting_guide.ipynb b/examples/gpt-5/gpt-5_prompting_guide.ipynb → ...les/prompting/gpt-5_prompting_guide.ipynb
diff --git a/examples/gpt4-1_prompting_guide.ipynb → ...es/prompting/gpt4-1_prompting_guide.ipynb b/examples/gpt4-1_prompting_guide.ipynb → ...es/prompting/gpt4-1_prompting_guide.ipynb
diff --git a/.../o-series/o3o4-mini_prompting_guide.ipynb → ...prompting/o3o4-mini_prompting_guide.ipynb b/.../o-series/o3o4-mini_prompting_guide.ipynb → ...prompting/o3o4-mini_prompting_guide.ipynb
diff --git a/.../gpt-5/prompt-optimization-cookbook.ipynb → ...mpting/prompt-optimization-cookbook.ipynb b/.../gpt-5/prompt-optimization-cookbook.ipynb → ...mpting/prompt-optimization-cookbook.ipynb
diff --git a/...pt-optimization-cookbook/llm_as_judge.txt → ...pt-optimization-cookbook/llm_as_judge.txt b/...pt-optimization-cookbook/llm_as_judge.txt → ...pt-optimization-cookbook/llm_as_judge.txt
diff --git a/...pt-optimization-cookbook/requirements.txt → ...pt-optimization-cookbook/requirements.txt b/...pt-optimization-cookbook/requirements.txt → ...pt-optimization-cookbook/requirements.txt
diff --git a/...-cookbook/results_failsafeqa_baseline.csv → ...-cookbook/results_failsafeqa_baseline.csv b/...-cookbook/results_failsafeqa_baseline.csv → ...-cookbook/results_failsafeqa_baseline.csv
diff --git a/...cookbook/results_failsafeqa_optimized.csv → ...cookbook/results_failsafeqa_optimized.csv b/...cookbook/results_failsafeqa_optimized.csv → ...cookbook/results_failsafeqa_optimized.csv
diff --git a/...m_as_judge_baseline/judgement_summary.csv → ...m_as_judge_baseline/judgement_summary.csv b/...m_as_judge_baseline/judgement_summary.csv → ...m_as_judge_baseline/judgement_summary.csv
diff --git a/...results_llm_as_judge_baseline/run_01.json → ...results_llm_as_judge_baseline/run_01.json b/...results_llm_as_judge_baseline/run_01.json → ...results_llm_as_judge_baseline/run_01.json
diff --git a/...results_llm_as_judge_baseline/run_02.json → ...results_llm_as_judge_baseline/run_02.json b/...results_llm_as_judge_baseline/run_02.json → ...results_llm_as_judge_baseline/run_02.json
diff --git a/...results_llm_as_judge_baseline/run_03.json → ...results_llm_as_judge_baseline/run_03.json b/...results_llm_as_judge_baseline/run_03.json → ...results_llm_as_judge_baseline/run_03.json
diff --git a/...results_llm_as_judge_baseline/run_04.json → ...results_llm_as_judge_baseline/run_04.json b/...results_llm_as_judge_baseline/run_04.json → ...results_llm_as_judge_baseline/run_04.json
diff --git a/...results_llm_as_judge_baseline/run_05.json → ...results_llm_as_judge_baseline/run_05.json b/...results_llm_as_judge_baseline/run_05.json → ...results_llm_as_judge_baseline/run_05.json
diff --git a/...results_llm_as_judge_baseline/run_06.json → ...results_llm_as_judge_baseline/run_06.json b/...results_llm_as_judge_baseline/run_06.json → ...results_llm_as_judge_baseline/run_06.json
diff --git a/...results_llm_as_judge_baseline/run_07.json → ...results_llm_as_judge_baseline/run_07.json b/...results_llm_as_judge_baseline/run_07.json → ...results_llm_as_judge_baseline/run_07.json
diff --git a/...results_llm_as_judge_baseline/run_08.json → ...results_llm_as_judge_baseline/run_08.json b/...results_llm_as_judge_baseline/run_08.json → ...results_llm_as_judge_baseline/run_08.json
diff --git a/...results_llm_as_judge_baseline/run_09.json → ...results_llm_as_judge_baseline/run_09.json b/...results_llm_as_judge_baseline/run_09.json → ...results_llm_as_judge_baseline/run_09.json
diff --git a/...results_llm_as_judge_baseline/run_10.json → ...results_llm_as_judge_baseline/run_10.json b/...results_llm_as_judge_baseline/run_10.json → ...results_llm_as_judge_baseline/run_10.json
diff --git a/...results_llm_as_judge_baseline/run_11.json → ...results_llm_as_judge_baseline/run_11.json b/...results_llm_as_judge_baseline/run_11.json → ...results_llm_as_judge_baseline/run_11.json
diff --git a/...results_llm_as_judge_baseline/run_12.json → ...results_llm_as_judge_baseline/run_12.json b/...results_llm_as_judge_baseline/run_12.json → ...results_llm_as_judge_baseline/run_12.json
diff --git a/...results_llm_as_judge_baseline/run_13.json → ...results_llm_as_judge_baseline/run_13.json b/...results_llm_as_judge_baseline/run_13.json → ...results_llm_as_judge_baseline/run_13.json
diff --git a/...results_llm_as_judge_baseline/run_14.json → ...results_llm_as_judge_baseline/run_14.json b/...results_llm_as_judge_baseline/run_14.json → ...results_llm_as_judge_baseline/run_14.json
diff --git a/...results_llm_as_judge_baseline/run_15.json → ...results_llm_as_judge_baseline/run_15.json b/...results_llm_as_judge_baseline/run_15.json → ...results_llm_as_judge_baseline/run_15.json
diff --git a/...results_llm_as_judge_baseline/run_16.json → ...results_llm_as_judge_baseline/run_16.json b/...results_llm_as_judge_baseline/run_16.json → ...results_llm_as_judge_baseline/run_16.json
diff --git a/...results_llm_as_judge_baseline/run_17.json → ...results_llm_as_judge_baseline/run_17.json b/...results_llm_as_judge_baseline/run_17.json → ...results_llm_as_judge_baseline/run_17.json
diff --git a/...results_llm_as_judge_baseline/run_18.json → ...results_llm_as_judge_baseline/run_18.json b/...results_llm_as_judge_baseline/run_18.json → ...results_llm_as_judge_baseline/run_18.json
diff --git a/...results_llm_as_judge_baseline/run_19.json → ...results_llm_as_judge_baseline/run_19.json b/...results_llm_as_judge_baseline/run_19.json → ...results_llm_as_judge_baseline/run_19.json
diff --git a/...results_llm_as_judge_baseline/run_20.json → ...results_llm_as_judge_baseline/run_20.json b/...results_llm_as_judge_baseline/run_20.json → ...results_llm_as_judge_baseline/run_20.json
diff --git a/...results_llm_as_judge_baseline/run_21.json → ...results_llm_as_judge_baseline/run_21.json b/...results_llm_as_judge_baseline/run_21.json → ...results_llm_as_judge_baseline/run_21.json
diff --git a/...results_llm_as_judge_baseline/run_22.json → ...results_llm_as_judge_baseline/run_22.json b/...results_llm_as_judge_baseline/run_22.json → ...results_llm_as_judge_baseline/run_22.json
diff --git a/...results_llm_as_judge_baseline/run_23.json → ...results_llm_as_judge_baseline/run_23.json b/...results_llm_as_judge_baseline/run_23.json → ...results_llm_as_judge_baseline/run_23.json
diff --git a/...results_llm_as_judge_baseline/run_24.json → ...results_llm_as_judge_baseline/run_24.json b/...results_llm_as_judge_baseline/run_24.json → ...results_llm_as_judge_baseline/run_24.json
diff --git a/...results_llm_as_judge_baseline/run_25.json → ...results_llm_as_judge_baseline/run_25.json b/...results_llm_as_judge_baseline/run_25.json → ...results_llm_as_judge_baseline/run_25.json
diff --git a/...results_llm_as_judge_baseline/run_26.json → ...results_llm_as_judge_baseline/run_26.json b/...results_llm_as_judge_baseline/run_26.json → ...results_llm_as_judge_baseline/run_26.json
diff --git a/...results_llm_as_judge_baseline/run_27.json → ...results_llm_as_judge_baseline/run_27.json b/...results_llm_as_judge_baseline/run_27.json → ...results_llm_as_judge_baseline/run_27.json
diff --git a/...results_llm_as_judge_baseline/run_28.json → ...results_llm_as_judge_baseline/run_28.json b/...results_llm_as_judge_baseline/run_28.json → ...results_llm_as_judge_baseline/run_28.json
diff --git a/...results_llm_as_judge_baseline/run_29.json → ...results_llm_as_judge_baseline/run_29.json b/...results_llm_as_judge_baseline/run_29.json → ...results_llm_as_judge_baseline/run_29.json
diff --git a/...results_llm_as_judge_baseline/run_30.json → ...results_llm_as_judge_baseline/run_30.json b/...results_llm_as_judge_baseline/run_30.json → ...results_llm_as_judge_baseline/run_30.json
diff --git a/..._as_judge_optimized/judgement_summary.csv → ..._as_judge_optimized/judgement_summary.csv b/..._as_judge_optimized/judgement_summary.csv → ..._as_judge_optimized/judgement_summary.csv
diff --git a/...esults_llm_as_judge_optimized/run_01.json → ...esults_llm_as_judge_optimized/run_01.json b/...esults_llm_as_judge_optimized/run_01.json → ...esults_llm_as_judge_optimized/run_01.json
diff --git a/...esults_llm_as_judge_optimized/run_02.json → ...esults_llm_as_judge_optimized/run_02.json b/...esults_llm_as_judge_optimized/run_02.json → ...esults_llm_as_judge_optimized/run_02.json
diff --git a/...esults_llm_as_judge_optimized/run_03.json → ...esults_llm_as_judge_optimized/run_03.json b/...esults_llm_as_judge_optimized/run_03.json → ...esults_llm_as_judge_optimized/run_03.json
diff --git a/...esults_llm_as_judge_optimized/run_04.json → ...esults_llm_as_judge_optimized/run_04.json b/...esults_llm_as_judge_optimized/run_04.json → ...esults_llm_as_judge_optimized/run_04.json
diff --git a/...esults_llm_as_judge_optimized/run_05.json → ...esults_llm_as_judge_optimized/run_05.json b/...esults_llm_as_judge_optimized/run_05.json → ...esults_llm_as_judge_optimized/run_05.json
diff --git a/...esults_llm_as_judge_optimized/run_06.json → ...esults_llm_as_judge_optimized/run_06.json b/...esults_llm_as_judge_optimized/run_06.json → ...esults_llm_as_judge_optimized/run_06.json
diff --git a/...esults_llm_as_judge_optimized/run_07.json → ...esults_llm_as_judge_optimized/run_07.json b/...esults_llm_as_judge_optimized/run_07.json → ...esults_llm_as_judge_optimized/run_07.json
diff --git a/...esults_llm_as_judge_optimized/run_08.json → ...esults_llm_as_judge_optimized/run_08.json b/...esults_llm_as_judge_optimized/run_08.json → ...esults_llm_as_judge_optimized/run_08.json
diff --git a/...esults_llm_as_judge_optimized/run_09.json → ...esults_llm_as_judge_optimized/run_09.json b/...esults_llm_as_judge_optimized/run_09.json → ...esults_llm_as_judge_optimized/run_09.json
diff --git a/...esults_llm_as_judge_optimized/run_10.json → ...esults_llm_as_judge_optimized/run_10.json b/...esults_llm_as_judge_optimized/run_10.json → ...esults_llm_as_judge_optimized/run_10.json
diff --git a/...esults_llm_as_judge_optimized/run_11.json → ...esults_llm_as_judge_optimized/run_11.json b/...esults_llm_as_judge_optimized/run_11.json → ...esults_llm_as_judge_optimized/run_11.json
diff --git a/...esults_llm_as_judge_optimized/run_12.json → ...esults_llm_as_judge_optimized/run_12.json b/...esults_llm_as_judge_optimized/run_12.json → ...esults_llm_as_judge_optimized/run_12.json
diff --git a/...esults_llm_as_judge_optimized/run_13.json → ...esults_llm_as_judge_optimized/run_13.json b/...esults_llm_as_judge_optimized/run_13.json → ...esults_llm_as_judge_optimized/run_13.json
diff --git a/...esults_llm_as_judge_optimized/run_14.json → ...esults_llm_as_judge_optimized/run_14.json b/...esults_llm_as_judge_optimized/run_14.json → ...esults_llm_as_judge_optimized/run_14.json
diff --git a/...esults_llm_as_judge_optimized/run_15.json → ...esults_llm_as_judge_optimized/run_15.json b/...esults_llm_as_judge_optimized/run_15.json → ...esults_llm_as_judge_optimized/run_15.json
diff --git a/...esults_llm_as_judge_optimized/run_16.json → ...esults_llm_as_judge_optimized/run_16.json b/...esults_llm_as_judge_optimized/run_16.json → ...esults_llm_as_judge_optimized/run_16.json
diff --git a/...esults_llm_as_judge_optimized/run_17.json → ...esults_llm_as_judge_optimized/run_17.json b/...esults_llm_as_judge_optimized/run_17.json → ...esults_llm_as_judge_optimized/run_17.json
diff --git a/...esults_llm_as_judge_optimized/run_18.json → ...esults_llm_as_judge_optimized/run_18.json b/...esults_llm_as_judge_optimized/run_18.json → ...esults_llm_as_judge_optimized/run_18.json
diff --git a/...esults_llm_as_judge_optimized/run_19.json → ...esults_llm_as_judge_optimized/run_19.json b/...esults_llm_as_judge_optimized/run_19.json → ...esults_llm_as_judge_optimized/run_19.json
diff --git a/...esults_llm_as_judge_optimized/run_20.json → ...esults_llm_as_judge_optimized/run_20.json b/...esults_llm_as_judge_optimized/run_20.json → ...esults_llm_as_judge_optimized/run_20.json
diff --git a/...esults_llm_as_judge_optimized/run_21.json → ...esults_llm_as_judge_optimized/run_21.json b/...esults_llm_as_judge_optimized/run_21.json → ...esults_llm_as_judge_optimized/run_21.json
diff --git a/...esults_llm_as_judge_optimized/run_22.json → ...esults_llm_as_judge_optimized/run_22.json b/...esults_llm_as_judge_optimized/run_22.json → ...esults_llm_as_judge_optimized/run_22.json
diff --git a/...esults_llm_as_judge_optimized/run_23.json → ...esults_llm_as_judge_optimized/run_23.json b/...esults_llm_as_judge_optimized/run_23.json → ...esults_llm_as_judge_optimized/run_23.json
diff --git a/...esults_llm_as_judge_optimized/run_24.json → ...esults_llm_as_judge_optimized/run_24.json b/...esults_llm_as_judge_optimized/run_24.json → ...esults_llm_as_judge_optimized/run_24.json
diff --git a/...esults_llm_as_judge_optimized/run_25.json → ...esults_llm_as_judge_optimized/run_25.json b/...esults_llm_as_judge_optimized/run_25.json → ...esults_llm_as_judge_optimized/run_25.json
diff --git a/...esults_llm_as_judge_optimized/run_26.json → ...esults_llm_as_judge_optimized/run_26.json b/...esults_llm_as_judge_optimized/run_26.json → ...esults_llm_as_judge_optimized/run_26.json
diff --git a/...esults_llm_as_judge_optimized/run_27.json → ...esults_llm_as_judge_optimized/run_27.json b/...esults_llm_as_judge_optimized/run_27.json → ...esults_llm_as_judge_optimized/run_27.json
diff --git a/...esults_llm_as_judge_optimized/run_28.json → ...esults_llm_as_judge_optimized/run_28.json b/...esults_llm_as_judge_optimized/run_28.json → ...esults_llm_as_judge_optimized/run_28.json
diff --git a/...esults_llm_as_judge_optimized/run_29.json → ...esults_llm_as_judge_optimized/run_29.json b/...esults_llm_as_judge_optimized/run_29.json → ...esults_llm_as_judge_optimized/run_29.json
diff --git a/...esults_llm_as_judge_optimized/run_30.json → ...esults_llm_as_judge_optimized/run_30.json b/...esults_llm_as_judge_optimized/run_30.json → ...esults_llm_as_judge_optimized/run_30.json
diff --git a/...-cookbook/results_topk_baseline/run_01.py → ...-cookbook/results_topk_baseline/run_01.py b/...-cookbook/results_topk_baseline/run_01.py → ...-cookbook/results_topk_baseline/run_01.py
diff --git a/...-cookbook/results_topk_baseline/run_02.py → ...-cookbook/results_topk_baseline/run_02.py b/...-cookbook/results_topk_baseline/run_02.py → ...-cookbook/results_topk_baseline/run_02.py
diff --git a/...-cookbook/results_topk_baseline/run_03.py → ...-cookbook/results_topk_baseline/run_03.py b/...-cookbook/results_topk_baseline/run_03.py → ...-cookbook/results_topk_baseline/run_03.py
diff --git a/...-cookbook/results_topk_baseline/run_04.py → ...-cookbook/results_topk_baseline/run_04.py b/...-cookbook/results_topk_baseline/run_04.py → ...-cookbook/results_topk_baseline/run_04.py
diff --git a/...-cookbook/results_topk_baseline/run_05.py → ...-cookbook/results_topk_baseline/run_05.py b/...-cookbook/results_topk_baseline/run_05.py → ...-cookbook/results_topk_baseline/run_05.py
diff --git a/...-cookbook/results_topk_baseline/run_06.py → ...-cookbook/results_topk_baseline/run_06.py b/...-cookbook/results_topk_baseline/run_06.py → ...-cookbook/results_topk_baseline/run_06.py
diff --git a/...-cookbook/results_topk_baseline/run_07.py → ...-cookbook/results_topk_baseline/run_07.py b/...-cookbook/results_topk_baseline/run_07.py → ...-cookbook/results_topk_baseline/run_07.py
diff --git a/...-cookbook/results_topk_baseline/run_08.py → ...-cookbook/results_topk_baseline/run_08.py b/...-cookbook/results_topk_baseline/run_08.py → ...-cookbook/results_topk_baseline/run_08.py
diff --git a/...-cookbook/results_topk_baseline/run_09.py → ...-cookbook/results_topk_baseline/run_09.py b/...-cookbook/results_topk_baseline/run_09.py → ...-cookbook/results_topk_baseline/run_09.py
diff --git a/...-cookbook/results_topk_baseline/run_10.py → ...-cookbook/results_topk_baseline/run_10.py b/...-cookbook/results_topk_baseline/run_10.py → ...-cookbook/results_topk_baseline/run_10.py
diff --git a/...-cookbook/results_topk_baseline/run_11.py → ...-cookbook/results_topk_baseline/run_11.py b/...-cookbook/results_topk_baseline/run_11.py → ...-cookbook/results_topk_baseline/run_11.py
diff --git a/...-cookbook/results_topk_baseline/run_12.py → ...-cookbook/results_topk_baseline/run_12.py b/...-cookbook/results_topk_baseline/run_12.py → ...-cookbook/results_topk_baseline/run_12.py
diff --git a/...-cookbook/results_topk_baseline/run_13.py → ...-cookbook/results_topk_baseline/run_13.py b/...-cookbook/results_topk_baseline/run_13.py → ...-cookbook/results_topk_baseline/run_13.py
diff --git a/...-cookbook/results_topk_baseline/run_14.py → ...-cookbook/results_topk_baseline/run_14.py b/...-cookbook/results_topk_baseline/run_14.py → ...-cookbook/results_topk_baseline/run_14.py
diff --git a/...-cookbook/results_topk_baseline/run_15.py → ...-cookbook/results_topk_baseline/run_15.py b/...-cookbook/results_topk_baseline/run_15.py → ...-cookbook/results_topk_baseline/run_15.py
diff --git a/...-cookbook/results_topk_baseline/run_16.py → ...-cookbook/results_topk_baseline/run_16.py b/...-cookbook/results_topk_baseline/run_16.py → ...-cookbook/results_topk_baseline/run_16.py
diff --git a/...-cookbook/results_topk_baseline/run_17.py → ...-cookbook/results_topk_baseline/run_17.py b/...-cookbook/results_topk_baseline/run_17.py → ...-cookbook/results_topk_baseline/run_17.py
diff --git a/...-cookbook/results_topk_baseline/run_18.py → ...-cookbook/results_topk_baseline/run_18.py b/...-cookbook/results_topk_baseline/run_18.py → ...-cookbook/results_topk_baseline/run_18.py
diff --git a/...-cookbook/results_topk_baseline/run_19.py → ...-cookbook/results_topk_baseline/run_19.py b/...-cookbook/results_topk_baseline/run_19.py → ...-cookbook/results_topk_baseline/run_19.py
diff --git a/...-cookbook/results_topk_baseline/run_20.py → ...-cookbook/results_topk_baseline/run_20.py b/...-cookbook/results_topk_baseline/run_20.py → ...-cookbook/results_topk_baseline/run_20.py
diff --git a/...-cookbook/results_topk_baseline/run_21.py → ...-cookbook/results_topk_baseline/run_21.py b/...-cookbook/results_topk_baseline/run_21.py → ...-cookbook/results_topk_baseline/run_21.py
diff --git a/...-cookbook/results_topk_baseline/run_22.py → ...-cookbook/results_topk_baseline/run_22.py b/...-cookbook/results_topk_baseline/run_22.py → ...-cookbook/results_topk_baseline/run_22.py
diff --git a/...-cookbook/results_topk_baseline/run_23.py → ...-cookbook/results_topk_baseline/run_23.py b/...-cookbook/results_topk_baseline/run_23.py → ...-cookbook/results_topk_baseline/run_23.py
diff --git a/...-cookbook/results_topk_baseline/run_24.py → ...-cookbook/results_topk_baseline/run_24.py b/...-cookbook/results_topk_baseline/run_24.py → ...-cookbook/results_topk_baseline/run_24.py
diff --git a/...-cookbook/results_topk_baseline/run_25.py → ...-cookbook/results_topk_baseline/run_25.py b/...-cookbook/results_topk_baseline/run_25.py → ...-cookbook/results_topk_baseline/run_25.py
diff --git a/...-cookbook/results_topk_baseline/run_26.py → ...-cookbook/results_topk_baseline/run_26.py b/...-cookbook/results_topk_baseline/run_26.py → ...-cookbook/results_topk_baseline/run_26.py
diff --git a/...-cookbook/results_topk_baseline/run_27.py → ...-cookbook/results_topk_baseline/run_27.py b/...-cookbook/results_topk_baseline/run_27.py → ...-cookbook/results_topk_baseline/run_27.py
diff --git a/...-cookbook/results_topk_baseline/run_28.py → ...-cookbook/results_topk_baseline/run_28.py b/...-cookbook/results_topk_baseline/run_28.py → ...-cookbook/results_topk_baseline/run_28.py
diff --git a/...-cookbook/results_topk_baseline/run_29.py → ...-cookbook/results_topk_baseline/run_29.py b/...-cookbook/results_topk_baseline/run_29.py → ...-cookbook/results_topk_baseline/run_29.py
diff --git a/...-cookbook/results_topk_baseline/run_30.py → ...-cookbook/results_topk_baseline/run_30.py b/...-cookbook/results_topk_baseline/run_30.py → ...-cookbook/results_topk_baseline/run_30.py
diff --git a/...pk_baseline/run_results_topk_baseline.csv → ...pk_baseline/run_results_topk_baseline.csv b/...pk_baseline/run_results_topk_baseline.csv → ...pk_baseline/run_results_topk_baseline.csv
diff --git a/...ne/run_results_topk_baseline_summary.json → ...ne/run_results_topk_baseline_summary.json b/...ne/run_results_topk_baseline_summary.json → ...ne/run_results_topk_baseline_summary.json
diff --git a/...ine/run_results_topk_baseline_summary.txt → ...ine/run_results_topk_baseline_summary.txt b/...ine/run_results_topk_baseline_summary.txt → ...ine/run_results_topk_baseline_summary.txt
diff --git a/...cookbook/results_topk_optimized/run_01.py → ...cookbook/results_topk_optimized/run_01.py b/...cookbook/results_topk_optimized/run_01.py → ...cookbook/results_topk_optimized/run_01.py
diff --git a/...cookbook/results_topk_optimized/run_02.py → ...cookbook/results_topk_optimized/run_02.py b/...cookbook/results_topk_optimized/run_02.py → ...cookbook/results_topk_optimized/run_02.py
diff --git a/...cookbook/results_topk_optimized/run_03.py → ...cookbook/results_topk_optimized/run_03.py b/...cookbook/results_topk_optimized/run_03.py → ...cookbook/results_topk_optimized/run_03.py
diff --git a/...cookbook/results_topk_optimized/run_04.py → ...cookbook/results_topk_optimized/run_04.py b/...cookbook/results_topk_optimized/run_04.py → ...cookbook/results_topk_optimized/run_04.py
diff --git a/...cookbook/results_topk_optimized/run_05.py → ...cookbook/results_topk_optimized/run_05.py b/...cookbook/results_topk_optimized/run_05.py → ...cookbook/results_topk_optimized/run_05.py
diff --git a/...cookbook/results_topk_optimized/run_06.py → ...cookbook/results_topk_optimized/run_06.py b/...cookbook/results_topk_optimized/run_06.py → ...cookbook/results_topk_optimized/run_06.py
diff --git a/...cookbook/results_topk_optimized/run_07.py → ...cookbook/results_topk_optimized/run_07.py b/...cookbook/results_topk_optimized/run_07.py → ...cookbook/results_topk_optimized/run_07.py
diff --git a/...cookbook/results_topk_optimized/run_08.py → ...cookbook/results_topk_optimized/run_08.py b/...cookbook/results_topk_optimized/run_08.py → ...cookbook/results_topk_optimized/run_08.py
diff --git a/...cookbook/results_topk_optimized/run_09.py → ...cookbook/results_topk_optimized/run_09.py b/...cookbook/results_topk_optimized/run_09.py → ...cookbook/results_topk_optimized/run_09.py
diff --git a/...cookbook/results_topk_optimized/run_10.py → ...cookbook/results_topk_optimized/run_10.py b/...cookbook/results_topk_optimized/run_10.py → ...cookbook/results_topk_optimized/run_10.py
diff --git a/...cookbook/results_topk_optimized/run_11.py → ...cookbook/results_topk_optimized/run_11.py b/...cookbook/results_topk_optimized/run_11.py → ...cookbook/results_topk_optimized/run_11.py
diff --git a/...cookbook/results_topk_optimized/run_12.py → ...cookbook/results_topk_optimized/run_12.py b/...cookbook/results_topk_optimized/run_12.py → ...cookbook/results_topk_optimized/run_12.py
diff --git a/...cookbook/results_topk_optimized/run_13.py → ...cookbook/results_topk_optimized/run_13.py b/...cookbook/results_topk_optimized/run_13.py → ...cookbook/results_topk_optimized/run_13.py
diff --git a/...cookbook/results_topk_optimized/run_14.py → ...cookbook/results_topk_optimized/run_14.py b/...cookbook/results_topk_optimized/run_14.py → ...cookbook/results_topk_optimized/run_14.py
diff --git a/...cookbook/results_topk_optimized/run_15.py → ...cookbook/results_topk_optimized/run_15.py b/...cookbook/results_topk_optimized/run_15.py → ...cookbook/results_topk_optimized/run_15.py
diff --git a/...cookbook/results_topk_optimized/run_16.py → ...cookbook/results_topk_optimized/run_16.py b/...cookbook/results_topk_optimized/run_16.py → ...cookbook/results_topk_optimized/run_16.py
diff --git a/...cookbook/results_topk_optimized/run_17.py → ...cookbook/results_topk_optimized/run_17.py b/...cookbook/results_topk_optimized/run_17.py → ...cookbook/results_topk_optimized/run_17.py
diff --git a/...cookbook/results_topk_optimized/run_18.py → ...cookbook/results_topk_optimized/run_18.py b/...cookbook/results_topk_optimized/run_18.py → ...cookbook/results_topk_optimized/run_18.py
diff --git a/...cookbook/results_topk_optimized/run_19.py → ...cookbook/results_topk_optimized/run_19.py b/...cookbook/results_topk_optimized/run_19.py → ...cookbook/results_topk_optimized/run_19.py
diff --git a/...cookbook/results_topk_optimized/run_20.py → ...cookbook/results_topk_optimized/run_20.py b/...cookbook/results_topk_optimized/run_20.py → ...cookbook/results_topk_optimized/run_20.py
diff --git a/...cookbook/results_topk_optimized/run_21.py → ...cookbook/results_topk_optimized/run_21.py b/...cookbook/results_topk_optimized/run_21.py → ...cookbook/results_topk_optimized/run_21.py
diff --git a/...cookbook/results_topk_optimized/run_22.py → ...cookbook/results_topk_optimized/run_22.py b/...cookbook/results_topk_optimized/run_22.py → ...cookbook/results_topk_optimized/run_22.py
diff --git a/...cookbook/results_topk_optimized/run_23.py → ...cookbook/results_topk_optimized/run_23.py b/...cookbook/results_topk_optimized/run_23.py → ...cookbook/results_topk_optimized/run_23.py
diff --git a/...cookbook/results_topk_optimized/run_24.py → ...cookbook/results_topk_optimized/run_24.py b/...cookbook/results_topk_optimized/run_24.py → ...cookbook/results_topk_optimized/run_24.py
diff --git a/...cookbook/results_topk_optimized/run_25.py → ...cookbook/results_topk_optimized/run_25.py b/...cookbook/results_topk_optimized/run_25.py → ...cookbook/results_topk_optimized/run_25.py
diff --git a/...cookbook/results_topk_optimized/run_26.py → ...cookbook/results_topk_optimized/run_26.py b/...cookbook/results_topk_optimized/run_26.py → ...cookbook/results_topk_optimized/run_26.py
diff --git a/...cookbook/results_topk_optimized/run_27.py → ...cookbook/results_topk_optimized/run_27.py b/...cookbook/results_topk_optimized/run_27.py → ...cookbook/results_topk_optimized/run_27.py
diff --git a/...cookbook/results_topk_optimized/run_28.py → ...cookbook/results_topk_optimized/run_28.py b/...cookbook/results_topk_optimized/run_28.py → ...cookbook/results_topk_optimized/run_28.py
diff --git a/...cookbook/results_topk_optimized/run_29.py → ...cookbook/results_topk_optimized/run_29.py b/...cookbook/results_topk_optimized/run_29.py → ...cookbook/results_topk_optimized/run_29.py
diff --git a/...cookbook/results_topk_optimized/run_30.py → ...cookbook/results_topk_optimized/run_30.py b/...cookbook/results_topk_optimized/run_30.py → ...cookbook/results_topk_optimized/run_30.py
diff --git a/..._optimized/run_results_topk_optimized.csv → ..._optimized/run_results_topk_optimized.csv b/..._optimized/run_results_topk_optimized.csv → ..._optimized/run_results_topk_optimized.csv
diff --git a/...d/run_results_topk_optimized_summary.json → ...d/run_results_topk_optimized_summary.json b/...d/run_results_topk_optimized_summary.json → ...d/run_results_topk_optimized_summary.json
diff --git a/...ed/run_results_topk_optimized_summary.txt → ...ed/run_results_topk_optimized_summary.txt b/...ed/run_results_topk_optimized_summary.txt → ...ed/run_results_topk_optimized_summary.txt
diff --git a/...t-optimization-cookbook/run_FailSafeQA.py → ...t-optimization-cookbook/run_FailSafeQA.py b/...t-optimization-cookbook/run_FailSafeQA.py → ...t-optimization-cookbook/run_FailSafeQA.py
diff --git a/...optimization-cookbook/scripts/__init__.py → ...optimization-cookbook/scripts/__init__.py b/...optimization-cookbook/scripts/__init__.py → ...optimization-cookbook/scripts/__init__.py
diff --git a/...mization-cookbook/scripts/gen_baseline.py → ...mization-cookbook/scripts/gen_baseline.py b/...mization-cookbook/scripts/gen_baseline.py → ...mization-cookbook/scripts/gen_baseline.py
diff --git a/...ization-cookbook/scripts/gen_optimized.py → ...ization-cookbook/scripts/gen_optimized.py b/...ization-cookbook/scripts/gen_optimized.py → ...ization-cookbook/scripts/gen_optimized.py
diff --git a/...ptimization-cookbook/scripts/llm_judge.py → ...ptimization-cookbook/scripts/llm_judge.py b/...ptimization-cookbook/scripts/llm_judge.py → ...ptimization-cookbook/scripts/llm_judge.py
diff --git a/...on-cookbook/scripts/results_summarizer.py → ...on-cookbook/scripts/results_summarizer.py b/...on-cookbook/scripts/results_summarizer.py → ...on-cookbook/scripts/results_summarizer.py
diff --git a/...ptimization-cookbook/scripts/topk_eval.py → ...ptimization-cookbook/scripts/topk_eval.py b/...ptimization-cookbook/scripts/topk_eval.py → ...ptimization-cookbook/scripts/topk_eval.py
diff --git a/registry.yaml b/registry.yaml
@@ -5,7 +5,7 @@
 # authors for each page.
 
 - title: GPT-5-Codex Prompting Guide
-  path: examples/gpt-5-codex_prompting_guide.ipynb
+  path: examples/prompting/gpt-5-codex_prompting_guide.ipynb
   date: 2025-09-23
   authors:
     - daveleo-openai
@@ -42,7 +42,7 @@
     - codex
 
 - title: Realtime Prompting Guide
-  path: examples/Realtime_prompting_guide.ipynb
+  path: examples/prompting/Realtime_prompting_guide.ipynb
   date: 2025-08-28
   authors:
     - minh-hoque
@@ -84,7 +84,7 @@
     - gpt-oss-local
 
 - title: GPT-5 Prompt Migration and Improvement Using the New Optimizer
-  path: examples/gpt-5/prompt-optimization-cookbook.ipynb
+  path: examples/prompting/prompt-optimization-cookbook.ipynb
   date: 2025-08-07
   authors:
     - rajpathak-openai
@@ -96,7 +96,7 @@
     - prompt-optimization
 
 - title: GPT-5 prompting guide
-  path: examples/gpt-5/gpt-5_prompting_guide.ipynb
+  path: examples/prompting/gpt-5_prompting_guide.ipynb
   date: 2025-08-07
   authors:
     - anoop-openai
@@ -249,7 +249,7 @@
     - audio
 
 - title: Optimize Prompts
-  path: examples/Optimize_Prompts.ipynb
+  path: examples/prompting/Optimize_Prompts.ipynb
   date: 2025-07-14
   authors:
     - corwin
@@ -271,7 +271,7 @@
     - automation
 
 - title: Prompt Migration Guide
-  path: examples/Prompt_migration_guide.ipynb
+  path: examples/prompting/Prompt_migration_guide.ipynb
   date: 2025-06-26
   authors:
     - minh-hoque
@@ -342,7 +342,7 @@
     - mutli-agent-collaboration
 
 - title: o3/o4-mini Function Calling Guide
-  path: examples/o-series/o3o4-mini_prompting_guide.ipynb
+  path: examples/prompting/o3o4-mini_prompting_guide.ipynb
   date: 2025-05-26
   authors:
     - billchen-openai
@@ -796,7 +796,7 @@
     - embeddings
 
 - title: Unit test writing using a multi-step prompt
-  path: examples/Unit_test_writing_using_a_multi-step_prompt.ipynb
+  path: examples/prompting/Unit_test_writing_using_a_multi-step_prompt.ipynb
   date: 2022-11-15
   authors:
     - ted-at-openai
@@ -805,7 +805,7 @@
 
 - title: Unit test writing using a multi-step prompt with legacy Completions
   path: >-
-    examples/Unit_test_writing_using_a_multi-step_prompt_with_older_completions_API.ipynb
+    examples/prompting/Unit_test_writing_using_a_multi-step_prompt_with_older_completions_API.ipynb
   date: 2023-05-19
   authors:
     - ted-at-openai
@@ -875,7 +875,7 @@
   archived: true
 
 - title: Whisper prompting guide
-  path: examples/Whisper_prompting_guide.ipynb
+  path: examples/prompting/Whisper_prompting_guide.ipynb
   date: 2023-06-27
   authors:
     - prestontuggle
@@ -2153,7 +2153,7 @@
     - completions
 
 - title: Prompt Caching 101
-  path: examples/Prompt_Caching101.ipynb
+  path: examples/prompting/Prompt_Caching101.ipynb
   date: 2024-10-01
   authors:
     - charuj
@@ -2194,7 +2194,7 @@
     - audio
 
 - title: Enhance your prompts with meta prompting
-  path: examples/Enhance_your_prompts_with_meta_prompting.ipynb
+  path: examples/prompting/Enhance_your_prompts_with_meta_prompting.ipynb
   date: 2024-10-23
   authors:
     - teomusatoiu
@@ -2377,7 +2377,7 @@
     - chatgpt-productivity
 
 - title: GPT-4.1 Prompting Guide
-  path: examples/gpt4-1_prompting_guide.ipynb
+  path: examples/prompting/gpt4-1_prompting_guide.ipynb
   date: 2025-04-14
   authors:
     - nm-openai