taste-lint 0.0.1

package/data/rules/interaction/interaction-a11y-semantic-html-first.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-semantic-html-first.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-semantic-html-first
+title: Prefer Native Semantics Before ARIA
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-semantic-html-first.md
+  repo: mblode/agent-skills
+  ruleId: a11y-semantic-html-first
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <(div|span|li|td)\b[^>]*\bonClick=
+severity: major
+fix:
+  hint: Use semantic HTML controls first; only add ARIA when native elements cannot express intent. Rebuilding those semantics in ARIA reimplements keyboard behaviour, role, and state by hand, and any gap leaves assistive tech reporting the wrong thing.
+status: review-only

package/data/rules/interaction/interaction-a11y-skip-link-heading-order.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-skip-link-heading-order.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-skip-link-heading-order
+title: Provide Skip Link and Logical Heading Order
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/a11y-skip-link-heading-order.md
+  repo: mblode/agent-skills
+  ruleId: a11y-skip-link-heading-order
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: href="#
+  flags: gu
+  regex: <main\b
+severity: minor
+fix:
+  hint: Include a skip link and keep heading levels sequential. Without both, keyboard and screen reader users walk the whole header on every page and lose the outline they navigate by.
+status: review-only

package/data/rules/interaction/interaction-a11y-tooltip-no-interactive.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/a11y-tooltip-no-interactive.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-a11y-tooltip-no-interactive
+title: Hover tooltips must not contain interactive content
+categoryId: focus-and-a11y
+source:
+  line: 10
+  path: skills/ui-design/rules/a11y-tooltip-no-interactive.md
+  repo: mblode/agent-skills
+  ruleId: a11y-tooltip-no-interactive
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <(Tooltip(Content)?|HoverCard(Content)?)[^>]*>[\s\S]{0,800}<(button|a |input|select|textarea)\b
+severity: minor
+fix:
+  hint: A hover tooltip that contains a link, button, or input cannot be used with a keyboard or a touch screen, and it vanishes when the pointer moves to reach the inner control. Users see an action they cannot activate reliably.
+status: review-only

package/data/rules/interaction/interaction-broken-focus-trap.yaml

@@ -0,0 +1,25 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/focus-broken-focus-trap.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+id: interaction-broken-focus-trap
+title: Modal without working focus trap
+categoryId: focus-and-a11y
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/focus-broken-focus-trap.md
+  line: 10
+  ruleId: focus-broken-focus-trap
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit: [source]
+mechanical:
+  flags: gu
+  regex: 'role="(dialog|alertdialog)"'
+  absent: "@radix-ui/react-dialog|react-aria|focus-trap-react|@headlessui/react"
+severity: major
+fix:
+  hint: >-
+    A hand-rolled dialog: Tab and Shift+Tab must cycle inside it and Esc must close it. Use a primitive that traps focus (Radix Dialog, React Aria, Headless UI, focus-trap-react) or wire the trap yourself.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/interaction/interaction-dont-block-paste-ime.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-dont-block-paste-ime.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-dont-block-paste-ime
+title: Do Not Block Paste or IME Input
+categoryId: form-usability
+source:
+  line: 9
+  path: skills/ui-design/rules/forms-dont-block-paste-ime.md
+  repo: mblode/agent-skills
+  ruleId: forms-dont-block-paste-ime
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: onPaste=\{[^}]*preventDefault
+severity: minor
+fix:
+  hint: Avoid handlers that prevent paste or aggressively filter keystrokes. Blocking paste breaks password managers and assistive input, and keystroke filters swallow the composition events IME users type with.
+status: review-only

