taste-lint 0.3.0 → 0.5.0

package/README.md

@@ -43,11 +43,13 @@ Checks bill your key and cache between runs. `--dry-run` previews the cost first
 - **Motion:** `transition-all` and `transition: all`, ease-in, linear easing, transitions over 300ms, entrances from scale zero, `framer-motion` imports.
 - **Copy:** the [ghostwriter](https://github.com/mblode/agent-skills/tree/main/skills/ghostwriter) structure tells (participle tails, “it’s not X, it’s Y”, “Here’s the thing”), “click here” links, “successfully” toasts, emoji in UI, nominalisations, anthropomorphism, long sentences that chain clauses.
 - **Typography:** straight quotes, three-dot ellipses, hyphens for dashes, `x` for ×, missing space before a unit, light weights on small body text, uppercase without tracking.
+- **Code** (`--profile code`): N+1 queries, unbounded reads, blocking sync calls in handlers, tests that assert nothing or only that a mock was called, logic your coverage report shows no test runs, commented-out code, unused dependencies, dropped errors, secrets and personal data in logs, CI runs that never cancel.
+- **Search:** pages with no metadata, a missing `metadataBase`, sitemap or robots, noindex on public pages, canonical URLs on a dev host.
 - **Under review:** vague errors, empty states with no action, bare “Confirm” labels, claims with nothing to check, missing error states. These go to [Jev by TypeSafe AI](https://docs.typesafe.ai/introduction), which answers with a probability.
 
-28 checks block. 125 more report and never fail a run. They are pattern ports nobody has yet watched on a real codebase, and Jev questions no labelled corpus has yet promoted. See [usage](https://blode.co/taste-lint/docs/usage) for how promotion works.
+28 checks block. 177 more report and never fail a run. They are pattern ports nobody has yet watched on a real codebase, and Jev questions no labelled corpus has yet promoted. See [usage](https://blode.co/taste-lint/docs/usage) for how promotion works.
 
-Profiles scope a run: `product` (tsx, jsx, css), `writing` (md, mdx, README), `instructions` (AGENTS.md, skills, plans), `all`.
+Profiles scope a run: `product` (tsx, jsx, css), `writing` (md, mdx, README), `instructions` (AGENTS.md, skills, plans), `code` (source, tests, CI), `all`.
 
 Add your own voice with a rule pack: `"rules": ["$GHOSTWRITER_HOME/taste-lint"]` in `taste-lint.config.json` checks drafts against your [ghostwriter](https://github.com/mblode/agent-skills/tree/main/skills/ghostwriter) profile.
 

package/data/corpus/copywriting.jsonl

@@ -133,7 +133,7 @@
 {"categoryId":"actionable-cta","id":"tt-x-qc-locate-default-button","kind":"jsx-text","labelSource":"manifest-weak","labels":{"copywriting-cta-names-outcome":true,"copywriting-friction-cta":true},"source":{"id":"qc-locate-default","path":"apps/web/content/exercises/train-your-eye.tsx","repo":"mblode/taste-training","option":"button"},"split":"dev","text":"Submit","context":{"docType":"ui","role":"body"}}
 {"categoryId":"typographic-detail","id":"tt-x-tye-repair-quotes-before","kind":"jsx-text","labelSource":"manifest-weak","labels":{"typography-straight-quotes":true,"typography-dashes":true,"typography-ellipsis":true,"typography-nbsp-value-unit":true},"source":{"id":"tye-repair-quotes","path":"apps/web/content/exercises/train-your-eye.tsx","repo":"mblode/taste-training","option":"before"},"split":"dev","text":"\"Sync everything.\"","context":{"docType":"ui","role":"body"}}
 {"categoryId":"typographic-detail","id":"tt-x-tye-repair-quotes-fixed","kind":"jsx-text","labelSource":"manifest-weak","labels":{"typography-straight-quotes":false,"typography-dashes":false,"typography-ellipsis":false,"typography-nbsp-value-unit":false},"source":{"id":"tye-repair-quotes","path":"apps/web/content/exercises/train-your-eye.tsx","repo":"mblode/taste-training","option":"curly"},"split":"dev","text":"“Sync everything.”","context":{"docType":"ui","role":"body"}}
-{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-1","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":true,"copywriting-machine-prose":true},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"We believe that teams of all sizes deserve powerful, easy to use analytics. Our mission is to help you be more productive and save time and money."}
-{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-2","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":true,"copywriting-machine-prose":true},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"This is a comprehensive platform that provides seamless integration with all the tools you need. It is a robust solution designed to be flexible and intuitive."}
-{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-3","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":true,"copywriting-machine-prose":true},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"Whether you're a startup founder or an enterprise leader, our cutting-edge product helps you grow your business and take it to the next level. In order to get started, sign up and create an account."}
-{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-4","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":true,"copywriting-machine-prose":true},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"Furthermore, our innovative approach utilizes next-generation technology to deliver best-in-class results. Contact us to request a demo and see everything you need, and much more."}
+{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-1","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":false},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"We believe that teams of all sizes deserve powerful, easy to use analytics. Our mission is to help you be more productive and save time and money."}
+{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-2","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":false},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"This is a comprehensive platform that provides seamless integration with all the tools you need. It is a robust solution designed to be flexible and intuitive."}
+{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-3","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":true,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":false,"copywriting-machine-prose":true},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"Whether you're a startup founder or an enterprise leader, our cutting-edge product helps you grow your business and take it to the next level. In order to get started, sign up and create an account."}
+{"categoryId":"evidence-over-claims","context":{"docType":"marketing","role":"body"},"id":"tt-sweep-sample-4","kind":"paragraph","labelSource":"sweep","labels":{"copywriting-dead-weight-hedges":false,"copywriting-generic-audience":true,"copywriting-claim-without-evidence":true,"copywriting-register-shift":true},"source":{"id":"SAMPLE_COPY","path":"apps/web/components/demos/copywriting/sweep-runner.tsx","repo":"mblode/taste-training"},"split":"dev","text":"Furthermore, our innovative approach utilizes next-generation technology to deliver best-in-class results. Contact us to request a demo and see everything you need, and much more."}

package/data/rule-drafts/interaction/interaction-layout-shift.yaml

@@ -31,11 +31,11 @@ question:
         - TODO
       what: >-
         - Skip files with `// ui-audit-ignore:states-layout-shift`.
-        
+
         - Below-the-fold `content-visibility: auto` may CLS-shift inside its own subtree (acceptable).
-        
+
         - Skip components declaring `min-height` via CSS class (Tailwind `min-h-*`); inspect class strings first.
-        
+
         - Skip Storybook fixtures.
     "true":
       examples:

package/data/rules/copywriting/copywriting-antithesis-contrast.yaml

@@ -0,0 +1,43 @@
+# The short denial forms models write ("A folder, not a portal", "Not another
+# place to work."). A regex cannot tell them from a plain instruction ("Use
+# their numbers, not benchmarks") or a clarification ("Unknown: ... Not a
+# pass."), so the regex only finds candidates and Jev decides.
+id: copywriting-antithesis-contrast
+title: Denies a thing nobody claimed to sharpen a point
+categoryId: machine-prose
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ghostwriter/references/tells.md,
+    line: 12,
+  }
+unit: [paragraph, heading, jsx-text]
+mechanical:
+  regex: "[\\p{L}\\p{N}’'], not (?:a |an |the |another |just |only )?[\\p{L}\\p{N}’'-]+|(?:^|[.!?]\\s+)Not (?:a|an|another|the|just|only|one) [\\p{L}\\p{N}’'-]+"
+  flags: gu
+question:
+  context: [docType, element]
+  instructions: >-
+    Does TEXT deny something that nobody in the text claimed, only to make its own point sound sharper? Return false when the contrast is an instruction choosing between two real options the reader has, when it corrects a misreading the reader is likely to make, or when it states a real trade-off or limit.
+  criteria:
+    true:
+      what: A denial of a straw alternative, used as rhetoric.
+      examples:
+        - "A folder, not a portal."
+        - "A shared folder. Not another place to work."
+        - "Conflicts are kept, not resolved for you."
+        - "Side by side, not overwritten."
+    false:
+      what: A contrast the reader can act on or would otherwise get wrong.
+      examples:
+        - "Use their numbers, not generic benchmarks."
+        - "Unknown: a check that could not decide. Not a pass."
+        - "Put links in the comments, not the post body."
+        - "Billed per seat, not per device."
+thresholds: { review: 0.4, act: 0.75 }
+severity: minor
+fix:
+  hint: Say the positive thing. "A folder, not a portal" becomes "A folder on every laptop."
+preconditions: { notInCode: true }
+status: review-only
+handWritten: [mechanical, question, fix, preconditions, status]

package/data/rules/copywriting/copywriting-antithesis-frame.yaml

@@ -1,3 +1,5 @@
+# The short denial forms ("A folder, not a portal") need a judge, so they live
+# in copywriting-antithesis-contrast; this rule stays exact enough to be active.
 # Hand-cut from mblode/agent-skills skills/ghostwriter/references/tells.md (structure tells).
 id: copywriting-antithesis-frame
 title: Sets up a claim by denying one nobody made
@@ -8,9 +10,9 @@ source:
     path: skills/ghostwriter/references/tells.md,
     line: 12,
   }
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
-  regex: "(?<![\"“‘'])\\bnot (?:just|only|merely) (?:a |an |the |about )?[\\w-]+(?: [\\w-]+){0,4}[,;]? but\\b|(?<![\"“‘'])\\b(?:it|this|that)(?:['’]s| is)(?: not|n['’]t) (?:just |only )?(?:about )?[^.!?,;]{1,40}[.,;] (?:it|this|that)(?:['’]s| is)\\b"
+  regex: "(?<![\"“‘'])\\bnot (?:just|only|merely) (?:a |an |the |about )?[\\w-]+(?: [\\w-]+){0,4}(?:[,;]? but|[,;] (?:it|they|we|this)(?:['’](?:s|re)| is| are))\\b|(?<![\"“‘'])\\b(?:it|this|that)(?:['’]s| is)(?: not|n['’]t) (?:just |only )?(?:about )?[^.!?,;]{1,40}[.,;] (?:it|this|that)(?:['’]s| is)\\b"
   flags: giu
 severity: minor
 fix:

package/data/rules/copywriting/copywriting-artificial-balance.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: artificial_balance
-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-boilerplate-offer.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: boilerplate_offer
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   flags: gui
   regex: "let me know|feel free to|happy to help|hope this helps|if you have any (?:other |further )?questions|reach out if"

package/data/rules/copywriting/copywriting-canned-phrasing.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: canned_phrasing
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   phrases:
     - in today's fast-paced world

package/data/rules/copywriting/copywriting-claim-without-evidence.yaml

@@ -30,10 +30,17 @@ mechanical:
     - next-generation
     - enterprise-grade
     - blazing
+    - faster
+    - fastest
+    - simpler
+    - easier
+    - smarter
+    - trusted by
+    - loved by
 question:
   context: [headingAbove, docType]
   instructions: >-
-    Read the TEXT. Return true when the TEXT describes a product, feature, service or company with an evaluative adjective or adverb (for example powerful, seamless, fast, intuitive, robust, best-in-class, simple) and the same TEXT gives the reader nothing they could check: no number with a unit or scope, no named mechanism that explains how, no named standard, customer or third party. Return false when the TEXT contains such a checkable fact, when the adjective names a category a reader can verify (open source, end-to-end encrypted, GDPR compliant), or when the TEXT is not describing a product at all (instructions, narrative, a lesson explaining the rule). Ignore code, URLs and the HEADING line; judge only the TEXT.
+    Read the TEXT. Return true when the TEXT describes a product, feature, service or company with an evaluative adjective or adverb (for example powerful, seamless, fast, intuitive, robust, best-in-class, simple) and the same TEXT gives the reader nothing they could check: no measurement with its conditions, no named mechanism that explains how, no named standard, customer or third party. A rounded boast is a claim, not evidence: a user count ("10,000+ teams"), an "up to" multiplier, or "trusted by" with no names. Return false when the TEXT contains such a checkable fact, when the adjective names a category a reader can verify (open source, end-to-end encrypted, GDPR compliant), or when the TEXT is not describing a product at all (instructions, narrative, a lesson explaining the rule). Ignore code, URLs and the HEADING line; judge only the TEXT.
   criteria:
     true:
       what: A quality is asserted about a product and nothing in the text lets the reader check it.
@@ -42,6 +49,8 @@ question:
         - "Enterprise-grade security, built for teams that take compliance seriously."
         - "Our blazing-fast platform simply supports parallel execution."
         - "Seamless sync across all your devices."
+        - "Loved by 50,000+ designers worldwide."
+        - "Up to 5x faster builds."
     false:
       what: The text names what happens, how much, or by which standard, or is not selling anything.
       examples:

package/data/rules/copywriting/copywriting-copula-avoidance.yaml

@@ -8,7 +8,7 @@ source:
     path: skills/ghostwriter/references/tells.md,
     line: 13,
   }
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   regex: "(?<![\"“‘'])\\b(?:serves|stands) as (?:a|an|the)\\b|(?<![\"“‘'])\\bboasts\\b"
   flags: giu

package/data/rules/copywriting/copywriting-dead-link.yaml

@@ -0,0 +1,28 @@
+# Four of five models wrote href="#" on nav and CTA links (2026-09-23 generation
+# test). Demo and registry files use it on purpose, so they are excluded.
+id: copywriting-dead-link
+title: Link with nowhere to go
+categoryId: page-structure
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/nav-semantic-links.md
+  line: 10
+  ruleId: nav-semantic-links
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+  exclude: ["**/examples/**", "**/registry/**", "**/*demo*"]
+unit: [source]
+mechanical:
+  regex: href=["']#["']
+  flags: gu
+severity: major
+fix:
+  hint: Point the link at the route its label names. If there is none yet, it is not a link; cut it or make it a button that does the thing.
+status: review-only
+review:
+  applicability: "A link or CTA whose href is a bare #."
+  exceptions: "Placeholder links in a demo, story or registry example."
+  evidence: "The link label and where the product actually sends that action."
+  verification: "Confirm the label names a real destination, then point the link there or remove it."
+  sourceHash: 156607414ec8464ecc9e40d0441c9242ec94547f5de51ed83d04d6333c305470
+handWritten: [mechanical]

package/data/rules/copywriting/copywriting-em-dash-in-ui.yaml

@@ -0,0 +1,23 @@
+# Fable and Grok put em dashes in interface copy when every other tell was gone
+# (2026-09-23 generation test). Unspaced em dashes are accepted (Matthew,
+# 2026-09-24), matching typography-audit; a full or no-break space either side
+# is the tell. Hair and thin spaces are allowed (spacing-hair-thin-spaces).
+id: copywriting-em-dash-in-ui
+title: Spaced em dash in interface copy
+categoryId: machine-prose
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/typography-audit/rules/punct-dashes.md,
+    line: 7,
+  }
+unit: [jsx-text, attr-string]
+mechanical:
+  regex: "[ \\u00a0]\\u2014|\\u2014[ \\u00a0]"
+  flags: gu
+severity: minor
+fix:
+  hint: Close up the em dash ("fast\u2014and safe"), or use a comma, full stop or parentheses.
+preconditions: { notInCode: true, docType: [ui, unknown] }
+status: review-only
+handWritten: [mechanical, fix, preconditions, status]

package/data/rules/copywriting/copywriting-excessive-hedging.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: excessive_hedging
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   phrases:
     - might

package/data/rules/copywriting/copywriting-external-arrow-internal-link.yaml

@@ -0,0 +1,26 @@
+# Hand-ported: the upstream rg pattern, narrowed to JSX.
+id: copywriting-external-arrow-internal-link
+title: External-link arrow on a link that stays on the site
+categoryId: page-structure
+source:
+  repo: mblode/agent-skills
+  path: skills/ui-design/rules/slop-external-arrow-internal-link.md
+  line: 10
+  ruleId: slop-external-arrow-internal-link
+scope:
+  include: ["**/*.tsx", "**/*.jsx"]
+unit: [source]
+mechanical:
+  regex: '<(?:(?:a|Link)\b(?![^>]*target="_blank")(?:=>|[^>])*\bhref="(?:#|/(?!/))[^"]*"|button\b)(?:=>|[^>])*>(?:(?!</(?:a|Link|button)>)[\s\S]){0,300}?(?:↗|&#8599;|&nearr;|ArrowUpRight|ExternalLink)'
+  flags: gu
+severity: minor
+fix:
+  hint: Remove the arrow. It promises a new site or tab; keep it for links that leave.
+status: review-only
+review:
+  applicability: "An up-right arrow sits on a link to a route or anchor on the same site."
+  exceptions: "A link that opens a new tab or another site, where the arrow is true."
+  evidence: "The href and target of the link carrying the arrow."
+  verification: "Confirm the link stays on the site, then remove the arrow."
+  sourceHash: 526719aa2eb755c1615c9100e8c9e433ddfd2965270148b94f1a66841f5f47d4
+handWritten: [mechanical]

package/data/rules/copywriting/copywriting-fabricated-specificity.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: fabricated_specificity
-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]
+  context: [docType, brief]
   instructions: >-
-    Does the writing include suspiciously specific details without grounding or attribution? Ignore a number, name or date the passage attributes to a source, a test, or the writer\u0027s own measurement.
+    Does the writing include suspiciously specific details without grounding or attribution? Ignore a number, name or date the passage attributes to a source, a test, or the writer’s own measurement. When BRIEF is given, it is the product’s own source of truth: a detail BRIEF states is grounded, and a specific that BRIEF does not state is ungrounded however plainly it is written.
   criteria:
     true:
       what: Precise-sounding detail with no source in sight.

package/data/rules/copywriting/copywriting-generic-framing.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 1 (generic frames and openers).
 id: copywriting-generic-framing
 title: Relies on generic framing instead of concrete context
@@ -10,22 +11,27 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: generic_framing
-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 rely on generic framing instead of concrete context? Ignore a first sentence that names a specific product, person, number, place or date.
+    Does the writing open or connect with a generic frame, a sentence that sets up the topic with claims that would fit any topic, instead of concrete context? Only a sentence that frames can be generic framing. Answer no for text that frames nothing: labels, names, headings, identifiers, URLs, placeholders, instructions to the reader, and plain statements of fact or opinion. Short or unspecific is not the same as generic. Ignore a first sentence that names a specific product, person, number, place or date.
   criteria:
     true:
-      what: A frame that would fit any topic.
+      what: A setup sentence whose frame would fit any topic.
       examples:
         - "In today's fast-paced world, teams need tools that help them move quickly and stay aligned."
         - "When it comes to onboarding, first impressions matter more than ever."
     false:
-      what: A frame anchored in the specific situation.
+      what: A frame anchored in the specific situation, or text that does no framing at all.
       examples:
         - "Our onboarding email had a 9 percent click rate in August; the one paragraph we changed took it to 21."
         - "Three of the five new hires this quarter could not find the deploy runbook in their first week."
+        - "Run commands from the repository root:"
+        - "Pricing"
 thresholds: { review: 0.4, act: 0.75 }
 severity: minor
 fix:

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

@@ -10,22 +10,30 @@ source:
   path: https://typesafe-parallel-judgment-lab.every-4573.chatgpt.site/downloads/typesafe-lab-source.zip (scripts/run-ai-checker.mjs)
   line: 1
   ruleId: generic_language
-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 rely on generic or interchangeable language? Ignore a passage where the nouns and verbs name specific things, even if a few common words appear.
+    Could TEXT sit unchanged on a competitor's page and stay just as true? Return true when it could because its words are abstract (platform, solution, experience, empower, seamless, value, teamwork, flow) instead of naming what this product does. Return false when TEXT names a specific object, action, number, limit or place, however short, and for instructions, validation messages, greetings, sign-offs, labels, and titles or headings that say what a page or section contains. A slogan headline is judged like any sentence.
   criteria:
     true:
       what: Words that could describe any product or team.
       examples:
         - "Our robust, seamless platform empowers teams to unlock powerful insights and drive meaningful outcomes."
         - "This comprehensive approach leverages best practices to deliver value at scale."
+        - "Collaboration, Elevated for the Modern Team"
+        - "Less busywork. More momentum."
     false:
-      what: Words that name the thing.
+      what: Words that name the thing, however plainly.
       examples:
         - "The sync engine merges edits made offline without overwriting anyone else, so field staff can work in basements and tunnels."
-        - "The audit found 14 buttons labelled Submit; renaming them to the action cut support tickets about forms by a quarter."
+        - "Free for up to 3 projects. No card needed."
+        - "Use 60 characters or fewer."
+        - "Where your files live, and what happens when you go offline."
+        - "How Northwind merges two offline edits"
 thresholds: { review: 0.4, act: 0.75 }
 severity: minor
 fix:

package/data/rules/copywriting/copywriting-generic-validation.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: generic_validation
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   phrases:
     - great question

package/data/rules/copywriting/copywriting-machine-prose.yaml

@@ -42,11 +42,14 @@ mechanical:
       tapestry,
       testament to,
       it's important to remember,
+      here is some,
+      here's some,
+      here are some,
     ]
 question:
   context: []
   instructions: >-
-    Read the TEXT. Return true when it reads as generated boilerplate: a chatbot opener ("I'd be happy to", "Let's dive in"), a vague attribution ("experts believe", "studies show") with no source, a stock flourish ("game-changer", "unlock the power of", "in today's fast-paced world", "a testament to"), or a symmetrical both-sides summary that adds no information. Return false when the TEXT makes a specific claim with a named source, gives an instruction, tells a concrete story, or quotes these phrases in order to warn against them.
+    Read the TEXT. Return true when it reads as generated boilerplate: a chatbot opener or preamble ("I'd be happy to", "Let's dive in", "Here is some copy for"), a vague attribution ("experts believe", "studies show") with no source, a stock flourish ("game-changer", "unlock the power of", "in today's fast-paced world", "a testament to"), a sentence that announces its own importance instead of making the point ("here is where it gets interesting", "the implications are significant"), a false contrast that denies a claim nobody made ("not just a tool, it is a way of working"), or a symmetrical both-sides summary that adds no information. Return false when the TEXT makes a specific claim with a named source, gives an instruction, tells a concrete story, or quotes these phrases in order to warn against them.
   criteria:
     true:
       what: Generated boilerplate.

package/data/rules/copywriting/copywriting-mechanism-over-outcome.yaml

@@ -8,7 +8,10 @@ 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: >-

package/data/rules/copywriting/copywriting-meta-commentary.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: meta_commentary
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   phrases:
     - in this section

package/data/rules/copywriting/copywriting-missing-reasoning-link.yaml

@@ -8,7 +8,10 @@ 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: >-

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

@@ -8,7 +8,7 @@ source:
     path: skills/ghostwriter/references/tells.md,
     line: 16,
   }
-unit: [paragraph]
+unit: [paragraph, jsx-text]
 mechanical:
   regex: "(?<![\"“‘']),\\s+(?:ensuring|highlighting|underscoring|showcasing|emphasi[sz]ing|reinforcing|cementing|solidifying|fostering|signall?ing)\\b"
   flags: giu

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

@@ -1,3 +1,5 @@
+# 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
@@ -8,9 +10,9 @@ source:
     path: skills/ghostwriter/references/tells.md,
     line: 15,
   }
-unit: [paragraph]
+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"
+  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: