@heyramzi/lint 2.0.0 → 2.1.0

package/data/slop/phrases-en-core.js

@@ -0,0 +1,185 @@
+/** The English banned phrases, first half: the workspace bans, throat-clearing, filler and the corpus reads. */
+export const phrasesEnCore = [
+  // --- Existing workspace bans ---
+  "not only",
+  "but also",
+
+  // --- Negation pivots: the "it is not X, it is Y" reveal --- Substring-matched, so only distinctive multi-word forms belong here.
+
+  // A bare "is not" is normal English and must never be listed.
+  "it's not just",
+  "it is not just",
+  "not just about",
+  "it's not about",
+  "it is not about",
+  "isn't about",
+  "it's not merely",
+  "it is not merely",
+  "not merely a",
+  "this isn't just",
+  "this is not just",
+  "that's not just",
+  "more than just a",
+  "ce n'est pas seulement",
+  "il ne s'agit pas seulement",
+  "non seulement",
+  "ever wondered why",
+  "reach new heights",
+  "in the realm of",
+  "think of it as",
+  "that's a wrap",
+  "it's like",
+  "let's dive in",
+  "dive in",
+  "buckle up",
+  "to the next level",
+  "in the fast-paced",
+  "in today's",
+  "hidden gems",
+
+  // --- Stop-slop: throat-clearing openers ---
+  "here's the thing",
+  "the uncomfortable truth",
+  "it turns out",
+  "let me be clear",
+  "the truth is",
+  "can we talk about",
+  "here's what i find",
+  "here's the problem",
+  "i'll say it again",
+  "i'm going to be honest",
+
+  // --- 2026 corpus: the three "here's the X" openers named alongside the two above by copy and marketing sources.
+
+  // Same shape, same job, and the copy one was caught in a shipped email arguing against AI writing.
+  "here's the fix",
+  "here's the kicker",
+  "here's the gap",
+
+  // --- Transition crutches.
+
+  // Held only in prose until 3 Sep 2026, in a "Transitions to Avoid" list inside seo-copywriting, where nothing checked them: 7 of its 10 entries were already here and 3
+
+  // were not, so the file was both a duplicate and the only home for the rest. ---
+  "that being said",
+  "this begs the question",
+  "let's delve into",
+  "lets delve into",
+
+  // --- Stop-slop: emphasis crutches ---
+  "let that sink in",
+  "this matters because",
+  "make no mistake",
+  "here's why that matters",
+
+  // --- Stop-slop: business jargon phrases ---
+  "lean into",
+  "double down",
+  "deep dive",
+  "take a step back",
+  "moving forward",
+  "circle back",
+  "on the same page",
+  "game-changer",
+  "game changer",
+  "cutting-edge",
+  "cutting edge",
+  "best-in-class",
+  "best in class",
+  "next-generation",
+  "state-of-the-art",
+  "end-to-end",
+
+  // --- Stop-slop: filler phrases ---
+  "no more",
+  "say goodbye to",
+  "at its core",
+  "at the end of the day",
+  "in a world where",
+  "in conclusion",
+  "it's worth noting",
+  "rest assured",
+  "the reality is",
+  "when it comes to",
+
+  // --- Stylometric markers from guillaumemeyer/watermarks-remover --- Its detector scores 24 weighted markers.
+
+  // 26 of the 34 surface forms those cover were already banned here; these are the eight that were not, checked against 56,568 words of first-party corpus first so none of
+
+  // them is his. Read 2026-08-16.
+  "it is important to note",
+  "it is essential to note",
+  "it is crucial to note",
+  "it is worth noting",
+  "to summarize",
+  "plays a crucial role",
+  "plays a key role",
+  "plays a vital role",
+
+  // --- Assistant leakage: a chatbot's own turn-taking, left in the copy ---
+  "as an ai",
+  "i hope this helps",
+
+  // --- Stop-slop: meta-commentary ---
+  "plot twist",
+  "you already know this",
+  "is a feature, not a bug",
+  "let me walk you through",
+  "as we'll see",
+
+  // --- The unfinished list, and the writer narrating his own argument --- Read from a Nicolas Cole newsletter on 26 Aug 2026, a specimen of the creator-newsletter register.
+
+  // "the list goes on and on" closes two separate lists in it, both times in place of the items the writer did not have.
+
+  // Zero occurrences in Ramzi's corpus for all of these except "possibilities are endless", which appears once, in a 2025 ClickUp post from the generic marketer era this voice system was
+
+  // built to end.
+  "the list goes on",
+  "the list is endless",
+  "possibilities are endless",
+  "and so much more",
+  "my point is",
+  "so you see",
+  "half the battle",
+  "the name of the game",
+
+  // --- Stop-slop: vague declaratives ---
+  "the implications are",
+  "the stakes are high",
+  "the consequences are",
+  "the reasons are structural",
+
+  // --- petergyang/no-ai-slop, read 2026-08-31 --- Faux-insight setups, weasel attribution, rhetorical setups, reader guidance and dated-world filler.
+
+  // Every one is a distinctive multi-word form, so it can be substring-matched without firing on ordinary English; the ones that cannot ("in other words",
+
+  // "literally", "simply", "overall") stay judgement calls in patterns.md 48. Zero occurrences across the first-party corpus.
+  "this changes everything",
+  "this is huge",
+  // "in today's" is listed above; only the curly apostrophe needs its own entry.
+  "in today\u2019s",
+  "in the age of",
+  "in the world of",
+  "in this article",
+  "going forward",
+  "with regard to",
+  "in terms of",
+  "widely regarded as",
+  "experts agree",
+  "industry reports suggest",
+  "many argue",
+  "what if i told you",
+  // "think about it" is NOT listed: the slop form is the standalone imperative ("Think about it:"), and a substring ban also catches the ordinary subordinate clause,
+
+  // which shipped copy uses ("whether you think about it or not"). It stays in patterns.md 33 as a human read.
+
+  // "as you can see" is NOT listed: voice-measured.md measures it 20 times in his own spoken corpus, tagged "spoken only, needs a screen".
+
+  // It is his tutorial register pointing at a screen, not reader guidance. patterns.md 48 carries it as a written-copy read.
+  "the key point is",
+  "this distinction matters",
+  "nobody tells you",
+  "the part everyone misses",
+  "most people get wrong",
+  "most people skip",
+];

