Carlos Florêncio
84 lines
2.1 KiB
Markdown
84 lines
2.1 KiB
Markdown
---
|
|
id: "04-public-docs"
|
|
title: "Document variation fallback"
|
|
status: done
|
|
wave: 3
|
|
depends_on: ["01-runtime-resolution", "02-frontend-advisory"]
|
|
plan: "plan.md"
|
|
requirements:
|
|
- REQ-AGENTS-NO-SILENT-MODEL-FALLBACK-002
|
|
acceptance_criteria:
|
|
- 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
|
|
system_design:
|
|
- ../../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
|
|
|
|
```bash
|
|
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.
|