# Terminology Semantics

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

- Skill: `kubernetes-sigs-kueue/terminology-semantics` (Agent Skill)
- Install (CLI): `npx get-skill add kubernetes-sigs-kueue/terminology-semantics`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kubernetes-sigs-kueue/terminology-semantics/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: kubernetes-sigs (https://skillmd.com/u/kubernetes-sigs-kueue)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/kubernetes-sigs-kueue/terminology-semantics

---


# 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.

