4 min read

Writing a brand voice guide Pilot can actually follow

Most style guides describe a feeling. AI needs rules it can check. How to turn your guide into forty short, testable rules with examples, and how to tell if it's working.

Divya MenonHead of Content

Guides
On this page

I’ve read hundreds of brand guidelines. Most of them open with a page of adjectives: confident but approachable, expert but never academic, warm, human, bold. They’re pleasant to read and almost impossible to follow, for people and for AI.

When a team sets up a brand voice in Pilot, the first thing I ask them to do is put the adjectives aside. Here’s what we write instead, and why it works.

Why adjectives don’t work

Ask ten writers to make a paragraph “warm but professional” and you’ll get ten different paragraphs. Each of them will be defensible. None of them will be wrong.

That’s the problem. A rule that can’t be broken can’t be followed either. Pilot checks a draft against your voice sentence by sentence, and it needs to know, for each sentence, whether it passes. “Be warm” gives it nothing to check.

Write rules you can test

A good voice rule passes one test: two people reading the same sentence would agree whether it follows the rule.

Instead of Write
Be approachable Use “you” and “we”. Avoid “the user” and “the company”.
Keep it simple Sentences under 25 words. One idea per sentence.
Sound confident No “might”, “perhaps” or “we think” in headlines.
Be human Use contractions: “it’s”, “don’t”, “we’ll”.
Stay on brand Say “workspace”, never “platform” or “solution”.

The rules on the right are less inspiring. They’re also the reason the drafts come back sounding like you.

Give an example for every rule

Rules are clearer with an example, and much clearer with a bad example next to a good one. For each rule, add one sentence that breaks it and the same sentence fixed.

  • Rule: Lead with what the reader can do, not what we built.
  • Not this: We’ve launched a new export menu with more formats.
  • This: You can now export any report to PDF, Word or Google Docs.

Pilot learns more from one pair like this than from a paragraph of explanation. So do new hires.

Cover the words people actually get wrong

Every company has a short list of words that cause most of the editing. Product names with odd capitalisation. Terms that legal has asked you not to use. The word your CEO hates.

Put these in a separate word list, with the preferred term and the ones to avoid. Ours includes:

  • Pilot, not “PILOT” or “the Pilot app”
  • Autopilot agent, not “bot” or “AI worker”
  • Library, capitalised when it means the product, lowercase otherwise
  • Customers, not “users”, in anything public

Pilot treats the word list strictly and flags every miss, which makes it the fastest win in any voice setup.

Keep it short

The best voice guides I’ve seen have between thirty and fifty rules. Fewer than that and drafts drift. More than that and rules start to contradict each other, and nobody remembers them.

If your guide is longer, group the rules by where they apply. Help articles, ads and executive emails don’t need the same voice. Pilot lets you set a base voice for the whole team, with smaller sets of rules for each channel on top.

Check that it’s working

After a week, pull ten drafts Pilot wrote in your voice and ten written by people on your team. Remove the names and ask a colleague to sort them. If they can’t reliably tell which is which, your guide is doing its job.

Then look at what editors changed in Pilot’s drafts. Edits that keep coming up are rules you haven’t written yet. Add them, with an example, and run the test again next month.

A starting point

If you’re starting from nothing, begin with these five questions and turn each answer into a rule:

  1. What do we call the people who use our product?
  2. How long is a typical sentence in our best writing?
  3. Which words do we never use, and why?
  4. Do we use contractions, exclamation marks, emoji?
  5. What should a reader feel able to do after reading?

You’ll find a ready-made brand voice template in the template gallery, with space for rules, examples and a word list.

brand-voicewritingstyle-guide
Portrait of Divya Menon

Written by

Divya Menon

Head of Content

Edits the blog and writes the style guide Pilot learns from first.

All posts
  • Guides

    6 min read

    How to check an AI answer in under a minute

    A five-step routine for checking an AI answer before you use it: read the sources, test the numbers, look for the missing side, and know when to stop and ask a person.

    Elise Moreau

  • Product

    4 min read

    Release 4.2: Autopilot agents

    Autopilot agents now write your recurring reports on a schedule, from the sources you choose, and wait for a person to approve them. Library search is also three times faster.

    Tomás Ferreira and Hector Salinas