taste-lint 0.2.0 → 0.4.0

package/data/rules/copywriting/copywriting-over-explanation.yaml

@@ -9,7 +9,10 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: over_explanation
-unit: [paragraph]
+# Prose wherever it is: a Markdown paragraph or a JSX sentence. Under five
+# words is a label, button or greeting, not prose.
+unit: [paragraph, jsx-text]
+preconditions: { minWords: 5, notInCode: true }
 question:
   context: [docType]
   instructions: >-

package/data/rules/copywriting/copywriting-participle-tail.yaml

@@ -0,0 +1,21 @@
+# Hand-cut from mblode/agent-skills skills/ghostwriter/references/tells.md (structure tells).
+id: copywriting-participle-tail
+title: Sentence ends in a participle tail
+categoryId: machine-prose
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ghostwriter/references/tells.md,
+    line: 16,
+  }
+unit: [paragraph, jsx-text]
+mechanical:
+  regex: "(?<![\"“‘']),\\s+(?:ensuring|highlighting|underscoring|showcasing|emphasi[sz]ing|reinforcing|cementing|solidifying|fostering|signall?ing)\\b"
+  flags: giu
+severity: minor
+fix:
+  hint: >-
+    Keep the fact and cut at the comma. "Tests run on every push, ensuring quality" becomes "Tests run on every push."
+preconditions: { notInCode: true }
+status: active
+handWritten: [mechanical, fix, preconditions]

package/data/rules/copywriting/copywriting-passive-voice.yaml

@@ -1,12 +1,13 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/voice-defaults.md (active voice, present tense).
+# Ported from mblode/agent-skills skills/docs-writing/rules/voice-defaults.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired. (active voice, present tense).
 id: copywriting-passive-voice
 title: Passive voice where the actor is known
 categoryId: machine-prose
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/voice-defaults.md,
-    line: 11,
+    path: skills/ghostwriter/references/docs.md,
+    line: 13,
   }
 unit: [paragraph, heading]
 mechanical:

package/data/rules/copywriting/copywriting-promotional-docs-voice.yaml

@@ -1,12 +1,13 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/voice-defaults.md (professional, not promotional).
+# Ported from mblode/agent-skills skills/docs-writing/rules/voice-defaults.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired. (professional, not promotional).
 id: copywriting-promotional-docs-voice
 title: Marketing voice inside documentation
 categoryId: evidence-over-claims
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/voice-defaults.md,
-    line: 14,
+    path: skills/ghostwriter/references/docs.md,
+    line: 13,
   }
 unit: [paragraph, heading]
 mechanical:

package/data/rules/copywriting/copywriting-prompt-restatement.yaml

@@ -10,11 +10,14 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: prompt_restatement
-unit: [paragraph]
+# Prose wherever it is: a Markdown paragraph or a JSX sentence. Under five
+# words is a label, button or greeting, not prose.
+unit: [paragraph, jsx-text]
+preconditions: { minWords: 5, notInCode: true }
 question:
   context: [docType]
   instructions: >-
-    Does the writing read like it is restating an implied prompt or assignment? Ignore a heading or a stated question the passage then answers.
+    Does the writing read like it is restating an implied prompt or assignment? Ignore a heading or a stated question the passage then answers. Return false for a greeting, a sign-off, a button or link label, a bare list label, or a heading on its own: they are not prose.
   criteria:
     true:
       what: The passage announces the task it was given instead of doing it.

package/data/rules/copywriting/copywriting-punctuation-tics.yaml

@@ -10,7 +10,10 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: punctuation_tics
-unit: [paragraph]
+# Prose wherever it is: a Markdown paragraph or a JSX sentence. Under five
+# words is a label, button or greeting, not prose.
+unit: [paragraph, jsx-text]
+preconditions: { minWords: 5, notInCode: true }
 question:
   context: [docType]
   instructions: >-

package/data/rules/copywriting/copywriting-reader-first.yaml

@@ -27,17 +27,20 @@ mechanical:
       we made,
       the tool,
       a tool,
+      now with,
+      now available,
     ]
 question:
   context: [docType, headingAbove]
   instructions: >-
