Skip to content

docs: fix the guidance-validation runbook — MCP_URL is what points a gate run at dev - #351

Merged
cboettig merged 1 commit into
mainfrom
docs/dev-targeted-gate-runbook
Aug 3, 2026
Merged

docs: fix the guidance-validation runbook — MCP_URL is what points a gate run at dev#351
cboettig merged 1 commit into
mainfrom
docs/dev-targeted-gate-runbook

Conversation

@cboettig

@cboettig cboettig commented Aug 3, 2026

Copy link
Copy Markdown
Member

Found while gating #312 (PR #350): the Validating guidance changes runbook could not be followed as written.

  • It said to use geo-agent-template because its layers-input.json points mcp_url at dev. It doesn't any more — it points at duckdb-mcp.carlboettiger.info (the cirrus mirror head). So the documented recipe silently measured prod guidance, i.e. not the change under test.
  • The runner had no MCP override at all, so no app repo could be aimed at dev without editing an app config. Fixed in feat(headless): MCP_URL override so a matrix run can target dev open-llm-proxy#100 + h3-guide: nuance APPROX_COUNT_DISTINCT vs COUNT(DISTINCT) by cardinality / GROUP BY context #101; this documents the resulting MCP_URL knob and makes "check the Job log's --- mcp: --- line" part of step 3.
  • It described the "standing baseline set" as a list to seed in the harness repo. That work is done and now lives in boettiger-lab/geo-agent-benchmark as the regression tier with gold answers, tiers, mechanical grading, and trap: tags — so the section now points there instead of describing a plan.
  • The model list came from geo-agent-template/k8s/configmap.yaml; the registry is now geo-agent-benchmark/suite/models.yaml.

Also notes that reading PROXY_KEY out of the cluster Secret onto a local disk is not the supported path — the Job mounts it in-pod, which is the reason the Job path exists.

No prompt artifact changes, so no model-suite validation applies to this PR (AGENTS.md is not injected into any tool description).

…gate run at dev

The recipe named geo-agent-template as the dev-targeted app, but its
mcp_url now points at the cirrus mirror head, so following it measured
prod guidance — not the change under test. The runner also had no MCP
override at all (added in open-llm-proxy#100/#101); document MCP_URL as
the knob, and make checking the Job log's mcp line part of the read-back.

Also replaces the "seed a standing baseline set" plan with a pointer to
geo-agent-benchmark, where the regression tier, gold answers, tiers,
grading, and trap tags now live, and updates the model-registry pointer.
@cboettig
cboettig merged commit 96d0d91 into main Aug 3, 2026
1 check passed
@cboettig
cboettig deleted the docs/dev-targeted-gate-runbook branch August 3, 2026 22:52
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