Skip to content

docs(lemonade-router-builder): clarify Mode A trace reading and example scope - #151

Open
AMD-melliott wants to merge 2 commits into
amd:mainfrom
AMD-melliott:fix/router-builder-docs
Open

docs(lemonade-router-builder): clarify Mode A trace reading and example scope#151
AMD-melliott wants to merge 2 commits into
amd:mainfrom
AMD-melliott:fix/router-builder-docs

Conversation

@AMD-melliott

Copy link
Copy Markdown

Description

Verified against Lemonade Server 11.5.2 on a Strix Halo host.

This PR:

  • SKILL.md: the Step 4 silent-fallback warning had no matching
    detection instruction at the tracing step. Points readers at
    default_used and notes that an empty rationale alone is not a
    fallback signal.
  • reference.md: documents the Mode A trace shape — synthetic
    __route_N rule ids (one per candidate, in declaration order), the
    empty-rationale-on-success case, and the unambiguous three-field
    fallback signature.
  • examples.md: states that the bundled examples are shape references,
    not runnable policies. They name models a given host may not have, and
    scripts/validate.py can't check model existence, so registering one
    unmodified fails at the server with 400 Collection component not registered.

…le scope

Three fixes verified against Lemonade Server 11.5.2 on a Strix Halo host:

- SKILL.md: the Step 4 silent-fallback warning had no matching detection
  instruction at the tracing step. Point readers at `default_used` and note
  that an empty `rationale` alone is not a fallback signal.

- reference.md: document Mode A trace shape - synthetic `__route_N` rule ids
  (one per candidate, in declaration order), the empty-`rationale`-on-success
  case, and the unambiguous three-field fallback signature.

- examples.md: state that the bundled examples are shape references, not
  runnable policies. They name models a given host may not have, and
  `scripts/validate.py` cannot check model existence, so registering one
  unmodified fails at the server with `400 Collection component not
  registered`.
@danielholanda

Copy link
Copy Markdown
Collaborator

@AMD-melliott Thanks for creating this PR!
@meghsat please take a look when you have a chance

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.

2 participants