package/data/slop/phrases-en-wikipedia.js

@@ -0,0 +1,136 @@
+/** The English banned phrases from Wikipedia's signs of AI writing, one block per section of that page. */
+export const phrasesEnWikipedia = [
+  // --- Wikipedia:Signs of AI writing, read 2026-09-05 --- One block per section of that page, so a reader can trace a ban back to the sign it came from.
+
+  // Only distinctive multi-word forms are here; the signs that need an anchor are `patterns` in `data/slop/patterns.js`, and the ones that need a whole document are the structural checks in `slop.js`.
+
+  // WP:AITREND and the Wikipedia section on undue emphasis. Significance asserted instead of stated.
+  "a testament to",
+  "plays a significant role",
+  "plays a pivotal role",
+  "a pivotal moment",
+  "a key turning point",
+  // "serves as a", "stands as a", "marks a shift" and "represents a shift" are not listed here: the `copula-avoidance` pattern in `data/slop/patterns/wikipedia-signs.js` owns that whole family,
+
+  // and a phrase entry would only report the same sentence twice.
+  "reflects a broader",
+  "reflects broader",
+  "part of a broader",
+  "setting the stage for",
+  "indelible mark",
+  "deeply rooted",
+  "evolving landscape",
+  "focal point",
+  "underscores the importance",
+  "highlights the importance",
+  "emphasizes the importance",
+  "underscoring its significance",
+  "contributing to the broader",
+  "in the broader context",
+  "ongoing efforts to",
+
+  // WP:OVERATTRIBUTION, WP:AIATTR. Notability asserted instead of shown.
+  "independent coverage",
+  "media outlets",
+  "trade publications",
+  "widely read outlets",
+  "has been profiled in",
+  "has been featured in",
+  "active social media presence",
+  "significant coverage",
+  "substantial coverage",
+  "independent and reliable sources",
+
+  // WP:AIPUFFERY, WP:AIPEACOCK. The travel-guide register.
+  "rich cultural heritage",
+  "rich history",
+  "natural beauty",
+  "in the heart of",
+  "nestled in",
+  "nestled within",
+  "diverse array",
+  "wide array of",
+  "a wide range of",
+  "commitment to excellence",
+  "a fascinating glimpse",
+  "a glimpse into",
+  "shed light on",
+  "valuable insights",
+  "align with",
+  "aligns with",
+  "resonate with",
+  "resonates with",
+  "an integral part of",
+
+  // WP:FACESCHALLENGES. The formulaic closing section.
+  "faces several challenges",
+  "faces a number of challenges",
+  "despite these challenges",
+  "despite its challenges",
+  "challenges and opportunities",
+  "future prospects",
+  "future outlook",
+  "awards and recognition",
+  "recognition and awards",
+
+  // WP:CONCLUSION, WP:INCONCLUSION. The section summary. "in conclusion" is
+  // listed in `phrases-en-core.js` with the filler phrases.
+  "in summary",
+  "to sum up",
+
+  // WP:DIDACTIC. The disclaimer aimed at an imagined reader.
+
+  // The uncontracted "it is important/essential/crucial to note" and "it's worth noting" are listed in `phrases-en-core.js`; these are the forms a substring match on those misses.
+  "it's important to note",
+  "it's essential to note",
+  "it's crucial to note",
+  "important to remember",
+  "crucial to remember",
+  "worth remembering",
+  "important to consider",
+  "may vary depending",
+
+  // WP:CERTAINLY, WP:COLLABCOMM. The chatbot's own turn, left in the copy.
+  // "as an ai" and "i hope this helps" are listed in `phrases-en-core.js`.
+  "as an ai language model",
+  "as a large language model",
+  "i cannot provide",
+  "i'm sorry, but",
+  "i am sorry, but",
+  "you're absolutely right",
+  "you are absolutely right",
+  "great question",
+  "would you like me to",
+  "let me know if you",
+  "is there anything else",
+  "detailed breakdown",
+  "here is a breakdown",
+  "here's a breakdown",
+  "i hope this message finds you well",
+  "i hope this finds you well",
+  "feel free to reach out",
+
+  // WP:AICUTOFF, WP:AIDISCLAIMER. The model speculating about its own gaps.
+  "as of my last knowledge update",
+  "as of my last training update",
+  "up to my last training update",
+  "based on available information",
+  "based on the available information",
+  "while specific details are limited",
+  "specific details are scarce",
+  "not widely documented",
+  "not widely available",
+  "not publicly available",
+  "in the provided sources",
+  "in the available sources",
+  "in the search results",
+  "maintains a low profile",
+  "keeps personal details private",
+
+  // WP:AICONNECT, WP:AIASSOCIATION. A relationship alluded to, never stated.
+  "widely interpreted as",
+  "has been associated with",
+  "widely associated with",
+  "in connection with",
+  "in association with",
+];

