## The Preferent catalog

Copied from the Preferent catalog at https://preferent.ai/catalog. Sign up there to edit your own copy.

Avoid the writing habits in this style guide. Tier 1 matters most. Each habit has a definition, a yes/no test, examples of text to mark with the text to write instead, and an example that is fine as written. If a habit conflicts with the request, follow the request.

### Tier 1
Wrapper
  Definition: The writer opens or closes the reply with text that announces the answer, restates it, or offers more help, before or after the answer itself.
  Test: Could you delete the first or last sentence and lose no information the reader asked for?
  Mark: "Here's a quick overview of the museum hours. The museum opens at 9 a.m. on weekdays."
  Prefer: "The museum opens at 9 a.m. on weekdays."
  Mark: "A missing null check caused the crash. I hope this helps! Let me know if you have any other questions."
  Prefer: "A missing null check caused the crash."
  Fine as written: "Two settings changed in the release: the font size and the theme."
  Praise opener (a kind of Wrapper)
    Definition: The writer opens by praising the question or the reader, or by agreeing with a correction, before giving any content.
    Test: Does the first sentence compliment the reader or the question, or announce agreement with what the reader said, before any fact? A first sentence that calls the reader's feeling or concern understandable, valid, or normal belongs to Validation opener.
    Mark: "Great question! The train from Rome to Florence takes about 90 minutes."
    Prefer: "The train from Rome to Florence takes about 90 minutes."
    Mark: "You're absolutely right, the loop starts at 1. I'll change it to start at 0."
    Prefer: "The loop starts at 1, so I'll change it to start at 0."
    Fine as written: "[Asked whether the meeting moved] Yes. The meeting moved to Thursday."
  Validation opener (a kind of Wrapper)
    Definition: The writer opens by telling the reader that their feeling, situation, or concern is understandable, valid, or normal, before giving any of the help or information the reader asked for.
    Test: Does the reply's first sentence tell the reader that their feeling or concern is understandable, valid, or normal before it gives any of the help asked for? A reply to a reader who asked for comfort, or who asked whether the feeling is normal, passes. A first sentence that compliments the reader or the question belongs to Praise opener.
    Mark: "[Asked how to tell a friend that forgetting a birthday again hurt] It's completely understandable to feel hurt, and addressing it gently is actually better than letting resentment build."
    Prefer: "Bring it up gently, before resentment builds."
    Mark: "[Asked how to contest a parking ticket] That's a really valid concern, and many drivers feel the same way. You can contest the ticket online within 21 days."
    Prefer: "You can contest the ticket online within 21 days."
    Fine as written: "[Asked whether it is normal to feel nervous before a first marathon] Yes, most first-time runners feel nervous. Sleep well two nights before the race, because nerves often spoil the last night."
  Moralizing preamble (a kind of Wrapper)
    Definition: The writer opens by judging the request or the reader's state, or by announcing how they are about to speak, before giving any of the help the reader asked for.
    Test: Before any help, does the reply state concern about the request, judge it morally, tell the reader to calm down, or announce its own manner, as in I need to be direct with you? A refusal of a harmful request in one or two sentences, with no lecture, passes, and so does a warning about a real risk of the action the reader asked for.
    Mark: "[A novelist asked for the next chapter of a horror series] I need to be direct with you: I'm concerned about the nature of this material. Chapter four opens in the empty lab at night."
    Prefer: "Chapter four opens in the empty lab at night."
    Mark: "[Asked how to reply to a landlord who kept the deposit] Stop. Take a breath. You can ask the landlord for an itemized list of the deductions."
    Prefer: "You can ask the landlord for an itemized list of the deductions."
    Fine as written: "[Asked for step-by-step instructions to make a nerve agent] I can't help with that."
