brand-compliance

namespace	aiwg
name	brand-compliance
platforms	["all"]
description	Validate brand compliance across visual, verbal, and legal dimensions with actionable reports

brand-compliance

Unified brand compliance validation across visual, verbal, and legal dimensions.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "brand police" → brand guideline enforcement
• "on-brand check" → brand consistency validation

Purpose

This skill provides comprehensive brand compliance validation by:

• Checking visual identity (colors, logos, typography)
• Validating verbal identity (tone, voice, terminology)
• Verifying claims and legal requirements
• Ensuring accessibility compliance
• Generating actionable compliance reports

Behavior

When triggered, this skill:

1. Loads brand guidelines:

   • Visual identity from .aiwg/marketing/brand/
   • Voice profile from voice-framework
   • Legal requirements from compliance config

2. Analyzes visual elements:

   • Color palette compliance
   • Logo usage correctness
   • Typography standards
   • Layout and spacing

3. Validates verbal content:

   • Tone consistency with brand voice
   • Terminology correctness
   • Messaging alignment
   • Tagline usage

4. Checks legal compliance:

   • Claims substantiation
   • Required disclosures
   • Trademark usage
   • Privacy statements

5. Validates accessibility:

   • WCAG 2.1 AA standards
   • Color contrast ratios
   • Alt text presence
   • Readable font sizes

6. Generates compliance report:

   • Pass/fail per criterion
   • Issue severity ratings
   • Specific corrections needed
   • Overall compliance score

Validation Dimensions

Visual Identity

visual_checks:
  colors:
    - primary_colors_only: Verify only brand colors used
    - color_ratios: Check 60-30-10 rule
    - contrast_compliance: WCAG AA contrast

  logo:
    - correct_version: Right logo variant for context
    - clear_space: Minimum padding around logo
    - no_modifications: Logo not altered
    - proper_placement: Correct position

  typography:
    - approved_fonts: Only brand typefaces
    - hierarchy: Proper heading structure
    - minimum_sizes: Legible  
        

  
        
       
       

Verbal Identity

verbal_checks:
  tone:
    - voice_consistency: Matches brand voice profile
    - formality_level: Appropriate for channel
    - personality_traits: Brand personality evident

  terminology:
    - approved_terms: Using brand glossary
    - product_names: Correct product naming
    - banned_phrases: No prohibited language

  messaging:
    - value_prop_alignment: Core messages present
    - tagline_usage: Correct tagline application
    - call_to_action: On-brand CTAs

  grammar:
    - style_guide: AP/Chicago/Brand style
    - capitalization:   
       

Legal Compliance

legal_checks:
  claims:
    - substantiation: Claims have evidence
    - comparative: Fair comparison rules
    - testimonials: Proper disclaimers

  disclosures:
    - required_statements: Mandatory disclosures
    - placement: Visible disclosure location
    - font_size: Legible disclosure text

  trademarks:
    - proper_symbols: ® and ™ usage
    - third_party: Licensed usage
    - no_infringement: No trademark violations

  privacy:
    - data_collection: Privacy notice present
    - consent: Opt-in mechanisms
         

Accessibility

accessibility_checks:
  wcag:
    - contrast_ratio: Minimum 4.5:1 text, 3:1 UI
    - text_alternatives: Alt text for images
    - keyboard_navigation: Focusable elements
    - readable_text: No text in images

  inclusive:
    - plain_language: Readable content
    - color_independence: Info not color-only
    - responsive: Mobile accessible

Compliance Report Format

# Brand Compliance Report

**Asset**: Summer Campaign Hero Banner
**Date**: 2025-12-08
**Reviewer**: brand-compliance skill

## Summary

| Dimension | Score | Status |
|-----------|-------|--------|
| Visual Identity | 95% | ✅ Pass |
| Verbal Identity | 88% | ⚠️ Minor Issues |
| Legal Compliance | 100% | ✅ Pass |
| Accessibility | 75% | ⚠️ Needs Attention |
| **Overall** | **90%** | **Conditional Pass** |

## Visual Identity

