Brand Context Generator

Brand Context Generator

# Brand Context Generator

Author: Echo Rose | Version: 1.0.0 | Price: $7.99 | Category: Marketing & Content Creation ---

AI agents produce generic, brand-blind output by default. When you ask an AI to write a tweet, draft an email, or generate ad copy, it reaches for generic language that could belong to any company. The result is content that: - Sounds like every other AI-generated piece - Misses your brand's specific tone, vocabulary, and personality - Requires extensive manual editing to feel on-brand - Wastes hours of human review time per piece of content - Creates inconsistency across channels, team members, and content types The root cause is simple: the AI doesn't know who you are. Prompting your brand guidelines into every request is impractical, inconsistent, and lossy. You need a structured, reusable brand context that any AI agent can consume before generating content. ---

What It Does

• Voice Profile Engine — Defines tone dimensions, vocabulary lists, personality traits, and communication principles in a machine-readable format
• Visual Identity Token System — Captures color palettes, typography choices, imagery direction, and design principles as structured data
• Strategic Positioning Framework — Stores mission, vision, core values, unique value proposition, and competitive landscape in a queryable structure
• Ideal Customer Profile (ICP) — Models demographics, psychographics, pain points, and buying triggers for audience-aware generation
• Template Rendering Engine — Converts brand data into formatted reports using a lightweight Jinja2-style template language with loops, variable substitution, and join filters
• CLI with Two Commands — `init` scaffolds a new brand context folder; `generate` produces a formatted brand report from your config

Frameworks/Standards Covered

| Framework / Standard | Application | |---|---| | Brand Voice Matrix | Tone, vocabulary, and personality dimensions mapped to communication contexts | | Design Token Methodology | Colors, typography, and spacing stored as semantic tokens (inspired by W3C Design Tokens) | | ICP Modeling (Jobs-to-be-Done) | Demographics, psychographics, pain points, and buying triggers structured for audience targeting | | Competitive Positioning Map | Mission, vision, UVP, and competitor landscape aligned with Porter's Generic Strategies | | Jinja2/NG-Template Syntax | Template rendering with for-loops, variable substitution, and join filters | | WCAG Accessibility Standards | Design principles reference accessible color contrast and typography | | Agile Brand Guidelines | Iterative, version-controlled brand documentation suitable for CI/CD workflows | ---

Detailed Feature Breakdown

### 1. Voice Profile Engine The voice profile captures the full spectrum of brand communication style. Unlike a flat list of adjectives, it structures tone across multiple dimensions, defines specific vocabulary preferences, and documents communication principles that guide content generation. - Multi-dimensional tone mapping (primary, secondary, formal/casual axes) - Controlled vocabulary list with preferred terminology and banned words - Personality traits with behavioral manifestations - Communication principles with do/don't examples - Context-specific voice adjustments (social vs. formal vs. technical) ### 2. Visual Identity Token System Stores design system information as structured data that AI agents can reference when generating visual content, mockups, or design recommendations. - Primary and secondary color palettes with hex values - Typography stack with heading and body font specifications - Imagery direction guidelines - Design principles (minimalist, accessible, mobile-first, etc.) - Reference to WCAG AA+ accessibility requirements ### 3. Strategic Positioning Framework Captures the brand's market position so AI agents can make strategic decisions aligned with business objectives. - Mission and vision statements - Core values hierarchy - Unique value proposition with proof points - Competitive landscape with differentiation analysis - Brand architecture and sub-brand relationships ### 4. Ideal Customer Profile (ICP) Structures audience data so AI content targets the right people with the right message. - Demographic filters (age, income, job roles, industries) - Psychographic mapping (goals, challenges, values, aspirations) - Pain points ranked by severity - Buying triggers and decision criteria - Channel preferences and content format preferences ### 5. Template Rendering Engine Converts the YAML configuration into a formatted markdown report using a custom template language that supports: - `{{ variable.path }}` syntax for nested data access - `{% for item in list %}` loops for iterating over arrays - `{% for key, value in dict.items() %}` loops for dictionary iteration - `{{ list | join(", ") }}` filter for inline array rendering - `{{ generation_date }}` automatic timestamp injection - Recursive path resolution for deeply nested structures ### 6. CLI Commands `init` — Scaffolds a complete brand context folder structure with default config and template. ``` python3 scripts/cli.py init --output ./my-brand ``` Creates: `brand_config.yaml`, `templates/brand_report.md`, `reports/` directory. `generate` — Renders the template with config data into a final brand report. ``` python3 scripts/cli.py generate --config config/brand_config.yaml --output reports/brand_report.md ``` Produces a fully populated markdown report with all brand data. ---

Quick Start