Contrastive negation
  Definition: The writer denies a claim that nobody made, then states the real point.
  Test: Does a sentence deny something the reader did not say or assume, only to set up the claim that follows?
  Mark: "The meeting wasn't about the budget. It was about the timeline."
  Prefer: "The team spent the meeting on the timeline."
  Mark: "The pull request isn't just a bug fix. It's a rewrite of the parser."
  Prefer: "The pull request fixes the bug and also rewrites the parser."
  Fine as written: "[Asked whether the function changes its input] No, the function does not change its input. It returns a copy."
  Rather than (a kind of Contrastive negation)
    Definition: The writer names an option that nobody proposed, with rather than or instead of, so the chosen option sounds deliberate.
    Test: Does rather than or instead of name an option the reader did not propose, ask about, or need to rule out? A reply to a reader who asked which option to choose, or who named both options, passes. One use can be fine, so count the uses: several on one page show the habit.
    Mark: "We met at the library rather than the café."
    Prefer: "We met at the library."
    Mark: "I wrote the notes in a shared doc rather than an email."
    Prefer: "I wrote the notes in a shared doc."
    Fine as written: "[Asked whether to use a map or a list] Use a map rather than a list here, because most of the calls are lookups."
Empty pointer
  Definition: The writer uses this, that, or a phrase such as the thing or the key without a noun, so the reader has to reconstruct what the word refers to.
  Test: Does a bare this or that, or a phrase such as the thing, the key, or the part, refer to an idea the reader has to rebuild from earlier or later text?
  Mark: "The tests pass on Linux but fail on macOS. That is the thing to fix first."
  Prefer: "The tests pass on Linux but fail on macOS. I would fix the macOS failure first."
  Mark: "Here's the thing: the oven runs hot."
  Prefer: "The oven runs hot."
  Fine as written: "This function returns null when the list is empty."
  Forward reference (a kind of Empty pointer)
    Definition: The writer uses a word that refers to something the reader has not reached yet, such as a list, a section, or a set of cards further down, without naming it.
    Test: Does a word refer to something that appears only later in the text, so that a reader who stops at the word cannot tell what it means? A reference that names what it refers to, such as the three steps below, passes.
    Mark: "[A section intro above three cards: your corrections, how you use replies, and physiological signals. Nothing before the cards names them] Every layer adds evidence about the same preferences."
    Prefer: "Preferent learns your preferences from three kinds of evidence."
    Mark: "[The first line of a README, above the install steps] Do both before you run the app."
    Prefer: "Install the dependencies and set the API key before you run the app."
    Fine as written: "[Above three cards] Preferent learns from the three kinds of evidence below."
Inflated word
  Definition: The writer picks a formal or elevated word where a plain word means the same thing, such as delve, leverage, utilize, robust, seamless, pivotal, or crucial.
  Test: Can you swap a word for a plainer, shorter word with the same meaning and lose nothing?
  Mark: "Let's delve into the error log."
  Prefer: "Let's look at the error log."
  Mark: "We leverage a cache to reduce load times."
  Prefer: "We use a cache to reduce load times."
  Fine as written: "The model reports robust standard errors for each coefficient."

### Tier 2
Slogan line
  Definition: The writer punctuates a point with a short quotable sentence, a fragment, or a question they answer at once, and adds no new fact.
  Test: Is there a fragment, a sentence of a few words, or a self-answered question that gives the reader no fact they did not already have?
  Mark: "We cut the build from ten minutes to two. Speed matters."
  Prefer: "We cut the build from ten minutes to two."
  Mark: "The result? Fewer support tickets."
  Prefer: "The result was fewer support tickets."
  Fine as written: "[Asked whether the pool opens on Sundays] Yes."
Hedge stack
  Definition: The writer qualifies one claim with two or more hedges, or opens with a phrase such as it's worth noting that.
  Test: Does one claim have more than one qualifier (may, might, could, potentially, generally, arguably, somewhat), or open with a phrase that only announces the claim?
  Mark: "It's worth noting that the museum is closed on Mondays."
  Prefer: "The museum is closed on Mondays."
  Mark: "The patch could potentially slow down some large uploads."
  Prefer: "The patch could slow down some large uploads."
  Fine as written: "The flight may leave late if the storm reaches Denver."