-    The TEXT is a headline or hero line on a page selling or introducing a product. Return true when it opens by naming what the product is (a platform, a tool, a solution, "Introducing X") before saying why that matters to the reader. Return false when it leads with the reader's problem or outcome, when the DOC TYPE is documentation, reference or a lesson where naming the thing first is correct, or when it is not a headline.
+    The TEXT is a headline or hero line on a page selling or introducing a product. Return true when it opens by naming what the product is (a platform, a tool, a solution, "Introducing X") or what it now has ("Now with X") before saying why that matters to the reader. Return false when it leads with the reader's problem or outcome, when the DOC TYPE is documentation, reference or a lesson where naming the thing first is correct, or when it is not a headline.
   criteria:
     true:
       what: What-first headline.
       examples:
         - "Introducing Northwind, the all-in-one platform for modern teams"
         - "A collaboration tool for growing companies"
+        - "Now with dark mode"
     false:
       what: Why-first, or a context where What belongs first.
       examples:

package/data/rules/copywriting/copywriting-repetitive-transitions.yaml

@@ -10,7 +10,7 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: repetitive_transitions
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   phrases:
     - moreover

package/data/rules/copywriting/copywriting-requirements-language.yaml

@@ -3,8 +3,8 @@ title: A requirement presented as a recommendation
 categoryId: reader-first-framing
 source:
   repo: mblode/agent-skills
-  path: skills/docs-writing/rules/voice-requirements-language.md
-  line: 7
+  path: skills/ghostwriter/references/docs.md
+  line: 13
   ruleId: voice-requirements-language
 unit:
   - paragraph

package/data/rules/copywriting/copywriting-searchable-headings.yaml

@@ -3,8 +3,8 @@ title: A documentation heading names no topic or action
 categoryId: page-structure
 source:
   repo: mblode/agent-skills
-  path: skills/docs-writing/rules/nav-searchable-headings.md
-  line: 7
+  path: skills/ghostwriter/references/docs.md
+  line: 21
   ruleId: nav-searchable-headings
 unit:
   - heading

package/data/rules/copywriting/copywriting-semantic-links.yaml

@@ -4,7 +4,7 @@ id: copywriting-semantic-links
 title: Use Semantic Links for Navigation
 categoryId: page-structure
 source:
-  line: 9
+  line: 10
   path: skills/ui-design/rules/nav-semantic-links.md
   repo: mblode/agent-skills
   ruleId: nav-semantic-links
@@ -26,4 +26,4 @@ review:
   exceptions: A redundant card shortcut around an accessible real link can be intentional.
   evidence: The actual destination, nested links, handler behavior, and keyboard or browser navigation options.
   verification: Verify keyboard navigation, open-in-new-tab, and copy-link behavior while preserving legitimate larger click targets.
-  sourceHash: 09e2de7a3e263b2dd145eb661ac460d9e49e3b360841bb3e8484f5f62d602347
+  sourceHash: 156607414ec8464ecc9e40d0441c9242ec94547f5de51ed83d04d6333c305470

package/data/rules/copywriting/copywriting-slogan-headings.yaml

@@ -0,0 +1,27 @@
+# Hand-ported: the upstream rg pattern, narrowed to heading text. The
+# "X, not Y" heading is copywriting-antithesis-contrast.
+id: copywriting-slogan-headings
+title: Headings built from stacked slogan fragments
+categoryId: machine-prose
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/slop-slogan-headings.md
+  line: 10
+  ruleId: slop-slogan-headings
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  regex: '<h[1-3]\b[^>]*>(?:\s|<br\s*/>|<span[^>]*>|</span>)*[A-Z$\d][\w’''$,-]*(?:[ \t]+[\w’''$,-]+){0,3}[.!?](?:\s|<br\s*/>|<span[^>]*>|</span>)+[A-Z$\d][\w’''$,-]*(?:[ \t]+[\w’''$,-]+){0,3}[.!?]'
+  flags: gu
+severity: minor
+fix:
+  hint: Say the one thing the product does in a plain sentence a reader could check, instead of two or three clipped fragments.
+status: review-only
+review:
+  applicability: "A heading made of two or more clipped sentences of four words or fewer."
+  exceptions: "A real name or a quoted title, and a pair of short sentences that each state a checkable fact."
+  evidence: "Whether each fragment says something a reader could verify about the product."
+  verification: "Confirm the fragments carry no checkable claim, then rewrite as one plain sentence."
+  sourceHash: 253bbb9dd01304ad87bb0b924a6dd434780c829cec8a0fe91a4b149446fed284
+handWritten: [mechanical]

package/data/rules/copywriting/copywriting-structural-symmetry.yaml

