@ryuxdsgn/design-intelligence 2.7.1 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -710,11 +710,11 @@ export const RULES = [
710
710
  title: "Tokens over one-off values",
711
711
  level: "preferred",
712
712
  gate: "lock",
713
- do: "Use tokens or variables for color, spacing, radius, elevation, and type.",
714
- dont: "Hard-code one-off values for things the system already defines.",
715
- why: "Tokens keep changes consistent and reviewable.",
716
- basis: "W3C Design Tokens Community Group",
717
- check: "review",
713
+ do: "Use tokens or variables for color, spacing, radius, elevation, and type. First look for the ones that exist (DESIGN.md, a tokens or theme file in the repo, the design file's variables and components, a linked library) and use them. When the project has none, define them before the first frame: color roles, a spacing scale, a radius scale, and a type scale (sizes, and font families). In a design tool, create them as the tool's variables and reference them in every value, and make anything that repeats (a row, a button, a bar) a component. After rendering, count the values that are still literal, by kind, and turn each into a token or name why it is an exception.",
714
+ dont: "Hard-code one-off values for things the system already defines, or define tokens for color only and leave spacing, radius, and type size literal.",
715
+ why: "Tokens keep changes consistent and reviewable; values that are not tokens drift from frame to frame and state to state.",
716
+ basis: "W3C Design Tokens Community Group; ryux four-problems baseline 2026-10-16: in all 12 runs, with or without RYUX, spacing, radius, and font size were 100% literal",
717
+ check: "count literal values after render; review",
718
718
  },
719
719
  {
720
720
  num: 5,
@@ -94,11 +94,17 @@ export const DESIGN_BODY = `# RYUX Design
94
94
  Direction (RX-UI-12, RX-UI-10). On task UI, follow conventions and the design system.
95
95
  5. **Read the modules the task needs** from the task table, for example ux, interaction, forms, and
96
96
  content for a form, or ui and responsive for a layout.
97
- 6. **Design in the tool.** Use the Figma MCP or the pen.dev MCP. Design every state that matters
98
- (empty, loading, error) and every width you claim, and source assets on purpose (RX-UI-13).
97
+ 6. **Design in the tool.** Use the Figma MCP or the pen.dev MCP. System first: look for the design
98
+ system that exists (DESIGN.md, a tokens or theme file in the repo, the design file's variables and
99
+ components, a linked library) and build from it. Create only what is missing: variables for color
100
+ roles, spacing, radius, and type sizes and families before the first frame, and components for
101
+ repeated elements (RX-DS-03). Building the system does not replace the states: design every
102
+ state that matters (empty, loading, error, including content that fails to load) and every width
103
+ you claim, and source assets on purpose (RX-UI-13).
99
104
  7. **Render and inspect.** Screenshot what you made, check it against the direction and the rules,
100
- fix, and render again (capabilities/qa.md). List where the render differs from the Design
101
- Direction (hierarchy, states, widths) and fix or record each one. Check the result against the Liveliness you set, and
105
+ fix, and render again (capabilities/qa.md). Count the values still literal (color, spacing,
106
+ radius, type size) and turn each into a variable or name the exception. List where the render
107
+ differs from the Design Direction (hierarchy, states, widths) and fix or record each one. Check the result against the Liveliness you set, and
102
108
  put each prominent or decorative element through the purpose gate (RX-AS-05: purpose,
103
109
  contribution, necessity); on calm task UI, deliberate restraint is a valid answer. Then judge the main state as a
104
110
  reviewer would, not as a checklist: rate Clarity, Hierarchy, and Specificity from the Design Read
@@ -524,8 +530,11 @@ Does not cover: component reuse and tokens (see ryux-design-system).`,
524
530
  **Quality Locks** to keep across the product: spacing, typography, color roles, terminology,
525
531
  components, interaction patterns and states, responsive behavior, and visual hierarchy.
526
532
 
527
- If the project has no system yet, define the smallest token set the screen needs and use it
528
- consistently. Do not introduce a component library the project does not use.`,
533
+ Look for the existing system before defining one: DESIGN.md, a tokens or theme file in the repo, the
534
+ design file's variables and components, or a linked library. If the project has no system yet, define
535
+ the smallest token set the screen needs and use it consistently: color roles, a spacing scale, a
536
+ radius scale, and a type scale, not color alone. After rendering, count the literal values left and
537
+ convert them (RX-DS-03). Do not introduce a component library the project does not use.`,
529
538
  accessibility: `Accessibility is product quality, not an enhancement. Check:
530
539
 
531
540
  - **Semantics**: real headings, landmarks, lists, buttons, links, labels.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ryuxdsgn/design-intelligence",
3
- "version": "2.7.1",
3
+ "version": "2.8.0",
4
4
  "description": "RYUX: design intelligence for AI agents and designers. One skill, five entry points: Analyze, Design, Build, Critique, and QA, for Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Cline, Copilot, and more.",
5
5
  "type": "module",
6
6
  "bin": {