package/data/slop/phrases-fr.js

@@ -0,0 +1,152 @@
+/** The French banned phrases. */
+export const phrasesFr = [
+  // --- French: throat-clearing openers ---
+  "il est important de noter",
+  "il convient de souligner",
+  "il est essentiel de",
+  "force est de constater",
+  "il va sans dire",
+  "dans un monde où",
+  "à l'ère du",
+  "à l'heure où",
+  "dans le paysage actuel",
+
+  // --- French: filler phrases ---
+  "en fin de compte",
+  "au bout du compte",
+  "en d'autres termes",
+  "il est à noter que",
+  "cela étant dit",
+  "dans cette optique",
+  "à cet égard",
+  "en ce qui concerne",
+  "dans le cadre de",
+
+  // --- French: business jargon phrases ---
+  "mise en place",
+  "montée en compétence",
+  "montée en puissance",
+  "retour sur investissement",
+  "valeur ajoutée",
+  "prise en compte",
+  "conduite du changement",
+  "transformation digitale",
+  "transformation numérique",
+  "passage à l'échelle",
+  "de pointe",
+  "clé en main",
+  "sur mesure",
+  "de bout en bout",
+  "à la pointe",
+  "état de l'art",
+
+  // --- French: AI emphasis crutches ---
+  "il ne fait aucun doute",
+  "sans aucun doute",
+  "il est indéniable",
+  "de manière significative",
+  "de façon significative",
+  "tout au long de",
+
+  // --- French: the same Wikipedia signs, in French --- fr:Aide:Identifier l'usage d'une IA générative, read 2026-09-05, plus the French surface forms of the English blocks in the `phrases-en-*.js` files.
+
+  // The French page adds no sign the English one lacks except its emphasis on "langue de bois", so the blocks below mirror the English ones section for section.
+
+  // Significance asserted instead of stated.
+  "constitue un témoignage",
+  "témoigne de l'importance",
+  "s'impose comme",
+  "se présente comme",
+  "joue un rôle crucial",
+  "joue un rôle clé",
+  "joue un rôle majeur",
+  "joue un rôle central",
+  "un tournant décisif",
+  "un moment charnière",
+  "une étape clé",
+  "marque un tournant",
+  "reflète une tendance",
+  "s'inscrit dans une dynamique",
+  "s'inscrit dans un contexte",
+  "contribuant ainsi",
+  "mettant en lumière",
+  "mettant en avant",
+  "met en lumière",
+  "met en évidence",
+  "souligne l'importance",
+  "soulignant l'importance",
+
+  // Notability asserted instead of shown.
+  "sources fiables et indépendantes",
+  "de nombreux médias",
+  "largement relayé",
+  "largement médiatisé",
+  "présence active sur les réseaux",
+
+  // The travel-guide register.
+  "au cœur de",
+  "niché au cœur",
+  "riche patrimoine",
+  "patrimoine culturel riche",
+  "beauté naturelle",
+  "un large éventail",
+  "une large gamme",
+  "un aperçu fascinant",
+  "des informations précieuses",
+  "en résonance avec",
+
+  // The formulaic closing section.
+  "malgré ces défis",
+  "malgré ces obstacles",
+  "fait face à plusieurs défis",
+  "de nombreux défis",
+  "défis et perspectives",
+  "perspectives d'avenir",
+  "prix et distinctions",
+
+  // The section summary.
+  "en résumé",
+  "pour résumer",
+  "en somme",
+  "pour conclure",
+
+  // The disclaimer aimed at an imagined reader.
+  "il est crucial de",
+  "il est primordial de",
+  "il est intéressant de noter",
+  "il est bon de noter",
+  "il convient de noter",
+  "il est utile de rappeler",
+  "peut varier selon",
+
+  // The chatbot's own turn, left in the copy.
+  "en tant qu'ia",
+  "en tant que modèle de langage",
+  "je ne peux pas fournir",
+  "je suis désolé, mais",
+  "vous avez tout à fait raison",
+  "excellente question",
+  "souhaitez-vous que je",
+  "y a-t-il autre chose",
+  "voici un aperçu détaillé",
+  "voici une version",
+  "j'espère que cela vous aidera",
+  "n'hésitez pas à me solliciter",
+
+  // The model speculating about its own gaps.
+  "à ma dernière mise à jour",
+  "selon les informations disponibles",
+  "d'après les informations disponibles",
+  "les détails sont limités",
+  "peu de sources",
+  "n'est pas largement documenté",
+  "n'est pas publiquement disponible",
+
+  // A relationship alluded to, never stated.
+  "en lien avec",
+  "en association avec",
+  "largement associé",
+  "étroitement associé",
+  "souvent associé",
+  "largement interprété comme",
+];