```bash
# 1. Initialize a new brand context folder
python3 scripts/cli.py init --output ./my-brand

# 2. Edit the config file with your brand data
#    vim ./my-brand/brand_config.yaml

# 3. Generate the brand report
python3 scripts/cli.py generate \
  --config ./my-brand/brand_config.yaml \
  --output ./my-brand/reports/brand_report.md

# 4. Point your AI agent at it
#    "Read ./my-brand/ before generating any content."
```

Configuration Example (brand_config.yaml)

```yaml brand: name: "Acme SaaS" tagline: "Enterprise automation, simplified" description: "Acme SaaS provides no-code workflow automation for enterprise teams." voice: tone: ["confident", "professional", "slightly witty"] vocabulary: - "automate" - "workflow" - "integration" - "streamline" personality: - "Confident expert" - "Approachable innovator" communication_principles: - "Lead with value, not features" - "Use concrete examples over abstractions" - "Acknowledge competitor strengths honestly" - "End with a clear next step" visual: primary_colors: ["#1A237E", "#0D47A1", "#1565C0"] secondary_colors: ["#FF6F00", "#00838F", "#2E7D32"] typography: heading_font: "Inter" body_font: "Inter" imagery_direction: "Clean, professional product screenshots with diverse teams" design_principles: - "Accessible (WCAG AAA)" - "Data-dense but readable" - "Consistent spacing 8px grid" positioning: mission: "Make enterprise automation accessible to every team" vision: "A world where any employee can automate their workflows without IT" values: - "Simplicity over complexity" - "Reliability at scale" - "Customer empathy" unique_value_proposition: "The only no-code automation platform with enterprise-grade security and consumer-grade ease of use." competitive_landscape: "Zapier": "Broader integration library but lacks enterprise governance" "Make": "Better for complex scenarios but steeper learning curve" icp: demographics: age_range: "28-50" income_level: "$80k-$200k" job_roles: ["Operations Manager", "IT Director", "Head of Automation"] industries: ["Financial Services", "Healthcare", "Enterprise SaaS"] psychographics: goals: ["Reduce manual processes", "Improve compliance", "Scale without headcount"] challenges: ["Shadow IT", "Integration complexity", "Change management"] values: ["Efficiency", "Compliance", "Innovation"] pain_points: - "IT backlog blocks process improvements" - "Manual processes cause errors and delays" - "Compliance requirements slow down innovation" buying_triggers: - "Audit finding related to manual processes" - "New compliance regulation" - "Department head requesting automation budget" ``` ---

Output Format

The generated brand report is a structured markdown document with these sections: ``` # Brand Name -- Brand Context Folder

1. Brand Overview (table with name, tagline, description)

2. Voice Profile (tone, vocabulary, personality, principles)

3. Visual Identity Tokens (colors, typography, imagery)

4. Strategic Positioning (mission, vision, values, UVP, competitors)

5. Ideal Customer Profile (demographics, psychographics, pain points, triggers)

Generated on 2026-07-06 12:00:00 | Brand Context Folder Generator by Echo Rose ``` Example snippet from a generated report: ``` ### Tone - confident - professional - slightly witty ### Core Values - Simplicity over complexity - Reliability at scale - Customer empathy ### Pain Points - IT backlog blocks process improvements - Manual processes cause errors and delays - Compliance requirements slow down innovation ``` ---

Why This Beats Prompting It Yourself

Dimension Prompting It Yourself Brand Context Generator --- --- --- Setup time 5-10 min per session, rewriting guidelines 30 seconds: `init` + edit config once Consistency Each session drifts; tone changes day to day Same config, same output, every time Depth 2-3 tone keywords, maybe a style note 30+ structured fields across 5 dimensions Portability In your head or a messy doc Portable folder, works with any AI agent Version control None YAML config goes in git Team alignment Everyone has their own interpretation Single source of truth, machine-readable AI agent integration Manual copy-paste into chat "Read this folder" -- the agent loads it like a file ---

Use Cases

• Content marketing teams — Generate on-brand blog posts, social media content, and email campaigns without manual brand guideline checking. Hand the agent the brand context folder and let it produce 5 variations of a LinkedIn post in the brand's voice.
• Agency onboarding — When a new client comes on board, run the generator to create their brand context. Share the folder with every team member and every AI tool they use. Eliminates the 2-week "learning the brand" period.
• Freelance designers & writers — Maintain a brand context folder for each client. Before starting any project, tell the AI agent to load the folder. No more re-reading style guides or guessing the tone.
• Enterprise brand governance — Store brand context folders in a shared drive. Marketing ops runs `generate` after quarterly brand updates and distributes the updated folder. Every AI-generated asset automatically respects the latest guidelines.
• Startup scaling — Early-stage startups lack formal brand guidelines. The generator forces the team to define voice, positioning, and ICP in a structured way. As the company grows, the config evolves in git alongside the product.

Support

For issues, feature requests, or custom brand context integrations, contact the author at the Agensi marketplace. Author: Echo Rose | SKILL.md v1.0.0