Skip to main content
Context file — Content

BRAND-VOICE.md

Drafts arrive in your voice on the first attempt instead of after four rounds of "less corporate". Telling a model to write "professional but conversational" produces LinkedIn house style, because that is what the phrase means in its training data. This file works from evidence instead: your real sentences, the words you never use, and before/after pairs showing the correction.

BRAND-VOICE.md
.md
# Brand voice — <name or company>

This file describes how <we write / I write>. It overrides any default instinct about how LinkedIn posts, messages or emails should sound. When this file and good practice disagree, this file wins.

## Five real sentences

These are actual sentences from things we have published. Match this rhythm, not a description of it.

1. <"The invitation ceiling is about 100 a week and no plan removes it.">
2. <"We checked on 12 September. If LinkedIn has moved it since, your billing page is right and we are wrong.">
3. <"Two of the eleven wins had the same finance system. That is not a pattern, it is a coincidence with a good PR team.">
4. <"Skip this if you are single-entity. It will not help you.">
5. <"The short answer is no, and the long answer is also no but with a table.">

## Rhythm

- Sentence length: <short. Under 20 words is the norm. One long sentence per paragraph at most, and only when the idea needs it.>
- Paragraphs: <two to three sentences. Single-sentence paragraphs are fine for emphasis, not as a default.>
- Person: <first person plural for the company, first person singular for founder posts. Never third person.>
- Contractions: <yes, always. "We are" reads as a press release.>

## Vocabulary we use

<close, entity, reconciliation, headcount, ceiling, list price, verified, the arithmetic>

## Vocabulary we never use

<leverage (verb), unlock, empower, seamless, game-changer, solution (as a noun for our product), journey, space (as in "the payroll space"), excited to announce, thrilled, delve, robust, best-in-class, at the end of the day>

## Banned constructions

- <Rhetorical questions as openers. "Ever wondered why your close takes nine days?" — never.>
- <Three-adjective strings. "Fast, simple and powerful.">
- <Hook formulas: "Unpopular opinion:", "Let that sink in", "Here's the thing".>
- <Emoji in body copy. One in a headline is already too many.>
- <Ending on "Thoughts?" or "Agree?">

## How we handle claims

- <Every number has a source or a date. If we cannot source it, we do not use it.>
- <We state the limitation of a claim in the same piece, not in the replies.>
- <We name competitors plainly rather than saying "some tools".>
- <We say "we do not know" in writing. It is a feature, not a weakness.>

## Before and after

| Generic | Ours |
|---|---|
| <"We help finance teams unlock efficiency in their close process."> | <"We cut multi-entity payroll close from nine days to two."> |
| <"Excited to share that we've hit a major milestone!"> | <"Eleven customers now, all logistics or retail, all multi-entity. Here is what we got wrong about the other segments."> |
| <"Reach out if you'd like to learn more."> | <"If your close got longer after an acquisition, I am curious whether it was reconciliation or consolidation."> |

## The test

<Read it aloud. If it sounds like a person who has done the work explaining it to a colleague, it is right. If it sounds like a company, rewrite it.>

## What to do when unsure

Ask, rather than guessing. One clarifying question costs less than a draft in the wrong voice.
BRAND-VOICE.md
Version 1.0 — updated 18 September 2026Downloads as BRAND-VOICE.mdRemoves the four rounds of "make it less corporate"
Where it goes
  • Claude Project knowledge
  • ChatGPT Project files
  • Gemini Gem instructions
  • Agent folders
What you have to fill in
  • The five real sentences — this is the section that does the work
  • The banned list, which should include things you have actually caught yourself hating
  • At least three before/after pairs

Everything in <angle brackets> is example content, not instructions. Replace it. The file ships filled in rather than empty on purpose: an empty template gets abandoned, a filled one gets edited.

Questions

Using this file

Why real sentences rather than a description of the tone?

Because adjectives are the weakest possible instruction. "Conversational but authoritative" describes about eighty per cent of published business writing; five of your actual sentences describe exactly one voice, and the model can pattern-match against them.

Where the content comes from

The reference behind this file

A voice file in practice

The Linkediz about page is written to exactly this kind of rule set — useful as a worked example of what the output looks like.

Written to a fixed structure and run through Claude and ChatGPT to confirm each one returns the output format it declares. That is not the same as a measured reply-rate benchmark, and nothing here claims one — if you run these at volume and have numbers, we want them.

Where to next

One file is a start. The folder is the point.

Files reference each other — CLAUDE.md declares the reading order, the prompts expect the files by name. The packs ship them together, already wired up.