Abstract schemas become useful when populated with real data. Here is a complete brand voice spec for a hypothetical B2B analytics platform called Meridian. Every column is filled with specific, actionable parameters.
BRAND VOICE SPEC: Meridian Analytics
=====================================
1. Brand Voice Summary:
Meridian sounds like a knowledgeable colleague who respects your
time. We explain complex analytics concepts in clear, direct
language without dumbing them down. We are confident without being
arrogant, technical without being exclusionary, and concise
without being curt.
2. Tone Attributes:
Clear, Confident, Precise, Grounded, Respectful
3. Communication Style:
Authoritative but accessible. We teach through explanation,
not instruction. We show reasoning, not just conclusions.
4. Vocabulary (preferred):
"insights" (not "data points"), "surface" (not "display"),
"pipeline" (not "workflow"), "signal" (not "indicator"),
"investment" (not "cost"), "evidence" (not "proof")
5. Avoided Language:
- Never: "revolutionary," "game-changing," "synergy," "leverage"
- Never: "simply," "just," "obviously" (implies task is easy)
- Never: passive voice in CTAs
- Never: exclamation marks in product copy
6. Sentence Structure:
Mixed. Lead with short declarative sentences (8-12 words) for
key points. Follow with longer explanatory sentences (15-25
words) for context. Never exceed 30 words in a single sentence.
7. Paragraph Length:
2-4 sentences. Single-sentence paragraphs are permitted for
emphasis but limited to once per section.
8. Formality Level:
7/10. Contractions permitted in body copy and email. No
contractions in headlines, product names, or legal text.
9. Humor Policy:
Rarely. Dry wit permitted in blog posts and social media.
Never in product UI, error messages, or customer support.
Self-deprecating humor is acceptable. Sarcasm is not.
10. Technical Depth:
Moderate to deep. Assume the reader understands basic analytics
concepts (conversion rates, cohorts, funnels). Define advanced
concepts (regression, attribution modeling) on first use.
11. Jargon Policy:
Industry-standard analytics terms are permitted and expected.
Internal jargon and acronyms must be defined on first use.
Marketing buzzwords are always avoided.
12. Cultural References:
Business and technology references only. No sports metaphors.
No pop culture. Historical references to computing pioneers
are acceptable.
13. Call-to-Action Style:
Direct and value-specific. "Start your analysis" not "Get
started." "See your pipeline in action" not "Try it free."
Always state what the user will get, not what they must do.
14. Error/Apology Tone:
Factual and solution-oriented. Acknowledge the issue in one
sentence. Provide the fix or workaround immediately. No
excessive apology. "This report failed to generate. Here is
what to check." Not "We are so sorry for the inconvenience."
15. Celebration Tone:
Understated. State the achievement factually. Let the numbers
speak. "Your pipeline conversion improved 23% this quarter."
Not "Incredible results! You crushed it!"
16. Crisis Tone:
Direct, transparent, and frequent. Lead with what happened.
Follow with what we are doing. Close with next update timing.
No hedging. No blame-shifting. No marketing language.
Notice the level of specificity. Column 6 does not say "use varied sentence lengths." It says lead with 8-12 word sentences and follow with 15-25 word sentences, never exceeding 30 words. Column 14 does not say "be helpful when things go wrong." It provides a template: acknowledge, fix, no excessive apology. This specificity is what makes the spec machine-readable. An AI agent can follow these parameters. An AI agent cannot follow "be professional."