# Terminology Semantics

> Terminology Semantics is an Agent Skill for testing & quality published in the kubernetes-sigs/kueue repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Review that code and events use terminology whose semantics match the operation (e.g., not Preempted for migration).

- Skill name: `terminology-semantics`
- Category: [Testing & Quality](https://www.openparable.com/skill/testing-quality/1)
- Source: https://github.com/kubernetes-sigs/kueue/blob/HEAD/cmd/experimental/skills/reviewer/terminology-semantics/SKILL.md
- Repository: kubernetes-sigs/kueue (2,719 GitHub stars when collected)

## SKILL.md

# Skill: Terminology Must Match Semantics

**Flag:** Code, events, status conditions, or log messages borrow a term from an adjacent concept when the semantics differ. Canonical example: using `Preempted` / `IssuePreemptions` for workload migration or topology-driven eviction that does not actually preempt another workload.

**Ask:** Use terminology that accurately reflects the operation. In Kueue, "preemption" means evicting a lower-priority workload to admit a higher-priority one. Other eviction causes (flavor migration, node replacement, workload slices) are distinct operations — labelling them `Preempted` produces misleading events and logs for operators debugging in production. Introduce a new reason constant (e.g., `FlavorMigration`) rather than reusing an existing one with different semantics.

---

Source: https://www.openparable.com/skill/testing-quality/terminology-semantics (OpenParable). Cite the canonical URL above.