package/data/slop/shapes-density.js

@@ -0,0 +1,81 @@
+/** Sentence shapes judged by density, so one instance is style and none can be a pattern. */
+export const shapesDensity = [
+  // --- 2026 corpus additions. Seven shapes named repeatedly across 31 videos on AI writing, read 6 Sep 2026. Evidence and counts: ai-doc/skills/content/writing/humanizer/references/detection.md.
+
+  // All seven are density-judged, so none can move into `patterns`: one instance is style.
+  {
+    id: "semantic-incoherence",
+    name: "Semantic incoherence",
+    rule: "Words that co-occur in training data joined into a picture that cannot exist. The phrase scans on first read and collapses on second: nothing is overarching and undergirding at once, a slate is not filled the way a container is, an offensive is not nestled. Name the physical picture the sentence asks for and check that it exists. Diagnoses bad writing, never authorship: weak human writers mix metaphors constantly. See patterns.md 53.",
+    example:
+      '"Two overarching pillars undergird the approach." / "the offensive, nestled amid a year of war" / "silence like a thunderstorm folded into velvet"',
+  },
+  {
+    id: "figure-stacking",
+    name: "Figure stacking",
+    rule: "Three or more similes or metaphors laid end to end for one moment, instead of choosing the one that carries it. Each figure passes a line edit on its own; the pile is the tell. Same instinct at the word level produces adjective couplets where one adjective would do. Choose one and delete the rest. See patterns.md 54.",
+    example:
+      '"It bit like a thousand tiny teeth, a cruel lover, a quiet violence made beautiful." / "brittle and sharp" / "pastel and brittle"',
+  },
+  {
+    id: "base-adjective-recycling",
+    name: "Base adjective recycling",
+    rule: "The plainest adjectives (soft, quiet, sharp, light, warm, heavy, bright) returning every page, because the passage is not describing anything specific enough to need another word. The inverse of elegant variation. Mechanical check: search the draft for its five commonest adjectives and count. The repair is a specific detail, not a thesaurus. See patterns.md 55.",
+    example: '"The room was quiet. Her voice was quiet. A quiet dread settled."',
+  },
+  {
+    id: "emotional-flatlining",
+    name: "Emotional flatlining",
+    rule: "One heightened register held from the first line to the last, so nothing is emphatic because everything is. Structural rather than local, which is why it survives sentence-level editing. Read the loudest and the quietest passage: if they are the same volume, the draft has no shape. Fix it by taking pressure out of the ordinary passages, not by adding more to the big ones. Correct and expected in technical and reference text. See patterns.md 56.",
+    example:
+      '"A breakfast scene and a betrayal written at the same pitch." / A case study whose setup, turn and result all land equally hard.',
+  },
+  {
+    id: "asserted-transition",
+    name: "Asserted transition",
+    rule: "Moreover, Furthermore, In addition, However, On the other hand connecting two sentences whose relation is not the one the word claims. Two failures compound: the pile-up, and the assertion of a logic that is not there. Delete the connective and read the pair again; if the relation was real, the sentences still carry it. One however is not a tell. See patterns.md 57.",
+    example:
+      '"The region gets heavy rainfall. However, agriculture is a major industry." / "The city has 50,000 people. Moreover, it is near the coast."',
+  },
+  {
+    id: "unsupported-opening-claim",
+    name: "Unsupported opening claim",
+    rule: "An opening sentence placing the subject among the most significant shifts in history, or reshaping how people think, followed by a second sentence on a different subject. The diagnostic is the absence of a follow-up: the claim is made, no evidence is offered, and the next line moves on to another claim. Ask of the opening line: what in the rest of this makes that true? If nothing does, open on what is actually true. See patterns.md 58.",
+    example:
+      '"The rise of AI is one of the most profound transformations in human history, reshaping industries, societies and our understanding of intelligence."',
+  },
+  {
+    id: "compare-by-restating",
+    name: "Compare by restating",
+    rule: "Rather than contrasting, the sentence offers a second and third phrasing of what it just said. It reads as precision and adds nothing, and underneath it is a writer who does not trust the reader to have understood the first phrasing. The tell is that deleting every clause after the first costs no meaning. The subtle cousin of the negation pivot. See patterns.md 59.",
+    example:
+      '"Her lipstick is red, not just red but vivid, the kind of colour that demands attention." / "hoops, the kind that no one second-guesses"',
+  },
+  {
+    id: "named-feeling",
+    name: "Named feeling",
+    rule: 'The emotion labelled where its cause belongs. A reader told what to feel feels nothing, and the label is the cheapest sentence in the language to produce, which is why a model reaches for it first. Delete the word and write what caused it: "I was frustrated" is "the fourth build failed at 2am and I put the laptop in a drawer". The reader supplies the word. Never invent the cause to replace the label; go and get it. See patterns.md 63.',
+    example:
+      '"I was frustrated." / "It was exciting." / "I felt proud of what we built." / "It was a humbling experience."',
+  },
+  {
+    id: "clean-resolution",
+    name: "Clean resolution",
+    rule: "Every thread tied off, every lesson learned, the piece landing complete. Real work leaves loose ends, so a piece where everything resolves was built backwards from its conclusion and the reader feels the reverse-engineering. Leave the thing that is still broken in, and say plainly what you do not know yet. See patterns.md 64.",
+    example:
+      '"And that is when it all clicked." / "Looking back, I would not change a thing." / "The lesson here is simple."',
+  },
+  {
+    id: "smoothed-figure",
+    name: "Smoothed figure",
+    rule: 'A hedge in front of a round number, where the number is the evidence. Real measurement produces ugly figures, so "about 50%" and "roughly 3x" tell the reader you estimated or invented it. Write 47%, 2.8x, $9,340, 213 hours. If the real figure is not to hand, say you are estimating rather than smoothing it. A round number nobody is leaning on (5 clients, 10 minutes) is ordinary English, which is why this stays a human read. The vague-magnitude half is lint-enforced. See patterns.md 65.',
+    example: '"about 50% faster" / "roughly 3x the output" / "around $10k a month"',
+  },
+  {
+    id: "costless-claim",
+    name: "Costless claim",
+    rule: "Advice from somebody who risked nothing. Authority comes from having paid for the knowledge, so instruction with no price attached anywhere in the piece reads as compiled rather than lived. Name one real cost, money, hours, a relationship or a reputation, and one moment you were wrong, neither of them softened. A cost that did not happen is a fabrication, so where there is none, cut the claim rather than furnishing it. See patterns.md 66.",
+    example:
+      '"Always validate before you build." with no account of the thing the writer built and nobody wanted.',
+  },
+];