package/data/rules/interaction/interaction-error-association.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-error-association.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-error-association
+title: Associate and Announce Form Errors
+categoryId: form-usability
+source:
+  line: 9
+  path: skills/ui-design/rules/forms-error-association.md
+  repo: mblode/agent-skills
+  ruleId: forms-error-association
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: aria-describedby
+  flags: gu
+  regex: \{\s*[\w.?]*[Ee]rror[\w.?]*\s*&&
+severity: major
+fix:
+  hint: Tie each error to its input via `aria-describedby`, mark the field `aria-invalid`, and announce it through a live region (`role="alert"`). A message only visually near the field is invisible to screen readers. Complements `forms-inline-errors-first-focus`, which covers placement and focus.
+status: review-only

package/data/rules/interaction/interaction-focus-visible.yaml

@@ -0,0 +1,25 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/interaction-focus-visible.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-focus-visible
+title: Preserve Visible Focus States
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/interaction-focus-visible.md
+  repo: mblode/agent-skills
+  ruleId: interaction-focus-visible
+scope:
+  include:
+    - "**/*.css"
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: focus-visible
+  flags: gu
+  regex: outline:\s*(none|0)|\boutline-(none|hidden)\b
+severity: major
+fix:
+  hint: Never remove outlines without a clear `:focus-visible` replacement. With the outline gone, keyboard users cannot see where they are and the interface stops being navigable.
+status: review-only

package/data/rules/interaction/interaction-inline-errors-first-focus.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-inline-errors-first-focus.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-inline-errors-first-focus
+title: Show Inline Errors and Focus the First Invalid Field
+categoryId: form-usability
+source:
+  line: 9
+  path: skills/ui-design/rules/forms-inline-errors-first-focus.md
+  repo: mblode/agent-skills
+  ruleId: forms-inline-errors-first-focus
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  absent: \.focus\(\)|autoFocus|shouldFocusError
+  flags: gu
+  regex: <form\b
+severity: minor
+fix:
+  hint: On submit, reveal all relevant errors and move focus to the first failing field. Errors the user has to hunt for are the point where they abandon the form.
+status: review-only

package/data/rules/interaction/interaction-input-affix-hit-target.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-input-affix-hit-target.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-input-affix-hit-target
+title: Overlay input affixes on the field
+categoryId: form-usability
+source:
+  line: 10
+  path: skills/ui-design/rules/forms-input-affix-hit-target.md
+  repo: mblode/agent-skills
+  ruleId: forms-input-affix-hit-target
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <div[^>]*(flex|grid)[^>]*>\s*<(svg|Icon|Search|span)[^>]*>[\s\S]{0,400}<input\b
+severity: minor
+fix:
+  hint: "A search icon, currency mark, or unit sitting beside the field as a sibling splits the hit target: clicks on the decoration do not focus the input, and the control reads as two widgets. Prefix and suffix decorations belong on top of the text input, with padding so the value does not collide, and the"
+status: review-only

package/data/rules/interaction/interaction-keyboard-operable.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/interaction-keyboard-operable.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-keyboard-operable
+title: Ensure Full Keyboard Operability
+categoryId: focus-and-a11y
+source:
+  line: 9
+  path: skills/ui-design/rules/interaction-keyboard-operable.md
+  repo: mblode/agent-skills
+  ruleId: interaction-keyboard-operable
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <[A-Za-z][^>]*?\b(?:role="button"|tabIndex=\{[0-9])(?![^>]*?(?:onKeyDown|onKeyUp|onKeyPress))[^>]*?>
+severity: major
+fix:
+  hint: Pointer-only handlers are not acceptable for critical actions. Anything reachable only by pointer cannot be completed by keyboard, switch, or screen reader users at all.
+status: review-only

package/data/rules/interaction/interaction-labels-and-autocomplete.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-labels-and-autocomplete.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-labels-and-autocomplete
+title: Label Inputs and Set Autocomplete Metadata
+categoryId: form-usability
+source:
+  line: 9
+  path: skills/ui-design/rules/forms-labels-and-autocomplete.md
+  repo: mblode/agent-skills
+  ruleId: forms-labels-and-autocomplete
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: <input\b(?![^>]*\bid=)(?![^>]*aria-label)[^>]*placeholder=
+severity: major
+fix:
+  hint: Inputs require explicit labels and appropriate `type`, `name`, and `autocomplete` values. Without them users retype data the browser already has, and assistive tech has no name to announce.
+status: review-only

package/data/rules/interaction/interaction-lost-data-on-error.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-lost-data-on-error.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-lost-data-on-error
+title: Form data lost on validation error
+categoryId: form-usability
+source:
+  line: 10
+  path: skills/ui-design/rules/forms-lost-data-on-error.md
+  repo: mblode/agent-skills
+  ruleId: forms-lost-data-on-error
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: <form
+severity: minor
+fix:
+  hint: "When a form fails server validation, typed values must survive the round-trip. Clearing fields on error is one of the highest-cost UX bugs in production: users abandon checkout, retype passwords wrong, lose multi-paragraph inputs. React 19's `useActionState` makes preservation the default, but only "
+status: review-only

package/data/rules/interaction/interaction-mobile-input-font-size.yaml

@@ -0,0 +1,24 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-mobile-input-font-size.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-mobile-input-font-size
+title: Keep Mobile Input Text at Readable Size
+categoryId: form-usability
+source:
+  line: 9
+  path: skills/ui-design/rules/forms-mobile-input-font-size.md
+  repo: mblode/agent-skills
+  ruleId: forms-mobile-input-font-size
+scope:
+  include:
+    - "**/*.css"
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit:
+  - source
+mechanical:
+  flags: gus
+  regex: \b(?:input|textarea|select)\b[^{}/]*\{[^}]*font-size:\s*(?:0?\.\d+rem|(?<![\d.])(?:\d|1[0-5])(?:\.\d+)?px)|<(?:input|textarea|select|Input|Textarea)\b[^>]*className="[^"]*\btext-(?:xs|sm)\b
+severity: minor
+fix:
+  hint: "Set input text to at least 16px on mobile and avoid autofocus on touch-first flows. iOS zooms the viewport in on any field below 16px and does not zoom back out, leaving the user panned into a form they now have to scroll sideways. Do not stop that zoom with `maximum-scale=1` or `user-scalable=no`: "
+status: review-only

package/data/rules/interaction/interaction-no-disable-while-submitting.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-no-disable-while-submitting.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-no-disable-while-submitting
+title: Submit button not disabled while pending
+categoryId: form-usability
+source:
+  line: 10
+  path: skills/ui-design/rules/forms-no-disable-while-submitting.md
+  repo: mblode/agent-skills
+  ruleId: forms-no-disable-while-submitting
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: <form
+severity: major
+fix:
+  hint: "A double-clickable submit button creates duplicate accounts, double-charges cards, and posts the same comment twice. React 19's `useFormStatus` makes the fix mechanical: a child component reads `pending` from the surrounding `<form>`, disables itself, and exposes a busy state. Keep the label stable "
+status: review-only

package/data/rules/interaction/interaction-no-empty-state.yaml

@@ -0,0 +1,26 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/states-no-empty-state.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-no-empty-state
+title: Empty state has no call to action
+categoryId: state-coverage
+source:
+  line: 10
+  path: skills/ui-design/rules/states-no-empty-state.md
+  repo: mblode/agent-skills
+  ruleId: states-no-empty-state
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+# The source's real check is its loop: an empty branch with no action element.
+mechanical:
+  flags: gu
+  regex: \.length === 0|isEmpty
+  absent: Button|Link|<a |onClick
+severity: minor
+fix:
+  hint: 'When a list, table, or feed is empty, "No items" alone is a dead end: the user can''t tell whether nothing exists, the filter is too narrow, or they must act to populate it. A good empty state names the situation, explains why, and offers exactly one primary action. Onboarding empty states (first-run'
+status: review-only
+handWritten: [mechanical]

package/data/rules/interaction/interaction-no-error-boundary.yaml

@@ -0,0 +1,27 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/async-no-error-boundary.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+# The source also lists every 'use client' file; this port keeps the async part
+# (useQuery, useSWR) so a plain client component is not a finding.
+id: interaction-no-error-boundary
+title: Client async tree without a local error boundary
+categoryId: state-coverage
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/async-no-error-boundary.md
+  line: 10
+  ruleId: async-no-error-boundary
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit: [source]
+mechanical:
+  flags: gu
+  regex: "useQuery|useSWR"
+  absent: "ErrorBoundary"
+severity: major
+fix:
+  hint: >-
+    A thrown error in an async tree with no ancestor boundary unmounts the whole route. Wrap the fetching subtree in an ErrorBoundary (or add error.tsx to the route segment) so a failed query degrades in place.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/interaction/interaction-no-error-state.yaml

@@ -0,0 +1,26 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/states-no-error-state.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-no-error-state
+title: Async fetch has no inline error state
+categoryId: state-coverage
+source:
+  line: 10
+  path: skills/ui-design/rules/states-no-error-state.md
+  repo: mblode/agent-skills
+  ruleId: states-no-error-state
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+# The source's real check is its loop: a fetcher with no inline error branch.
+mechanical:
+  flags: gu
+  regex: useQuery|useSWR
+  absent: isError|hasError|onError|catch
+severity: major
+fix:
+  hint: "Every async op can fail. A happy-path-only component turns a transient 500 into a blank screen, an infinite spinner, or a silent stale render. This rule owns the component's own error branch: the failure renders a message naming what broke plus a way out (retry, go back, contact support), in place, "
+status: review-only
+handWritten: [mechanical]

package/data/rules/interaction/interaction-no-suspense-boundary.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/async-no-suspense-boundary.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-no-suspense-boundary
+title: Async server component without Suspense boundary
+categoryId: state-coverage
+source:
+  line: 10
+  path: skills/ui-design/rules/async-no-suspense-boundary.md
+  repo: mblode/agent-skills
+  ruleId: async-no-suspense-boundary
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: ^export (default )?async function
+severity: minor
+fix:
+  hint: "In the App Router and React 19, an async server component with no enclosing `<Suspense>` boundary blocks the whole route from streaming. Users wait for the slowest fetch before seeing anything: no shell, no skeleton, no progressive paint. Wrap the slow async tree in `<Suspense fallback={...}>` to un"
+status: review-only

package/data/rules/interaction/interaction-not-restored.yaml

@@ -0,0 +1,25 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/focus-not-restored.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+id: interaction-not-restored
+title: Focus not restored after a modal, sheet or popover closes
+categoryId: focus-and-a11y
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/focus-not-restored.md
+  line: 10
+  ruleId: focus-not-restored
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit: [source]
+mechanical:
+  flags: gu
+  regex: "role=\"dialog\"|<Dialog\\b|<Sheet\\b"
+  absent: "onCloseAutoFocus|triggerRef|finalFocus|returnFocusOnDeactivate"
+severity: major
+fix:
+  hint: >-
+    When a dialog closes, focus returns to the element that opened it. Keep the trigger ref and focus it on close (onCloseAutoFocus, finalFocus, returnFocusOnDeactivate) instead of leaving focus on body.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/interaction/interaction-on-dynamic-content.yaml

@@ -0,0 +1,25 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/focus-on-dynamic-content.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+id: interaction-on-dynamic-content
+title: Route change without focus management or a live region
+categoryId: focus-and-a11y
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/focus-on-dynamic-content.md
+  line: 10
+  ruleId: focus-on-dynamic-content
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit: [source]
+mechanical:
+  flags: gu
+  regex: "router\\.(push|replace)"
+  absent: "focus\\(\\)|aria-live"
+severity: minor
+fix:
+  hint: >-
+    A client-side navigation never moves focus or announces the new content. After router.push, focus the new page heading or main region, or announce the change in an aria-live region.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/interaction/interaction-optimistic-without-rollback.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/async-optimistic-without-rollback.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-optimistic-without-rollback
+title: Optimistic update without rollback on server reject
+categoryId: state-coverage
+source:
+  line: 10
+  path: skills/ui-design/rules/async-optimistic-without-rollback.md
+  repo: mblode/agent-skills
+  ruleId: async-optimistic-without-rollback
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: useOptimistic\b
+severity: major
+fix:
+  hint: "`useOptimistic` shows the post-action state immediately (liked post, cart item added, renamed file). Contract: on server reject (422, 500, network error) the UI must roll back to real server state, or it lies and a reload reveals the truth, costing trust. Second half of the contract: optimistic upda"
+status: review-only

package/data/rules/interaction/interaction-out-of-order-responses.yaml

@@ -0,0 +1,27 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/async-out-of-order-responses.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+# The first `-A 8` window in the source becomes a 400-character span here; a handler
+# that fetches further down still counts, a fetch elsewhere in the file does not.
+id: interaction-out-of-order-responses
+title: Input handler fetches with no cancellation
+categoryId: state-coverage
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/async-out-of-order-responses.md
+  line: 10
+  ruleId: async-out-of-order-responses
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit: [source]
+mechanical:
+  flags: gu
+  regex: "on(?:Change|Input)=[\\s\\S]{0,400}?(?:fetch\\(|useQuery\\(|axios\\.)"
+  absent: "AbortController|useDeferredValue|signal:"
+severity: major
+fix:
+  hint: >-
+    Two keystrokes fire two requests and the slow one can land last, showing stale results under fresh input. Cancel the in-flight request with an AbortController (or pass signal), or debounce through useDeferredValue.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/interaction/interaction-target-size.yaml

@@ -0,0 +1,26 @@
+# Hand-ported from mblode/agent-skills skills/ui-design/rules/interaction-target-size.md. The detection there is a
+# shell loop or pipeline; regex plus absent is the same check over one file.
+# Both halves of the source pipeline apply to one line: a small h-, w- or size- step
+# and a button on the same line.
+id: interaction-target-size
+title: Button sized below the touch target floor
+categoryId: focus-and-a11y
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/interaction-target-size.md
+  line: 9
+  ruleId: interaction-target-size
+scope:
+  include:
+    - "**/*.tsx"
+    - "**/*.jsx"
+unit: [source]
+mechanical:
+  flags: gum
+  regex: "^(?=.*\\b(?:h|w|size)-(?:[1-9]|10)\\b).*(?:button|role=\"button\").*$"
+severity: minor
+fix:
+  hint: >-
+    Touch targets need 44 by 44px; 24px is the floor only for dense desktop UI under pointer: fine. Give the button at least size-11, or pad the hit area while keeping the icon small.
+status: review-only
+handWritten: [mechanical, fix, status]

package/data/rules/interaction/interaction-use-form-status-misuse.yaml

@@ -0,0 +1,23 @@
+# Ported from mblode/agent-skills skills/ui-design/rules/forms-use-form-status-misuse.md by scripts/port-rules.ts.
+# Keys listed in handWritten are preserved on re-run; everything else is regenerated.
+id: interaction-use-form-status-misuse
+title: useFormStatus called in same component as form (silent bug)
+categoryId: form-usability
+source:
+  line: 10
+  path: skills/ui-design/rules/forms-use-form-status-misuse.md
+  repo: mblode/agent-skills
+  ruleId: forms-use-form-status-misuse
+scope:
+  include:
+    - "**/*.ts"
+    - "**/*.tsx"
+unit:
+  - source
+mechanical:
+  flags: gu
+  regex: useFormStatus
+severity: major
+fix:
+  hint: "`useFormStatus` returns the **parent** `<form>`'s status. Called in the same component that renders the `<form>`, it returns `{ pending: false }` forever (no parent form to inspect). It compiles, runs, never warns, and silently breaks everything depending on it (disabled submit, pending label, optim"
+status: review-only

package/data/rules/product/product-nested-modals.yaml

@@ -0,0 +1,26 @@
+# Hand-authored from mblode/agent-skills skills/product-design/references/rules.md (rule/no-nested-modals), a deterministic
+# slice named in skills/product-design/references/lint-patterns.md.
+id: product-nested-modals
+title: A modal that opens inside another modal
+categoryId: control-choice
+source:
+  repo: mblode/agent-skills
+  path: skills/product-design/references/rules.md
+  line: 86
+  ruleId: rule/no-nested-modals
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  flags: gu
+  regex:
+    "<(Dialog|AlertDialog|Modal|Sheet|Drawer)\\b[^>]*>(?:(?!</\\1>)[\\s\\S])*?<(?:Dialog|AlertDi\
+    alog|Modal|Sheet|Drawer)\\b[^>]*>"
+severity: minor
+fix:
+  hint: >-
+    Resolve the first modal, use one multi-step surface, or move the second step inline. Stacked modals break focus trapping, escape order and layering.
+# review-only: a regex over markup cannot see dynamically rendered children or
+# a modal opened from a handler; the finding is a candidate for a person.
+status: review-only
+handWritten: [mechanical, fix, status]