From e973e209da5c88970cf16833cfbb36d8f4cc0d52 Mon Sep 17 00:00:00 2001 From: ayattara Date: Mon, 7 Sep 2026 01:19:35 +0000 Subject: [PATCH] docs(agents): clarify strict model fallback policy --- .../agents/system-design/no-silent-model-fallback-01.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/specs/agents/system-design/no-silent-model-fallback-01.md b/docs/specs/agents/system-design/no-silent-model-fallback-01.md index 329b546fae..94306770e0 100644 --- a/docs/specs/agents/system-design/no-silent-model-fallback-01.md +++ b/docs/specs/agents/system-design/no-silent-model-fallback-01.md @@ -118,8 +118,8 @@ Kandev must keep the task operational and explain the effective model.** evidence. - **Fallback-model mode**: profile has `auto_fallback = false` and a non-empty `fallback_model`. The only permitted automatic switch is to - that single model when the executor advertises it. Otherwise, the agent uses - its default and Kandev persists a warning. + that single model when the executor advertises and applies it. Otherwise, + Kandev fails the session before inference with sanitized mismatch evidence. - **Auto-fallback mode**: profile has `auto_fallback = true`. Legacy behavior (session-start best-effort; office routing re-dispatch to next candidate). Every session-start deviation creates a warning. @@ -144,8 +144,9 @@ over `fallback_model`): | Model picker (profile editor, session toolbar) | Gone models greyed out, unselectable, visible. | Same. | Same. | `SetModel` failures that mean "this agent does not support model selection" -(JSON-RPC `-32601`, `sessionmodel.MethodNone` / `IsMethodNotFound`) do not stop -the launch. The agent uses its default and Kandev persists a warning. +(JSON-RPC `-32601`, `sessionmodel.MethodNone` / `IsMethodNotFound`) fail exact +and fallback-model launches before inference. Only `auto_fallback = true` +continues on the agent default and persists a warning. The executor ACP catalog is authoritative for launch. Exact-profile model identity is enforced by [ADR-2026-09-06](../../../decisions/2026-09-06-exact-profile-model-identity.md).