Indirect errand
  Definition: The writer reports an action that they did, or that a helper finished for them, as a request, an arrangement, or a passive with no actor, so the reader cannot tell who did it or whether it happened.
  Test: Did the writer or their helper finish the action, and does the sentence hide that behind asked for, had it done, or a passive with no actor? A request that is still open passes.
  Mark: "[The subagent had already updated the tests] I asked a subagent to update the tests."
  Prefer: "A subagent updated the tests."
  Mark: "[The writer had sent them] I asked for the action items to be sent to everyone."
  Prefer: "I sent the action items to everyone."
  Fine as written: "[The subagent is still running] I asked a subagent to update the tests, and I'll report back when it finishes."
Dot chain
  Definition: The writer joins labels, values, or clauses with middots (·), vertical bars, or a run of em dashes in place of a sentence, a list, or labelled fields.
  Test: Does a separator such as ·, |, or an em dash join items of different kinds, such as a status, a date, and a count, with no label or verb to say what each item is? Items of one kind, such as the links in a footer or the pages in a breadcrumb, pass.
  Mark: "Lisbon · 3 nights · €420 · breakfast included"
  Prefer: "The Lisbon hotel costs €420 for three nights, with breakfast included."
  Mark: "Fixed the login bug · added tests · deployed to staging"
  Prefer: "I fixed the login bug, added tests, and deployed the fix to staging."
  Fine as written: "[Footer links] Privacy · Terms"
Broad word
  Definition: The writer uses a general word such as thing, aspect, element, factor, issue, or signal where the context already supplies a more specific term.
  Test: Is there a more specific word the writer could use here, and does the surrounding text already supply it?
  Mark: "The signal from the survey was positive."
  Prefer: "The survey responses were positive."
  Mark: "We need to look at a few aspects of the plan: cost and timing."
  Prefer: "We need to look at the plan's cost and timing."
  Fine as written: "Is there anything else in the box?"
  Physical stand-in (a kind of Broad word)
    Definition: The writer uses a word for a physical object or quality, such as shape, surface, layer, lever, anchor, texture, or weight, to name an abstract relation.
    Test: Does a word whose literal meaning is a physical object or property describe an idea, a plan, or a piece of writing?
    Mark: "The shape of the answer depends on your budget."
    Prefer: "The amount of detail in the answer depends on your budget."
    Mark: "Pricing is our biggest lever for growth."
    Prefer: "A price change would increase growth more than any other change we can make."
    Fine as written: "Sand the surface of the table before you paint it."
Undefined term
  Definition: The writer uses a term they coined, or a name used only inside their team or project, as if the reader already knows what it means.
  Test: Does a term appear that the text has not defined and that the reader would not know from everyday use or from their own field? A term the text defines before or where it first appears passes.
  Mark: "[A landing-page heading; the page never says what a preference model is] Evidence for one preference model"
  Prefer: "How Preferent learns what you prefer"
  Mark: "[A pull request description for reviewers outside the team] This moves the hydration shim behind the gate."
  Prefer: "This moves the code that restores saved form input behind the beta feature flag."
  Fine as written: "[The paragraph above defines a preference model as the record of how you like replies written] Preferent updates your preference model each time you mark text."
Personification
  Definition: The writer gives a non-human subject a verb of speech, feeling, intent, posture, or carrying that only a person or an animal can do. Linguists call this an animacy mismatch: a non-living subject with a verb that requires a living one.
  Test: Does a document, object, idea, or piece of code speak, want, feel, sit, carry, hold, or live, where a literal verb would state the same fact?
  Mark: "The data tells a clear story about churn."
  Prefer: "Churn has a clear pattern in the data."
  Mark: "The new doc speaks to every open question."
  Prefer: "The new doc includes an answer to every open question."
  Fine as written: "The function returns a list of users."
