Tom's writing checks

These checks document Tom's writing preferences and the patterns his tools flag. Use them alongside the author's own approved examples and standards. A different writer may make different choices.

Download Markdown

Updated November 6, 2026Revision 4b98b5003337

  1. Plan the purpose, claims, audience and structure before drafting. Use representative examples across the kinds of work the author needs.
  2. Preserve the author's meaning, stance, qualifications and useful variation when revising.
  3. A match identifies text to inspect. Read its context and legitimate-use conditions before deciding what to change.
  4. Keep exact author requirements separate from contextual editorial judgment. Do not turn every warning into a ban.
  5. Repair the decision or production method behind a recurring defect. Replacing punctuation or substituting a synonym can leave the same problem in place.
  6. An empty scan establishes only that the available detectors found no matches. Evaluate the complete work against its purpose and source examples.

All 159 checks

Author requirements18

  • Em dash

    Hard banShared writing catcher

    Restructure the sentence with a colon, semicolon, comma, or participial phrase. The em dash gives prose an ad-copy cadence Tom never uses.

    Example of the pattern: the result—a clean break—held

  • Contrastive-negation template

    Hard banShared writing catcher

    Lead with the positive claim. Delete the negated clause and read what remains; if the positive statement stands on its own, keep only that.

    Examples of the template:

    • “not just a tool, but a way of thinking”
    • “it's not about speed, it's about depth”

    Legitimate use: a single genuine correction of a real misconception can be legitimate. Flagging it is still correct, and the agent keeps it only when the negated belief is one a reader actually holds.

  • Contrastive negation (semicolon hinge)

    Hard banShared writing catcher

    The semicolon variant of contrastive negation (“X does not Y; it Z”, “is not A; it is B”) is the form that most often slips past a fast read. After any rewrite, grep for not ...; it (the applicable writing criterion no-contrastive-negation).

    Restructure the grammar in one of these ways:

    • lead with the positive claim;
    • lay out the competing territories so the reader feels the gap;
    • give a concrete illustration.

    Cut the negation entirely when the reader was never going to hold the wrong belief.

    Examples of the pattern:

    • “The map does not store the route; it stores the rule.”
    • “Mass is not intensive; it is extensive.”

    The ban targets the grammatical template. Correcting a genuine misconception remains allowed (the applicable writing criterion): when the reader truly holds a wrong belief, a “common belief X; the truth is Y” correction is allowed once the grammar has been restructured. Flagging is still correct; keep the correction only when the negated belief is one a reader actually holds, and prefer leading with the positive claim.

    A quoted source or a [cite:...] attribution is exempt and does not fire.

  • Abstraction denigration

    Hard banShared writing catcher

    Abstraction is epistemically essential: it is a real pattern expressible in many concrete ways. Describe what the abstraction is and what it does. Use “pair the concept with a concrete example”, never “make the abstract concrete”.

    Examples of the pattern:

    • “not just abstract theory”
    • “we make the abstract concept concrete”
  • Significance scaffold (matters because)

    Hard banShared writing catcher

    Name the work the idea does: it distinguishes, protects, reveals, limits, connects, prevents, or makes something visible. State that directly.

  • Significance caption (that matters)

    Hard banShared writing catcher

    Do not caption importance. State the consequence, constraint, distinction, or mechanism that makes it weigh.

    Example of the pattern: “The symmetry is exact, and that matters.”

  • Coy reason scaffold

    Hard banShared writing catcher

    State the reason in the same sentence. Do not make the reader wait for it.

  • "X is Y you can [verb]" sentence

    Hard banShared writing catcher

    State the same definition or capability while preserving its qualifications and explanatory purpose. Apply the applicable writing criterion.

    Before: “The report is a record you can review after the run”

    After: “The report remains available for review after the run.”

    Adding a command changes this statement into an instruction and is not a faithful wording repair.

    Another example of the pattern: “Your voice is a set of claims you can inspect”

    What it matches: this rule fires only on a definition padded with the reader's capability (“X is Y you can verb”). Plain uses of “you can” belong to the you-can watchlist rule.

  • Stock numerical advice that hides the intended action

    Hard banShared writing catcher

    Explain the intended choice and the evidence that finishes the task. Read the surrounding passage to decide what it asks for: priority, a manageable trial, coverage, comparison, or a finished result.

    • For priority, choose the useful task that is feasible now.
    • For a trial, use a representative case that can expose a failure.
    • For a summary, include what changes the reader's decision.

    When that is the intended lesson, “Choose one thing and make it work” might become “Choose the recurring task that costs you the most time and test the automation on your next real request.”

    Do not replace one with a/an, swap digits for words, substitute a fixed synonym, or invent a selection criterion. Rewrite the complete thought and preserve supported meaning.

    Examples of the pattern:

    • “Find one way to improve your workflow”
    • “Choose ONE thing and make it work”
    • “Do the one thing”
    • “Start with one small action”

    Quantities that stay are those that carry facts or necessary constraints: mathematics, dates, versions, measured totals, a stated schema or format, per-item allocation, capacity, batching, an explicit comparison, or a demonstrated test design. Ordinary idioms, factual enumerations, and quoted source text also stay.

    A numbered list alone does not justify imposing its length. Repeated arbitrary quotas and fixed recipe counts need semantic review even when the catcher finds no match.

  • Figurative financial language for intellectual value

    Hard banShared writing catcher

    Hard ban in all authored prose: financial language used to describe intellectual or pedagogical value. The ban covers the whole financial family, of which “buys you” is one member. State the concrete capability or consequence instead.

    The banned family includes:

    • paying rent
    • payoff, pays off
    • repays the effort
    • pays dividends
    • price of admission
    • the currency of X
    • cashing in
    • getting a result for free
    • a property that earns its name; earns its place or earns its keep
    • spend attention
    • cognitive budget or cognitive tax
    • a lesson, test, or answer that “pays” points or XP

    Rewrites from the source. For points, say what gives them.

    FlaggedRewrite
    “Full tests pay XP for the habits that raise your score”“Full tests give XP for the habits that raise your score”
    “a wrong answer never pays”“a wrong answer gets no XP”
    “They keep paying rent”“they have kept solving new problems in every century since”
    “the payoff is leverage: prove one theorem and every system inherits it”“a theorem proved once about the pattern holds in every system wearing that pattern”
    “you get the second theorem for free”“the second theorem follows at once”

    What stays:

    • Ordinary idioms of effort. Investing or spending time, energy, or effort is common usage and stays.
    • Literal money. A tenant paying rent, a fund paying dividends, a museum's price of admission, a free download or free tier, cashing in a bond, wages earned, a one-time purchase (“you pay once”).
    • Points and XP. Earning points or XP is the game's own verb and stays; only “pay” is flagged for points.
    • Terms of art. Payoff matrix, payoff function, and payoff table in game theory (excluded by the pattern).
    • Mathematics literally about money. Examples such as bank deposits and withdrawals as integers.

    Other examples flagged by this rule:

    • “groups keep paying rent”
    • “this subject repays the effort”
    • “abstraction pays dividends later”
    • “counting one hands you the other for free”

    This rule is the sibling and generalization of buys-payoff, which keeps its own rule.

  • Compounding claimed without actual exponential growth

    Hard banShared writing catcher

    What compounding means. In growth claims, use “compounding” only for actual exponential growth: successive gains proportional to the accumulated amount.

    What does not establish it. Feedback, recursion, reuse, persistence, and improvements that help later improvements do not establish compounding. Neither does a number, or the words exponential, multiplicative, recursive, or reinvested, by themselves. A disclaimer about an irregular rate does not excuse an unsupported growth claim. Growth uses require semantic review and evidence of actual exponential growth.

    How to repair it. Say what happens: the setup improves over time, saved checks catch more errors, or the assistant handles more tasks. Do not invent a rate or add growth jargon to justify the word. Rewrite the whole thought as finished prose without mentioning the previous wording.

    Examples of the pattern:

    • “They turn every AI interaction into a compounding improvement”
    • “A compounding loop improves the means of making later improvements”
    • “The gains compound because each improvement becomes part of the base for the next improvement”

    Literal technical uses stay: compound interest, chemical compound, compound sentence, compound fracture, and compound microscope.

  • "Has teeth" cliche

    Hard banShared writing catcher

    Name the actual force or consequence.

    Before: “The rule has teeth”

    After: “Violating the rule voids the warranty.”

    Example of the pattern: “the constraint finally has teeth”

    Literal anatomy is fine (“sharks have teeth arranged in rows”); the clause-end match targets the idiom.

  • Vague perception verb (see/watch/read invitation)

    Hard banShared writing catcher

    Say what the reader gets, what happens, what the control does, or what to check. Trading one perception verb for another (watch, read, view, look at, observe) keeps the defect.

    FlaggedRewrite
    “Watch your agent secure your computer, step by step”“Choose what your agent secures and get a live report of each check”
    “See all 12 steps”“Show all 12 steps”
    “See why access makes the help specific”state the reason

    Other examples flagged by this rule:

    • “See each AI term drawn, with an example from everyday work”
    • “Copy the prompt, then watch each check update here.”
    • “Read more”

    Literal uses stay:

    • a person, assistant, or app that can see or read something (data access);
    • playing a video or recording;
    • reading a book or article as the activity;
    • an instruction to an AI agent to read a source;
    • “read X as Y” interpretation (Tom approved “You can read a matrix as a map”, 2026-10-05);
    • a lowercase citation or “See also” cross-reference in agent-facing guidance;
    • “Watch out” as a warning;
    • Tom's own wording, which stays verbatim.
  • Placeholder action noun (move/shape/signal)

    Hard banShared writing catcher

    Write the exact action, structure, observation, criterion, or saved instruction. Use a concrete verb with its object and result, so a cold reader does not have to infer what changes, what evidence was observed, or which instruction applies.

    FlaggedRewrite
    “the next move”“compare both drafts”
    “the lines that shape the reply”“the lines the reply must reflect”
    “progress signals”“course activity, saved items, and test-outs”
    “output shape”“required sections and fields”

    Examples flagged by this rule:

    • “use the same four moves in both apps”
    • “what is your next move”
    • “the next site learning signal”

    Literal or defined uses stay:

    • a chess move;
    • moving a file to a named folder;
    • a geometric shape;
    • a data schema whose fields are stated;
    • an electrical, acoustic, statistical, or model-internal signal;
    • a named mathematical rule or transformation (the chain rule, the distributive rule, a rotation by 90 degrees);
    • a named saved rule whose trigger and required behavior are stated.

    A function, map, update, or recurrence that a passage calls “the rule” is not a defined use: rule-for-function covers that case. A numbered set can stay when the passage immediately enumerates a genuinely closed set and names every item.

    The match nominates a contextual review and gives no permission for blind replacement.

  • Counted label ("Two moves", "Four jobs")

    Hard banShared writing catcher

    A count and a vague noun stand where the section's idea should be, so the reader learns only how many. Write the heading or label that says what the reader does with which idea, or names the exact subject, in the form its own section calls for. Read it beside its neighbors so the rewritten set does not share one construction.

    • “Four jobs” becomes “Hand the assistant drafting, sorting, searching, and scheduling”.
    • “Two moves” becomes the two actions themselves.

    Never swap the count for an article or another vague noun: changing “Choosing One Moment” to “Choosing a Moment” leaves it as vague. See the applicable writing criterion.

    Examples of the pattern:

    • ## Two moves
    • **Two steps:**
    • “One proposal and four checks”

    Counts that stay carry a fact the reader needs:

    • a measured quantity or duration (“Ten minutes a day”);
    • a recipe amount;
    • a math answer choice;
    • a navigation label (“Step 1 of 5”);
    • the title of a real work;
    • a heading that opens a claim (“One of the hardest problems ...”).

    Quoted source text stays as printed.

  • Doorway / key / unlocks scaffold

    Hard banShared writing catcher

    Stock threshold language (doorways, keys, unlocking) stands in for what the passage should say. Replace it with the exact mechanism, consequence, or step the learner takes in the passage.

    Legitimate uses. Literal locks and keys stay ("the key is under the mat", "the badge unlocks the lab door"). So does a product mechanic whose result is stated, though "finishing level 3 opens level 4" is still clearer than "unlocks".

  • Figurative worth/worthwhile judgment

    Hard banShared writing catcher

    Banned in every judgment sense. These phrases borrow a money word to say something is good without saying what it does:

    • "worth keeping", "worth testing", "worth revisiting"
    • "worth it"
    • "worthwhile"
    • "it's worth noting"

    State the concrete result, reason, or condition instead:

    FlaggedRewrite
    "a prompt worth saving""a prompt you will run again next week"
    "two flavors worth telling apart""the two cases call for different tests"

    A synonym swap (valuable, deserves, merits, rewarding) keeps the empty judgment and fails.

    Other flagged examples: "This decomposition is worth doing.", "Is the setup worth it?", "a worthwhile experiment".

    What stays. Literal money: a price or amount ("$20 worth of credits"), net worth, an asset's market value, and explicit economics. Quotations and cited titles also stay. Every other use is a hit, and a scoped authorial judgment is not an exemption.

    This rule is a sibling of financial-metaphor.

  • Backwards definition (scenario before the definition)

    Hard banShared writing catcher

    In any definition, tooltip, glossary entry, marginalia callout, or concept annotation, the first sentence must state what the term means in plain language. Scenarios, examples, analogies, and "You want..." openers come after the definition. Rewrite so the plain-language definition leads, then add the scenario.

    Flagged examples:

    • "You want your assistant to handle morning briefings. That capability is one module. A module is..."
    • "Imagine a system that settles into a repeating state. That is an attractor."

    Where the hard ban applies. Treat this as a hard ban only inside definition, tooltip, glossary, and callout contexts. In ordinary narrative prose, a scenario opener is a legitimate hook, not a backwards definition.

    When the definition is missing. Do not fire when the same sentence both opens with a scenario and the definition is genuinely absent. That sentence needs the definition added, but outside definition surfaces, downgrade it to a fixer note. The catcher only fires when the scenario opener is immediately followed by a definition-like sentence.

