kandev/docs/plans/unique-model-variation-fallback/task-04-public-docs.md

id, title, status, wave, depends_on, plan, requirements, acceptance_criteria, system_design

id	title	status	wave	depends_on	plan	requirements	acceptance_criteria	system_design
04-public-docs	Document variation fallback	done	3	01-runtime-resolution 02-frontend-advisory	plan.md	REQ-AGENTS-NO-SILENT-MODEL-FALLBACK-002	AC-AGENTS-NO-SILENT-MODEL-FALLBACK-002.1 AC-AGENTS-NO-SILENT-MODEL-FALLBACK-002.2 AC-AGENTS-NO-SILENT-MODEL-FALLBACK-002.3 AC-AGENTS-NO-SILENT-MODEL-FALLBACK-002.5 AC-AGENTS-NO-SILENT-MODEL-FALLBACK-002.6	../../specs/agents/system-design/no-silent-model-fallback-01.md

Task 04: Document Variation Fallback

Summary

Update the public profile and executor guides with the unique-variation rule. Give users enough detail to predict unique and ambiguous results.

In scope

• Document the four-step launch order.
• Add one unique and one ambiguous example.
• State that labels remain opaque and saved profiles do not change.
• Run the public-doc validation commands.

Out of scope

• Release notes and changelog generation.
• Internal implementation detail beyond user-visible behavior.
• New screenshots or media.

Acceptance

• Both guides describe the same precedence and ambiguity rule.
• The docs state that the executor is authoritative and the profile stays unchanged.
• Public-doc validators pass.

Verification

node --test scripts/validate-public-docs.test.mjs
node scripts/validate-public-docs.mjs
git diff --check

Files likely touched

• docs/public/agents-and-profiles.md
• docs/public/executors.md

Dependencies

Tasks 01 and 02.

Risks

• Examples can imply that Kandev understands 1m or fast. The docs must state that it compares only the ID shape and candidate count.

Parallelism

parallel-safe with Task 03 after Tasks 01 and 02.

Inputs

• Final runtime precedence and warning behavior.
• Existing host-probe and remote-executor guide sections.

Results

Updated the public agent-profile and executor guides with the four-step resolution order, unique and ambiguous examples, opaque variation matching, and the unchanged saved-profile rule. Public-document tests passed (61) and the validator checked 46 published pages.