@@ -10,7 +10,10 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: structural_symmetry
-unit: [paragraph]
+# Prose wherever it is: a Markdown paragraph or a JSX sentence. Under five
+# words is a label, button or greeting, not prose.
+unit: [paragraph, jsx-text]
+preconditions: { minWords: 5, notInCode: true }
 question:
   context: [docType]
   instructions: >-

package/data/rules/copywriting/copywriting-tee-up.yaml

@@ -0,0 +1,23 @@
+# Widened 2026-09-23 with the tee-ups Opus, Fable and Grok wrote in the
+# generation test.
+# Hand-cut from mblode/agent-skills skills/ghostwriter/references/tells.md (structure tells).
+id: copywriting-tee-up
+title: Tees up a point instead of stating it
+categoryId: machine-prose
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ghostwriter/references/tells.md,
+    line: 15,
+  }
+unit: [paragraph, jsx-text]
+mechanical:
+  regex: "(?<![\"“‘'])\\bhere['’]s the (?:thing|kicker|catch|deal|twist)\\b|(?<![\"“‘'])\\bthe (?:kicker|catch|twist)\\?|(?<![\"“‘'])\\bwhat struck me (?:was|is)\\b|(?<![\"“‘'])\\blet that sink in\\b|(?<![\"“‘'])\\bhere['’]s (?:a quick way to|the short version)\\b|(?<![\"“‘'])\\bthe part worth knowing\\b|(?<![\"“‘'])\\bthat['’]s the whole (?:pitch|idea|point|story)\\b"
+  flags: giu
+severity: minor
+fix:
+  hint: >-
+    Delete the tee-up and state the thing.
+preconditions: { notInCode: true }
+status: active
+handWritten: [mechanical, fix, preconditions]

package/data/rules/copywriting/copywriting-temporal-words.yaml

@@ -1,4 +1,5 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/hygiene-no-temporal.md and
+# Ported from mblode/agent-skills skills/docs-writing/rules/hygiene-no-temporal.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired. and
 # rules/hygiene-update-metadata.md.
 id: copywriting-temporal-words
 title: Wording anchored to the time of writing
@@ -6,8 +7,8 @@ categoryId: reference-reading
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/hygiene-no-temporal.md,
-    line: 7,
+    path: skills/ghostwriter/references/docs.md,
+    line: 23,
   }
 unit: [paragraph, heading]
 mechanical:

package/data/rules/copywriting/copywriting-unexplained-action.yaml

@@ -8,11 +8,14 @@ source:
   repo: every.to
   path: https://every.to/also-true-for-humans/mini-vibe-check-typesafe-s-jev-judged-everything-i-ve-written-in-0-7-seconds
   line: 1
-unit: [paragraph]
+# Prose wherever it is: a Markdown paragraph or a JSX sentence. Under five
+# words is a label, button or greeting, not prose.
+unit: [paragraph, jsx-text]
+preconditions: { minWords: 5, notInCode: true }
 question:
   context: [docType]
   instructions: >-
-    Read the TEXT. Return true when it asks the reader to do, or describes someone doing, an action whose concrete steps cannot be pictured from the words (teach a calendar, activate the culture, leverage the learnings). Return false when the action names a thing a person could start doing now, or when the TEXT is a heading or label that a following paragraph will explain.
+    Read the TEXT. Return true when it asks the reader to do, or describes someone doing, an action whose concrete steps cannot be pictured from the words (teach a calendar, activate the culture, leverage the learnings). Return false when the action names a thing a person could start doing now, or when the TEXT is a heading or label that a following paragraph will explain, a button label, or a numbered step in a procedure.
   criteria:
     true:
       what: An action with no picturable steps.

package/data/rules/copywriting/copywriting-unnatural-polish.yaml

@@ -1,6 +1,7 @@
 # One of the 21 AI-writing checks Every ran with Jev (Mike Taylor, "Jev judged
-# everything I've written in 0.7 seconds", 15 Sep 2026). The question is the
-# published wording; the second sentence says what to ignore.
+# everything I've written in 0.7 seconds", 15 Sep 2026). The question started as
+# the published wording; it now also says what cannot be a violation, because
+# Jev read plain labels, identifiers and instructions as violations (2026-09-23 eval).
 # Candidate list from EveryInc/compound-writing skills/cw-ai-check/SKILL.md, category 0 (structural overcompletion, performed voice).
 id: copywriting-unnatural-polish
 title: Polished in a way that suppresses personal texture