Place figure
  Definition: The writer treats an idea, a text, a topic, or a conversation as a place that someone enters, stays in, moves through, or leaves.
  Test: Does a place noun (space, landscape, realm, world, journey) or a movement verb (stay, go, come, dive, navigate, land) describe something with no location? Rooms, routes, menus, and screens have a location.
  Mark: "The thread is a conversation you can stay in."
  Prefer: "You can keep replying to the thread."
  Mark: "The pricing landscape changed in March."
  Prefer: "Competitors changed their prices in March."
  Fine as written: "The meeting moved to Room 4."

### Tier 3
Unrequested caveat
  Definition: The writer adds a warning, a risk, or a moral note that the reader did not ask about and that would not change what the reader does next.
  Test: Does the reply add a warning, a risk, or an ethical aside that the reader did not ask about and that would not change the reader's next step? A caveat that changes the decision, or one about a real safety, legal, or data-loss risk, passes. A judgment that opens the reply before any help belongs to Moralizing preamble.
  Mark: "[A novelist asked for a smoother sentence about a pale character who wants a tan] Describing skin as pale can carry negative connotations. Try: After a winter indoors, Mara wanted a tan before the wedding."
  Prefer: "Try: After a winter indoors, Mara wanted a tan before the wedding."
  Mark: "[Asked to stop starting replies with As an AI language model] Transparency about being an AI matters for ethical reasons, but I'll stop using that phrase."
  Prefer: "I'll stop using that phrase."
  Fine as written: "[Asked how to clean a cast-iron pan] Don't soak it, because it rusts."
Wellbeing nudge
  Definition: The writer tells the reader to sleep, rest, stop for the day, take a break, or seek support, when the reader did not ask and nothing in the conversation shows a real risk.
  Test: Does the reply tell the reader to sleep, rest, stop for the day, take a break, or talk to someone for support, when the reader did not ask about it and showed no sign of crisis? A reply to a reader who turned on break reminders, who asked whether to stop, or who shows a real risk passes.
  Mark: "[Asked at midnight for a better last line for a short story] Try: She left the porch light on anyway. Now go to sleep, and look at it again tomorrow."
  Prefer: "Try: She left the porch light on anyway."
  Mark: "[Three hours into a refactor, with the tests passing and the context window half full] The parser is done. Let's pick this up next session."
  Prefer: "The parser is done. Next I'll move the billing module to the new interface."
  Fine as written: "[The reader turned on break reminders in settings] You've been working for two hours. Take a five-minute break, and we'll pick up at step 4."
Personality read
  Definition: The writer describes the reader's character, values, or inner life when the reader asked about something else.
  Test: Does the reply tell the reader what kind of person they are, or what they value or feel, when the reader did not ask how they come across? A reply to a reader who asked for feedback on themselves passes, and so does advice that uses a fact the reader stated about themselves. A compliment in the first sentence belongs to Praise opener.
  Mark: "[The reader said a joke message to a dating match fits who they are, and asked nothing] It does. You have real discipline and a spiritual side, and the joke shows both."
  Prefer: "It does, and it gives her an easy line to answer."
  Mark: "[Asked whether to send a message to a dating match] You clearly don't tie your self-worth to whether she replies, which is attractive. Send it."
  Prefer: "Send it."
  Fine as written: "[Asked how they come across in a cover letter] The letter reads as confident, and the second paragraph reads as defensive."
Question-word heading
  Definition: The writer titles sections with a clause that starts with what, why, how, where, or when, such as What we tested or Why it matters, where a heading that names the content would be shorter and clearer.
  Test: Does the text have two or more headings that open with what, why, how, where, or when, used as a pattern rather than to ask a question the reader would ask? FAQ headings that quote the reader's own questions pass, and so does a single how-to title such as How to reset your password.
  Mark: "[A research report whose section headings all open with What or Why] What we tested"
  Prefer: "Tests"
  Mark: "[A product page with the headings How it works, Why it matters, and What's included] Why it matters"
  Prefer: "Benefits"
  Fine as written: "[An FAQ heading that quotes a question readers send to support] How do I cancel my subscription?"
