165### Model choice165### Model choice
166 166
167- **`gpt-5.6`**: Start here for demanding agents. It's strongest for ambiguous, multi-step work that needs planning, tool use, validation, and follow-through across a larger context.167- **`gpt-5.6`**: Start here for demanding agents. It's strongest for ambiguous, multi-step work that needs planning, tool use, validation, and follow-through across a larger context.
168- **`gpt-5.4`**: Use this when a workflow is pinned to GPT-5.4. It combines strong coding, reasoning, tool use, and broader workflows.
169- **`gpt-5.6-terra`**: Use for agents that favor speed and efficiency over depth, such as exploration, read-heavy scans, large-file review, or processing supporting documents. It works well for parallel workers that return distilled results to the main agent.168- **`gpt-5.6-terra`**: Use for agents that favor speed and efficiency over depth, such as exploration, read-heavy scans, large-file review, or processing supporting documents. It works well for parallel workers that return distilled results to the main agent.
169- **`gpt-5.6-luna`**: Use for fast, narrowly scoped agents handling clear, repeatable, or high-volume work.
170 170
171### Reasoning effort (`model_reasoning_effort`)171### Reasoning effort (`model_reasoning_effort`)
172 172
424```toml424```toml
425name = "reviewer"425name = "reviewer"
426description = "PR reviewer focused on correctness, security, and missing tests."426description = "PR reviewer focused on correctness, security, and missing tests."
427427model = "gpt-5.4"model = "gpt-5.6-terra"
428model_reasoning_effort = "high"428model_reasoning_effort = "high"
429sandbox_mode = "read-only"429sandbox_mode = "read-only"
430developer_instructions = """430developer_instructions = """
439```toml439```toml
440name = "docs_researcher"440name = "docs_researcher"
441description = "Documentation specialist that uses the docs MCP server to verify APIs and framework behavior."441description = "Documentation specialist that uses the docs MCP server to verify APIs and framework behavior."
442442model = "gpt-5.4-mini"model = "gpt-5.6-luna"
443model_reasoning_effort = "medium"443model_reasoning_effort = "medium"
444sandbox_mode = "read-only"444sandbox_mode = "read-only"
445developer_instructions = """445developer_instructions = """
474```toml474```toml
475name = "code_mapper"475name = "code_mapper"
476description = "Read-only codebase explorer for locating the relevant frontend and backend code paths."476description = "Read-only codebase explorer for locating the relevant frontend and backend code paths."
477477model = "gpt-5.4-mini"model = "gpt-5.6-luna"
478model_reasoning_effort = "medium"478model_reasoning_effort = "medium"
479sandbox_mode = "read-only"479sandbox_mode = "read-only"
480developer_instructions = """480developer_instructions = """
488```toml488```toml
489name = "browser_debugger"489name = "browser_debugger"
490description = "UI debugger that uses browser tooling to reproduce issues and capture evidence."490description = "UI debugger that uses browser tooling to reproduce issues and capture evidence."
491491model = "gpt-5.4"model = "gpt-5.6-terra"
492model_reasoning_effort = "high"492model_reasoning_effort = "high"
493sandbox_mode = "workspace-write"493sandbox_mode = "workspace-write"
494developer_instructions = """494developer_instructions = """