taste-lint 0.2.0 → 0.3.0

package/README.md

@@ -40,15 +40,17 @@ Checks bill your key and cache between runs. `--dry-run` previews the cost first
 
 ## What it checks
 
-- **Motion:** `transition-all`, ease-in, linear easing, transitions over 300ms, entrances from scale zero.
-- **Copy:** “click here” links, “successfully” toasts, emoji in UI, Latinisms, nominalisations, anthropomorphism, sentences over 25 words.
+- **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.
 - **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.
 
-22 checks block. 122 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. 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.
 
 Profiles scope a run: `product` (tsx, jsx, css), `writing` (md, mdx, README), `instructions` (AGENTS.md, skills, plans), `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.
+
 ## Docs
 
 <p>

package/data/config.schema.json

@@ -14,6 +14,13 @@
     "smartQuotesAtBuild": {
       "type": "boolean"
     },
+    "rules": {
+      "description": "Extra rule directories, laid out like data/rules (domain folders of YAML rules). Paths resolve from the scan root; a leading ~ and $VARS expand, so a voice pack can live in $GHOSTWRITER_HOME.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
     "components": {
       "type": "object",
       "additionalProperties": false,

package/data/rules/copywriting/copywriting-anthropomorphism.yaml

@@ -1,12 +1,13 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/voice-no-anthropomorphism.md.
+# Ported from mblode/agent-skills skills/docs-writing/rules/voice-no-anthropomorphism.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired.
 id: copywriting-anthropomorphism
 title: Software described as thinking, wanting or knowing
 categoryId: machine-prose
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/voice-no-anthropomorphism.md,
-    line: 7,
+    path: skills/ghostwriter/references/docs.md,
+    line: 13,
   }
 unit: [paragraph]
 mechanical:

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

@@ -0,0 +1,21 @@
+# 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
+categoryId: machine-prose
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ghostwriter/references/tells.md,
+    line: 12,
+  }
+unit: [paragraph]
+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"
+  flags: giu
+severity: minor
+fix:
+  hint: >-
+    Say the positive thing. "It's not a tool, it's a workflow" becomes "It's a workflow."
+preconditions: { notInCode: true }
+status: active
+handWritten: [mechanical, fix, preconditions]

package/data/rules/copywriting/copywriting-click-here-links.yaml

@@ -1,4 +1,5 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/format-descriptive-links.md and taste-training
+# Ported from mblode/agent-skills skills/docs-writing/rules/format-descriptive-links.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired. and taste-training
 # full-stack-audit.tsx (click-here).
 id: copywriting-click-here-links
 title: Link text that names nothing
@@ -6,8 +7,8 @@ categoryId: actionable-cta
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/format-descriptive-links.md,
-    line: 7,
+    path: skills/ghostwriter/references/docs.md,
+    line: 21,
   }
 unit: [jsx-text]
 mechanical:

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

@@ -3,8 +3,8 @@ title: An instruction hides its prerequisite after the action
 categoryId: page-structure
 source:
   repo: mblode/agent-skills
-  path: skills/docs-writing/rules/structure-conditions-first.md
-  line: 7
+  path: skills/ghostwriter/references/docs.md
+  line: 15
   ruleId: structure-conditions-first
 unit:
   - paragraph

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

@@ -0,0 +1,21 @@
+# Hand-cut from mblode/agent-skills skills/ghostwriter/references/tells.md (structure tells).
+id: copywriting-copula-avoidance
+title: Dresses up "is" or "has"
+categoryId: machine-prose
+source:
+  {
+    repo: mblode/agent-skills,
+    path: skills/ghostwriter/references/tells.md,
+    line: 13,
+  }
+unit: [paragraph]
+mechanical:
+  regex: "(?<![\"“‘'])\\b(?:serves|stands) as (?:a|an|the)\\b|(?<![\"“‘'])\\bboasts\\b"
+  flags: giu
+severity: minor
+fix:
+  hint: >-
+    Write "is" or "has". "The index serves as a cache" becomes "The index is a cache."
+preconditions: { notInCode: true }
+status: review-only
+handWritten: [mechanical, fix, preconditions]

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

@@ -3,8 +3,8 @@ title: An error explanation provides no recovery guidance
 categoryId: reference-reading
 source:
   repo: mblode/agent-skills
-  path: skills/docs-writing/rules/code-error-descriptions.md
-  line: 7
+  path: skills/ghostwriter/references/docs.md
+  line: 19
   ruleId: code-error-descriptions
 unit:
   - paragraph

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

@@ -1,4 +1,5 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/clarity-defaults.md (cut filler) and the lesson
+# Ported from mblode/agent-skills skills/docs-writing/rules/clarity-defaults.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired. (cut filler) and the lesson
 # edit-one-lens-at-a-time.mdx.
 id: copywriting-filler-words
 title: Intensifiers and filler that add nothing
@@ -6,8 +7,8 @@ categoryId: machine-prose
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/clarity-defaults.md,
-    line: 12,
+    path: skills/ghostwriter/references/docs.md,
+    line: 17,
   }
 unit: [paragraph, jsx-text]
 mechanical:

package/data/rules/copywriting/copywriting-latinisms.yaml

@@ -1,12 +1,14 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/clarity-no-latin.md.
+# Ported from mblode/agent-skills skills/docs-writing/rules/clarity-no-latin.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired. Review-only:
+# ghostwriter keeps "plain words" but no longer bans Latin abbreviations outright.
 id: copywriting-latinisms
 title: Latin abbreviation in running text
 categoryId: reader-first-framing
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/clarity-no-latin.md,
-    line: 7,
+    path: skills/ghostwriter/references/docs.md,
+    line: 17,
   }
 unit: [paragraph, heading]
 mechanical:
@@ -21,5 +23,5 @@ preconditions:
     docType:
       [tutorial, howto, reference, explanation, agent-instructions, lesson],
   }
-status: active
+status: review-only
 handWritten: [mechanical, fix, preconditions]

package/data/rules/copywriting/copywriting-nominalisations.yaml

@@ -1,12 +1,13 @@
-# Ported from mblode/agent-skills skills/docs-writing/rules/clarity-no-nominalizations.md.
+# Ported from mblode/agent-skills skills/docs-writing/rules/clarity-no-nominalizations.md, now
+# skills/ghostwriter/references/docs.md after docs-writing was retired.
 id: copywriting-nominalisations
 title: Verb buried in a noun
 categoryId: reader-first-framing
 source:
   {
     repo: mblode/agent-skills,
-    path: skills/docs-writing/rules/clarity-no-nominalizations.md,
-    line: 7,
+    path: skills/ghostwriter/references/docs.md,
+    line: 17,
   }
 unit: [paragraph, jsx-text]
 mechanical:

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]
+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-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-tee-up.yaml

@@ -0,0 +1,21 @@
+# 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]
+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"
+  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/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: 696321dfa9cb90a6d31bba628bba33aecf23ff4aaadd3516ca2a2eea4e6219e1
+handWritten: [mechanical, fix, review, scope]

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