refactor: rename gpt5-preset to llm-gpt5-preset and document naming convention

.agents/skills/code-review.md

@@ -78,3 +78,13 @@ grep -rn "function_name" /tmp/agent-sdk/
 - Ensure MDX frontmatter is present and well-formed
 - Check that internal links use absolute doc paths (e.g., `/overview/quickstart`)
 - Verify code blocks with file references use the correct sync format (see `sdk-guidelines.md`)
+
+### SDK guide file naming convention
+
+SDK guide files under `sdk/guides/` **must** use a category prefix:
+
+- `llm-` for LLM-related guides (e.g., `llm-reasoning.mdx`, `llm-gpt5-preset.mdx`)
+- `agent-` for Agent-related guides (e.g., `agent-custom.mdx`, `agent-delegation.mdx`)
+- `convo-` for Conversation-related guides (e.g., `convo-async.mdx`, `convo-persistence.mdx`)
+
+Flag any new SDK guide that does not follow this naming convention.

AGENTS.md

@@ -152,6 +152,18 @@ Workflow: `.github/workflows/sync-agent-sdk-openapi.yml`
 - Use Mintlify components (`<Note>`, `<Warning>`, `<Tabs>`, etc.) where appropriate.
 - When linking internally, prefer **absolute** doc paths (e.g. `/overview/quickstart`).
 
+### SDK guide file naming
+
+SDK guide files under `sdk/guides/` use a **category prefix** to group related pages:
+
+| Prefix | Category | Examples |
+|--------|----------|----------|
+| `llm-` | LLM features (model configuration, providers, streaming, presets) | `llm-reasoning.mdx`, `llm-gpt5-preset.mdx` |
+| `agent-` | Agent features (customization, delegation, browser, settings) | `agent-custom.mdx`, `agent-delegation.mdx` |
+| `convo-` | Conversation features (async, persistence, pause/resume) | `convo-async.mdx`, `convo-persistence.mdx` |
+
+When adding a new SDK guide, always use the appropriate prefix so that related files sort together and the sidebar grouping in `docs.json` stays consistent.
+
 ## LLM API Key Options
 
 The SDK documentation maintains three ways for users to obtain LLM access:

docs.json

@@ -253,7 +253,7 @@
                   "sdk/guides/llm-registry",
                   "sdk/guides/llm-routing",
                   "sdk/guides/llm-reasoning",
-                  "sdk/guides/gpt5-preset",
+                  "sdk/guides/llm-gpt5-preset",
                   "sdk/guides/llm-streaming",
                   "sdk/guides/llm-image-input",
                   "sdk/guides/llm-error-handling",