package/data/slop/shapes-framing.js

@@ -0,0 +1,101 @@
+/** Sentence shapes, second third: framing, aphorism and abstraction tells. */
+export const shapesFraming = [
+  {
+    id: "tells-you-more-than",
+    name: "The diagnostic-tell close",
+    rule: "Closing by ranking one signal above another as a source of truth. It sounds like earned judgement and is untestable, and it always arrives as the last line so it reads as a moral.",
+    example:
+      '"How they answer tells you more than the brief does." / "Their reply says more than the contract ever will." / "That one question reveals more than an hour of discovery."',
+  },
+  {
+    id: "chiastic-reveal",
+    name: "Chiastic reveal",
+    rule: "Two abstract nouns swapped across a colon or a full stop so the sentence sounds like an insight. It is a rhetorical figure with no content: the reader has to decode the wordplay before reaching the point, and nobody speaks this way. Say the point.",
+    example:
+      '"Everyone here has the where. The part that took me longest was the what." / "The problem was never the tool. It was the habit." / "You do not need more time. You need less work."',
+  },
+  {
+    id: "appositive-fragment",
+    name: "Appositive fragment",
+    rule: "A noun phrase, a comma, then a verbless phrase that grades or denies the first half. The second half carries no fact, only the writer's assurance about the tone of the first. A comma in a short sentence is allowed to join a list of three or more real objects, an adverbial opener, or two clauses that each have a subject and a verb. Nothing else. Delete the appositive, or give it a verb.",
+    example:
+      '"One line, nothing dramatic." / "A single question, no pressure." / "Two fields, nothing fancy."',
+  },
+  {
+    id: "imperative-payoff",
+    name: "Imperative with a restated payoff",
+    rule: 'An order to the reader whose payoff only restates the order: the reader is told to do something and then told what they would have seen, so the line teaches nothing and orders nothing. Ramzi, 8 Sep 2026, on a shipped course title slide. Write the claim as a plain statement, or make the imperative an instruction somebody can carry out. Stays out of `patterns` because the same shape is right in a tutorial step: "Run pnpm dev and you get a server on 5173".',
+    example:
+      '"Open 10 agency accounts and you get 10 shapes" / "Fix the shape and the fields can be fixed too" / "Ask 3 people and you get 3 answers"',
+  },
+  {
+    id: "moral-aphorism",
+    name: "Moral aphorism",
+    rule: "An abstract virtue or vice given a predicate as a general truth about people. It reads as a lesson delivered from above, and it is unfalsifiable, so it adds nothing the surrounding sentence did not already carry. Generalisations take a concrete subject out of the work: a tool, a price, a status, a deadline.",
+    example:
+      '"Politeness is free, so it gets treated as free." / "Trust is earned in drops." / "Urgency is a choice."',
+  },
+  {
+    id: "definitional-demotion",
+    name: "Definitional demotion",
+    rule: 'A concrete noun, a relative clause that disqualifies it, then an equals sign to a lesser noun: "A backup nobody has rebuilt from is a folder." The shape reads as a hard-won definition and is a word game. Nothing is measured, nothing is instructed, and the reader cannot act on the verdict. Write the mechanism instead: what the thing fails to do, and what to do about it. It is the positive twin of the negation pivot, so a draft that has had its "it is not X, it is Y" removed often grows this one in its place.',
+    example:
+      '"A backup nobody has rebuilt from is a folder." / "A process nobody follows is a document." / "A plan without a date is a wish." / "A meeting with no notes is a rumour."',
+  },
+  {
+    id: "hypothetical-law",
+    name: "Hypothetical law",
+    rule: 'An "if" clause followed by a re-labelling of an abstraction rather than by an instruction or a real consequence. The sentence sounds like a discovered rule and is only a restatement. Follow a conditional with what to do, or with what actually happens.',
+    example:
+      '"If nothing ever stops, your due date is a suggestion." / "If everything is urgent, nothing is." / "If you never say no, your calendar belongs to somebody else."',
+  },
+  {
+    id: "colon-connector",
+    name: "Colon as a connector",
+    rule: "A colon used mid-sentence to join two clauses that a full stop would join better. A colon is right before a list or an example and nowhere else. The construction always arrives with comparison framing in front of it, so the fix is to drop both and let the point stand on its own.",
+    example:
+      '"If you are coming from traditional automation: instead of registering handlers, you describe conditions." / "The rule is simple: write it down." / "Here is the tradeoff: speed against accuracy."',
+  },
+  {
+    id: "abstract-metaphor-noun",
+    name: "Abstract metaphor noun",
+    rule: "A noun borrowed from physics, chess or engineering to make a plain idea sound technical: substrate, wedge, vector, locus, vantage, nexus, primitive (as a noun), harness (as a metaphor), surface (as in API surface), bedrock, scaffolding (as a metaphor), modality, gold-plating, ratchet, evacuate (for moving code), endgame, north star, flywheel. Each one has a plainer concrete word. Substrate is base, wedge in is add, vector is way or method, gold-plating is more than the job needs, ratchet is the mechanism's real name or a limit that only tightens, evacuate is move out, endgame is the last phase. Pick the concrete word. These stay off the lint list because several are literal in a codebase: a language primitive and a test harness are the real names of real things.",
+    example:
+      '"The substrate the whole product sits on." / "Use pricing as a wedge into the account." / "Another vector for growth." / "That is the north star for the flywheel."',
+  },
+  {
+    id: "feeling-not-mechanism",
+    name: "Feeling instead of mechanism",
+    rule: 'A sentence that names how something feels instead of what it does: "the database stays close at hand", "SQL you can read", "types that follow your schema". The fix names the mechanism or a number. Ask what the sentence tells the reader to do or know and write that; if it cannot be restated as an instruction, a fact or a number, cut it. Second test: if the sentence could appear unchanged in another project\'s docs, it says nothing about this one.',
+    example:
+      '"The database stays close at hand." / "SQL you can actually read." / "Types that follow your schema." / "Built for teams that move fast."',
+  },
+  {
+    id: "applause-line",
+    name: "Applause line",
+    rule: 'A standalone sentence whose only job is to tell the reader the paragraph above it was impressive. It carries no new fact, no number and no instruction, and it is always short, so it reads as emphasis while adding nothing. The tell is that deleting it costs the passage nothing. Delete it, or replace it with the figure that would have earned the reaction. Not in `patterns` because "This is leverage." and "This is the schema." are the same shape and only one of them is empty.',
+    example:
+      '"This is leverage." / "This is a huge benefit." / "That\'s a lot of free growth!" / "There is no better marketing than that." / "But their loss is your gain!"',
+  },
+  {
+    id: "propped-adverb",
+    name: "Propped adverb",
+    rule: "An adverb holding up a verb that is too weak to stand alone. Runs quickly is is fast or the number, significantly improves is the measured delta. An adverb propping a verb means the verb is wrong, so replace the pair with one stronger verb or with the figure.",
+    example:
+      '"Significantly improves load time." / "Runs quickly on modest hardware." / "Dramatically reduces the number of steps."',
+  },
+  {
+    id: "long-sentence",
+    name: "Sentence past 30 words",
+    rule: "Ogilvy's third rule is short words, short sentences and short paragraphs, and the sentence half is the one that gets skipped. Past about 30 words the reader reaches the end holding none of the beginning, so they read it twice or they stop. The tell is a sentence with three or more clauses stacked by commas and `and`. Split it at the first `and` that starts a new idea. Not in `patterns` because a regex counting words across a hard-wrapped paragraph cannot tell a sentence from a bullet list; `course-lint.mjs` counts it where the text is structured.",
+    example:
+      '"It does the typing part of every lesson with you, one module a sitting, on your own site, and it stops at the end of each module because the reading stays yours." (32 words)',
+  },
+  {
+    id: "spelled-out-number",
+    name: "Spelled-out number",
+    rule: 'A quantity written as words instead of digits. A digit is the one shape in a line of prose the eye cannot skim, so every count, price, duration, percentage, date and measure ships as digits at any size: 15 clients, 3 hours a week, 20%, 60 seconds, $4,000, 2 of 5. Words are correct only where the number is not a quantity: one standing in for a or a single thing ("one page per space"), an idiom ("second nature", "at first hand"), and a number opening a sentence, which is better rewritten so it does not open one.',
+    example:
+      '"fifteen clients in and nothing is written down" / "three hours a week" / "a sixty second read" / "twenty per cent of the pipeline"',
+  },
+];