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.
Updated November 6, 2026·Revision 4b98b5003337
- Plan the purpose, claims, audience and structure before drafting. Use representative examples across the kinds of work the author needs.
- Preserve the author's meaning, stance, qualifications and useful variation when revising.
- A match identifies text to inspect. Read its context and legitimate-use conditions before deciding what to change.
- Keep exact author requirements separate from contextual editorial judgment. Do not turn every warning into a ban.
- Repair the decision or production method behind a recurring defect. Replacing punctuation or substituting a synonym can leave the same problem in place.
- 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- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
—Flags g
Original wording
- Guidance
- Restructure with a colon, semicolon, comma, or participial phrase. The em dash gives prose an ad-copy cadence Tom never uses.
- Examples
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bnot\s+(?:just|merely|only|simply)\b[^.!?]{0,120}\bbut\b|\bit'?s\s+not\s+(?:just|about)\b[^.!?]{0,80}\bit'?s\bFlags gi
Original wording
- Guidance
- Lead with the positive claim. Delete the negated clause and read what remains; if the positive statement stands on its own, keep only that.
- Legitimate uses
- A single genuine correction of a real misconception can be legitimate. Flagging is still correct; the agent keeps it only when the negated belief is one a reader actually holds.
- Examples
- not just a tool, but a way of thinking
- it's not about speed, it's about depth
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.- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern matchQuotations are exempt.
- Candidate pattern
\b(?:does|do|did|is|are|was|were|isn'?t|aren'?t|won'?t|can'?t|couldn'?t|wasn'?t|weren'?t)\s+not\b[^.;!?]{0,80};\s+it(?:'?s)?\bFlags gi
Original wording
- Guidance
- 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, so grep for "not ...; it " after any rewrite (the applicable writing criterion no-contrastive-negation). Restructure the grammar: lead with the positive claim, lay out the competing territories so the reader feels the gap, or give a concrete illustration. Cut the negation entirely when the reader was never going to hold the wrong belief.
- Legitimate uses
- The banned thing is the grammatical template, not the act of correcting a genuine misconception (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 it 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.
- Examples
- The map does not store the route; it stores the rule.
- Mass is not intensive; it is extensive.
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”
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:mere|merely|purely|empty|sterile|vague|bloodless)\s+abstraction\b|abstraction\s+for\s+abstraction'?s\s+sake|\bnot\s+(?:just\s+|merely\s+)?(?:an?\s+)?abstract(?:ion)?\b|\bmore\s+than\s+(?:mere\s+)?(?:theory|abstraction)\b|(?:make|turn|render)s?\s+(?:the\s+|an?\s+)?abstract\s+\w+\s+(?:concrete|tangible|real)Flags gi
Original wording
- Guidance
- Abstraction is epistemically essential: it is a real pattern expressible in many concrete ways. Describe what the abstraction IS and does. Use "pair the concept with a concrete example", never "make the abstract concrete".
- Examples
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bmatters\s+because\b|\bmatter\s+because\bFlags gi
Original wording
- Guidance
- 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.”
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bthat\s+matters\b|\bthis\s+matters\b|\bwhy\s+this\s+matters\b|\bwhat\s+matters\s+is\bFlags gi
Original wording
- Guidance
- Do not caption importance. State the consequence, constraint, distinction, or mechanism that makes it weigh.
- Examples
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bfor\s+a\s+reason\bFlags gi
Original wording
- Guidance
- 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-canwatchlist rule.- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bis\s+(?:(?!\b(?:that|to|where|when|why|how|whether|if|because|so|as|while|although|though|unless|until|once|after|before)\b|[.!?,;:\n()[\]{}]).){1,120}(?<!\band\s)(?<!\bbut\s)(?<!\bor\s)\byou\s+can\b(?!['’]|\s+(?:no\s+longer|never)\b|\s+not\b(?!\s+only\b))\s+[a-z][a-z'-]*\bFlags gi
Original wording
- Guidance
- State the same definition or capability while preserving its qualifications and explanatory purpose. "The report is a record you can review after the run" becomes "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. Apply the applicable writing criterion
- Legitimate uses
- 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.
- Examples
- Your voice is a set of claims you can inspect
- The report is a record you can review after the run
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?![^.!?;\n]{0,150}\b(?:per|at\s+a\s+time|because|so\s+that|rather\s+than|instead\s+of|compared\s+with|versus|vs\.?|requires?|required|limit|capacity|slots?|fields?|schema|format)\b)(?:(?:find|choose|pick|do|make|take|focus\s+on|start\s+with)\s+(?:(?:just|only|the)\s+)?(?:one|single|1)\s+(?:(?:small|tiny|concrete|meaningful|focused|clear|simple|easy|quick|smart|key|practical|useful|grounded|honest|real|specific|deliberate|important|valuable|short|main|best)\s+)?(?:thing|way|action|step|move)\b|the\s+(?:one|single)\s+(?:thing|action|move|step|question|outcome|project|change|habit)\b|single\s+most\s+important\b)Flags gi
Original wording
- Guidance
- Explain the intended choice and the evidence that finishes the task. Read the surrounding passage to decide whether 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. "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" when that is the intended lesson. 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.
- Legitimate uses
- Keep quantities 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 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.
- Examples
- Find one way to improve your workflow
- Choose ONE thing and make it work
- Do the one thing
- Start with one small action
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.
Flagged Rewrite “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.Background
Added after “keeps paying rent” and “the payoff is leverage” shipped in lesson prose that only the narrower
buys-payoffregex was guarding.- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bpay(?:s|ing)?\s+(?:rent|dividends|off|for\s+itself|back)\b|\bpaid\s+off\b|\bpayoffs?\b(?!\s+(?:matri(?:x|ces)|functions?|tables?))|\brepays?\s+(?:the\s+)?(?:effort|attention|study|climb|time|reader|investment)\b|\bprice\s+of\s+admission\b|\bcurrency\s+of\b|\bcash(?:es|ed|ing)?\s+in\s+on\b|\bfor\s+free\b|\bearn(?:s|ed|ing)?\s+(?:you|us|(?:its?|their|a)\s+(?:own\s+)?(?:name|keep|place|spot|seat))\b|\bspend(?:s|ing)?\s+(?:your\s+|the\s+|more\s+)?(?:attention|focus)\b|\b(?:attention|cognitive|complexity)\s+(?:tax|budget|currency)\b|\b(?:pay(?:s|ing)?|paid)\s+(?:(?:out|you|extra|more|bonus)\s+)?(?:xp|points?|experience\s+points)\b|\b(?:answers?|questions?|tests?|retakes?|lessons?|habits?|success(?:es)?|takeaways?|quiz(?:zes)?|exercises?|drills?|practice)\s+(?:(?:never|only|always|also)\s+)?pays?\bFlags gi
Original wording
- Guidance
- The whole financial family is banned for describing intellectual or pedagogical value, not just "buys you": paying rent, payoff, 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, and a lesson, test, or answer that "pays" points or XP. State the concrete capability or consequence instead; for points, say what gives them ("Full tests pay XP for the habits that raise your score" becomes "Full tests give XP for the habits that raise your score"; "a wrong answer never pays" becomes "a wrong answer gets no XP"). "They keep paying rent" becomes "they have kept solving new problems in every century since"; "the payoff is leverage: prove one theorem and every system inherits it" becomes "a theorem proved once about the pattern holds in every system wearing that pattern"; "you get the second theorem for free" becomes "the second theorem follows at once". Hard ban in all authored prose , including pays off, earns its place/keep, spend attention, and cognitive budget or tax. Ordinary idioms of effort are not in the family: investing or spending time, energy, or effort is common usage and stays . Added after "keeps paying rent" and "the payoff is leverage" shipped in lesson prose that only the narrower buys-payoff regex was guarding. Sibling and generalization of buys-payoff, which keeps its own rule.
- Legitimate uses
- Literal money stays: 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"). Earning points or XP is the game's own verb and stays; only "pay" is flagged for points. Terms of art stay: payoff matrix, payoff function, payoff table in game theory (excluded by the pattern). Mathematical examples that are literally about money (bank deposits and withdrawals as integers) stay.
- Examples
- groups keep paying rent
- the payoff is leverage
- this subject repays the effort
- abstraction pays dividends later
- counting one hands you the other for free
- full tests pay XP for the habits that raise your score
- a wrong answer never pays
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
misappliedCompounding
Original wording
- Guidance
- In growth claims, use compounding only for actual exponential growth: successive gains proportional to the accumulated amount. Feedback, recursion, reuse, persistence, and improvements that help later improvements do not establish 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.
- Legitimate uses
- Keep literal technical uses such as compound interest, chemical compound, compound sentence, compound fracture, and compound microscope. Other growth uses require semantic review and evidence of actual exponential growth, with successive gains proportional to the accumulated amount. A number or the words exponential, multiplicative, recursive, or reinvested are not evidence by themselves. A disclaimer about an irregular rate does not excuse an unsupported growth claim.
- Examples
- 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
"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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:has|have|had|with|got|gives?\s+it|giving\s+it)\s+(?:real\s+|some\s+)?teeth\b(?=\s*[.,;:!?)]|\s*$)Flags gi
Original wording
- Guidance
- Name the actual force or consequence. "The rule has teeth" becomes "Violating the rule voids the warranty."
- Legitimate uses
- Literal anatomy ("sharks have teeth arranged in rows") is fine; the clause-end match targets the idiom.
- Examples
- the constraint finally has teeth
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.
Flagged Rewrite “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.
Background
Tom named read, watch, and see together as banned vague verbs on 2026-10-29.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern matchQuotations are exempt.
- Candidate pattern
(?<=^|[.!?:;]\s+|["“‘(\[>*#]\s*|^\s*[-*+]\s+)(?:Watch\s+(?!out\b)|See\s(?!\s|also\b|section\b|[`\[§\d])|Read\s+(?:why|how|what|about|more|less|on)\b)|\b(?:then|and|to|can|will|'ll|’ll)\s+watch\s+(?:as|how|what|whether|it|them|each|every|your)\b|\bwatch\s+(?:as|how|what|whether)\b|\b[Yy]ou(?:'ll|’ll|\s+will)\s+(?:see|watch)\bFlags gm
Original wording
- Guidance
- Say what the reader gets, what happens, what the control does, or what to check. "Watch your agent secure your computer, step by step" became "Choose what your agent secures and get a live report of each check"; "See all 12 steps" becomes "Show all 12 steps"; "See why access makes the help specific" states the reason. Trading one perception verb for another (watch, read, view, look at, observe) keeps the defect. Tom named read, watch, and see together as banned vague verbs on 2026-10-29.
- Legitimate uses
- 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; and Tom's own wording, which stays verbatim.
- Examples
- Watch your agent secure your computer, step by step
- See each AI term drawn, with an example from everyday work
- Copy the prompt, then watch each check update here.
- Read more
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.
Flagged Rewrite “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-functioncovers 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:next|same|better|best|smart|key|core|durable|portable|single|first|second|final|useful|important|main|big|small|one|two|three|four|five|six|few|these|those|each|every)\s+(?:move|moves|shape|shapes|signal|signals)\b|\b(?:the|this|that|same|a|one|your)\s+(?:move|shape|signal)\b|\b(?:lines|rules|examples|context|information|documents?)\s+(?:that (?:should )?|to |should )shape\bFlags gi
Original wording
- Guidance
- Write the exact action, structure, observation, criterion, or saved instruction. Use a concrete verb with its object and result: "the next move" becomes "compare both drafts"; "the lines that shape the reply" becomes "the lines the reply must reflect"; "progress signals" becomes "course activity, saved items, and test-outs"; "output shape" becomes "required sections and fields". A cold reader should not have to infer what changes, what evidence was observed, or which instruction applies.
- Legitimate uses
- Keep literal or defined uses: 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); and 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; it is not permission for blind replacement.
- Examples
- use the same four moves in both apps
- the lines that shape the reply
- what is your next move
- the next site learning signal
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
^#{1,6}[ \t]+(?:\*\*|__|\*|_)?(?:One|Two|Three|Four|Five|Six|Seven|Eight|Nine|Ten|Eleven|Twelve|ONE|TWO|THREE|FOUR|FIVE|SIX|SEVEN|EIGHT|NINE|TEN)(?![-‑])(?![ \t]+(?:of|in|on|at|by|or|to|more|another|day|way|time|times|minutes?|hours?|seconds?|days?|weeks?|months?|years?|mins?|hrs?|percent|cups?|eggs?|players?|people|dollars?|cents?)\b)[ \t]+\S[^\n]{0,70}$|^[ \t]*(?:[-*+][ \t]+)?\*\*(?:One|Two|Three|Four|Five|Six|Seven|Eight|Nine|Ten|Eleven|Twelve|ONE|TWO|THREE|FOUR|FIVE|SIX|SEVEN|EIGHT|NINE|TEN)(?![-‑])(?![ \t]+(?:of|in|on|at|by|or|to|more|another|day|way|time|times|minutes?|hours?|seconds?|days?|weeks?|months?|years?|mins?|hrs?|percent|cups?|eggs?|players?|people|dollars?|cents?)\b)[ \t]+[^*\n]{1,40}\*\*|^[ \t]*(?:One|Two|Three|Four|Five|Six|Seven|Eight|Nine|Ten|Eleven|Twelve|ONE|TWO|THREE|FOUR|FIVE|SIX|SEVEN|EIGHT|NINE|TEN)(?![-‑])(?![ \t]+(?:of|in|on|at|by|or|to|more|another|day|way|time|times|minutes?|hours?|seconds?|days?|weeks?|months?|years?|mins?|hrs?|percent|cups?|eggs?|players?|people|dollars?|cents?)\b)[ \t]+\p{L}[\p{L}'’]*(?:[ \t-]+\p{L}[\p{L}'’]*){0,3}[ \t]*[.:]?[ \t]*$Flags gmu
Original wording
- Guidance
- A count and a vague noun stand where the section's idea should be: 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, and 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 ("Choosing One Moment" to "Choosing a Moment" stays as vague). See `the applicable writing criterion`.
- Legitimate uses
- Keep a count that carries 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"), a title of a real work, or a heading that opens a claim ("One of the hardest problems ..."). Quoted source text stays as printed.
- Examples
- ## Two moves
- Four jobs
- **Two steps:**
- One proposal and four checks
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".
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:first\s+doorway|doorway\s+into|the\s+central\s+insight|starting\s+move|modest\s+but\s+powerful|this\s+unlocks|unlocks|the\s+key\s+is|at\s+its\s+core|the\s+secret\s+(?:is|to))\bFlags gi
Original wording
- Guidance
- Replace stock threshold language 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"), as does a product mechanic whose result is stated ("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:
Flagged Rewrite "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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
(?<!\bnet\s)\bworth(?:while)?\bFlags gi
Original wording
- Guidance
- Banned in every judgment sense . "Worth keeping", "worth testing", "worth it", "worth revisiting", "worthwhile", and "it's worth noting" borrow a money word to say something is good without saying what it does. State the concrete result, reason, or condition: "a prompt worth saving" becomes "a prompt you will run again next week"; "two flavors worth telling apart" becomes "the two cases call for different tests". A synonym swap (valuable, deserves, merits, rewarding) keeps the empty judgment and fails. Sibling of financial-metaphor.
- Legitimate uses
- Literal money stays: a price or amount ("$20 worth of credits"), net worth, an asset's market value, and explicit economics. Quotations and cited titles stay. Every other use is a hit; a scoped authorial judgment is not an exemption.
- Examples
- two flavors worth telling apart
- This decomposition is worth doing.
- a prompt worth saving
- Is the setup worth it?
- a worthwhile experiment
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
(?:^|\n)\s*(?:You want|You'?re|Imagine|Suppose|Say you|Picture|Think about|Consider when|Let'?s say)\b(?=[^.!?]{0,220}[.!?]\s+(?:(?:That|This|These|Those|Such)\b[^.!?]{0,80}\b(?:is|are|means?|refers\s+to|is\s+called|are\s+called)\b|(?:A|An)\s+[A-Za-z][A-Za-z0-9' -]{1,80}\s+(?:is|are|means?|refers\s+to|is\s+called|are\s+called)\b))Flags gi
Original wording
- Guidance
- 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.
- Legitimate uses
- Only treat as a hard ban inside definition/tooltip/glossary/callout contexts. In ordinary narrative prose a scenario opener is a legitimate hook, not a backwards definition. Do not fire when the same sentence both opens with a scenario AND the definition is genuinely absent (that needs the definition added, but downgrade to a fixer note outside definition surfaces). The catcher only fires when the scenario opener is immediately followed by a definition-like sentence.
- 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.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
contrastiveNegationCluster
Original wording
- Guidance
- Repeated negation hinges ("not X", "not merely", "more than just", "rather than") make prose think only by opposing abstractions. Name the actual force.
- Legitimate uses
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\byou\s+can\b(?!['’]|\s+(?:no\s+longer|never)\b|\s+not\b(?!\s+only\b))Flags gi
Original wording
- Guidance
- "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, or a definition padded with the reader's capability. Write each sentence from its own idea so the syntax varies; do not swap in another stock frame such as "lets you" or a command.
- Legitimate 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.
- Examples
- You can inspect each claim. You can compare the sources. You can save the result.
- Save a record so you can compare the results
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:[Cc]alled|[Kk]nown\s+as|[Nn]icknamed|[Rr]eferred\s+to\s+as)\s+(?:(?:the|a|an)\s+)?(?!(?:for|on|off|out|up|back|in|to|by|after|upon|it|them|him|her|me|us|you|this|that|these|those|its|his|their|my|our|your)\b|(?:the|a|an)\s+[^a-z\s])[a-z]Flags g
Original wording
- Guidance
- 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.
- Legitimate uses
- Other senses of the verb stay: 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.
- Examples
- 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.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?![^.!?;\n]{0,150}\b(?:per|at\s+a\s+time|because|so\s+that|rather\s+than|instead\s+of|compared\s+with|versus|vs\.?|requires?|required|limit|capacity|slots?|fields?|schema|format)\b)(?:(?:choose|pick|select|find|identify|name|list|write|draft|generate|create|produce|give|ask|offer|return|suggest|recommend|brainstorm|collect|capture|save|record|keep|try|test|plug\s+in|start\s+with|focus\s+on|come\s+up\s+with)\s+(?:(?:just|only|exactly|up\s+to|no\s+more\s+than|at\s+least|at\s+most|the\s+next|your\s+next)\s+)?(?:\d+|(?:twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety)(?:[-\s](?:one|two|three|four|five|six|seven|eight|nine))?|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|hundred|thousand)(?:(?:\s+(?:to|or)\s+|[–-])(?:\d+|(?:twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety)(?:[-\s](?:one|two|three|four|five|six|seven|eight|nine))?|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|hundred|thousand))?\s+(?:(?:small|tiny|concrete|meaningful|focused|clear|simple|easy|quick|smart|key|practical|useful|grounded|honest|real|specific|deliberate|important|valuable|short|main|best)\s+){0,3}(?:things?|ways?|actions?|steps?|moves?|tasks?|projects?|workflows?|habits?|questions?|outcomes?|changes?|improvements?|examples?|ideas?|options?|alternatives?|takeaways?|lessons?|points?|insights?|reasons?|sentences?|paragraphs?|bullets?|recommendations?|priorities|goals?|problems?|checks?|details?|values?|numbers?|connections?|opportunities|axes)\b(?!\s+(?:of|per|each|at\s+a\s+time)\b)|(?:for|choose|select|review)\s+(?:the\s+)?top\s+(?:\d+|(?:twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety)(?:[-\s](?:one|two|three|four|five|six|seven|eight|nine))?|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|hundred|thousand)(?:(?:\s+(?:to|or)\s+|[–-])(?:\d+|(?:twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety)(?:[-\s](?:one|two|three|four|five|six|seven|eight|nine))?|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|hundred|thousand))?\s+(?:(?:small|tiny|concrete|meaningful|focused|clear|simple|easy|quick|smart|key|practical|useful|grounded|honest|real|specific|deliberate|important|valuable|short|main|best)\s+){0,3}(?:things?|ways?|actions?|steps?|moves?|tasks?|projects?|workflows?|habits?|questions?|outcomes?|changes?|improvements?|examples?|ideas?|options?|alternatives?|takeaways?|lessons?|points?|insights?|reasons?|sentences?|paragraphs?|bullets?|recommendations?|priorities|goals?|problems?|checks?|details?|values?|numbers?|connections?|opportunities|axes)\b|(?:must|should|need\s+to)\s+(?:\w+\s+){1,6}?(?:at\s+least|at\s+most|no\s+more\s+than)\s+(?:\d+|(?:twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety)(?:[-\s](?:one|two|three|four|five|six|seven|eight|nine))?|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|hundred|thousand)(?:(?:\s+(?:to|or)\s+|[–-])(?:\d+|(?:twenty|thirty|forty|fifty|sixty|seventy|eighty|ninety)(?:[-\s](?:one|two|three|four|five|six|seven|eight|nine))?|one|two|three|four|five|six|seven|eight|nine|ten|eleven|twelve|thirteen|fourteen|fifteen|sixteen|seventeen|eighteen|nineteen|hundred|thousand))?\b|(?:(?:just|only)\s+)?one\s+(?:small|tiny|concrete|meaningful|focused|clear|simple|easy|quick|smart|key|practical|useful|grounded|honest|real|specific|deliberate|important|valuable|short|main|best)\s+\w+|smallest\s+(?:useful|possible|viable|honest|practical|complete|next)\b)Flags gi
Original wording
- Guidance
- Explain the intended choice and the evidence that finishes the task. Read the surrounding passage to decide whether 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. "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" when that is the intended lesson. 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.
- Legitimate uses
- Keep quantities 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 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.
- Examples
- Write three takeaways from the meeting
- Draft 12 ideas for the launch
- List twenty-five lessons from the trial
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:buys?|bought)\s+(?:you|us|me|them|the|some|a\s+lot|enough|little|nothing)\b|\bpurchas(?:e|es|ed)\s+(?:you|us|the|some)\b|\bthat\s+buys\bFlags gi
Original wording
- Guidance
- Name what actually becomes available. "The Jacobian buys you the easy version" becomes "For continuous-time dynamics near a fixed point, the Jacobian describes how a small displacement changes the velocity."
- Legitimate uses
- Literal commerce ("buys a house", "purchased the dataset license") is fine. Fires on the figurative payoff sense.
- Examples
- the Jacobian buys you the easy version
- that buys us a closed-form solution
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
revisionResidue
Original wording
- Guidance
- 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, not the revision history.
- Legitimate uses
- Editing instructions, redlines, changelogs, textual scholarship, and explicit comparisons of historical document versions may need revision history. The defect is residue inside finished reader-facing prose that should read as if the corrected claim had always been there. Preserve accurate quotations and source discussions.
- Examples
- 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
"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).
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:one\s+)?honest\s+(?:caveat|answer|truth|admission|note|confession)\b|\bto\s+be\s+honest\b|\bif\s+I'?m\s+honest\b|\bin\s+all\s+honesty\b|\bhonestly,Flags gi
Original wording
- Guidance
- Drop the hedge and state the caveat. "One honest caveat: the model ignores migration" becomes "The model ignores migration, so it overstates local extinction."
- Legitimate uses
- Prose genuinely about honesty as a subject (ethics, testimony, an honest day's work) is legitimate.
- Examples
- One honest caveat:
- to be honest, the estimate is rough
"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”
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:doing|does|do|did)\s+(?:all\s+|most\s+of\s+)?the\s+(?:heavy\s+lifting|work|hard\s+work)\b|\bheavy\s+lifting\b|\bcarr(?:y|ies|ied|ying)\s+the\s+weight\b|\bpull(?:s|ing)?\s+its\s+weight\b|\bdoing\s+the\s+work\s+here\bFlags gi
Original wording
- Guidance
- Name the mechanism. "The exponent is doing all the work" becomes "The exponent sets how fast error grows, so it alone decides whether the trajectory diverges."
- Examples
- 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.
Flagged Rewrite “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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:honest|real|true|genuine)\s+(?:middle|magic|question|story|reason|point|picture|deal|winner|culprit|driver|engine|insight|payoff|kicker|takeaway|answer|version|account|reading|cut|split|baseline|hero|star|heart|core|secret|beauty|power|trick|catch)\b|\b(?:genuinely|truly|really|honestly)\s+(?:\w+\s+)?(?:informative|remarkable|powerful|surprising|important|useful|elegant|beautiful|striking|fascinating|crucial|essential|profound|fundamental|insightful|impressive|extraordinary|special|unique|matters?|shines?)\bFlags gi
Original wording
- Guidance
- honest/real/true/genuine as emphasis asserts importance instead of showing it; the word adds nothing. State the property or mechanism directly. "the AND gate is the honest middle" becomes "the AND gate sits in the middle, mixing redundancy and synergy". "the real magic is X" becomes naming X. Keep the word only when it is load-bearing.
- Legitimate uses
- Technical terms keep the word: real numbers/analysis/part/line/-valued/-time/-world, true positive/negative/value/mean/north, truth value. "honest" about real honesty (testimony, an honest day's work) stays. A "real"/"true" that contrasts with a specific stated illusion the reader holds can stay; empty emphasis before a framing noun does not.
- Examples
- the AND gate is the honest middle
- that is where the real magic happens
- the truly remarkable part is the symmetry
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bslaved\s+to\b|\bslav(?:e|es|ing)\s+(?:the\s+|a\s+|them\s+|it\s+)?(?:fast|slow|variable|mode|modes|complex)\b|\bslaving\s+(?:principle|theorem|condition|works|relation)\b|\bmay\s+slave\b|\bsafely\s+slaved\bFlags gi
Original wording
- Guidance
- 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.
- Legitimate uses
- Prose about actual slavery (history, ethics, abolition, forced labor) is legitimate and must never be rewritten.
- Examples
- you may slave the fast variable
- the complex is slaved to the substrate
- Tikhonov's slaving theorem
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
(?<!\b(?:you|we|they|i)\s)(?:gets?|makes?|keeps?|leaves?|renders?|future[-\s]?proofs?)\s+(?:[\w'-]+[\s,]+){0,5}?(?:ready|done|working|set up|organi[sz]ed|reliable|consistent|durable|repeatable|future[-\s]?proof|bulletproof|safe|usable|portable|discoverable|searchable|testable|reusable|automatic|tractable|effortless|seamless|trustworthy|alive|intact|better|smarter|easier|faster|simpler|clear(?:er)?|self[-\s](?:correcting|documenting))\b|\bturns?\s+[^.?!\n]{1,60}\b(?:into|from)\bFlags gi
Original wording
- Guidance
- 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 usable capacity. Describe what learners do and what that prepares them to do. Literal physical causation, a defined mathematical transformation and an already explained mechanism can use makes, keeps or turns into accurately. They do not require an invented human actor. Preserve the author's explanatory or instructional purpose; do not turn an explanation into a command or swap the verb merely to clear the match. A short summary can rely on the mechanism established immediately before it.
- Legitimate uses
- Keep literal physical relationships, defined mathematical transformations, real actors doing specified actions, receive/create senses of get and make, and summaries whose mechanism is already available. A mechanism can be an explained relationship rather than a person acting. Preserve necessary qualification and authored stance.
- Examples
- one short assistant conversation gets the next session ready
- Practice turns concepts into capabilities
- Discovery makes skills usable
- Spaced resurfacing keeps ideas alive
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
(?:^|[.!?]\s)[\s"'*_>()-]*(?:Store|Tell|Give|Put|Add|Keep|Make|Ask|Send|Point|Hand|Show|Leave|Set|Drop|Paste|Type|Run|Open|Save|Write|Take|Move|Feed|Name|Mark|Pick|Skip|Delete|Remove|Sort|File|Split|Build|Create|Use|Read|Choose|Connect|Install|Click|Copy|Share|Lock|Hide|Load|Teach|Treat|Follow|Gather|Collect|Improve|Mix|Combine|Merge|Hold|Let|Trust)\b[^.?!\n]{0,80}?(?:,\s*)?(?:and|then)\s+[*_`]{0,2}\s*(?:every|each|no|nobody|no\s+one|none|everyone|everything|the\s+rest|the\s+whole|the\s+entire|the\s+other|most|nothing|another|neither)\b[^.?!;:\n]{0,40}?(?<!\b(?:the|a|an|your|its|our|their|his|her|my|this|that|each|every|no|some|any|one|another|you|it|they|we|i|he|she)\s)\b(?:works|reads|walks|becomes|goes|costs|gets|stops|loads|breaks|fails|wins|happens|appears|changes|stays|ends|starts|runs|shows|means|matters|follows|reaches|sees|holds|drifts|slips|misses|loses|falls|rises|grows|pulls|pushes|sits|lives|waits|skips|hears|inherits|diverges|splinters|forgets|ignores|skews|drags|lags|slides|snaps|lapses|rots|splits|starves|stalls|slows|leaks|scatters|spreads)\bFlags g
Original wording
- Guidance
- An imperative-mood command voices a hypothetical or illustrative scenario, not a real instruction, with no setup word to mark it as conditional. "Store one of those in a single tool and every other tool works without it" reads as a direction to store the rule in one tool, when the passage is describing the mistake of doing that. 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. Mark the hypothetical with a setup word or recast it as a declarative: "Store one of those in a single tool and every other tool works without it" becomes "If you keep one of those in a single tool, every other tool works without it."
- Legitimate uses
- 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, so the command is correct. The separator is the sentence's intended function: preserve genuine authored instructions, but do not convert a qualified recommendation or explanation into a command merely because its action might be useful. A genuine two-step instruction that continues with another bare imperative ("Read the path and state which jobs it covers") is not this pattern. A declarative sentence that merely coordinates two clauses ("The rule lives in one tool, and every other assistant works without it") is not an imperative and does not apply.
- Examples
- Store one of those in a single tool and every other tool works without it
- 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
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:name|naming)\s+(?:the|a|an|your|that|this|what|which|one|each|every|its|their|his|her|my|our|it|them)\b|\bsee\s+(?:why|how)\b|\b(?:you'?ll|you\s+will|we'?ll|we\s+will|let'?s)\s+see\b|\b(?:notice|noticing)\s+(?:the|a|an|your|that|this|what|which|how|why|when|where|one|each|every|its|their|his|her|my|our|it|them|you|we|they|he|she|i)\b|\btell(?:s|ing)?\s+[^.?!\n]{0,40}?\bapart\b|\btell\s+(?:the\s+)?differences?\bFlags gi
Original wording
- Guidance
- 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, and 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.
- Legitimate uses
- Preserve 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, not the matched verb alone.
- Examples
- 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
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;fis the rate function, andy'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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\brules?\bFlags gi
Original wording
- Guidance
- 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, not automatic replacement; explicitly approved unchanged occurrences are retained by the reviewed-warning store.
- Legitimate uses
- Named rules stay: 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. So do 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) stays when the passage uses that field's own word. The match nominates a contextual review; it is not permission for blind replacement.
- Examples
- 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
"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.
Flagged Rewrite “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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:its|their|his|her|our|your|a|an|the|same|equal|larger|smaller|bigger|largest|smallest|biggest|each|every|\p{L}+['’]s)\s+shares?\b(?!\s+(?:a|an|the|about|every|each|no|some|all|any|both|its|their|his|her|our|your|one|two|three|four|five|six|seven|eight|nine|ten|nothing|much|more|most|less|half|\d)\b)Flags giu
Original wording
- Guidance
- 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: "its share of the days" becomes "the fraction of the days in it"; "each cell is its row's share times its column's" becomes "each cell's probability is its row's total times its column's total"; "mixes the rows' bits in the same shares" becomes "averages the rows' bits with the same weights, 3/4 and 1/4". The verb stays: two variables share 0.71 bits, two actors share a co-star.
- Legitimate uses
- The verb stays: two series share history, neighboring characters share about 0.71 bits, two starts share six decimal places. So do shares of stock and a share in a company, market share and a fair share in writing about business or money, and a screen or file share. The match nominates a contextual review; it is not permission for blind replacement.
- Examples
- its share of the days
- That swaps the shares
- a share of deaths
- each cell is its row's share times its column's
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.
Flagged Rewrite “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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:cleanest|purest|sharpest|finest|clearest|simplest|deepest|strongest)\b|\bgold[- ]standard\bFlags gi
Original wording
- Guidance
- 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 cleanest physical case of a whole that does not come apart" becomes "a physical case of a whole that does not come apart"; "gave the field its cleanest map" becomes "gave the field a clear map". This is science writing, not a YouTube headline.
- Legitimate uses
- 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.
- Examples
- the cleanest demonstration that modularity can evolve
- the sharpest controversy in the field
- Linearity Is the Gold Standard of Decomposability
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:more|larger|bigger|greater|higher)\s+than\s+(?:the\s+)?(?:number\s+of\s+)?atoms\b|\binfinitely\s+(?:more|less|many|fewer|harder|easier|faster|slower|better|worse|smaller|larger)\b|\bbreaks?\s+every\s+rule\b|\bdefies?\s+all\bFlags gi
Original wording
- Guidance
- A reader who checks an exaggerated magnitude finds a false claim. Verify the magnitude and state it literally. "2^100 is larger than the number of atoms in the universe" (false: 2^100 is about 10^30, atoms about 10^80) becomes "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.
- Legitimate uses
- A literally-true magnitude comparison stays. "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.
- Examples
- larger than the number of atoms in the observable universe
- infinitely harder to compute
- breaks every rule of the model
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bis\s+(?:literally|just|simply|merely|nothing\s+but)\s+(?:an?|the)\s+(?:[\w-]+\s+){0,3}?(?:tensor|matrix|vector|graph|network|array)\bFlags gi
Original wording
- Guidance
- A physical thing is described or represented by a mathematical object; it is not one. "the three-photon state is literally an order-3 tensor" becomes "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. Do not add philosophy-of-science commentary; correct the verb. See the applicable writing criterion
- Legitimate uses
- 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. The defect runs both ways: a formal object said to BE a physical quantity or another model's quantity ("the metric's time part is Newton's potential", "the derivative is the viral-load growth rate") fails the same test.
- Examples
- the three-photon state is literally an order-3 tensor
- the system is just a graph
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bpins?\s+down\b|\bpinned\s+down\bFlags gi
Original wording
- Guidance
- A theory, model, equation, or formal object describes, represents, specifies, determines, fixes, or is given by something; it does not "pin down" a result, which reads as colloquial flourish. "quantum theory pins down a pure state" becomes "quantum theory describes a pure state" or "specifies a pure state".
- Legitimate uses
- An ordinary idiom that stays clear in flowing prose can be kept, especially with a person or a measurement as 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.
- Examples
- quantum theory pins down a pure state
- the third axis pins down the factors
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.
Background
The source grounds this rule in the applicable writing criteria, including move 4, and cites the applicable writing criterion for the idiom guard.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bsmuggl(?:e|es|ed|ing)\s+in\b|\bunpack(?:s|ed|ing)\s+(?:how|why|what|the\s+(?:idea|concept|notion|intuition|argument|claim|meaning|logic|details?|implications?|nuances?|mechanism)|this|that)\b|\b(?:equation|formula|model|theory|method|proof|axiom|theorem|function)\s+(?:knows|wants)\b|\b(?:equation|formula|model|theory|method|proof|axiom|theorem)\s+tells\s+you\b|\bsnaps?\s+into\s+focus\b|\bcomes?\s+into\s+focus\b|\bsprings?\s+to\s+life\b|\bcomes?\s+(?:due|alive)\b|\bthe\s+(?:whole\s+)?(?:payoff|picture)\s+(?:lands|arrives|comes\s+together)\bFlags gi
Original wording
- Guidance
- A verb performing instead of stating: "smuggles in," "unpacks," a formal subject that "knows," "wants," or "tells you," or a mood verb that supplies affect with no mechanism ("snaps into focus," "comes due," "springs to life," "the payoff lands") (the applicable writing criterion, the applicable writing criterion, the applicable writing criterion move 4). Use a plain, accurate verb: rests on, assumes, requires, describes, specifies, determines, fixes. Keep a figurative verb only when it names the actual mechanism, the way a spring "carries the push across." 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.); this rule covers only the verbs those rules do not.
- 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" (the applicable writing criterion). 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. "has teeth" and "buys you" stay with their own rules and are not re-flagged here.
- 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
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.
Background
The source cites the applicable writing criteria by name: deferred-payoff, no-process-narration, and moves 1-2.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bthe\s+formal\s+names?\s+(?:arrive|arrives|come|comes)\b|\bwe(?:\s+will|'?ll)\s+name\s+this\s+later\b|\bwe(?:\s+will|'?ll)\s+(?:come\s+back\s+to|return\s+to)\b|\bcomes\s+later\s+in\s+this\s+(?:lesson|section|chapter)\b|\ba\s+later\s+(?:module|section|chapter)\s+gives\s+this\s+its\s+name\b|\bafter\s+you\s+have\s+seen\s+more\s+cases\b|\bmore\s+on\s+this\s+later\b|\bas\s+we'?ll\s+see\b|\b(?:bear|stay)\s+with\s+me\b|\bthis\s+is\s+where\s+it\s+gets\b|\btake\s+them\s+one\s+at\s+a\s+time\b|\bnow\s+the\s+name\s+can\s+land\b|\bthat\s+is\s+the\s+whole\s+test\b|\bpicture\s+the\s+contrast\s+directly\b|\bthe\s+work\s+of\s+this\s+(?:lesson|module|section)\b|\bthe\s+rest\s+of\s+the\s+(?:course|module|lesson)\s+(?:tours|covers|works\s+through|takes\s+up|walks|will)\b|\bthe\s+modules?\s+that\s+follows?\b|\byou\s+will\s+see\s+when\b|\bthis\s+(?:module|lesson|section)\s+(?:follows|traces|tours|takes\s+up|walks\s+you)\bFlags gi
Original wording
- Guidance
- Deferring the name or payoff of the concept under discussion, or 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 (the applicable writing criterion deferred-payoff; the applicable writing criterion no-process-narration; the applicable writing criterion moves 1-2). State the content; the structure carries itself.
- Legitimate uses
- An ordinary forward cross-reference to a genuinely separate topic in another module is allowed and should be rare (the applicable writing criterion). Deferring the name or payoff of the concept being taught right now is the target.
- 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.
- tracing that fact is the work of this lesson
- the rest of the course tours that middle ground
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".
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:is\s+important\s+because|is\s+significant\s+because|plays?\s+(?:a\s+)?(?:key|central|important|pivotal|crucial|vital)\s+role|marks?\s+a\s+(?:turning\s+point|pivotal|key)|the\s+(?:significance|importance|meaning)\s+of|(?:is|are|that(?:'|’)s)\s+the\s+part\s+to\s+(?:practice|remember|learn|notice|watch|focus\s+on|work\s+on|get\s+right)|(?:is|are|(?:they|we|you|these|those|that)(?:'|’)(?:re|s))\s+where\s+the\s+(?:real\s+)?(?:learning|work|growth|progress)\s+happens|is\s+what\s+to\s+(?:practice|remember|watch\s+for))\bFlags gi
Original wording
- Guidance
- Let the specific fact carry its own weight. Replace the caption with the consequence or distinction. The same caption can close a sentence ("and that step is the part to practice", "they're where the learning happens"): cut the tail, or say what the reader does next.
- Legitimate uses
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bby\s+understanding\bFlags gi
Original wording
- Guidance
- 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"
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\btells?\s+(?:you\s+|us\s+)?the\s+whole\s+story\b|\bthe\s+whole\s+story\b|\btells?\s+you\s+everything\b|\bat\s+the\s+heart\s+of\b|\bchanges?\s+everything\b|\bdecides?\s+everything\b|\bpaints?\s+a(?:\s+vivid)?\s+picture\b|\bcaptures?\s+the\s+essence\bFlags gi
Original wording
- Guidance
- Empty payoff that gestures at importance instead of stating it. Replace 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".
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bthis\s+(?:lesson|module|section|chapter|article|piece|post)\s+(?:shows|reveals|traces|explores|explains|covers|teaches|is\s+about|will\s+show|walks)\bFlags gi
Original wording
- Guidance
- When several intros or sections all end with the same "this lesson shows..." template, the repetition reads as machine scaffolding. Vary it, or cut it and let the last concrete sentence carry the promise. 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bit'?s\s+worth\s+noting\b|\bit\s+is\s+important\s+to\s+note\b|\bit\s+should\s+be\s+noted\b|\bneedless\s+to\s+say\b|\bin\s+conclusion\b|\bdelve\s+into\b|\bone\s+might\s+argue\b|\bat\s+the\s+end\s+of\s+the\s+day\b|\bsuffice\s+(?:it\s+)?to\s+say\bFlags gi
Original wording
- Guidance
- Remove an attention-announcing preface only when it contributes no substantive judgment. Preserve the author's scope, uncertainty, degree, conditions, and explanatory purpose under the applicable writing criterion 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 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.'"
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:here\s+is\s+)?an?\s+illustrative\s+(?:case|example|response|reply|scenario|output|draft|email|entry|consultant|person|brief|exchange)\bFlags gi
Original wording
- Guidance
- 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.
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:good|right|better)\s+(?:representation|basis|coordinate\s+system)\b[^.!?]{0,180}\b(?:poor|bad|wrong)\s+(?:one|representation|basis|coordinate\s+system)\b|\b(?:poor|bad|wrong)\s+(?:representation|basis|coordinate\s+system)\b[^.!?]{0,180}\b(?:good|right|better)\s+(?:one|representation|basis|coordinate\s+system)\bFlags gi
Original wording
- Guidance
- 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.
- 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.
- 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
Filler phrase
WatchlistShared writing catcher
Tighten filler phrases to the word they stand for:
Filler Tightened "in order to" "to" "due to the fact that" "because" "at this point in time" "now" - Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bin\s+order\s+to\b|\bdue\s+to\s+the\s+fact\s+that\b|\bat\s+this\s+point\s+in\s+time\b|\bfor\s+all\s+intents\s+and\s+purposes\b|\bthe\s+fact\s+of\s+the\s+matter\s+is\b|\bin\s+the\s+process\s+of\b|\bwhen\s+it\s+comes\s+to\bFlags gi
Original wording
- Guidance
- Tighten: "in order to" becomes "to"; "due to the fact that" becomes "because"; "at this point in time" becomes "now".
Unearned profundity
WatchlistShared writing catcher
Earn the weight with a specific fact instead of announcing a revelation.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:everything\s+changed|something\s+shifted|and\s+that\s+changes\s+everything|let\s+that\s+sink\s+in|read\s+that\s+again|here'?s\s+the\s+thing|here'?s\s+the\s+truth|but\s+here'?s\s+the)\bFlags gi
Original wording
- Guidance
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bin\s+today'?s\s+(?:fast-paced|rapidly\s+evolving|digital|modern)\b|\bas\s+technology\s+continues\s+to\s+evolve\b|\bin\s+a\s+world\s+where\b|\bin\s+an\s+(?:era|age)\s+(?:of|where)\bFlags gi
Original wording
- Guidance
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
(?:^|[.!?]\s+)(?:The\s+(?:result|catch|culprit|problem|upshot|takeaway|kicker)|Why\s+does\s+this\s+matter|So\s+what)\?Flags gm
Original wording
- Guidance
- Answer the question as a statement. "The result? Chaos." becomes "The result is chaos."
- Legitimate uses
- A genuine question the passage then explores at length can stay.
Copula avoidance
WatchlistShared writing catcher
Fix only the puffed-up uses:
Puffed-up Plain "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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:serves\s+as|stands\s+as|acts\s+as|functions\s+as)\b|\bboasts\s+a\bFlags gi
Original wording
- Guidance
- Fix only the puffed-up uses: "serves as a reminder" becomes "reminds", "stands as a testament to" becomes the specific claim, "boasts a" becomes "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).
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:vibrant|groundbreaking|seamless|cutting-edge|game-?changer|revolutionary|nestled|in\s+the\s+heart\s+of|rich\s+tapestry|breathtaking|stunning|world-class|state-of-the-art)\bFlags gi
Original wording
- Guidance
- Drop the brochure adjective and state the concrete property.
- Legitimate uses
- "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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
,\s+(?:highlighting|underscoring|emphasizing|reflecting|symbolizing|showcasing|fostering|cultivating|encompassing|illustrating|demonstrating|reinforcing)\bFlags gi
Original wording
- Guidance
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:studies\s+have\s+shown|research\s+suggests|experts\s+(?:argue|say|believe)|it\s+is\s+widely\s+believed|some\s+critics\s+argue|according\s+to\s+sources|industry\s+reports)\bFlags gi
Original wording
- Guidance
- Name the study, author, or source. If there is none, drop the borrowed authority and make the claim in your own voice.
- Legitimate uses
- Legitimate when an actual citation follows in the same sentence or as a footnote.
Sycophantic filler
InfoShared writing catcher
Cut the servile filler and answer.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:great\s+question|you'?re\s+absolutely\s+right|excellent\s+point|happy\s+to\s+help|I\s+hope\s+this\s+helps)\b|\b(?:Certainly|Absolutely)!Flags gi
Original wording
- Guidance
- Cut the servile filler and answer.
Overused word: magic
WatchlistShared writing catcher
Name the mechanism or effect instead of calling it magic.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:magic|magical|magically)\bFlags gi
Original wording
- Guidance
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:dance|dances|danced|dancing)\bFlags gi
Original wording
- Guidance
- Choose a verb that names the actual movement, exchange, or relation.
- Legitimate uses
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
^(?:#{1,6}\s+)?(?:Choose|Pick|Find|Start|Build|Make|Turn|Bring|Use|Set|Take|Apply|Match|Connect|Keep|Carry|Give|Put|Name|See|Notice|Learn|Shape|Grow|Design|Plan|Try|Identify|Practice)\b[^\r\n.!?]{0,160}\b(?:in\s+front\s+of\s+you|(?:in|from|around|for|to|with)\s+your\s+(?:own\s+)?(?:work|life)|work\s+you\s+(?:already\s+)?(?:do|repeat)|(?:with|from)\s+what\s+you\s+(?:already\s+)?(?:have|do|repeat))\s*[.!?]?\s*$Flags gim
Original wording
- Guidance
- Read the section and neighboring headings. State the particular insight, selection criterion, consequence, or concrete instruction hidden by the command and vague personal-context tail. 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. This is a candidate signal, not an authorship test or a ban on commands, prepositions, you, or your. Broader sibling rhythm requires editorial review.
- 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
Generic header formula
WatchlistShared writing catcher
Headers name the actual concept, mechanism, limitation, or learner decision. State the takeaway instead of a generic formula.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
^#{1,6}\s+(?:Why\s+.+\s+matters|What\s+.+\s+teaches|How\s+.+\s+changes\s+everything|The\s+(?:key|secret|power|truth)\s+of\s+.+)\s*$Flags gim
Original wording
- Guidance
- Headers name the actual concept, mechanism, limitation, or learner decision. State the takeaway.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
^#{1,6}\s+(?!.*\b(?:[Cc]an|[Mm]ay|[Oo]ften|[Tt]ends?\s+to|[Ss]ometimes|[Nn]ot\s+[Nn]ecessarily)\b).*\b(?:[Ee]nables?|[Cc]reates?|[Pp]roduces?|[Dd]etermines?|[Dd]rives?|[Pp]revents?|[Ee]nsures?|[Gg]uarantees?)\s+\wFlags gm
Original wording
- Guidance
- Compare the causal claim with its evidence and conditions. Rewrite an overstatement as the supported relationship; do not mechanically add can or may, which cannot rescue an unsupported or vague headline. Keep supported direct claims and definitions.
- Legitimate uses
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
fullSentenceBolding
Original wording
- Guidance
- Review the selection against the full paragraph for centrality and standalone meaning using the applicable writing criterion A full sentence is normal emphasis. Correct a secondary or incomplete selection; do not shorten it merely because the detector found a complete sentence.
- Legitimate uses
- Complete central claims, including full sentences in neighboring paragraphs, are valid. This 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\p{Extended_Pictographic}Flags gu
Original wording
- Guidance
- 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, is legitimate.
Unicode formatting artifact
InfoShared writing catcher
Mathematical-styled unicode letters and zero-width characters are paste artifacts. Use plain letters and real markdown emphasis.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
[\u{1D400}-\u{1D7FF}\u200B\u200C\u200D\uFEFF]Flags gu
Original wording
- Guidance
- 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.:).
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
colonEnumeration
Original wording
- Guidance
- Powerful once, monotonous in bulk. Recast as cause, sequence, or pressure; let one image carry it; use a periodic or cumulative sentence. A colon-to-period swap is not variation.
- Legitimate uses
- Quotes, clock times, and label prefixes (Note:, e.g.:) are not enumerations.
Repeated sentence opening
WatchlistShared writing catcher
Vary how sentences enter: begin with a place, action, condition, image, claim, or consequence.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
repeatedOpening
Original wording
- Guidance
- Vary entries: begin with 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
syntacticClustering
Original wording
- Guidance
- Mix short declaratives with cumulative sentences; 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
siblingRepeatedTail
Original wording
- Guidance
- Three or more strings in a set (directions, prompts, hints) end with the same added sentence, such as "Tap each one." 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 uses
- 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.
Background
Tom described this pattern as "redundant 'A ___ does ___'" titles.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
siblingThesisHeadingRun
Original wording
- Guidance
- Several titles, previews, or short labels in one set are full claims of the same shape ("A search chooses among complete options", "A map shows every option; a route is one search through it"). Tom called it "redundant 'A ___ does ___'" titles. Compare with the approved version: if these headings were rewritten, restore them unless a named defect required the change. 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
staccatoFragmentRun
Original wording
- Guidance
- 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
unframedImperativeStaging
Original wording
- Guidance
- Read the complete passage and 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. Decide the sentence's purpose and what the reader already knows before revising. 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. This is a contextual warning, with no imperative quota or automatic replacement.
- 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. The approximate catcher excludes balanced inline quotations, blockquotes, list steps, headings, Markdown table rows and code. A solitary thought-framing invitation such as "Picture a frictionless plane" is not itself a defect; repeated invitations still need whole-set review. A match cannot establish that an instruction is inappropriate, and an empty scan cannot establish that the prose is natural. Preserve the author's qualifications, meaning and degree of obligation.
- Examples
- Call the hours, turns and shuffles elements.
- 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.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
bareVariableCluster
Original wording
- Guidance
- Introduce a symbol with its meaning when needed: "f(t) gives the room's temperature in degrees Celsius at time t, measured in minutes" or "N(i) lists the nodes linked to node i". A parenthetical name alone does not explain inputs, outputs or units. Later shorthand can use established meaning within the same passage; an independently entered screen 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\beveryone\bFlags gi
Original wording
- Guidance
- Tom's live checker flags every 'everyone' as cognitive projection. Avoid universal claims about what everyone thinks/wants/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.'
- Legitimate uses
- Keep when 'everyone' is literally and provably true and specific ('everyone on the four-person team signed off'). Recall-first; the fixer dismisses provable universals. Skip quotations.
- Examples
- Everyone knows the model is overconfident.
- Everyone wants the same thing.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:Despite (?:its|these) (?:strengths|challenges|prosperity)|Challenges and (?:Legacy|Future|Prospects)|Future Outlook|faces? several challenges)\bFlags gi
Original wording
- Guidance
- Boilerplate challenge/future sections that gesture at complexity without supplying it. Replace with specific events or facts ('Traffic congestion increased after 2015 when three IT parks opened').
- Legitimate uses
- Keep a genuine challenges section that names specific, concrete obstacles with evidence. The tell is template framing with no specifics. Skip quotations.
- Examples
- Despite its strengths, the system faces several challenges.
- Challenges and Future Prospects
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.
- Scope
- Tom's preferences for meditation writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to meditation.
- Candidate pattern
\b(?:feel (?:grateful|gratitude)|let (?:gratitude|it) fill|allow (?:deep )?gratitude|notice the gratitude (?:arising|filling)|gratitude (?:fill|fills|filling) your)\bFlags gi
Original wording
- Guidance
- In gratitude/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. Project-scoped.
- Legitimate uses
- Scope to the author's meditation work scripts. Skip quotations.
- Examples
- Allow deep gratitude to fill your chest.
- Feel grateful now for the many hands that made this.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:unlike most|not just another|not theory|what most (?:people|experts) (?:never|don'?t)|while others struggle|beyond what typical|where most (?:fail|fall short)|that others overlook|separates \w+ from)\bFlags gi
Original wording
- Guidance
- Elevating 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 Tom's win-win value rejects.
- Legitimate uses
- Keep a specific, sourced comparison against a NAMED alternative with real evidence (e.g. 'unlike the 2019 protocol, which dropped packets above 1Gbps'). The tell is vague unnamed inferiors, not a concrete benchmarked comparison.
- Examples
- something most experts never build: processes pulled from actual work, not theory
- Unlike most platforms, this isn't just another framework.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
[‘’“”]Flags g
Original wording
- Guidance
- Use straight quotes, not curly/smart quotes (a ChatGPT tell). Normalize “ ” ‘ ’ to " and '.
- Legitimate uses
- Keep when a project's house style deliberately requires typographic quotes (some published-prose pipelines do). Skip code blocks and quotations of sources that use them meaningfully.
- Examples
- He said “hello” to her.
- It’s a test.
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.
- Scope
- Tom's preferences for email writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to email.
- Candidate pattern
\b(?:synerg\w*|circle back|touch base|deep dive|value[- ]add|bandwidth|move the needle|low-hanging fruit|streamline|as per (?:our|the) (?:discussion|conversation|call)|please don'?t hesitate|don'?t hesitate to (?:reach out|contact))\bFlags gi
Original wording
- Guidance
- Strip corporate buzzwords. 'As per our discussion' becomes 'As the recipient mentioned'; drop 'please don't hesitate' and let the warm close stand. Email-scoped but the jargon ban generalizes.
- Legitimate uses
- Keep 'bandwidth' in literal network/signal contexts, 'streamline' where it names a specific process change, 'deep dive' in casual register if Tom uses it. Skip quotations.
- Examples
- Let's circle back and touch base to move the needle.
- Please don't hesitate to reach out with any questions.
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.
- Scope
- Tom's preferences for email writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to email.
- Candidate pattern
\b(?:provid(?:e|ing)\s+value|deliver\s+value|show(?:ing)?\s+you\s+(?:the\s+)?value|what\s+I\s+can\s+do\s+for\s+you)\bFlags gi
Original wording
- Guidance
- In client email, do not frame a conversation as Tom giving value or showing what he can do. Reframe as collaborative: learn about their goals, establish mutual fit, map a plan. Email-scoped.
- Legitimate uses
- Scope to AI-consulting client email. Keep literal value discussions in pricing/contract contexts where value delivered is the explicit topic. Skip quotations.
- Examples
- I'd love to show you the value I can provide for your business.
- Here is what I can do for you.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:on the other hand|while some (?:argue|experts|praise)|the (?:debate|truth) (?:continues|likely lies)|only time will tell|the truth lies somewhere in between)\bFlags gi
Original wording
- Guidance
- Presenting multiple perspectives even when unnecessary creates wishy-washy text. Make the claim the evidence supports. Critical objectivism: engage with what is actually true rather than performing balance.
- 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' introducing a substantive counter-consideration. Skip quotations.
- 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.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:could (?:potentially|possibly)|potentially possibly|might (?:have some|potentially)|it (?:could|might) be argued that|may (?:perhaps|possibly))\bFlags gi
Original wording
- Guidance
- Stacked qualifiers that drain commitment. Collapse to a single calibrated modal. 'It could potentially possibly be argued that the policy might have some effect' becomes 'The policy may affect outcomes.'
- Legitimate uses
- 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.
- Examples
- It could potentially possibly be argued that the policy might have some effect.
- This might potentially help.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:the\s+exercise\s+has|this\s+exercise\s+has|stopping\s+at\s+\w+\s+is\s+part\s+of|the\s+discipline\s+is\s+to|this\s+exercise\s+works\s+in|the\s+exercise\s+works\s+by|this\s+lab\s+is\s+designed\s+to|part\s+of\s+the\s+reading\s+experience)\bFlags gi
Original wording
- Guidance
- Do not narrate the structure of an exercise or that a lab is 'designed to teach'. Run the exercise directly; show the mechanism. The reader follows the steps, not a description of the format.
- Legitimate uses
- Keep brief setup that genuinely orients the learner to a concrete task. Skip quotations.
- Examples
- This exercise works by having you pause at each step.
- The lab below is designed to teach feedback.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bliteral(?:ly)?\bFlags gi
Original wording
- Guidance
- Use these words only when the claim is factually/materially true, never as rhetorical emphasis. Replace figurative uses 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.'
- Legitimate uses
- Keep when the claim IS literally/physically/actually true ('the bridge literally collapsed', 'the value is actually 42, not 41', 'the heat physically deforms the rail'). This guard is essential: the word is correct far more often than not. Skip quotations.
- Examples
- Her discovery literally changed everything.
- The argument physically dismantles the objection.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bfrom\s+\w+\s+to\s+\w+\bFlags gi
Original wording
- Guidance
- 'From X to Y' where X and Y are not on a meaningful scale. Replace with a plain list of what is covered. 'Everything from philosophy to breakfast cereal' becomes a direct list.
- 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'), and ordered scales ('from novice to expert'). Only the unscaled rhetorical 'from X to Y' is the tell. High recall; fixer dismisses scaled ranges. Skip quotations.
- Examples
- Everything from philosophy to breakfast cereal.
- from the Big Bang to dark matter, from stars to the cosmic web
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.
- Scope
- Tom's preferences for fiction writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to fiction.
- Candidate pattern
\b(?:I|he|she|they|we)\s+(?:saw|see|noticed?|notice|realized?|realize|felt|feel|thought|think|remembered?|remember|watched|observed|could (?:see|feel|hear|smell|taste))\bFlags gi
Original wording
- Guidance
- In deep-POV fiction, remove the filter verb and jump straight to what is perceived/thought. 'I see the sunlight bouncing off the bar top' becomes 'Sunlight bounces off the bar top, too bright, like it's interrogating me.' Fiction-scoped.
- Legitimate uses
- Scope to immersive fiction only; do not fire in technical, expository, email, or news prose where 'I think' / 'we saw' are legitimate. Keep when perception itself is the explicit subject. Skip quotations.
- Examples
- I see the sunlight bouncing off the bar top.
- She felt the cold creep into her hands.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:a testament to|serves as a reminder|it cannot be overstated|a nuanced approach|paradigm shift|game-?changer|at the end of the day|rich tapestry)\bFlags gi
Original wording
- Guidance
- Delete and rewrite directly with the concrete claim. These phrases announce significance or comprehensiveness while saying nothing checkable.
- Legitimate uses
- Keep 'paradigm shift' only when directly quoting or discussing Kuhn. Keep 'tapestry' for a literal woven textile. Skip quotations.
- 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.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:the future looks bright|exciting times lie ahead|step in the right direction|journey toward excellence|the possibilities are endless)\bFlags gi
Original wording
- Guidance
- Vague upbeat endings. Replace with a concrete next fact or plan. 'The future looks bright' becomes 'The company plans to open two more locations next year.'
- Legitimate uses
- Skip quotations and anti-example blocks. Low false-positive risk.
- Examples
- The future looks bright. Exciting times lie ahead.
- This is a step in the right direction.
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:
# Titlethen### Subsectionwith 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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Heuristic ·
headingLevelSkip
Original wording
- Guidance
- Do not skip heading levels (jumping from H1/H2 straight to H3). Human writers rarely skip levels. Insert the intervening level or promote the heading.
- Legitimate uses
- Keep when a documented component/MDX convention legitimately starts sections at a fixed level. Skip code blocks. Requires scanning heading sequence, so implement as a structural pass.
- Examples
- # Title then ### Subsection with no ## between
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
^\s*[-*]\s+\*\*[^*]+:?\*\*:?Flags gi
Original wording
- Guidance
- List items that start with a bolded header + colon and then restate the header in a sentence. Convert to flowing prose where it reads better, or strip the redundant restatement.
- Legitimate uses
- Keep genuine definition lists, glossaries, API parameter docs, and changelog entries where the bold lead-in is a real label and the following text is not a restatement. Skip quotations and code.
- Examples
- - **Speed:** It is fast.
- - **Performance:** Performance has been enhanced through optimized algorithms.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:deeply|profoundly|incredibly|remarkably|fundamentally|truly|utterly|vitally)\b|\b(?:important|crucial|critical|essential|remarkable|profound|far-reaching|significant|noteworthy|groundbreaking|transformative|game-?chang(?:er|ing)|revolutionary)\bFlags gi
Original wording
- Guidance
- Drop the intensifier unless the same sentence gives exact evidence. Reward specificity and claims that make the weight visible over assertions of importance. Name the concrete result, consequence, or limitation that earns the word.
- Legitimate uses
- Keep when the word is technically precise ('critical point' in physics, 'critical path' in scheduling, 'significant' in a statistics sentence reporting a p-value). Keep when the same sentence supplies exact evidence the intensifier summarizes. Skip quotations.
- Examples
- This is a crucial and profound insight with far-reaching implications.
- a deeply transformative, profoundly important breakthrough
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:as of my last (?:update|training)|up to my last training|while specific details (?:are|remain) (?:limited|scarce|not extensively documented)|based on available information|as of \[?date)\bFlags gi
Original wording
- Guidance
- AI disclaimers about incomplete info left in the text. Replace with a sourced fact or cut. 'While specific details are limited... established in the 1990s' becomes 'Founded in 1994, per its registration documents.'
- Legitimate uses
- Keep genuine, dated data-currency notes in a report where recency is the explicit subject ('data current as of Q1 2026'). Skip quotations.
- Examples
- As of my last update, while specific details are limited based on available information...
- up to my last training, the figure was unclear
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:unlock|transform|elevate|harness|leverage|empower|supercharge|revolutionize|turbocharge)\b|\btake\s+.{0,20}\s+to (?:the )?next level\bFlags gi
Original wording
- Guidance
- Replace with concrete actions and plain verbs. 'Leverage' becomes 'use'; 'harness' becomes the named mechanism; 'empower' becomes the specific capability granted. Banned especially in teaching content.
- Legitimate uses
- Keep 'leverage' as a finance/physics noun (financial leverage, mechanical leverage). Keep 'transform' in math/CS senses (a Fourier transform, transform a matrix, data transformation). Keep 'empower' when describing literal legal authorization. Skip quotations.
- Examples
- Unlock your potential and transform your workflow to take productivity to the next level.
- We leverage a holistic framework to empower learners.
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.
- Scope
- Tom's preferences for meditation writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to meditation.
- Candidate pattern
\b(?:don'?t|do not|isn'?t|doesn'?t|won'?t|never|nothing|without)\b|\bno\bFlags gi
Original wording
- Guidance
- In meditation scripts only, eliminate not/don't/isn't/no/never/nothing/without. Say what things ARE ('stay relaxed' instead of 'don't tense'). Project-scoped; this rule would break ordinary prose, so apply only on meditation-script files.
- Legitimate uses
- Apply ONLY to the author's meditation work guided-script files; never fire on general prose. Skip quotations.
- Examples
- Don't let any tension remain; there is nothing you need to do.
- No effort is required.
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.
- Scope
- Tom's preferences for fiction writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to fiction.
- Candidate pattern
\b(?:in|into) the mirror\bFlags gi
Original wording
- Guidance
- In fiction, never have a character study a mirror to catalog their own appearance. Reveal appearance through contrast or a salient plot-relevant detail. Fiction-scoped.
- Legitimate uses
- Scope to fiction. Keep mirrors that serve plot/theme (a cracked mirror as a clue, a literal mirror in a physics demo). Skip quotations.
- Examples
- She looked in the mirror at her green eyes and long auburn hair.
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.
Background
Tom originally wrote this as a fiction rule in capitals.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:not (?:metaphorical|metaphorically|literal|figurative|imagined|hypothetical)|wasn'?t (?:just|merely|simply|metaphorical)|isn'?t (?:just|merely|simply))\bFlags gi
Original wording
- Guidance
- Tom's capitalized fiction rule, generalizing to all prose: do not negate a phantom alternative to assert the real thing. Delete the negated phantom and show the real thing as concrete physical action or a direct claim. 'The vertigo hit then, not metaphorical, actual' becomes 'The vertigo hit. The room tilted. She gripped the counter.'
- Legitimate uses
- Keep when genuinely disambiguating 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.
- Examples
- The vertigo hit then, not metaphorical, actual.
- This wasn't just theory.
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.
Background
Tom asked for a hook that would catch novel forms of this pattern, which is why the LLM monitor covers variants beyond the known list.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bthat'?s\s+(?:the\s+(?:whole\s+|real\s+|entire\s+)?(?:point|beauty|magic|trick|crux|key|genius)|what\s+makes|where\s+\w+\s+(?:gets|comes\s+in))\b|\bthis\s+is\s+where\s+(?:it|things)\s+gets?\b|\bwhich\s+is\s+(?:exactly\s+)?the\s+(?:whole\s+)?point\bFlags gi
Original wording
- Guidance
- Tom asked for a hook for novel forms: flag 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. Fix by deleting the announcement and stating the actual idea, or by adding the concrete claim the sentence promised.
- Legitimate uses
- Keep when the sentence both flags and immediately delivers a specific, checkable claim in the same breath. Do not fire on legitimate transitions that carry real content. Skip quotations and anti-example blocks. This is a recall-first heuristic; the fixer/monitor dismisses sentences that do carry a concept.
- Examples
- Here's the thing: it changes everything.
- This is where it gets interesting.
- It cannot be overstated how important this is.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:translated|derived from|carried forward|simply became|turned directly into|invented from|in a straight line from)\bFlags gi
Original wording
- Guidance
- Do not present interpretive lineages as settled one-way transmissions. Verify whether the evidence is documentary or interpretive; if interpretive, lower the claim with '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.
- Legitimate uses
- Keep when documentary evidence genuinely supports the direct claim (a documented citation, letter, or stated influence). Keep literal translation of a text/language. Skip quotations.
- Examples
- Deleuze derived his concept of singularity straight from Scotus.
- Her method translated directly into the modern algorithm.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:additionally|align with|crucial|delve|emphasizing|enduring|enhance|fostering|garner|interplay|intricate|intricacies|pivotal|showcase|tapestry|testament|underscore|valuable|multifaceted|utilize|robust|holistic|comprehensive|nuanced|ecosystem|notably)\bFlags gi
Original wording
- Guidance
- One or two uses are coincidental; a cluster of 5-6 is a strong tell, or when any single one substitutes for specificity. Do not ban individual words by reflex; replace the ones that stand in for a concrete word.
- Legitimate uses
- Keep 'ecosystem' for literal ecology, 'crucial/pivotal' where exact evidence follows, 'utilize/enhance' where they carry precise technical meaning, 'nuanced' where the nuance is then delivered. The tell is density and vagueness, not the word alone. Skip quotations.
- Examples
- Additionally, we leverage a robust, holistic framework to enhance the intricate tapestry of our ecosystem.
- a comprehensive, nuanced, multifaceted approach
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:facts? come before|claim before|comes before (?:advice|commentary|framing)|method and result|source[- ]?checked|source context|useful takeaway|before (?:advice|commentary|framing))\bFlags gi
Original wording
- Guidance
- Do not narrate the agent's evaluation order, page structure, source-checking habit, or page apparatus in reader-facing copy. Name the news, finding, consequence, or the reader's subject. Also covers the author's projects apparatus vocabulary ('evidence trail', 'source ledger', 'the lab below', 'this page/section/module').
- Legitimate uses
- Keep when the literal subject genuinely is process/methodology being explained to the reader as content. Skip quotations and anti-example blocks.
- Examples
- Facts Come Before Commentary
- Source-Checked Before Framing
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bmore\s+real\s+than\b|\btruly\s+real\b|\bthe\s+real\s+\w+\s+(?:is|was|are|were)\b|\bmere\s+(?:concrete|particular|implementation|instantiation|instance)\b|\btranscends?\s+the\s+(?:concrete|particular|physical|material)\b|\brises?\s+above\s+the\s+(?:particular|concrete|physical)\bFlags gi
Original wording
- Guidance
- State the reality of each level on its own terms; say they are intertwined; never adjudicate which is more real. Degrees of ALIGNMENT (how faithfully an expression embodies what it connects to) are real and encouraged; degrees of REALITY between abstract and concrete are forbidden. Ordinary emergence language ('a level above the genome') is fine.
- Legitimate uses
- Keep ordinary emergence/level language that does not rank realness. Keep 'more real than' in quoted philosophical sources being reported. This is the abstract-evolution book's specific ontology; treat as watchlist outside that project. Skip quotations.
- Examples
- The abstract essence of a need is more real than any particular strategy.
- The pattern transcends the particular instances.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b\w+,\s+\w+,\s+and\s+\w+\bFlags g
Original wording
- Guidance
- AI forces ideas into groups of three for false comprehensiveness. Two items often hit harder; each item must earn its place. Check whether the triad is padded ('fast, reliable, and scalable') or genuinely three distinct necessary items.
- Legitimate uses
- High false-positive rate by design (recall-first). Keep any triad whose three members are genuinely distinct and necessary, technical enumerations, and lists that happen to have three real items. The fixer should dismiss most hits; flag clusters of multiple padded triads. Skip quotations and code.
- Examples
- It's fast, reliable, and scalable.
- innovation, inspiration, and industry insights
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.
- Scope
- Tom's preferences for news writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to news.
- Candidate pattern
\bsignals?\bFlags gi
Original wording
- Guidance
- In casual news/product copy, do not use 'signal'; reserve it for literal signal transduction or signal processing. Prefer entries, reports, readings, claims, patterns, or items. Project-scoped to the author's news copy.
- Legitimate uses
- Keep literal/technical signal (signal transduction, signal processing, a radio signal, traffic signal, signal-to-noise). Scope to the author's news copy casual copy. Skip quotations.
- Examples
- This release is a strong signal of where coding agents are heading.
- The data sends a clear signal.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\b(?:stands? as|is a testament|reflects? (?:a )?broader|symboliz(?:es|ing)|setting the stage for|key turning point|evolving landscape|focal point|indelible mark|deeply rooted|enduring legacy)\bFlags gi
Original wording
- Guidance
- Puffing importance by tying arbitrary facts to a broader topic. Cut the inflation and state the concrete fact. 'established in 1989, marking a pivotal moment in the evolution of regional statistics' becomes 'established in 1989 to collect and publish regional statistics.'
- Legitimate uses
- Keep 'deeply rooted' / 'legacy' in literal botanical, genetic, or software-legacy-code senses. Skip quotations.
- Examples
- officially established in 1989, marking a pivotal moment in the evolving landscape
- This stands as a testament to the project's enduring legacy.
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.
- Scope
- Tom's preferences for fiction writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to fiction.
- Candidate pattern
\b(?:was|were|felt|looked|seemed)\s+like\b|\bas if (?:it|he|she|they)\bFlags gi
Original wording
- Guidance
- In lyrical/creative prose, fold the comparison into the verb so the action carries the meaning. 'The rain was like tears' becomes 'Rain grieved down the window.' Creative-prose-scoped.
- Legitimate uses
- Scope to creative/poetic prose; do not fire in technical or expository writing where 'looks like' / 'seemed like' are precise. Keep similes that genuinely earn their place. Skip quotations.
- Examples
- The rain was like tears.
- Her voice was like gravel.
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.
- Scope
- Tom's preferences for meditation writing; preserve the rule's narrower conditions.
- Detection
- Pattern matchApplies only to meditation.
- Candidate pattern
\b(?:sacred|divine|vibration|spiritual energy|source energy|blessing|blessed|manifest(?:ing|ation)?|higher purpose|the universe wants)\bFlags gi
Original wording
- Guidance
- In meditation/gratitude/acknowledgment copy, never assert reverence with spiritual vocabulary; earn it through accurate description of the real process. Project-scoped to the author's meditation work.
- Legitimate uses
- Scope to the author's meditation work gratitude/meditation content. Keep 'manifest' in its ordinary verb sense ('symptoms manifest as fever'), 'vibration' in physics, 'divine' as a verb ('divine the cause'). Skip quotations.
- Examples
- The sacred energy of the earth flows through this blessed material.
- This is your higher purpose manifesting.
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.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
\bthe real (?:issue|reason|problem|question|skill|story|point|trick)\s+(?:is|isn'?t|was)\b|\bwhat really matters is\bFlags gi
Original wording
- Guidance
- 'The real X is Y' implies other things are less real. Describe the thing directly: 'The skill is being willing to ask' instead of 'The real skill isn't technical knowledge, it's being willing to ask.'
- Legitimate uses
- Keep when distinguishing a genuinely misidentified cause where the reader holds a specific wrong belief and the correction is concrete. Skip quotations.
- Examples
- The real reason the build fails is a stale lockfile.
- What really matters is the data model.
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 PartnershipsLegitimate use: do not fire on headings dominated by proper nouns (names, product names, place names), where title case is correct. Skip quotations and code.
- Scope
- Tom's writing preferences; inspect the rule's conditions before applying it elsewhere.
- Detection
- Pattern match
- Candidate pattern
^#{1,6}\s+(?:[A-Z][a-z]+\s+(?:a|an|and|as|at|but|by|for|in|of|on|or|the|to|with|from|into)?\s*){2,}[A-Z][a-z]+\s*$Flags gi
Original wording
- Guidance
- AI capitalizes all main words in headings. Use sentence case: capitalize only the first word and proper nouns. '## How To Optimize Your Workflow' becomes '## How to optimize your workflow'.
- Legitimate uses
- Do not fire on headings dominated by proper nouns (names, product names, place names) where title case is correct. Skip quotations and code.
- Examples
- ## Strategic Negotiations And Global Partnerships
- ## How To Optimize Your Workflow
- Before:
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Nominates capability framing for review under the shared catalog's current severity.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags AI behavior asserted as a bare universal (in headers/titles) and hard causal overclaims. Capability claims must carry their condition: say when, if, or that the tool can do it, 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags self-referential, contentless labels (apply this article, a setup you can paste, 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags weak, vague mental-act and perception verbs ("name", "see", "watch", "read", "notice", "tell ... apart") that invite a fuzzy internal step or a passive look instead of stating the point, the result, or the check.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags current probable AI-ism patterns as editorial redirect signals, not proof or automatic bans.
Significance Signaling
WarningSite writing linter
This check flags stock phrases that announce significance instead of explaining it.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags "X gets Y ready": an abstract subject plus a causative verb and resulting state that can hide the action.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags growth uses of compounding for review against the requirement for actual exponential growth.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Blocks figurative money language (worth, pays off, payoff, earns its place) for the value of ideas, habits, or steps.
Prescriptive Singular
ErrorSite writing linter
This check flags stock numerical advice that hides the intended priority, trial, or completed result.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Requests contextual review of counted advice and output quotas, including digits and larger written numbers.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags finished prose that mentions discarded wording, an earlier draft, or the editor's correction instead of stating the corrected claim.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags 'X is not a Y; it is a Z' reframes where the negation may be factually false — a common AI writing tic that denies obvious categories to sound sophisticated.
Overused Ai Vocab
WarningSite writing linter
This check flags common model-default vocabulary. Stronger terms are caught immediately.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags common model-default vocabulary, with stronger terms caught immediately.
Superlative Claims
ErrorSite writing linter
This check flags unscientific superlative claims that assert a ranking without evidence.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags unscientific superlative claims that assert 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags closed-set 'the N things you act on' enumerations that 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
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags transport metaphors, placeholder action nouns, and convolution phrasing that replace a plain, concrete claim.
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."
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags the manufactured-expectation straw-man that tells the reader what to expect so it can be knocked down ("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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags "real" used as an empty intensifier before nouns where it adds no meaning.
Vapid Openers
ErrorSite writing linter
This check blocks generic opening frames that could introduce almost any AI article.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags dramatic profundity gestures that do not add information.
Filler Phrases
WarningSite writing linter
This check flags filler phrases that can usually be cut or simplified.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags sentences that announce importance without carrying the idea.
Mid Sentence Rhetorical
WarningSite writing linter
This check flags dramatic question-fragment transitions.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags dramatic question-fragment transitions.
Copula Avoidance
WarningSite writing linter
This check flags inflated substitutes for is, are, and has.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags four or more consecutive short declarative sentences (subject-verb-object, 4-14 words) in one paragraph, signaling 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".
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags three or more paragraphs within a sliding window of four that open with conditional clauses (When X, If X, Once X, 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"
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags sentences that announce a redundant restatement of a point already made ("In other words," "What this means is," "The point is").
Generic Conclusions
WarningSite writing linter
This check flags empty conclusion lines.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags empty conclusion lines.
Maya Name Ban
ErrorSite writing linter
This check blocks the overused placeholder name Maya in public content.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Blocks embedded reader questionnaires in books and guides so 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Blocks marketing verbs and slogans the writing standards ban in teaching and article copy.
Not Only But Also
WarningSite writing linter
This check flags not only ... but also constructions.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags not-only-but-also constructions.
Significance Adjectives
WarningSite writing linter
This check flags importance adjectives when they cluster.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags clustered importance adjectives.
Em Dashes
ErrorSite writing linter
This check blocks em dash punctuation, and also the double hyphen (
--) used as an em dash substitute.- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Blocks em dash punctuation and double-hyphen em dash substitutes.
Editorial Scaffold Leak
ErrorSite writing linter
This check keeps private planning fields (source, action, result, review) out of learner-facing prose.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Keeps private source/action/result/review planning fields out of learner-facing prose.
Contrastive Superiority
WarningSite writing linter
This check flags positioning that tears down unnamed others to sound superior.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Nominates acronyms in headings, titles, and callout titles for contextual familiarity review.
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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags vague nouns like 'the system' or 'the tool' in teaching content 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags sentences with multiple technical terms stacked together in guide content.
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
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags self-referential book-framing: announcing what 'this book is about' or claiming 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags an imperative used to voice a hypothetical (a command verb coordinated with a third-party consequence clause, 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags framing that treats human judgment as sacrosanct or the final authority rather than aiming at the best aligned outcome from human or 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.
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- 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"
- Scope
- This site's editorial checks. Error severity is not a universal language ban.
- Detection
- Site detector
Original wording
- Guidance
- Flags one-cause soundbites that collapse a multi-causal idea into a single driver ('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.