Brand Guidelines

Brand Guidelines

Brand identity, voice, messaging, asset management, and consistency frameworks.

When to Use

• Brand voice definition
• Visual identity standards
• Messaging framework creation
• Content tone guidance
• Brand consistency review
• Style guide development
• Asset organization and naming
• Color palette management
• Typography specifications
• Logo usage validation
• Asset approval workflows

Quick Start

Inject brand context into prompts:

node scripts/inject-brand-context.cjs
node scripts/inject-brand-context.cjs --json

Validate an asset:

node scripts/validate-asset.cjs <asset-path>
node scripts/validate-asset.cjs <asset-path> --json

Extract/compare colors:

node scripts/extract-colors.cjs --palette
node scripts/extract-colors.cjs <image-path>

References

Scripts

Brand Sync Workflow

When updating brand identity, always sync all files:

# 1. Edit docs/brand-guidelines.md (or use /brand:update command)

# 2. Sync to design tokens
node scripts/sync-brand-to-tokens.cjs

# 3. Verify
node scripts/inject-brand-context.cjs --json | head -20

Files synced:

• docs/brand-guidelines.md → Source of truth (human-readable)
• assets/design-tokens.json → Token definitions
• assets/design-tokens.css → CSS variables

Templates

Asset Directory Structure

.assets/                  # Git-tracked metadata
├── manifest.json         # Central asset registry
├── tags.json            # Tagging system
├── versions/            # Version history
└── metadata/            # Type-specific metadata

assets/                   # Raw files
├── designs/             # Campaign, web, print
├── banners/             # Social, email, landing
├── logos/               # Full, icon, mono
├── videos/              # Ads, tutorials, testimonials
├── infographics/
└── generated/           # AI-generated (timestamped)

Naming Convention

{type}_{campaign}_{description}_{timestamp}_{variant}.{ext}

Examples:
banner_claude-launch_hero-image_20251209_16-9.png
logo_brand-refresh_horizontal_20251209.svg

Brand Elements

Voice Dimensions:

• Tone: Formal ↔ Casual
• Language: Simple ↔ Complex
• Character: Serious ↔ Playful
• Emotion: Reserved ↔ Expressive

Visual Elements:

• Logo (primary, secondary, icon)
• Colors (primary, secondary, accent)
• Typography (headers, body)
• Imagery style

Workflows

Voice Development

1. Define brand personality (3-5 traits)
2. Establish tone spectrum
3. Create do's and don'ts
4. Write example content
5. Document in style guide

Asset Approval

1. Create asset following naming convention
2. Run validate-asset.cjs for compliance check
3. Extract colors, compare to palette
4. Complete approval checklist
5. Register in manifest.json

Brand Audit

1. Collect all materials
2. Assess consistency
3. Identify gaps
4. Prioritize fixes
5. Update guidelines

Integration

With ai-multimodal skill:

• Generate brand-aligned images with Imagen 4
• Analyze assets for color compliance
• Create consistent visual content

With content-marketing skill:

• Apply brand voice to all content
• Ensure messaging alignment
• Maintain consistency

Primary Agents: content-creator, social-media-manager, email-wizard, ui-ux-designer

Skill Dependencies: ai-multimodal, content-marketing, social-media

Best Practices

1. Consistency > perfection
2. Voice adapts to context, personality stays same
3. Show examples, not just rules
4. Update guidelines as brand evolves
5. Audit quarterly
6. Register all assets in manifest
7. Use naming conventions strictly