@@ -27,18 +28,20 @@ preconditions:
 question:
   context: [docType]
   instructions: >-
-    Does the writing feel polished in a way that suppresses personal texture or irregularity? Ignore reference documentation and UI copy, where a neutral register is the point.
+    Is the writing polished in a way that suppresses personal texture: smooth, abstract praise or summary where a specific fact, opinion or rough edge should be? Neutral, plain writing is not polish. Answer no for instructions, technical explanation, data, labels, names, identifiers and headings, and for any sentence that states a concrete fact, number or opinion, even if no person is visible. Ignore reference documentation and UI copy, where a neutral register is the point.
   criteria:
     true:
-      what: Even, frictionless prose with no person behind it.
+      what: Even, frictionless prose that smooths over what should be specific.
       examples:
         - "The initiative delivered meaningful improvements across several dimensions, and stakeholders responded positively to the enhanced experience."
         - "Each component was carefully considered to ensure a cohesive, thoughtful result that balances form and function."
     false:
-      what: Prose with a specific person, opinion or rough edge in it.
+      what: Prose with a specific fact, person, opinion or rough edge in it, or plain functional text.
       examples:
         - "I hated the old settings page. It had 14 toggles and I could never remember which one hid the sidebar."
         - "The first version was ugly and we shipped it anyway, because the two people who needed it were waiting."
+        - "Run commands from the repository root:"
+        - "Each enabled scout runs once per day and draws from the 24-run daily budget."
 thresholds: { review: 0.4, act: 0.75 }
 severity: minor
 fix:

package/data/rules/copywriting/copywriting-unverifiable-proof.yaml

@@ -26,4 +26,4 @@ review:
   exceptions: Clearly labeled placeholders, teaching examples, chart data, and claims supported by supplied evidence.
   evidence: The exact claim and location, its displayed context, and a checkable source or an accountable owner.
   verification: Verify the claim against its source or remove only the unsupported claim; preserve real evidence and clearly marked examples.
-  sourceHash: 0901fbcaeac7ed1d59328aa3012fb808332c4761ab4cb44c268433eb5a48d7f1
+  sourceHash: fd0234fa235214885b51d0645416a224ec35fa32d3990bba46817f6c13932aba

package/data/rules/copywriting/copywriting-vague-error.yaml

@@ -15,6 +15,8 @@ mechanical:
     - an error has occurred
     - something went wrong
     - please try again
+    - try again
+    - try saving again
     - try again later
     - oops
     - invalid

package/data/rules/craft/craft-atmosphere-gradient.yaml

@@ -0,0 +1,28 @@
+# Hand-cut from mblode/agent-skills skills/ui-design/direction/aesthetic-direction.md (slop signals).
+id: craft-atmosphere-gradient
+title: Purple or cyan gradient used as atmosphere
+categoryId: generic-decoration
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ui-design/direction/aesthetic-direction.md,
+    line: 12,
+  }
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  regex: "\\bbg-(?:gradient-to|linear-to|radial)-?[\\w-]*[^\"'`\\n]*?\\b(?:from|via|to)-(?:purple|violet|fuchsia|indigo|cyan)-\\d{2,3}\\b|\\b(?:from|via)-(?:purple|violet|fuchsia|indigo|cyan)-\\d{2,3}\\b[^\"'`\\n]*?\\bbg-(?:gradient-to|linear-to|radial)"
+  flags: gu
+severity: minor
+fix:
+  hint: >-
+    Give the surface a content or brand role, or remove the gradient. Purple and cyan washes are the most common AI-generated backdrop.
+status: review-only
+review:
+  applicability: A class list pairs a gradient background with purple, violet, fuchsia, indigo or cyan stops.
+  exceptions: Brand colours, data visualisation ramps, and illustrations where the gradient carries meaning.
+  evidence: The brand palette and what the gradient surface contains.
+  verification: Confirm the gradient carries a brand or content role, or replace it with a flat surface from the theme.
+  sourceHash: fd4edd9d4dc8f0ec9c09c49390e37482535f899972c5d7c15c9d8f1344360f82
+handWritten: [mechanical, fix, review, scope]

package/data/rules/craft/craft-decoration-no-role.yaml

@@ -1,3 +1,4 @@
+# The mechanical regex is widened from the source: an empty element hung off the box by a negative offset counts as decorative, and so does a large bordered ring (GPT-6 and Opus output, 2026-09-23).
 id: craft-decoration-no-role
 title: Stacked decorative layers with no role
 categoryId: generic-decoration