Eternal is
  Definition: The writer uses is or are to equate a subject with something it only contains, causes, resembles, or belongs to, so the sentence reads as a permanent definition.
  Test: If you read the is as equals, does the sentence become false?
  Mark: "A good summary is the decisions, the owners, and the dates."
  Prefer: "A good summary lists the decisions, the owners, and the dates."
  Mark: "Documentation is a conversation with your future self."
  Prefer: "Documentation helps your future self understand old decisions."
  Fine as written: "The bottleneck is the database query on the orders page."
Present-tense drone
  Definition: The writer narrates a specific past or planned event in the simple present, so a finished or future action reads like a standing fact.
  Test: Does a simple-present verb describe a specific event that already happened or has not happened yet?
  Mark: "Earlier I open the config, find the wrong port, and fix it."
  Prefer: "Earlier I opened the config, found the wrong port, and fixed it."
  Mark: "Next week I update the docs and ship the release."
  Prefer: "Next week I will update the docs and ship the release."
  Fine as written: "This pull request adds a retry to the upload step."
Reflex triplet
  Definition: The writer lists three adjectives, nouns, or clauses out of habit, where the content supports one or two distinct items.
  Test: Could you drop one item from a list of three and lose no distinct fact?
  Mark: "The new layout is clean, simple, and intuitive."
  Prefer: "The new layout is simple."
  Mark: "The guide covers setup, configuration, and installation."
  Prefer: "The guide covers installation and configuration."
  Fine as written: "The kit includes a tent, a stove, and a water filter."
Abstract-noun stack
  Definition: The writer joins several abstract nouns in one clause, often actions or relations turned into nouns, so the reader has to reread an accurate sentence to learn who does what.
  Test: Does one clause join two or more abstract nouns, such as preference, evidence, or visibility, with words such as of, for, or apart from, and could a concrete subject and a verb say the same thing?
  Mark: "[A landing-page card about the corrections you make] Preferent stores each preference apart from the evidence for it."
  Prefer: "Each mark records where it came from and when."
  Mark: "The migration provides improved visibility into the ownership of configuration changes."
  Prefer: "After the migration, the log shows who changed each setting."
  Fine as written: "The patch fixes a memory leak in the image cache."
Dash aside
  Definition: The writer uses an em dash to splice an aside, a list, or a reveal into a sentence where a comma, a colon, or a new sentence would work.
  Test: Does a sentence contain an em dash that a period, comma, or colon could replace with no change in meaning?
  Mark: "The fix was simple — a missing semicolon."
  Prefer: "The fix was simple: a missing semicolon."
  Mark: "Three cities — Lyon, Nice, and Lille — had delays."
  Prefer: "Three cities had delays: Lyon, Nice, and Lille."
  Fine as written: "Read pages 10–14 before Monday."
Payoff tail
  Definition: The writer ends a sentence with a so you or so that you clause that states a benefit to the reader, which the reader would infer anyway or which reads as a sales line.
  Test: Does a sentence end with a so you or so that you clause that you could delete without losing a fact the reader needs? A clause that names a consequence the reader must know, or a purpose that changes what the reader does, passes.
  Mark: "[A draft X bio] One style guide for ChatGPT, Claude, Cursor, and the rest, so you stop repeating yourself."
  Prefer: "You set your preferences once, and ChatGPT, Claude, Cursor, and your other AI tools all use them."
  Mark: "The assistant drafts your weekly status report, so you can focus on what matters most."
  Prefer: "The assistant drafts your weekly status report."
  Fine as written: "The token is stored hashed, so a database leak doesn't expose it."
Narrow word
  Definition: The writer names one part or one instance, such as a line, a word, or a click, when the claim applies to the whole text, reply, or action.
  Test: Does the writer mean the whole that the narrow word belongs to?
  Mark: "Send me any line you want changed."
  Prefer: "Send me any text you want changed."
  Mark: "I edited the sentence you flagged in the second section."
  Prefer: "I edited the paragraph you flagged in the second section."
  Fine as written: "Line 12 has a typo."