### ✅ Colors
- Primary blue (#0066CC) used correctly
- Secondary green (#00AA55) in accent areas
- No off-brand colors detected

### ✅ Logo
- Correct horizontal logo version
- Clear space maintained (1x height)
- No modifications to logo

### ⚠️ Typography
- **Issue**: Body text uses Arial instead of Inter
- **Severity**: Medium
- **Fix**: Replace Arial with Inter Regular

## Verbal Identity

### ✅ Tone
- Voice consistent with "Friendly Professional" profile
- Appropriate formality for social media channel

### ⚠️ Terminology
- **Issue**: "Best-in-class" used (prohibited phrase)
- **Severity**: High
- **Fix**: Replace with specific benefit statement

### ✅ Messaging
- Value proposition clearly stated
- CTA "Start Free Trial" is on-brand

## Legal Compliance

### ✅ Claims
- All claims substantiated
 No comparative claims


 Trademark symbols present
 Terms link visible




 : White text on light blue (3.2:1 ratio)
 : High
 : Darken background or use darker text
 : WCAG AA requires 4.5:1


 : Hero image missing alt text
 : High
 : Add descriptive alt text



| Priority | Issue | Location | Fix |
|----------|-------|----------|-----|
| High | Low contrast | Hero text | Darken background |
| High | Missing alt text | Hero image | Add alt attribute |
| High | Banned phrase | Body copy | Replace "best-in-class" |
| Medium | Wrong font | Body text | Use Inter, not Arial |



: CONDITIONAL APPROVAL

Asset may proceed after addressing:
 [ ] High-priority accessibility issues
 [ ] Banned phrase removal

Re-review recommended after corrections.

Usage Examples

Full Brand Review

User: "Brand review for the new landing page"

Skill validates:
1. Visual: colors, logo, typography
2. Verbal: tone, terms, messaging
3. Legal: claims, disclosures, trademarks
4. Accessibility: contrast, alt text

Output:
"Brand Compliance: 90% (Conditional Pass)

Issues Found:
- High: Low contrast ratio (3.2:1, need 4.5:1)
- High: Missing alt text on 2 images
- Medium: Body font incorrect

Report: .aiwg/marketing/reviews/brand-landing-page.md"

Quick Tone Check

User: "Is this copy on-brand?"

Skill analyzes:
- Voice consistency
- Terminology
- Messaging alignment

Output:
"Tone Analysis: ✅ On-brand

Voice: Friendly Professional (matches profile)
Terminology: All approved terms
Messaging: Value prop present

One suggestion: CTA could be more action-oriented"

Legal Review Focus

User: "Check claims compliance"

Skill validates:
- Claim substantiation
- Comparative statements
- Required disclosures

Output:
"Claims Compliance: ⚠️ Issues Found

- Claim 'fastest in industry' needs substantiation
- Missing source citation for statistics
- Disclosure font too small (8pt, need 10pt)"

Integration

This skill uses:

• parallel-dispatch: Launch Brand Guardian + Legal + Accessibility
• voice-framework: Load brand voice profile for tone validation
• project-awareness: Find brand guidelines location

Agent Orchestration

agents:
  visual_review:
    agent: brand-guardian
    focus: Visual identity validation

  verbal_review:
    agent: brand-guardian
    focus: Verbal identity and tone

  legal_review:
    agent: legal-reviewer
    focus: Claims, disclosures, trademarks

  accessibility_review:
    agent: accessibility-checker
    focus: WCAG compliance, inclusive design

  quality_check:
    agent: quality-controller
    focus: Technical specs, rendering

Configuration

Brand Guidelines Location

brand_config:
  guidelines_dir: .aiwg/marketing/brand/
  voice_profile: .aiwg/voices/brand-voice.yaml
  color_palette: brand/colors.yaml
  typography: brand/typography.yaml
  logo_specs: brand/logo-usage.md
  terminology: brand/glossary.yaml
  banned_phrases: brand/banned-phrases.yaml

Severity Thresholds

severity:
  blocking:
    - trademark_violation
    - missing_required_disclosure
    - wcag_level_a_failure

  high:
    - banned_phrase
    - contrast_below_aa
    - missing_alt_text
    - wrong_logo_version

  medium:
    - wrong_font
    - color_off_palette
    - tone_inconsistency

  low:
    - minor_spacing
    - style_preference

Output Locations

• Compliance report: .aiwg/marketing/reviews/brand-{asset}-{date}.md
• Issue tracker: .aiwg/marketing/reviews/brand-issues.json
• Approval records: .aiwg/marketing/approvals/

References

• Brand guidelines: .aiwg/marketing/brand/
• Voice profiles: voice-framework addon
• WCAG guidelines: https://www.w3.org/WAI/WCAG21/quickref/
• Templates: templates/governance/brand-compliance-checklist.md