Skip to content

docs(skills): scale-semantics guidance and value-level LWS eval - #195

Draft
rogirun wants to merge 1 commit into
feat/add-workload-type-skillfrom
feat/skill-scale-semantics
Draft

docs(skills): scale-semantics guidance and value-level LWS eval#195
rogirun wants to merge 1 commit into
feat/add-workload-type-skillfrom
feat/skill-scale-semantics

Conversation

@rogirun

@rogirun rogirun commented Jul 28, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Skill improvements for add-workload-type, surfaced by testing it against the
built-in catalog:

  • Adds scale-semantics guidance: a component's replicasPath is the count of its
    own instances, not the pods beneath it. Grouped/replicated workloads expose two
    numbers (how many groups/replicas vs members-per-group); a group-level
    component scales on the group count. The LeaderWorkerSet trap
    (group -> .spec.replicas, not .spec.leaderWorkerTemplate.size) is spelled
    out, with a sibling-consistency self-check.
  • Adds a value-level eval (id 4) that asserts extracted scale numbers against a
    concrete manifest, grounded in the real API, so a valid-but-wrong scale path is
    catchable rather than invisible to a match-the-definition comparison.

Stacks on #187.

Related issue(s)

Fixes #194

Checklist

  • All commits are signed off with DCO (git commit -s)
  • New/modified files have SPDX license and copyright headers
  • Documentation updated (if applicable)
  • Tests pass (make check) - docs/evals only, no Go impact
  • No proprietary or internal information included

A component's replicasPath is the count of its own instances, not the pods
beneath it. Add guidance (with the LeaderWorkerSet group-vs-size trap and a
sibling-consistency self-check) and a value-level eval that asserts extracted
scale numbers against a concrete manifest, so this class of valid-but-wrong
scale error is catchable.

Relates to #186.

Signed-off-by: Roee Gil <roee.gil@run.ai>
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