@@ -14,7 +15,7 @@ unit:
   - source
 mechanical:
   flags: gus
-  regex: <(?:div|span)\b(?=[^>]*?(?:\babsolute\b|\bfixed\b))(?=[^>]*?(?:pointer-events-none|aria-hidden))(?=[^>]*?(?:gradient|bg-linear|bg-radial|\bblur|backdrop-blur|mix-blend|opacity-))(?![^>]*?(?:size-\[max\(100%|pointer-fine:hidden|bg-clip-text|\bmask-))[^>]*?/>
+  regex: '<(?:div|span)\b(?=[^>]*?(?:\babsolute\b|\bfixed\b))(?=[^>]*?(?:pointer-events-none|aria-hidden|["\s]-(?:inset|top|right|bottom|left)-(?:[2-9]|\d{2})\b))(?=[^>]*?(?:gradient|bg-linear|bg-radial|\bblur|backdrop-blur|mix-blend|opacity-|(?=[^>]*?\brounded-full\b)(?=[^>]*?\bborder\b)(?=[^>]*?\b(?:h|w|size)-(?:[2-9]\d|\d{3})\b)))(?![^>]*?(?:size-\[max\(100%|pointer-fine:hidden|bg-clip-text|\bmask-))[^>]*?/>'
 severity: minor
 fix:
   hint: "A blurred blob, a grid overlay, a noise layer and a radial glow behind the heading: absolutely positioned elements that contain nothing and mean nothing. Cut them until each remaining layer has a job a reader could name."

package/data/rules/craft/craft-decorative-ordinals.yaml

@@ -0,0 +1,26 @@
+# Hand-ported: the upstream rg pattern, narrowed to JSX text.
+id: craft-decorative-ordinals
+title: Ordinal numbers on items that are not a sequence
+categoryId: generic-decoration
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/slop-decorative-ordinals.md
+  line: 10
+  ruleId: slop-decorative-ordinals
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  regex: '\b(?:number|num|step|index|idx|no|label|eyebrow)\s*:\s*["''`]0[1-9]\b|>\s*0[1-9]\s*[./)]?\s*<'
+  flags: gu
+severity: minor
+fix:
+  hint: Drop the numbers unless the order is real (install steps, a setup flow, a fallback chain). Cards a reader could shuffle need no number.
+status: review-only
+review:
+  applicability: "Zero-padded numbers label cards or sections."
+  exceptions: "A real sequence: install steps, a setup flow, a ranked list, a fallback chain."
+  evidence: "Whether the items could be reordered without changing their meaning."
+  verification: "Confirm the order means nothing, then remove the numbers."
+  sourceHash: ae618ad62bb446ec2c7019f60acfe8ca48d1f5adea14ba6286463446cf596be9
+handWritten: [mechanical]

package/data/rules/craft/craft-default-indigo.yaml

@@ -0,0 +1,28 @@
+# Hand-cut from mblode/agent-skills skills/ui-design/guidelines/colors.md.
+id: craft-default-indigo
+title: Indigo accent that looks like a template default
+categoryId: colour-system
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ui-design/guidelines/colors.md,
+    line: 5,
+  }
+scope:
+  include: ["**/*.tsx", "**/*.jsx", "**/*.css"]
+unit: [source]
+mechanical:
+  regex: "\\b(?:bg|text|border|ring|from|via|to|fill|stroke|outline|accent|shadow|decoration)-indigo-\\d{2,3}\\b"
+  flags: gu
+severity: minor
+fix:
+  hint: >-
+    Pick an accent from the brand, or use the theme's primary token. Indigo is the colour every starter template ships with.
+status: review-only
+review:
+  applicability: Components use Tailwind indigo classes as the accent colour.
+  exceptions: A brand that is indigo, or a project whose theme already standardises on indigo.
+  evidence: The brand colour in the theme or design tokens, and how many components use indigo.
+  verification: Confirm indigo is the brand choice, or replace it with the theme's primary token.
+  sourceHash: cdd85836ef30c0827d41e0a07ed549a3b5a3d120b6f1aa39cf259aff87a8d0e8
+handWritten: [mechanical, fix, review, scope]

package/data/rules/craft/craft-faux-product-chrome.yaml

@@ -1,4 +1,5 @@
 # Ported from mblode/agent-skills skills/ui-design/rules/slop-faux-product-chrome.md by scripts/port-rules.ts.
+# The mechanical regex is widened from the source: three adjacent empty dots of any colour (Opus, Astra and Sol drew them in pastel and hex, 2026-09-23).
 # Keys listed in handWritten are preserved on re-run; everything else is regenerated.
 id: craft-faux-product-chrome
 title: Faux product chrome wrapping nothing
@@ -15,11 +16,13 @@ unit:
   - source
 mechanical:
   flags: gu
-  regex: rounded-full[^"`]*\bbg-(red|rose|yellow|amber|green|emerald)-[45]00
+  regex: '(?:<(?:span|div|i)\b(?=[^>]*\brounded-full\b)(?=[^>]*\b(?:size|h)-(?:1|1\.5|2|2\.5|3|3\.5)\b)[^>]*/>\s*){3}'
 severity: minor
 fix:
   hint: "Three coloured dots in a row, a rounded bar with a URL typed into it, a laptop outline around an empty gradient panel: this is a drawing of a product where the product should be. A visitor reads it as a screenshot, leans in to see what the app actually looks like, and finds there is nothing to see. "
 status: review-only
+handWritten:
+  - mechanical
 review:
   applicability: Decorative browser or device chrome presents itself as a product preview.
   exceptions: Real screenshots, video, rendered product content, labeled status dots, and intentionally illustrative examples.

package/data/rules/motion/motion-will-change-misuse.yaml

@@ -0,0 +1,28 @@
+# Hand-cut from mblode/agent-skills skills/ui-animation/references/performance-deep-dive.md.
+id: motion-will-change-misuse
+title: will-change promotes a property the compositor cannot animate
+categoryId: motion-restraint
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ui-animation/references/performance-deep-dive.md,
+    line: 161,
+  }
+scope:
+  include: ["**/*.css", "**/*.scss", "**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  regex: "will-change\\s*:\\s*[\"'`]?(?!\\s*(?:transform|opacity|auto)\\s*[\"'`]?\\s*[;},!])[a-z-]+|\\bwill-change-(?:scroll|contents|\\[(?!transform|opacity)[^\\]]+\\])"
+  flags: giu
+severity: minor
+fix:
+  hint: >-
+    Promote only transform or opacity, and only while the motion runs. Each promoted layer costs compositor memory.
+status: review-only
+review:
+  applicability: A stylesheet or class list sets will-change to a property other than transform or opacity.
+  exceptions: Measured scroll-performance fixes with a comment explaining the choice.
+  evidence: The declaration, the element it applies to, and whether it is toggled around the animation.
+  verification: Restrict will-change to transform or opacity and set it only during the animation.
+  sourceHash: f3f43c733bac58c4e64f13c769f7a360c39c0d446c886f79d929e76ae8b5fdfc
+handWritten: [mechanical, fix, review, scope]

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

@@ -29,4 +29,4 @@ review:
   exceptions: JSX nesting alone does not prove simultaneous visibility; mutually exclusive steps and nonmodal surfaces are exceptions.
   evidence: Both open-state transitions, modal primitive implementations, and focus and Escape behavior.
   verification: Open the second step using the keyboard; confirm one modal owns focus and Escape closes the intended surface.
-  sourceHash: e575cc8c2c06ae38542bd068a9f4d1871714391c543b5caf0dbb8ae1847a2f77
+  sourceHash: 9aab069ba1b93ab405a9741cd6d1e026eb08442ff881587b4f84a612653a2fbb

package/data/rules/product/product-select-for-few-options.yaml

@@ -27,4 +27,4 @@ review:
   exceptions: Dynamically loaded options, dependent choices, or a documented platform constraint can require a select.
   evidence: The complete option source, dynamic branches, and the task requiring comparison.
   verification: Confirm all choices remain available and selection, keyboard input, and form submission work.
-  sourceHash: e575cc8c2c06ae38542bd068a9f4d1871714391c543b5caf0dbb8ae1847a2f77
+  sourceHash: 9aab069ba1b93ab405a9741cd6d1e026eb08442ff881587b4f84a612653a2fbb

package/data/rules/schema/rule.schema.json

@@ -127,7 +127,9 @@
               "writingFacts",
               "writingProfile",
               "writingInstructions",
-              "section"
+              "section",
+              "earlier",
+              "brief"
             ]
           }
         },
@@ -224,6 +226,10 @@
         },
         "smartQuotesAtBuild": {
           "const": false
+        },
+        "minWords": {
+          "type": "integer",
+          "minimum": 1
         }
       }
     },