brand-voice.md context file defines your brand’s unique personality, tone, and messaging framework. It ensures all content generated by SEO Machine matches your brand’s voice consistently.
Location
Template:~/workspace/source/context/brand-voice.md
Example: ~/workspace/source/examples/castos/brand-voice.md
What It Defines
The brand voice file contains:- Voice Pillars - 3-5 core characteristics that define your brand personality
- Tone Guidelines - How your voice adapts for different content types
- Core Messages - Key brand messages to weave throughout content
- Value Propositions - Specific positioning for each customer segment
- Writing Style - Sentence structure, word choice, and formatting preferences
- Audience Understanding - Who you write for and what they care about
Voice Pillars
Voice pillars are the foundation of your brand personality. Each pillar should include:Structure
Real Example: Castos
Choosing Your Voice Pillars
Good voice pillars are:- Specific - “Professional yet approachable” not just “professional”
- Actionable - Clear guidance on how to write
- Differentiated - Unique to your brand
- Consistent - All pillars work together harmoniously
- How do we want customers to perceive us?
- What makes our brand different from competitors?
- What personality traits reflect our company culture?
- How would we describe our brand to a friend?
Tone Guidelines
General Tone
Define your overall tone with a clear metaphor: Castos Example:Imagine you’re an experienced podcaster helping a friend succeed. You know what you’re talking about, you genuinely want them to succeed, and you explain things clearly without being patronizing.
Tone by Content Type
Your tone should adapt based on content type while maintaining core voice:Core Brand Messages
Define 3-5 key messages that should be woven throughout content:Structure
Real Example: Castos
How to Use Core Messages
Core messages are themes to incorporate, not scripts to repeat verbatim: ❌ Don’t: Force the same message into every article ✅ Do: Naturally weave relevant messages into appropriate content Example: In an article about podcast editing software, incorporate “Podcasting Made Simple” by emphasizing intuitive interfaces and easy workflows.Value Propositions
Define specific positioning for each customer segment:Writing Style Guidelines
Sentence Structure
Define preferences for:- Length variation - Mix of short and long sentences
- Voice preference - Active voice percentage
- Average length - Target words per sentence
- Clarity standards - Plain language requirements
Word Choice
Document specific word preferences:Terminology
Define industry-specific term usage:- Technical terms and when to define them
- Acronyms and first-use rules
- Product names and capitalization
- Competitive product references
Voice Examples
Excellent Voice Example ✅
Provide a full paragraph that demonstrates your brand voice:Poor Voice Example ❌
Show what NOT to do:Audience Understanding
Primary Audience
Define your main target audience in detail:What They Care About
Document audience priorities and pain points:How to Serve Them
Define principles for serving your audience:Configuration Steps
1. Copy the Template
2. Review the Example
Study the Castos example to understand proper format:3. Define Your Voice Pillars
Brainstorm 3-5 characteristics that define your brand:- How do customers describe you?
- What makes your brand different?
- What personality traits matter to your audience?
- How do you want to be perceived?
4. Document Tone Variations
Write example phrases for each content type:- How-to guides
- Strategic advice
- Industry news
- Product content
5. Articulate Core Messages
Identify 3-5 key themes to incorporate:- What do you want people to know about your brand?
- What unique value do you provide?
- What problems do you solve?
6. Define Your Audience
Document who you write for:- Demographics and firmographics
- Goals and priorities
- Challenges and pain points
- How they consume content
7. Provide Examples
Write both positive and negative examples:- Show excellent brand voice in action
- Demonstrate what NOT to do
- Explain why each example works or fails
8. Test and Refine
Generate sample content and evaluate:Quality Checklist
Before finalizing your brand voice file:- Voice pillars are specific - Not generic traits like “professional”
- Examples are concrete - Actual sentences, not vague descriptions
- Tone variations are clear - Distinct guidance for each content type
- Messages are actionable - Can be naturally incorporated into content
- Audience is well-defined - Clear understanding of who you serve
- Terminology is documented - Preferred terms and usage guidelines
- Positive and negative examples - Show both what to do and avoid
- Tested with content - Generated content matches your expectations
Common Mistakes
Too Generic
❌ Bad: “Be professional and helpful” ✅ Good: “Professional yet approachable—like an experienced podcaster helping a friend succeed”No Examples
❌ Bad: “Use a conversational tone” ✅ Good: “Use a conversational tone: ‘Here’s what you need to know’ not ‘The following information is pertinent‘“Feature-Focused
❌ Bad: “Mention our advanced features” ✅ Good: “Focus on benefits: ‘Save hours with automated distribution’ not ‘Advanced API integration capabilities‘“Inconsistent Pillars
❌ Bad: Mixing “Fun and playful” with “Serious and authoritative” ✅ Good: All pillars should work together harmoniouslyNext Steps
Style Guide
Configure grammar and formatting standards
SEO Guidelines
Define SEO optimization requirements
Write Content
Generate content using your brand voice
Context Files Overview
Learn about all context files