From 1e0eaca35e18b8fb2041ed8862092599512bbca6 Mon Sep 17 00:00:00 2001 From: Timothy Date: Tue, 14 Jul 2026 19:17:37 +0200 Subject: [PATCH] docs(queue): start tool-bearing selectors at low effort Clarify that enabled web_search makes a cheap worker tool-bearing even when the selector intends to use only Gitea, reserve minimal for tool-free supplied-evidence synthesis, and require hard evidence/output caps. Co-Authored-By: OpenAI Codex --- docs/handoffs/chicorytv-issue-queue.md | 28 ++++++++++++++++---------- 1 file changed, 17 insertions(+), 11 deletions(-) diff --git a/docs/handoffs/chicorytv-issue-queue.md b/docs/handoffs/chicorytv-issue-queue.md index 429eb1395..93c19a6e8 100644 --- a/docs/handoffs/chicorytv-issue-queue.md +++ b/docs/handoffs/chicorytv-issue-queue.md @@ -11,7 +11,7 @@ ## Orchestrator launch profile (operator-facing; do not paste) -As of 2026-07-13: +As of 2026-07-14: - **Codex:** use **GPT-5.6 Sol, `ultra`** for the orchestrator. `ultra` is the Codex multi-agent orchestration setting; if it is unavailable, use **GPT-5.6 Sol, `max` effort** @@ -20,8 +20,10 @@ As of 2026-07-13: orchestration preset built on `xhigh`). Reserve **Fable 5, `high` effort** for the frontier escalations listed below; use `xhigh` there only when the decision remains genuinely difficult. - **Queue preflight:** when the user has not named an issue, use the client's cheapest suitable - fast/small model at low or minimal effort. Route it as a subagent when possible; otherwise run a - separate low-cost selector session and pass its compact selection packet to the orchestrator. + fast/small model at **low** effort. Queue selection is tool-bearing, so do not use `minimal`: + Codex validates the full enabled tool profile, and enabled `web_search` can reject `minimal` even + when the selector intends to call only Gitea MCP. Route it as a subagent when possible; otherwise + run a separate low-cost selector session and pass its compact selection packet to the orchestrator. Never spend the orchestrator tier on queue ranking. - If those names are unavailable, choose the client's strongest long-horizon coding/agentic model at its high extended-reasoning setting. Do not weaken the orchestrator to a fast/mini model; use @@ -50,16 +52,20 @@ available, otherwise use a fresh agent with no implementation role. **Low-cost routing applies throughout the session, not only to queue selection.** Before any batch of bounded searches, inventories, log triage, URL/status sampling, or report drafting, dispatch the cheapest -suitable fast/small model at low or minimal effort. Strictly cap its files, queries, log window, and output; -the orchestrator receives a compact evidence packet and performs only the minimum focused live recheck. -Same-tier agents add parallelism, not cost savings, while direct tool-only mechanical checks may stay inline. -If a cheap worker lacks a required tool, give it already-collected bounded evidence for synthesis or report -the limitation explicitly instead of silently expanding orchestrator reconnaissance. Global Codex hook -enforcement is tracked in `timothy/server-management#592`; the wider Claude-hook port is tracked in -`timothy/server-management#593`. +suitable fast/small model. **If any tool is enabled or required, start at `low`; this includes enabled +`web_search` even when the prompt names only Gitea MCP. Reserve `minimal` for explicitly tool-free synthesis +over already-supplied bounded evidence.** Never retry a known tool-bearing profile at `minimal`. Strictly +cap its allowed files, queries, log window, result/evidence count, and output; instruct it to stop and return +partial evidence at a cap instead of broadening scope. The orchestrator receives a compact evidence packet +and performs only the minimum focused live recheck. Same-tier agents add parallelism, not cost savings, +while direct tool-only mechanical checks may stay inline. If a tool-bearing launch is rejected at `minimal`, +retry once with the same model and unchanged scope at `low`. If a cheap worker lacks a required tool, give it +already-collected bounded evidence for explicitly tool-free synthesis or report the limitation instead of +silently expanding orchestrator reconnaissance. Global Codex hook enforcement is tracked in +`timothy/server-management#592`; the wider Claude-hook port is tracked in `timothy/server-management#593`. **When the user has not named an issue, queue selection is mechanical fast/small work, never orchestrator -work.** Dispatch exactly one selector on the cheapest suitable model at low or minimal effort. Give it only +work.** Dispatch exactly one selector on the cheapest suitable model at `low` effort. Give it only #237's body, last ~6 comments, every OPEN milestone and its OPEN issues, OPEN `review`-labeled issues, and the reviewer-repo candidate list plus each candidate's claim/deliverable comments; it returns a ranked shortlist of at most three issue IDs with one-line rationales and live-state evidence. The -- 2.47.3