Review signals141

  • Contrastive negation (cluster)

    WatchlistShared writing catcher

    Repeated negation hinges make prose think only by opposing abstractions. The hinges include “not X”, “not merely”, “more than just”, and “rather than”. Name the actual force instead.

    One isolated necessary negation is fine. The cluster detector fires only when the frame recurs.

  • Second-person capability frame (check for reflex use)

    WatchlistShared writing catcher

    “You can” is fine when it tells the reader something they really can do (“You can read a matrix as a map”). Rewrite only reflex use:

    • the same capability frame across neighboring sentences;
    • a promised capability where the text should say what happens;
    • a definition padded with the reader's capability.

    Write each sentence from its own idea so the syntax varies. Swapping in another stock frame such as “lets you”, or a command, does not repair it.

    Examples of reflex use:

    • “You can inspect each claim. You can compare the sources. You can save the result.”
    • “Save a record so you can compare the results”

    Acceptable uses: a single “you can” stating a real option the reader has is acceptable. Negative forms such as cannot, can't, can not, can never, and can no longer express a limit and are different constructions. Preserve verbatim quotations and executable code.

  • Name introduced without quotation marks or bold

    WatchlistShared writing catcher

    Set the name off with quotation marks or bold (the applicable writing criterion): a check called the “because” test, a form called the “singular possessive.”

    Keep a coined name marked on every later use too. This catcher only sees the introduction, so search the file for the bare name.

    Examples of an unmarked introduction:

    • “A check called the because test uses that difference”
    • “a form called the singular possessive”
    • “Using only the results that fit a claim is called cherry-picking.”

    Uses that stay:

    • Other senses of the verb: called for, called the police, called the new plan a bargain, a cat named Pip.
    • Names inside quoted source text or test passages stay as printed.
    • A name already set off with bold markup (<strong>, **) or code formatting passes, even though the pattern sees a letter after the article.
  • Quantified advice or output quota needing a reason

    WatchlistShared writing catcher

    Explain the intended choice and the evidence that finishes the task. Read the surrounding passage to decide what it asks for: priority, a manageable trial, coverage, comparison, or a finished result.

    • For priority, choose the useful task that is feasible now.
    • For a trial, use a representative case that can expose a failure.
    • For a summary, include what changes the reader's decision.

    When that is the intended lesson, “Choose one thing and make it work” might become “Choose the recurring task that costs you the most time and test the automation on your next real request.”

    Do not replace one with a/an, swap digits for words, substitute a fixed synonym, or invent a selection criterion. Rewrite the complete thought and preserve supported meaning.

    Examples of quantified advice or output quotas:

    • “Write three takeaways from the meeting”
    • “Draft 12 ideas for the launch”
    • “List twenty-five lessons from the trial”

    Quantities that stay are those that carry facts or necessary constraints: mathematics, dates, versions, measured totals, a stated schema or format, per-item allocation, capacity, batching, an explicit comparison, or a demonstrated test design. Ordinary idioms, factual enumerations, and quoted source text also stay.

    A numbered list alone does not justify imposing its length. Repeated arbitrary quotas and fixed recipe counts need semantic review even when the catcher finds no match.

  • Figurative "buys/purchases" payoff

    WatchlistShared writing catcher

    Name what actually becomes available.

    Before: “The Jacobian buys you the easy version”

    After: “For continuous-time dynamics near a fixed point, the Jacobian describes how a small displacement changes the velocity.”

    Another example of the pattern: “that buys us a closed-form solution”

    Literal commerce is fine (“buys a house”, “purchased the dataset license”). The rule fires on the figurative payoff sense.

  • Published prose narrates discarded wording

    WatchlistShared writing catcher

    Write the corrected claim as finished prose. Delete commentary about what an earlier draft said, what the text used to call something, or which wording the editor replaced. The reader needs the subject, and the revision history gets in the way.

    Examples of residue:

    • “The previous version called this compounding”
    • “Rather than calling these gains compounding, think of them as cumulative”
    • “This used to say that every interaction compounds”

    Where revision history belongs: editing instructions, redlines, changelogs, textual scholarship, and explicit comparisons of historical document versions may need it. The defect is residue inside finished reader-facing prose, which should read as if the corrected claim had always been there. Preserve accurate quotations and source discussions.

  • "Honest" hedge

    WatchlistShared writing catcher

    Drop the hedge and state the caveat.

    Before: “One honest caveat: the model ignores migration”

    After: “The model ignores migration, so it overstates local extinction.”

    Another example of the pattern: “to be honest, the estimate is rough”

    Legitimate use: prose genuinely about honesty as a subject (ethics, testimony, an honest day's work).

  • "Doing all the work" / heavy lifting

    WatchlistShared writing catcher

    Name the mechanism.

    Before: “The exponent is doing all the work”

    After: “The exponent sets how fast error grows, so it alone decides whether the trajectory diverges.”

    Examples of the pattern:

    • “the normalization term is doing all the work”
    • “the prior does the heavy lifting”
  • Empty intensifier (honest/real/true as emphasis)

    WatchlistShared writing catcher

    Using honest, real, true, or genuine as emphasis asserts importance instead of showing it, and the word adds nothing. State the property or mechanism directly. Keep the word only when it is load-bearing.

    FlaggedRewrite
    “the AND gate is the honest middle”“the AND gate sits in the middle, mixing redundancy and synergy”
    “the real magic is X”name X

    Other examples of the pattern:

    • “that is where the real magic happens”
    • “the truly remarkable part is the symmetry”

    Uses that stay:

    • Technical terms keep the word: real numbers, real analysis, real part, real line, real-valued, real-time, real-world, true positive, true negative, true value, true mean, true north, truth value.
    • “Honest” about real honesty (testimony, an honest day's work).
    • A “real” or “true” that contrasts with a specific stated illusion the reader holds. Empty emphasis before a framing noun does not qualify.
  • Opaque control-theory jargon (slave/slaved)

    WatchlistShared writing catcher

    The synergetics and singular-perturbation term “slave/slaved/slaving” is opaque and off-putting to a beginner. Replace it with plain language for what happens. The fast variable:

    • is eliminated;
    • settles to a value the slow variable fixes;
    • follows the slow variable;
    • or is set by it.

    Gloss the term of art at most once in a parenthetical, and never lead with it. This is the catchable instance of the broader plain-language-first standard: define or replace specialist jargon at first use.

    Examples of the pattern:

    • “you may slave the fast variable”
    • “the complex is slaved to the substrate”
    • “Tikhonov's slaving theorem”

    Prose about actual slavery (history, ethics, abolition, forced labor) is legitimate and must never be rewritten.

  • Causative-resultative compression ("X gets Y ready")

    WatchlistShared writing catcher

    Check whether the surrounding explanation identifies the change, relationship and relevant conditions. “Practice turns concepts into capabilities” promises a result without explaining the practice or the usable capacity. Describe what learners do and what that prepares them to do.

    Preserve the author's explanatory or instructional purpose. Turning an explanation into a command, or swapping the verb merely to clear the match, is not a repair.

    Other examples of the pattern:

    • “one short assistant conversation gets the next session ready”
    • “Discovery makes skills usable”
    • “Spaced resurfacing keeps ideas alive”

    Accurate uses stay. Literal physical causation, a defined mathematical transformation and an already explained mechanism can use makes, keeps or turns into accurately, and they do not require an invented human actor; a mechanism can be an explained relationship rather than a person acting. Also keep real actors doing specified actions, the receive and create senses of get and make, and summaries whose mechanism is already available: a short summary can rely on the mechanism established immediately before it. Preserve necessary qualification and authored stance.

  • Imperative used for a hypothetical (missing conditional marker)

    WatchlistShared writing catcher

    The pattern: an imperative-mood command voices a hypothetical or illustrative scenario, with no setup word to mark it as conditional, so the reader takes it for a real instruction. English lets a command stand in for a conditional antecedent (“Do X and Y happens” means “If you do X, Y happens”), so the model states a supposition without writing “If”, “Say”, “Suppose”, or “When”, and the reader parses a direction they were never given.

    Repair: mark the hypothetical with a setup word or recast it as a declarative. Unmarked, the Before sentence below reads as a direction to store the rule in one tool, when the passage is describing the mistake of doing that.

    Before: “Store one of those in a single tool and every other tool works without it”

    After: “If you keep one of those in a single tool, every other tool works without it.”

    Other examples of the pattern:

    • “Tell one babysitter and nobody else, and the rest of the house walks in with shoes on”
    • “Lock your rules in one app and each tool loses them”

    When the imperative is correct. The separator is the sentence's intended function. Keep the imperative when the reader genuinely is being instructed to do the thing: “Split the job into stages, and each stage gets one focus” and “Give each email type its own skill” are recommended moves the lesson wants the reader to take. Preserve genuine authored instructions, but do not convert a qualified recommendation or explanation into a command merely because its action might be useful.

    Also outside this pattern:

    • A genuine two-step instruction that continues with another bare imperative (“Read the path and state which jobs it covers”).
    • A declarative sentence that merely coordinates two clauses (“The rule lives in one tool, and every other assistant works without it”), since it is not an imperative.
  • Vague mental-act verb (name/see/notice/tell apart)

    WatchlistShared writing catcher

    Read the complete task and its context. A direction fails when the learner cannot identify what to inspect, compare, calculate or conclude. Repair that missing object or reasoning, preserving the author's meaning and the distinction the activity needs. “Notice the pattern” might become “Compare the gaps between successive terms; how does each gap change?” when that comparison is the intended task.

    See, watch, and read are banned as vague verbs, so the repair never trades one perception verb for another. Replacing these words with understand, distinguish or another stock verb does not repair an unclear task either. An explanation may simply state its relationship.

    A nomination in a title Tom approved is judged in context; he rejected a count-driven rewrite of approved titles on 2026-10-03. Judge the complete encounter under authored-meaning-and-stance.

    Examples this rule nominates:

    • “Name the assistant that goes and does the heavier work”
    • “See why access is what makes the help specific”
    • “Notice what you pay when you explain the same job every time”
    • “Tell a one-time request apart from a saved skill”

    What stays: specific, answerable comparison tasks; literal naming, perception and data access; and Tom's own wording. Established context may supply the object and criterion. The posted-notice noun and “tell” meaning instruct are ordinary uses. Judge missing meaning or unnecessary repeated framing, rather than the matched verb alone.

  • Review whether "rule" names the actual object

    WatchlistShared writing catcher

    Name the actual object or relationship. A derivative, function, mapping, recurrence, differential equation, constraint, or decision criterion needs its own precise name and meaning. For y' = f(y), the differential equation relates the amount to its rate; f is the rate function, and y' is the derivative.

    Choose from the mathematics in this passage instead of replacing every occurrence with one stock noun. Use “rule” when a rule is meant. This warning requests contextual judgment rather than automatic replacement; explicitly approved unchanged occurrences are retained by the reviewed-warning store.

    Examples this rule nominates:

    • “A dynamical system feeds each value back into one rule”
    • “the value the rule gives back unchanged”
    • “and the rule turns 10 into 15”
    • “Repeating a rule”

    Uses that stay:

    • Named rules: the chain rule, the product rule, the distributive rule, Cramer's rule, Simpson's rule, an exponent rule written out (“the rule $x^{-n} = 1/x^n$”), a rule of inference, a rule of thumb.
    • The rules of a game, a policy, a law, a style guide, or a software configuration, where no function of a value is meant.
    • A constraint a puzzle calls a rule (a unique game's rules), when the passage uses that field's own word.

    The match nominates a contextual review and gives no permission for blind replacement.

  • "Share" standing in for a fraction, probability, or weight

    WatchlistShared writing catcher

    In math and science prose, a part of a whole has a precise name: a fraction, a proportion, a probability, or a weight in an average. “Share” leaves the reader to guess which one is meant, and whether it is a number at all. Use the word that names the quantity.

    FlaggedRewrite
    “its share of the days”“the fraction of the days in it”
    “each cell is its row's share times its column's”“each cell's probability is its row's total times its column's total”
    “mixes the rows' bits in the same shares”“averages the rows' bits with the same weights, 3/4 and 1/4”

    Other examples this rule nominates:

    • “That swaps the shares”
    • “a share of deaths”

    Uses that stay:

    • The verb: two variables share 0.71 bits, two actors share a co-star, two series share history, neighboring characters share about 0.71 bits, two starts share six decimal places.
    • Shares of stock and a share in a company.
    • Market share and a fair share in writing about business or money.
    • A screen share or file share.

    The match nominates a contextual review and gives no permission for blind replacement.

  • Superlative asserted as fact

    WatchlistShared writing catcher

    A superlative asserted as bare fact about the science or the exposition (“the cleanest case”, “the sharpest controversy”, “the strongest argument”) claims a ranking the evidence rarely supports, and reads as a headline. State the specific property instead. The register to keep is science writing; a bare superlative reads like a YouTube headline.

    FlaggedRewrite
    “the cleanest physical case of a whole that does not come apart”“a physical case of a whole that does not come apart”
    “gave the field its cleanest map”“gave the field a clear map”

    Examples this rule nominates:

    • “the cleanest demonstration that modularity can evolve”
    • “the sharpest controversy in the field”
    • “Linearity Is the Gold Standard of Decomposability”

    Uses that stay:

    • Genuine mathematical terms of art keep the superlative and must not be rewritten: best rank-k approximation, best low-rank approximation, least upper bound, greatest common divisor, shortest path, steepest descent. “Best” is intentionally excluded from the pattern for this reason.
    • A standard, defensible descriptor for a named object can stay (the Ising model as the simplest model of a magnet).
    • A superlative the passage explicitly defines and earns over several sentences is borderline; keep it only if the definition does the work.
  • Exaggeration for effect

    WatchlistShared writing catcher

    A reader who checks an exaggerated magnitude finds a false claim. Verify the magnitude and state it literally.

    Before: “2^100 is larger than the number of atoms in the universe” (false: 2^100 is about 10^30, atoms about 10^80)

    After: “2^100 is about 1.27 × 10^30. At a billion operations per second, that many operations would take about 4 × 10^13 years”

    Cut “infinitely” unless the quantity is literally unbounded.

    Examples this rule nominates:

    • “larger than the number of atoms in the observable universe”
    • “infinitely harder to compute”
    • “breaks every rule of the model”

    Uses that stay: a literally true magnitude comparison. “Infinite” or “infinitely” for a genuinely unbounded mathematical quantity (an infinite series, an infinitely differentiable function) is correct and is not matched by the pattern.

  • Model conflated with the thing it represents

    WatchlistShared writing catcher

    A physical thing is described or represented by a mathematical object; it is not one. Correct the verb, and leave out philosophy-of-science commentary. See the applicable writing criterion.

    Before: “the three-photon state is literally an order-3 tensor”

    After: “quantum theory describes the three-photon state with an order-3 tensor”

    The model-property (tensor rank, treewidth) can track a real structural property. Keep that claim and fix the identity claim.

    Another example of the pattern: “the system is just a graph”

    The defect runs both ways. A formal object said to be a physical quantity or another model's quantity fails the same test: “the metric's time part is Newton's potential”, “the derivative is the viral-load growth rate”.

    Uses that stay:

    • Defining the mathematical object itself is fine and is not matched: “a tensor is a multi-way array of numbers”, “a vector is a list of numbers”.
    • A representation or role verb (is described by, is represented as, is modeled as, corresponds to, is given by, acts as, plays the role of, measures) is correct and must never be rewritten, including when copula-avoidance flags it.
  • Trendy verb (pins down)

    WatchlistShared writing catcher

    A theory, model, equation, or formal object describes, represents, specifies, determines, fixes, or is given by something. Saying that it "pins down" a result reads as a colloquial flourish.

    • "quantum theory pins down a pure state" becomes "quantum theory describes a pure state" or "specifies a pure state".
    • "the third axis pins down the factors" is another flagged example.

    Legitimate use. An ordinary idiom that stays clear in flowing prose can be kept, especially when a person or a measurement is the subject: "the number of yes-or-no questions needed to pin down its value". The target is a formal subject (a theory, model, equation, or axis) pinning down a result.

  • Trendy / cute verb (performing instead of stating)

    WatchlistShared writing catcher

    A trendy or cute verb performs instead of stating. The rule covers three families:

    • "smuggles in" and "unpacks"
    • a formal subject that "knows," "wants," or "tells you"
    • a mood verb that supplies affect with no mechanism: "snaps into focus," "comes due," "springs to life," "the payoff lands"

    Use a plain, accurate verb instead: rests on, assumes, requires, describes, specifies, determines, fixes. A figurative verb can stay when it names the actual mechanism, the way a spring "carries the push across."

    Flagged examples:

    • "the proof smuggles in continuity"
    • "the equation knows the answer"
    • "the method wants smooth data"
    • "the whole module snaps into focus"
    • "the opening weigh-in comes due"

    Legitimate uses.

    • An ordinary idiom that stays clear in flowing prose is fine, especially with a person as the subject: "the number of questions needed to pin down its value".
    • Literal unpacking (a box, an argument list, a suitcase) is fine; the figurative "unpacks the idea" is the target.
    • Literal "comes due" for a bill, loan, or deadline is fine; the figurative "the argument comes due" is the target.

    Scope among sibling rules. This rule is a sibling of trendy-verb-pins-down (which covers "pins down"), has-teeth, buys-payoff, and marketing-verbs in extended-rules.json (unlock, transform, supercharge, etc.). It covers only the verbs those rules do not, so "has teeth" and "buys you" stay with their own rules and are not re-flagged here.

  • Deferral / process-narration signpost

    WatchlistShared writing catcher

    This pattern takes two forms:

    • deferring the name or payoff of the concept under discussion, and
    • narrating the teaching move instead of performing it ("tracing that fact is the work of this lesson," "the rest of the course tours that middle ground," "the modules that follow take this up").

    Name the concept where you teach it and state its consequence there. State the content; the structure carries itself.

    Other flagged examples:

    • "the formal names arrive in the next section"
    • "we'll come back to this later"
    • "bear with me"
    • "Take them one at a time."

    Legitimate use. An ordinary forward cross-reference to a genuinely separate topic in another module is allowed and should be rare. The target is deferring the name or payoff of the concept being taught right now.

  • Significance captioning

    WatchlistShared writing catcher

    Let the specific fact carry its own weight: replace the caption with the consequence or distinction it was gesturing at.

    The same caption can close a sentence, as in "and that step is the part to practice" or "they're where the learning happens". Cut the tail, or say what the reader does next.

    Legitimate use. A literal part of a thing stays ("the part to the left of the equals sign"); the pattern needs a verb after "the part to".

  • Instructional scaffold (by understanding)

    WatchlistShared writing catcher

    When a sentence leans on the "by understanding" scaffold, name the action or comparison the learner can now perform.

  • Vague payoff cliche (whole story / heart of / changes everything)

    WatchlistShared writing catcher

    Phrases such as "the whole story," "the heart of," and "changes everything" make an empty payoff that gestures at importance instead of stating it. Replace the phrase with the concrete fact: what the one measurement is enough to determine, what specifically changes, or what the actual central mechanism is.

    "one thermometer per room tells the whole story"

    becomes

    "one thermometer per room is enough, because the desks in a room already match each other"

  • Value-teaser (announce the payoff instead of delivering it)

    WatchlistShared writing catcher

    A value-teaser is a sentence whose only job is to announce that a payoff is coming, which the next sentence then delivers:

    • "But here's the catch:"
    • "Here is the payoff of all that setup."
    • "Here's where it gets interesting."

    Delete the announcement and lead with the payoff itself: the time-saving fact, the point, or the result.

    "Here is the part that saves you time. Working with both is the same skill"

    becomes

    "Working with both is mostly the same skill, so learning one teaches you most of the other."

    Enforcement and exclusions. The writing-lint rule value-teaser enforces this at error severity. It excludes magic, secret, and trick, because those words routinely introduce a concrete artifact ("the secret key", "the magic number").

  • Formulaic explanatory closer (this lesson shows...)

    WatchlistShared writing catcher

    When several intros or sections all end with the same "this lesson shows..." template, the repetition reads as machine scaffolding. Vary the closer, or cut it and let the last concrete sentence carry the promise. Two alternatives work well: pose the question the piece answers, or state plainly what the reader will be able to do.

  • AI hedge phrase

    WatchlistShared writing catcher

    Remove an attention-announcing preface only when it contributes no substantive judgment. Under the applicable writing criterion, the revision preserves the author's scope, uncertainty, degree, conditions, and explanatory purpose. A qualified judgment of importance is not the same as announcing that a fact should be noted.

    Legitimate uses. Keep substantive assessments, qualifications, and intentional emphasis. Words such as usually, may, often, important, and very are not defects by themselves. Do not convert a judgment into an imperative or a certainty merely to remove a match.

  • Literal "illustrative" label on a hypothetical

    WatchlistShared writing catcher

    Frame a hypothetical with "Suppose," "Say," or "For example" instead of labeling it illustrative. The framing keeps an invented case from reading as a real record, without the stiff label.

    Flagged examples:

    • "Here is an illustrative case."
    • "An illustrative response: 'The proposal is due at 10:00.'"
  • Representation ranked without scope

    WatchlistShared writing catcher

    Do not rank representations as generically good or poor when the actual claim is task-scoped. Name the representation, the question it serves, and the structure it reveals or leaves mixed. Avoid implying that separability, linearity, or convenience is the only measure of representation quality.

    Flagged examples:

    • "a good representation makes a problem come apart into independent pieces, while a poor one hides them"
    • "a good basis reveals structure a poor one buried"

    Legitimate uses. A passage may compare representations after naming the task, metric, and tradeoff. Keep mathematically precise claims, such as well-conditioned bases or best rank-k approximation, when the criterion is explicit.

  • Filler phrase

    WatchlistShared writing catcher

    Tighten filler phrases to the word they stand for:

    FillerTightened
    "in order to""to"
    "due to the fact that""because"
    "at this point in time""now"
  • Unearned profundity

    WatchlistShared writing catcher

    Earn the weight with a specific fact instead of announcing a revelation.

  • Vapid opener

    WatchlistShared writing catcher

    Open with the actual situation, not a generic scene-setter.

  • Stock rhetorical question

    WatchlistShared writing catcher

    Answer a stock rhetorical question as a statement: "The result? Chaos." becomes "The result is chaos."

    Legitimate use. A genuine question that the passage then explores at length can stay.

  • Copula avoidance

    WatchlistShared writing catcher

    Fix only the puffed-up uses:

    Puffed-upPlain
    "serves as a reminder""reminds"
    "stands as a testament to"the specific claim
    "boasts a""has"

    Never turn a role verb into "is" when a model, equation, tensor, variable, or analogy stands in for a physical thing or for a quantity in another model. That rewrite creates model-reality-literal.

    Legitimate uses. Keep "acts as", "plays the role of", "serves as", and "functions as" when the subject is a formal object or analogy standing in for something else ("the metric's time part acts as Newton's potential", "pressure acts as a source of gravity"). These are the honest representation verbs.

  • Promotional language

    WatchlistShared writing catcher

    Drop the brochure adjective and state the concrete property.

    Exclusion. "robust" is intentionally excluded: it is a term of art in Tom's content (robust estimator, robustness).

  • Superficial -ing analysis

    WatchlistShared writing catcher

    Trailing participle phrases tack on fake depth. Make the claim a real clause, or cut it.

  • Vague attribution

    WatchlistShared writing catcher

    Name the study, author, or source. If there is none, drop the borrowed authority and make the claim in your own voice.

    Legitimate use. The attribution is fine when an actual citation follows in the same sentence or as a footnote.

  • Sycophantic filler

    InfoShared writing catcher

    Cut the servile filler and answer.

  • Overused word: magic

    WatchlistShared writing catcher

    Name the mechanism or effect instead of calling it magic.

  • Overused word: dance

    WatchlistShared writing catcher

    Choose a verb that names the actual movement, exchange, or relation instead of "dance".

    Legitimate use. Literal dancing is fine.

  • Generic coaching imperative with a personal-context tail

    WatchlistShared writing catcher

    This pattern pairs a generic command with a vague personal-context tail. Flagged examples:

    • "Choose a habit from the work in front of you"
    • "Set authority from the action in front of you"
    • "Choose a correction from the failures in your own work"

    Read the section and its neighboring headings first. Then state the particular insight, selection criterion, consequence, or concrete instruction that the command and its tail were hiding, and vary the expression with the idea. Synonym swaps and a uniform declarative replacement do not repair repeated syntax. See generic-coaching-imperative in the applicable writing criterion.

    Legitimate uses. Keep concrete instructions, meaningful ownership, literal spatial directions, and ordered procedures. A heading about an action already specified by its immediate context may be useful.

    What a match means. This is a candidate signal, not an authorship test or a ban on commands, prepositions, "you", or "your". Broader sibling rhythm requires editorial review.

  • Generic header formula

    WatchlistShared writing catcher

    Headers name the actual concept, mechanism, limitation, or learner decision. State the takeaway instead of a generic formula.

  • Overly absolute causal headline

    InfoShared writing catcher

    Compare the causal claim with its evidence and conditions, then rewrite an overstatement as the supported relationship. Do not mechanically add "can" or "may": a hedge word cannot rescue an unsupported or vague headline. Keep supported direct claims and definitions.

    Legitimate use. Definitions and tautologies are fine stated absolutely.

  • Review full-sentence emphasis

    InfoShared writing catcher

    Review the bolded selection against the full paragraph for centrality and standalone meaning, using the applicable writing criterion. A full sentence is normal emphasis. Correct a selection that is secondary or incomplete; do not shorten it merely because the detector found a complete sentence.

    Legitimate uses. Complete central claims are valid, including full sentences in neighboring paragraphs. The detector nominates text for semantic review and cannot establish a skimmability failure.

  • Emoji in professional output

    WatchlistShared writing catcher

    Drop the emoji. Tom's work copy and headings carry tone through word choice, not pictographs.

    Legitimate uses. Content genuinely about emoji, or a user-supplied quote that contains one.

  • Unicode formatting artifact

    InfoShared writing catcher

    Mathematical-styled unicode letters and zero-width characters are paste artifacts. Use plain letters and real markdown emphasis.

  • Colon-enumeration

    WatchlistShared writing catcher

    A colon-enumeration is powerful once, monotonous in bulk. To vary a run of them:

    • recast the list as cause, sequence, or pressure;
    • let one image carry it; or
    • use a periodic or cumulative sentence.

    A colon-to-period swap is not variation.

    Not enumerations. Quotes, clock times, and label prefixes (Note:, e.g.:).

  • Repeated sentence opening

    WatchlistShared writing catcher

    Vary how sentences enter: begin with a place, action, condition, image, claim, or consequence.

  • Repeated sentence architecture

    InfoShared writing catcher

    Mix short declaratives with cumulative sentences, and vary clause order and punctuation rhythm.

  • Same closing sentence appended across sibling strings

    WatchlistShared writing catcher

    The pattern appears when three or more strings in a set (directions, prompts, hints) end with the same added sentence, such as "Tap each one." It usually means a rewrite copied one example's shape onto every string.

    Drop the tail where the control or its status line already says it, and let each direction say what its own task needs.

    Legitimate use. A genuinely shared instruction that the interface does not show elsewhere may repeat. Judge the set, not the single string.

  • Heading set rewritten as thesis sentences

    WatchlistShared writing catcher

    The pattern is several titles, previews, or short labels in one set that are full claims of the same shape, for example "A search chooses among complete options" and "A map shows every option; a route is one search through it".

    Compare the set with the approved version. If these headings were rewritten, restore them unless a named defect required the change.

    When a heading may state its insight. On a selected discovery or independent practice task, the heading must not reveal the answer. Explanation and synthesis headings may state their insight. Follow the project's current heading contract, including its conditions for question headings; the October 3 correction does not require every screen to use discovery.

    Legitimate uses. Explanatory screens, essays, and reference pages may state findings in headings. Judge whether the set serves its ideas with natural variety, and whether a task's answer remains available for the learner to work out.

  • Staccato fragment run

    InfoShared writing catcher

    Give ideas full sentences. Fragments are seasoning, not the meal.

  • Cold imperative opening (review its purpose and context)

    WatchlistShared writing catcher

    Read the complete passage and its neighboring examples under the applicable writing criterion. A cold imperative can replace a definition, observation, or assumed situation, even once. "Call the hours, turns and shuffles elements" asks the reader to supply the term the explanation should give them.

    Before revising, decide the sentence's purpose and what the reader already knows. A descriptive statement may do the job directly; a hypothetical may need an explicit condition or introduction. Choose from the idea and its context, then read sibling strings for rhythm. Replacing every command with Suppose, Imagine, If you, You can, or one declarative formula repeats the problem.

    Other flagged examples:

    • "Turn a light on and the circuit closes."
    • "Load two sealed cargo boxes onto a truck. Weigh each box on its own, add the two numbers, and you have the answer. Now bind two protons and two neutrons into a helium-4 nucleus."
    • "Take two numbers and line them up. Multiply each pair of digits."

    Legitimate uses. Keep genuine instructions for actual tasks, controls, exercises, and procedures, including instructions nominated in flowing prose, with the warmth and pacing their purpose needs. A solitary thought-framing invitation such as "Picture a frictionless plane" is not itself a defect, though repeated invitations still need whole-set review. Preserve the author's qualifications, meaning, and degree of obligation.

    What a match means. This is a contextual warning, with no imperative quota or automatic replacement. The approximate catcher excludes balanced inline quotations, blockquotes, list steps, headings, Markdown table rows, and code. A match cannot establish that an instruction is inappropriate, and an empty scan cannot establish that the prose is natural.

  • Math variables without names

    WatchlistShared writing catcher

    Introduce a symbol with its meaning when needed:

    • "f(t) gives the room's temperature in degrees Celsius at time t, measured in minutes"
    • "N(i) lists the nodes linked to node i"

    A parenthetical name alone does not explain inputs, outputs, or units. Later shorthand can rely on established meaning within the same passage; a screen that readers can enter independently supplies a brief reminder where needed.

  • Cognitive projection (everyone)

    InfoShared writing catcher

    Tom's live checker flags every "everyone" as cognitive projection. Avoid universal claims about what everyone thinks, wants, or does; name the specific group or person.

    "Everyone knows the model is overconfident."

    becomes

    "Reviewers on the last three PRs flagged the model's overconfidence."

    Another flagged example: "Everyone wants the same thing."

    Legitimate use. Keep "everyone" when it is literally and provably true and specific ("everyone on the four-person team signed off"). Skip quotations.

    Detection note. The check is recall-first; the fixer dismisses provable universals.

  • Formulaic challenges-and-future section

    InfoShared writing catcher

    Boilerplate challenge and future sections gesture at complexity without supplying it. Replace them with specific events or facts, such as "Traffic congestion increased after 2015 when three IT parks opened".

    Flagged examples:

    • "Despite its strengths, the system faces several challenges."
    • "Challenges and Future Prospects"

    Legitimate use. Keep a genuine challenges section that names specific, concrete obstacles with evidence. The tell is template framing with no specifics. Skip quotations.

  • Commanded gratitude / commanded feeling

    InfoShared writing catcher

    In gratitude and meditation scripts, never instruct the listener to feel a prescribed emotion. Guide the seeing and let feeling arise. "Allow deep gratitude to fill your chest" becomes a specific thing to notice.

    Another flagged example: "Feel grateful now for the many hands that made this."

    Scope. This rule is project-scoped to the author's meditation work scripts. Skip quotations.

  • Contrastive superiority / tear-down positioning

    WatchlistShared writing catcher

    This pattern elevates the subject by denigrating vague alternatives ("most people", "traditional approaches", "theory"). Say what the thing is and let the reader draw the conclusion; never tell the reader everyone else is worse. This is the zero-sum framing that Tom's win-win value rejects.

    Flagged examples:

    • "something most experts never build: processes pulled from actual work, not theory"
    • "Unlike most platforms, this isn't just another framework."

    Legitimate use. Keep a specific, sourced comparison against a named alternative with real evidence, for example "unlike the 2019 protocol, which dropped packets above 1Gbps". The tell is vague unnamed inferiors, not a concrete benchmarked comparison.

  • Curly quotation marks

    InfoShared writing catcher

    Use straight quotes, not curly or smart quotes, which are a ChatGPT tell. Normalize “ ” ‘ ’ to " and '.

    Flagged examples:

    • "He said “hello” to her."
    • "It’s a test."

    Legitimate uses. Keep typographic quotes when a project's house style deliberately requires them, as some published-prose pipelines do. Skip code blocks and quotations of sources that use them meaningfully.

  • Corporate jargon / buzzwords (email)

    InfoShared writing catcher

    Strip corporate buzzwords. "As per our discussion" becomes "As the recipient mentioned"; drop "please don't hesitate" and let the warm close stand.

    Flagged examples:

    • "Let's circle back and touch base to move the needle."
    • "Please don't hesitate to reach out with any questions."

    Scope. The rule is email-scoped, but the jargon ban generalizes.

    Legitimate uses. Keep "bandwidth" in literal network or signal contexts, "streamline" where it names a specific process change, and "deep dive" in casual register if Tom uses it. Skip quotations.

  • Provide-value / self-promotional framing (email)

    InfoShared writing catcher

    In client email, do not frame a conversation as Tom giving value or showing what he can do. Reframe it as collaborative: learn about their goals, establish mutual fit, and map a plan.

    Flagged examples:

    • "I'd love to show you the value I can provide for your business."
    • "Here is what I can do for you."

    Scope. The rule applies to AI-consulting client email. Keep literal value discussions in pricing or contract contexts where value delivered is the explicit topic. Skip quotations.

  • Excessive balance / false even-handedness

    WatchlistShared writing catcher

    Presenting multiple perspectives even when unnecessary creates wishy-washy text. Make the claim the evidence supports. The stance here is critical objectivism: engage with what is actually true rather than performing balance.

    Flagged examples:

    • "On the other hand, while some argue X, others contend Y, and the debate continues."
    • "The truth likely lies somewhere in between, and only time will tell."

    Legitimate uses. Keep genuine two-sided analysis where both sides have real evidence and the piece's job is to weigh them. Keep "on the other hand" when it introduces a substantive counter-consideration. Skip quotations.

  • Excessive hedging

    WatchlistShared writing catcher

    Stacked qualifiers drain commitment. Collapse them to a single calibrated modal.

    "It could potentially possibly be argued that the policy might have some effect."

    becomes

    "The policy may affect outcomes."

    Another flagged example: "This might potentially help."

    Legitimate use. Keep a single appropriate hedge on a genuinely uncertain empirical claim; Tom hedges contingent causal claims on purpose. The tell is stacked qualifiers, not one honest modal. Skip quotations.

  • Exercise / lab meta-narration

    WatchlistShared writing catcher

    Do not narrate the structure of an exercise, or say that a lab is "designed to teach". Run the exercise directly and show the mechanism; the reader follows the steps, not a description of the format.

    Flagged examples:

    • "This exercise works by having you pause at each step."
    • "The lab below is designed to teach feedback."

    Legitimate use. Keep brief setup that genuinely orients the learner to a concrete task. Skip quotations.

  • Rhetorical literally/actual/physically on figurative claims

    WatchlistShared writing catcher

    Use "literally," "actual," and "physically" only when the claim is factually or materially true, never as rhetorical emphasis. Replace a figurative use with the accurate verb: quoted, echoed, mirrored, carried, embedded, appears within, registers as.

    "The proof literally tears the continuum apart"

    becomes

    "The proof splits the continuum into two cardinalities."

    Other flagged examples:

    • "Her discovery literally changed everything."
    • "The argument physically dismantles the objection."

    Legitimate uses (essential guard). Keep the word when the claim is literally, physically, or actually true: "the bridge literally collapsed", "the value is actually 42, not 41", "the heat physically deforms the rail". The word is correct far more often than not. Skip quotations.

  • False range (from X to Y)

    InfoShared writing catcher

    A false range uses "from X to Y" where X and Y are not on a meaningful scale. Replace it with a plain list of what is covered; "Everything from philosophy to breakfast cereal" becomes a direct list.

    Another flagged example: "from the Big Bang to dark matter, from stars to the cosmic web"

    Legitimate uses. Keep genuine ranges on a real scale:

    • numeric ("from 0 to 100")
    • temporal ("from 1990 to 2020")
    • spatial ("from the coast to the ridge")
    • ordered scales ("from novice to expert")

    Only the unscaled rhetorical "from X to Y" is the tell. Skip quotations.

    Detection note. The check is high recall; the fixer dismisses scaled ranges.

  • Filter phrases (telling perception instead of showing it)

    InfoShared writing catcher

    This rule applies only to deep-POV (immersive) fiction. In that kind of writing, a filter verb tells the reader that the character perceives something instead of showing what they perceive. Remove the filter verb and jump straight to what is perceived or thought.

    • Before: "I see the sunlight bouncing off the bar top."
    • After: "Sunlight bounces off the bar top, too bright, like it's interrogating me."

    Another flagged example: "She felt the cold creep into her hands."

    Where filter phrases are legitimate:

    • Technical, expository, email, or news prose, where "I think" and "we saw" are legitimate. Do not fire there.
    • Sentences where perception itself is the explicit subject.
    • Quotations: skip them.
  • Generic phrase blacklist (penalize on sight)

    InfoShared writing catcher

    These phrases announce significance or comprehensiveness while saying nothing checkable, so they are penalized on sight. Delete the phrase and rewrite directly with the concrete claim.

    Flagged examples:

    • "In today's world, the landscape of AI is a multifaceted, rich tapestry; it cannot be overstated that this is a game-changer."
    • "This serves as a reminder of the broader trend."

    Legitimate uses: "paradigm shift" stays when directly quoting or discussing Kuhn, and "tapestry" stays for a literal woven textile. Skip quotations.

  • Generic positive conclusion

    WatchlistShared writing catcher

    This flags vague upbeat endings. Replace one with a concrete next fact or plan.

    • Before: "The future looks bright."
    • After: "The company plans to open two more locations next year."

    Flagged examples:

    • "The future looks bright. Exciting times lie ahead."
    • "This is a step in the right direction."

    The false-positive risk is low. Skip quotations and anti-example blocks.

  • Heading-level skip

    InfoShared writing catcher

    Do not skip heading levels (jumping from H1/H2 straight to H3). Human writers rarely skip levels. To fix a skip, insert the intervening level or promote the heading.

    Flagged example: # Title then ### Subsection with no ## between.

    Exception: keep the structure when a documented component or MDX convention legitimately starts sections at a fixed level. Skip code blocks.

    Because detection requires scanning the heading sequence, implement the check as a structural pass.

  • Inline-header vertical list

    InfoShared writing catcher

    This flags list items that start with a bolded header and a colon and then restate the header in a sentence. Convert the list to flowing prose where it reads better, or strip the redundant restatement.

    Flagged examples:

    • - **Speed:** It is fast.
    • - **Performance:** Performance has been enhanced through optimized algorithms.

    Legitimate uses are genuine definition lists, glossaries, API parameter docs, and changelog entries, where the bold lead-in is a real label and the text after it is not a restatement. Skip quotations and code.

  • Significance signaling / intensifiers as proof

    WatchlistShared writing catcher

    An intensifier asserts importance without showing it. Drop the intensifier unless the same sentence gives exact evidence. Specificity, and claims that make the weight visible, are rewarded over assertions of importance. Name the concrete result, consequence, or limitation that justifies the word.

    Flagged examples:

    • "This is a crucial and profound insight with far-reaching implications."
    • "a deeply transformative, profoundly important breakthrough"

    Keep the word when:

    • It is technically precise: "critical point" in physics, "critical path" in scheduling, or "significant" in a statistics sentence reporting a p-value.
    • The same sentence supplies exact evidence that the intensifier summarizes.

    Skip quotations.

  • Knowledge-cutoff / availability disclaimer

    WatchlistShared writing catcher

    This flags AI disclaimers about incomplete information left in the text. Replace the disclaimer with a sourced fact, or cut it.

    • Before: "While specific details are limited... established in the 1990s"
    • After: "Founded in 1994, per its registration documents."

    Flagged examples:

    • "As of my last update, while specific details are limited based on available information..."
    • "up to my last training, the figure was unclear"

    Legitimate use: a genuine, dated data-currency note in a report where recency is the explicit subject, such as "data current as of Q1 2026". Skip quotations.

  • Marketing / brochure verbs

    WatchlistShared writing catcher

    Brochure verbs stand in for what something does. Replace them with concrete actions and plain verbs. They are banned especially in teaching content.

    • "Leverage" becomes "use".
    • "Harness" becomes the named mechanism.
    • "Empower" becomes the specific capability granted.

    Flagged examples:

    • "Unlock your potential and transform your workflow to take productivity to the next level."
    • "We leverage a holistic framework to empower learners."

    Legitimate uses:

    • "Leverage" as a finance or physics noun (financial leverage, mechanical leverage).
    • "Transform" in math and computer science senses (a Fourier transform, transform a matrix, data transformation).
    • "Empower" when describing literal legal authorization.

    Skip quotations.

  • Negative statement in meditation script

    InfoShared writing catcher

    Apply this only to the author's meditation work, in guided-script files. It would break ordinary prose, so never fire it on general prose.

    In meditation scripts, eliminate not, don't, isn't, no, never, nothing, and without, and say what things are: "stay relaxed" instead of "don't tense".

    Flagged examples:

    • "Don't let any tension remain; there is nothing you need to do."
    • "No effort is required."

    Skip quotations.

  • Mirror-cliche self-description

    InfoShared writing catcher

    Fiction only. In fiction, never have a character study a mirror to catalog their own appearance. Reveal appearance through contrast or through a salient, plot-relevant detail.

    Flagged example: "She looked in the mirror at her green eyes and long auburn hair."

    Legitimate uses: mirrors that serve plot or theme, such as a cracked mirror as a clue or a literal mirror in a physics demo. Skip quotations.

  • Negation of the unreal (describing what is NOT happening)

    WatchlistShared writing catcher

    This began as Tom's fiction rule and generalizes to all prose: do not negate a phantom alternative to assert what is happening. Delete the negated phantom and show the thing itself as concrete physical action or a direct claim.

    • Before: "The vertigo hit then, not metaphorical, actual."
    • After: "The vertigo hit. The room tilted. She gripped the counter."

    Another flagged example: "This wasn't just theory."

    Legitimate use: keep the negation when it genuinely disambiguates a term the reader would otherwise misread as figurative, in a context where both readings are live and the distinction is load-bearing. Skip quotations.

  • Obtuse fluff announcing significance or effort without a concept

    WatchlistShared writing catcher

    This flags sentences that announce importance, difficulty, or effort while conveying no concept: no checkable claim, mechanism, consequence, or specific.

    Known forms include:

    • "this is where it gets interesting"
    • "here is the thing"
    • "this is the crux"
    • "bear with me"
    • "stay with me"
    • "it cannot be overstated"
    • "let that sink in"
    • "read that again"

    The LLM monitor catches novel variants beyond this list.

    To fix one, delete the announcement and state the idea itself, or add the concrete claim the sentence promised.

    Flagged examples:

    • "Here's the thing: it changes everything."
    • "It cannot be overstated how important this is."

    Legitimate uses: keep a sentence that flags and immediately delivers a specific, checkable claim in the same breath. Do not fire on legitimate transitions that carry content. Skip quotations and anti-example blocks.

    This is a recall-first heuristic: the fixer or monitor dismisses sentences that do carry a concept.

  • Overstated intellectual genealogy

    WatchlistShared writing catcher

    Do not present interpretive lineages as settled one-way transmissions. First verify whether the evidence is documentary or interpretive. If it is interpretive, lower the claim with wording such as:

    • "in dialogue with"
    • "often read through"
    • "widely taken as"
    • "develops in relation to"
    • "frequently understood as carrying forward"

    Mark historical fact and interpretation as different kinds of claim.

    Flagged examples:

    • "Deleuze derived his concept of singularity straight from Scotus."
    • "Her method translated directly into the modern algorithm."

    Legitimate uses: keep the direct claim when documentary evidence supports it, such as a documented citation, a letter, or a stated influence. Keep literal translation of a text or language. Skip quotations.

  • Overused AI vocabulary (cluster tell)

    InfoShared writing catcher

    One or two uses of these words are coincidental. A cluster of five or six is a strong tell, and so is any single one that substitutes for specificity. Do not ban individual words by reflex; replace the ones that stand in for a concrete word.

    Flagged examples:

    • "Additionally, we leverage a robust, holistic framework to enhance the intricate tapestry of our ecosystem."
    • "a comprehensive, nuanced, multifaceted approach"

    Legitimate uses:

    • "Ecosystem" for literal ecology.
    • "Crucial" or "pivotal" where exact evidence follows.
    • "Utilize" or "enhance" where they carry precise technical meaning.
    • "Nuanced" where the nuance is then delivered.

    Density and vagueness make the tell; the word alone does not. Skip quotations.

  • Process-slogan / apparatus narration in titles or UI

    WatchlistShared writing catcher

    Do not narrate, in reader-facing copy including titles and UI, the agent's evaluation order, page structure, source-checking habit, or page apparatus. Name the news, the finding, the consequence, or the reader's subject.

    The rule also covers the apparatus vocabulary of the author's projects: "evidence trail", "source ledger", "the lab below", and "this page/section/module".

    Flagged examples:

    • "Facts Come Before Commentary"
    • "Source-Checked Before Framing"

    Legitimate use: keep the wording when the literal subject genuinely is a process or methodology being explained to the reader as content. Skip quotations and anti-example blocks.

  • Reality hierarchy between abstract and concrete

    WatchlistShared writing catcher

    State the reality of each level on its own terms, and say they are intertwined. Never adjudicate which is more real.

    The distinction to keep:

    • Degrees of alignment are real and encouraged. Alignment means how faithfully an expression embodies what it connects to.
    • Degrees of reality between abstract and concrete are forbidden.

    Ordinary emergence language, such as "a level above the genome", is fine.

    Flagged examples:

    • "The abstract essence of a need is more real than any particular strategy."
    • "The pattern transcends the particular instances."

    Legitimate uses: ordinary emergence or level language that does not rank realness, and "more real than" in quoted philosophical sources being reported. Skip quotations.

    Scope: this is the specific ontology of the abstract-evolution book. Outside that project, treat it as a watchlist item.

  • Rule-of-three / forced triad

    InfoShared writing catcher

    AI forces ideas into groups of three for false comprehensiveness. Two items often hit harder, and each item has to be there for a reason. Check whether a triad is padded ("fast, reliable, and scalable") or genuinely three distinct, necessary items.

    Another flagged example: "innovation, inspiration, and industry insights"

    The false-positive rate is high by design, because the check is recall-first, and the fixer should dismiss most hits. Keep any triad whose three members are genuinely distinct and necessary, technical enumerations, and lists that happen to have three real items. Flag clusters of several padded triads. Skip quotations and code.

  • Overused noun 'signal' (the author's news copy)

    InfoShared writing catcher

    Scope: casual news and product copy within the author’s news writing (project-scoped to the author’s news copy). There, do not use "signal"; reserve it for literal signal transduction or signal processing. Prefer entries, reports, readings, claims, patterns, or items.

    Flagged examples:

    • "This release is a strong signal of where coding agents are heading."
    • "The data sends a clear signal."

    Legitimate uses: literal and technical senses, such as signal transduction, signal processing, a radio signal, a traffic signal, or signal-to-noise. Skip quotations.

  • Significance / legacy / broader-trends inflation

    WatchlistShared writing catcher

    This flags puffing up importance by tying an arbitrary fact to a broader topic. Cut the inflation and state the concrete fact.

    • Before: "established in 1989, marking a pivotal moment in the evolution of regional statistics"
    • After: "established in 1989 to collect and publish regional statistics."

    Flagged examples:

    • "officially established in 1989, marking a pivotal moment in the evolving landscape"
    • "This stands as a testament to the project's enduring legacy."

    Legitimate uses: "deeply rooted" and "legacy" in literal botanical, genetic, or legacy-code senses. Skip quotations.

  • Simile crutch (like/as instead of an active verb)

    InfoShared writing catcher

    Scope: lyrical and creative prose. There, fold the comparison into the verb so the action carries the meaning.

    • Before: "The rain was like tears."
    • After: "Rain grieved down the window."

    Another flagged example: "Her voice was like gravel."

    Legitimate uses: do not fire in technical or expository writing, where "looks like" and "seemed like" are precise. Keep similes that genuinely earn their place. Skip quotations.

  • Spiritual vocabulary (gratitude/meditation voice)

    InfoShared writing catcher

    Scope: gratitude, meditation, and acknowledgment copy in the author's meditation work. In that copy, never assert reverence with spiritual vocabulary. Let reverence come from accurate description of the real process.

    Flagged examples:

    • "The sacred energy of the earth flows through this blessed material."
    • "This is your higher purpose manifesting."

    Legitimate uses: "manifest" in its ordinary verb sense ("symptoms manifest as fever"), "vibration" in physics, and "divine" as a verb ("divine the cause"). Skip quotations.

  • Reality-ranking reveal (the real X is Y)

    WatchlistShared writing catcher

    "The real X is Y" implies that other things are less real. Describe the thing directly.

    • Before: "The real skill isn't technical knowledge, it's being willing to ask."
    • After: "The skill is being willing to ask"

    Flagged examples:

    • "The real reason the build fails is a stale lockfile."
    • "What really matters is the data model."

    Legitimate use: keep the construction when distinguishing a genuinely misidentified cause, where the reader holds a specific wrong belief and the correction is concrete. Skip quotations.

  • Title-case heading

    WatchlistShared writing catcher

    AI capitalizes all main words in headings. Use sentence case: capitalize only the first word and proper nouns.

    • Before: ## How To Optimize Your Workflow
    • After: ## How to optimize your workflow

    Another flagged example: ## Strategic Negotiations And Global Partnerships

    Legitimate use: do not fire on headings dominated by proper nouns (names, product names, place names), where title case is correct. Skip quotations and code.

  • You Can

    WarningSite writing linter

    This check nominates capability framing, such as "you can", for review. How strongly a hit counts follows the shared catalog's current severity for the pattern.

  • Absolute Claims

    ErrorSite writing linter

    This check flags two kinds of overclaim:

    • AI behavior asserted as a bare universal, in headers and titles.
    • Hard causal overclaims.

    A capability claim must carry its condition. Say when, if, or that the tool can do something, never that it always does.

  • Vague Label

    ErrorSite writing linter

    This check flags self-referential, contentless labels, such as "apply this article", "a setup you can paste", or "putting X to work". Name the result the reader gets, or what the prompt does.

  • Vague Mental Verb

    WarningSite writing linter

    This check flags weak, vague mental-act and perception verbs:

    • "name"
    • "see"
    • "watch"
    • "read"
    • "notice"
    • "tell ... apart"

    These verbs invite a fuzzy internal step or a passive look. State the point, the result, or the check instead.

  • Aiism Redirect Signals

    WarningSite writing linter

    This check flags current probable AI-ism patterns as editorial redirect signals. A hit is neither proof of an AI-ism nor an automatic ban; it marks a sentence for an editor to reconsider.

  • Significance Signaling

    WarningSite writing linter

    This check flags stock phrases that announce significance instead of explaining it.

  • Contrastive Negation

    WarningSite writing linter

    This check flags formulaic "not X but Y" contrastive framing.

  • Causative Resultative

    WarningSite writing linter

    This check flags the shape "X gets Y ready": an abstract subject, a causative verb, and a resulting state. The construction can hide the action that produces the result.

  • Misapplied Compounding

    ErrorSite writing linter

    What it flags: uses of compounding to describe growth. Senses of the word that do not describe growth fall outside the check.

    What the review asks: compounding carries a requirement of actual exponential growth. Each flagged use is reviewed against that requirement. A use stands when the growth it describes is exponential, and it is misapplied when the growth is not.

    The error severity marks a hit for review on this site; it does not make the word a universal ban.

  • Economic Metaphor

    ErrorSite writing linter

    This check blocks figurative money language for the value of ideas, habits, or steps, such as "worth", "pays off", "payoff", and "earns its place". The condition is the figurative use: money words standing in for the value of an idea, a habit, or a step.

  • Prescriptive Singular

    ErrorSite writing linter

    This check flags stock numerical advice that hides the intended priority, trial, or completed result.

  • Numeric Prescription

    WarningSite writing linter

    This check requests contextual review of counted advice and output quotas. It covers numbers written as digits and larger numbers written out in words.

  • Revision Residue

    WarningSite writing linter

    This check flags finished prose that mentions discarded wording, an earlier draft, or the editor's correction. The finished text should state the corrected claim instead.

  • Circumvention Advice

    ErrorSite writing linter

    This check flags advice to route around an employer's controls, such as using a personal account to dodge a locked-down work account.

  • False Negation Reframe

    WarningSite writing linter

    This check flags "X is not a Y; it is a Z" reframes where the negation may be factually false. Denying an obvious category to sound sophisticated is a common AI writing tic.

  • Overused Ai Vocab

    WarningSite writing linter

    This check flags common model-default vocabulary. Stronger terms are caught immediately.

  • Superlative Claims

    ErrorSite writing linter

    This check flags unscientific superlative claims that assert a ranking without evidence.

  • Closed Set Enumeration

    ErrorSite writing linter

    This check flags closed-set enumerations such as "the N things you act on", which frame an open set as the complete, only set.

  • Concrete Not Metaphor

    ErrorSite writing linter

    This check flags phrasing that replaces a plain, concrete claim:

    • transport metaphors
    • placeholder action nouns
    • convolution phrasing
  • Value Teaser

    ErrorSite writing linter

    This check flags value-teaser fluff that announces a result is coming instead of delivering it.

    Flagged examples:

    • "Here is the part that saves you time"
    • "here's the catch"
    • "Here is the payoff"
    • "here's where it gets interesting"
  • Manufactured Expectation

    ErrorSite writing linter

    This check flags the manufactured-expectation straw man: the text tells the reader what to expect so it can knock that expectation down.

    Flagged examples:

    • "You might expect X... that is rarely how it works"
    • "You might expect to dig through menus. You do not."
  • Filler Real

    ErrorSite writing linter

    This check flags "real" used as an empty intensifier before a noun, where it adds no meaning.

  • Vapid Openers

    ErrorSite writing linter

    This check blocks generic opening frames that could introduce almost any AI article.

  • Unearned Profundity

    WarningSite writing linter

    This check flags dramatic gestures toward profundity that do not add information.

  • Filler Phrases

    WarningSite writing linter

    This check flags filler phrases that can usually be cut or simplified.

  • Rhetorical Fluff

    WarningSite writing linter

    This check flags sentences that announce importance without carrying the idea.

  • Mid Sentence Rhetorical

    WarningSite writing linter

    This check flags dramatic question-fragment transitions.

  • Copula Avoidance

    WarningSite writing linter

    This check flags inflated substitutes for is, are, and has.

  • Staccato Fragments

    WarningSite writing linter

    This check flags three or more consecutive very short sentences in one paragraph.

  • Declarative Stacking

    WarningSite writing linter

    This check flags four or more consecutive short declarative sentences in one paragraph, where each is subject-verb-object and 4 to 14 words long. The run marks syntactic monotony.

  • Conditional Opener Repetition

    WarningSite writing linter

    This check flags three or more paragraphs, within any sliding window of four, that open with conditional clauses such as "When X", "If X", "Once X", or "After X".

  • Restatement Padding

    WarningSite writing linter

    This check flags sentences that announce a redundant restatement of a point already made.

    Flagged openers:

    • "In other words,"
    • "What this means is,"
    • "The point is"
  • Generic Conclusions

    WarningSite writing linter

    This check flags empty conclusion lines.

  • Maya Name Ban

    ErrorSite writing linter

    This check blocks the overused placeholder name Maya in public content.

  • Manual Questionnaire

    ErrorSite writing linter

    This check blocks reader questionnaires embedded in books and guides, so that exercises become assistant-led prompt templates.

  • Marketing Vocab

    ErrorSite writing linter

    This check blocks the marketing verbs and slogans that the writing standards ban in teaching and article copy.

  • Not Only But Also

    WarningSite writing linter

    This check flags not only ... but also constructions.

  • Significance Adjectives

    WarningSite writing linter

    This check flags importance adjectives when they cluster.

  • Em Dashes

    ErrorSite writing linter

    This check blocks em dash punctuation, and also the double hyphen (--) used as an em dash substitute.

  • Editorial Scaffold Leak

    ErrorSite writing linter

    This check keeps private planning fields (source, action, result, review) out of learner-facing prose.

  • Contrastive Superiority

    WarningSite writing linter

    This check flags positioning that tears down unnamed others to sound superior.

  • List In Paragraph

    WarningSite writing linter

    This check flags inline numbered lists embedded in prose paragraphs.

  • Abstraction Denigration

    ErrorSite writing linter

    This check blocks using abstraction as a synonym for vagueness or useless theory.

  • Infrastructure Jargon

    WarningSite writing linter

    This check flags implementation-level MCP language in reader-facing article and guide text.

  • Unexplained Acronyms

    WarningSite writing linter

    This check nominates acronyms in headings, titles, and callout titles for review of whether the reader will know them in context.

  • Vague Referent

    WarningSite writing linter

    In teaching content, this check flags vague nouns such as "the system" or "the tool" when no specific referent is established nearby.

  • Stacked Jargon

    WarningSite writing linter

    In guide content, this check flags sentences with several technical terms stacked together.

  • Framing Self Reference

    WarningSite writing linter

    This check flags self-referential book framing:

    • announcing what "this book is about"
    • claiming that one sentence, loop, or idea carries or is the whole book
  • Imperative For Hypothetical

    WarningSite writing linter

    This check flags an imperative used to voice a hypothetical: a command verb coordinated with a consequence clause about a third party, with no conditional setup word.

  • Judgment As Endpoint

    WarningSite writing linter

    This check flags framing that treats human judgment as sacrosanct or as the final authority. The aim is the best aligned outcome, whether it comes from a human or from AI.

  • Primacy Ranking

    WarningSite writing linter

    This check flags claims that crown one factor or skill as primary, central, or the master key, when relative importance cannot be known.

  • Premature Universalization

    WarningSite writing linter

    This check flags one-cause soundbites that collapse a multi-causal idea into a single driver.

    Flagged phrasings:

    • "comes down to"
    • "all you need is"
    • "the one thing that drives it"

What the detectors cover

107
shared catcher entries
52
site linter entries
78
editorial reference entries
  • The editorial reference includes contextual requirements that have no executable detector. The shared catcher's hardBan count is not the full inventory of author requirements.
  • Shared regex patterns are included where maintained. Heuristic names and site descriptions are metadata, not runnable detector implementations or a complete standalone linter.
  • The shared catcher and site linter have overlapping coverage and different severities. Their entries are retained separately rather than presented as interchangeable checks.
  • This snapshot removes private provenance and inaccessible local references. Regeneration follows changes to the maintained owners; the revision identifies the published content.