@jack200714/mafw 4.5.1 → 4.5.2

package/.opencode/skills/brand/references/approval-checklist.md

@@ -1,169 +0,0 @@
-# Asset Approval Checklist
-
-Comprehensive checklist for reviewing marketing assets before approval.
-
-## Quick Review
-
-Before detailed review, verify:
-- [ ] Asset serves stated purpose
-- [ ] Target audience appropriate
-- [ ] No obvious errors or issues
-- [ ] Aligns with campaign goals
-
-## Visual Elements
-
-### Logo Usage
-- [ ] Correct logo variant for context
-- [ ] Proper clear space maintained
-- [ ] Minimum size requirements met
-- [ ] Approved colors only
-- [ ] No unauthorized modifications
-- [ ] Appropriate for background
-
-### Color Compliance
-- [ ] Uses brand palette colors only
-- [ ] Primary/secondary ratio appropriate (60/30/10)
-- [ ] Semantic colors used correctly
-- [ ] No off-brand colors introduced
-- [ ] Consistent across all elements
-
-### Typography
-- [ ] Brand fonts used throughout
-- [ ] Correct font weights applied
-- [ ] Proper type hierarchy
-- [ ] Appropriate sizes for medium
-- [ ] Line heights adequate
-- [ ] No orphans/widows in body text
-
-### Imagery
-- [ ] Matches brand photography style
-- [ ] Appropriate subjects/content
-- [ ] Quality meets requirements
-- [ ] Properly licensed/credited
-- [ ] Optimized for intended use
-
-## Accessibility
-
-### Visual Accessibility
-- [ ] Text contrast ratio >= 4.5:1 (AA)
-- [ ] Large text contrast >= 3:1
-- [ ] Interactive elements have visible focus
-- [ ] Color not sole indicator of meaning
-- [ ] Alt text for all images
-
-### Content Accessibility
-- [ ] Clear and scannable layout
-- [ ] Readable font sizes
-- [ ] Logical reading order
-- [ ] Meaningful headings structure
-- [ ] Links describe destination
-
-## Content Quality
-
-### Copy Review
-- [ ] Matches brand voice
-- [ ] Appropriate tone for context
-- [ ] No prohibited terms used
-- [ ] Value proposition clear
-- [ ] CTA compelling and clear
-- [ ] Proofread for errors
-
-### Messaging
-- [ ] Aligns with key messages
-- [ ] Differentiators highlighted
-- [ ] Benefits over features
-- [ ] Target audience addressed
-- [ ] No conflicting claims
-
-## Technical Requirements
-
-### File Specifications
-- [ ] Correct file format
-- [ ] Appropriate resolution
-- [ ] File size optimized
-- [ ] Proper naming convention
-- [ ] Metadata included
-
-### Platform Requirements
-| Platform | Verified |
-|----------|----------|
-| Instagram | [ ] Correct dimensions |
-| Twitter/X | [ ] Meets requirements |
-| LinkedIn | [ ] Professional standards |
-| Facebook | [ ] Guidelines compliant |
-| Email | [ ] Size under 1MB |
-| Web | [ ] Optimized for web |
-
-## Legal & Compliance
-
-### Intellectual Property
-- [ ] Stock images licensed
-- [ ] Music/audio cleared
-- [ ] No trademark violations
-- [ ] User content authorized
-- [ ] Credits included where needed
-
-### Regulatory
-- [ ] Required disclosures present
-- [ ] No misleading claims
-- [ ] Pricing accurate
-- [ ] Terms linked where needed
-- [ ] Privacy compliant
-
-## Review Status
-
-### Reviewer Sign-off
-
-| Review Area | Reviewer | Date | Status |
-|-------------|----------|------|--------|
-| Visual Design | | | [ ] Pass / [ ] Revisions |
-| Copy/Content | | | [ ] Pass / [ ] Revisions |
-| Brand Compliance | | | [ ] Pass / [ ] Revisions |
-| Technical | | | [ ] Pass / [ ] Revisions |
-| Legal | | | [ ] Pass / [ ] Revisions |
-
-### Final Approval
-
-- [ ] All review areas passed
-- [ ] Revisions completed (if any)
-- [ ] Final version uploaded
-- [ ] Metadata updated
-- [ ] Ready for publish/use
-
-**Approved By:** _______________
-
-**Date:** _______________
-
-**Version:** _______________
-
-## Common Issues & Fixes
-
-| Issue | Fix |
-|-------|-----|
-| Logo too small | Increase to minimum size |
-| Wrong font | Replace with brand font |
-| Low contrast | Adjust colors for accessibility |
-| Off-brand color | Replace with palette color |
-| Blurry image | Use higher resolution source |
-| Missing alt text | Add descriptive alt text |
-| Weak CTA | Strengthen action-oriented copy |
-
-## Automation Support
-
-The `validate-asset.cjs` script can auto-check:
-- Color palette compliance
-- Minimum dimensions
-- File format/size
-- Naming convention
-- Basic metadata
-
-Run: `node .claude/skills/brand/scripts/validate-asset.cjs <asset-path>`
-
-## Archival
-
-After approval:
-1. Update asset status in manifest.json
-2. Add approver and timestamp
-3. Move previous versions to archive
-4. Update campaign tracking
-5. Notify relevant teams

package/.opencode/skills/brand/references/asset-organization.md

@@ -1,157 +0,0 @@
-# Asset Organization Guide
-
-Guidelines for organizing marketing assets in a structured, searchable system.
-
-## Directory Structure
-
-```
-project-root/
-├── .assets/                          # Git-tracked metadata
-│   ├── manifest.json                 # Central asset registry
-│   ├── tags.json                     # Tagging system
-│   ├── versions/                     # Version history
-│   │   └── {asset-id}/
-│   │       └── v{n}.json
-│   └── metadata/                     # Type-specific metadata
-│       ├── designs.json
-│       ├── banners.json
-│       ├── logos.json
-│       └── videos.json
-├── assets/                           # Raw files
-│   ├── designs/
-│   │   ├── campaigns/                # Campaign-specific designs
-│   │   ├── web/                      # Website graphics
-│   │   └── print/                    # Print materials
-│   ├── banners/
-│   │   ├── social-media/             # Platform banners
-│   │   ├── email-headers/            # Email template headers
-│   │   └── landing-pages/            # Hero/section images
-│   ├── logos/
-│   │   ├── full-horizontal/          # Full logo with wordmark
-│   │   ├── icon-only/                # Symbol only
-│   │   ├── monochrome/               # Single color versions
-│   │   └── variations/               # Special versions
-│   ├── videos/
-│   │   ├── ads/                      # Promotional videos
-│   │   ├── tutorials/                # How-to content
-│   │   └── testimonials/             # Customer videos
-│   ├── infographics/                 # Data visualizations
-│   └── generated/                    # AI-generated assets
-│       └── {YYYYMMDD}/               # Date-organized
-```
-
-## Naming Convention
-
-### Format
-```
-{type}_{campaign}_{description}_{timestamp}_{variant}.{ext}
-```
-
-### Components
-| Component | Format | Required | Examples |
-|-----------|--------|----------|----------|
-| type | lowercase | Yes | banner, logo, design, video |
-| campaign | kebab-case | Yes* | claude-launch, q1-promo, evergreen |
-| description | kebab-case | Yes | hero-image, email-header |
-| timestamp | YYYYMMDD | Yes | 20251209 |
-| variant | kebab-case | No | dark-mode, 1x1, mobile |
-
-*Use "evergreen" for non-campaign assets
-
-### Examples
-```
-banner_claude-launch_hero-image_20251209_16-9.png
-logo_brand-refresh_horizontal-full-color_20251209.svg
-design_holiday-campaign_email-hero_20251209_dark-mode.psd
-video_product-demo_feature-walkthrough_20251209.mp4
-infographic_evergreen_pricing-comparison_20251209.png
-```
-
-## Metadata Schema
-
-### Asset Entry (manifest.json)
-```json
-{
-  "id": "uuid-v4",
-  "name": "Campaign Hero Banner",
-  "type": "banner",
-  "path": "assets/banners/landing-pages/banner_claude-launch_hero-image_20251209.png",
-  "dimensions": { "width": 1920, "height": 1080 },
-  "fileSize": 245760,
-  "mimeType": "image/png",
-  "tags": ["campaign", "hero", "launch"],
-  "status": "approved",
-  "source": {
-    "model": "imagen-4",
-    "prompt": "...",
-    "createdAt": "2025-12-09T10:30:00Z"
-  },
-  "version": 2,
-  "createdBy": "agent:content-creator",
-  "approvedBy": "user:john",
-  "approvedAt": "2025-12-09T14:00:00Z"
-}
-```
-
-### Version Entry (versions/{id}/v{n}.json)
-```json
-{
-  "version": 2,
-  "previousVersion": 1,
-  "path": "assets/banners/landing-pages/banner_claude-launch_hero-image_20251209_v2.png",
-  "changes": "Updated CTA button color to match brand refresh",
-  "createdAt": "2025-12-09T12:00:00Z",
-  "createdBy": "agent:ui-designer"
-}
-```
-
-## Tagging System
-
-### Standard Tags
-| Category | Values |
-|----------|--------|
-| status | draft, review, approved, archived |
-| platform | instagram, twitter, linkedin, facebook, youtube, email, web |
-| content-type | promotional, educational, brand, product, testimonial |
-| format | 1x1, 4x5, 9x16, 16x9, story, reel, banner |
-| source | imagen-4, veo-3, user-upload, canva, figma |
-
-### Tag Usage
-- Each asset should have: status + platform + content-type
-- Optional: format, source, campaign
-
-## File Organization Best Practices
-
-1. **One file per variant** - Don't combine dark/light in one file
-2. **Source files separate** - Keep .psd/.fig in same structure
-3. **AI assets timestamped** - Auto-organize by generation date
-4. **Archive don't delete** - Move to `archived/` with date prefix
-5. **Large files external** - Videos > 100MB use cloud storage links
-
-## Search Patterns
-
-### By Type
-```bash
-# Find all banners
-ls assets/banners/**/*
-```
-
-### By Campaign
-```bash
-# Find all assets for specific campaign
-grep -l "claude-launch" .assets/manifest.json
-```
-
-### By Status
-```bash
-# Find approved assets only
-jq '.assets[] | select(.status == "approved")' .assets/manifest.json
-```
-
-## Cleanup Workflow
-
-1. Run `extract-colors.cjs` on new assets
-2. Validate against brand guidelines
-3. Update manifest.json with new entries
-4. Tag appropriately
-5. Remove duplicates/outdated versions

package/.opencode/skills/brand/references/brand-guideline-template.md

@@ -1,140 +0,0 @@
-# Brand Guidelines Template
-
-Use this template to create comprehensive brand guidelines for any project.
-
-## Document Structure
-
-```markdown
-# Brand Guidelines v{X.Y}
-
-## Quick Reference
-- **Primary Color:** #XXXXXX
-- **Secondary Color:** #XXXXXX
-- **Primary Font:** {font-family}
-- **Voice:** {3 key traits}
-
-## 1. Color Palette
-
-### Primary Colors
-| Name | Hex | RGB | Usage |
-|------|-----|-----|-------|
-| {Name} | #{hex} | rgb({r},{g},{b}) | Primary brand color, CTAs, headers |
-| {Name} | #{hex} | rgb({r},{g},{b}) | Supporting accent |
-
-### Secondary Colors
-| Name | Hex | RGB | Usage |
-|------|-----|-----|-------|
-| {Name} | #{hex} | rgb({r},{g},{b}) | Secondary elements |
-| {Name} | #{hex} | rgb({r},{g},{b}) | Highlights |
-
-### Neutral Palette
-| Name | Hex | RGB | Usage |
-|------|-----|-----|-------|
-| Background | #{hex} | rgb({r},{g},{b}) | Page backgrounds |
-| Text Primary | #{hex} | rgb({r},{g},{b}) | Body text |
-| Text Secondary | #{hex} | rgb({r},{g},{b}) | Captions, muted text |
-| Border | #{hex} | rgb({r},{g},{b}) | Dividers, borders |
-
-### Accessibility
-- Text/Background Contrast: {ratio}:1 (WCAG {level})
-- CTA Contrast: {ratio}:1
-- All interactive elements meet WCAG 2.1 AA
-
-## 2. Typography
-
-### Font Stack
-```css
---font-heading: '{Font}', sans-serif;
---font-body: '{Font}', sans-serif;
---font-mono: '{Font}', monospace;
-```
-
-### Type Scale
-| Element | Font | Weight | Size (Desktop/Mobile) | Line Height |
-|---------|------|--------|----------------------|-------------|
-| H1 | {font} | 700 | 48px / 32px | 1.2 |
-| H2 | {font} | 600 | 36px / 28px | 1.25 |
-| H3 | {font} | 600 | 28px / 24px | 1.3 |
-| H4 | {font} | 600 | 24px / 20px | 1.35 |
-| Body | {font} | 400 | 16px / 16px | 1.5 |
-| Small | {font} | 400 | 14px / 14px | 1.5 |
-| Caption | {font} | 400 | 12px / 12px | 1.4 |
-
-## 3. Logo Usage
-
-### Variants
-- **Primary:** Full horizontal logo with wordmark
-- **Stacked:** Vertical arrangement for square spaces
-- **Icon:** Symbol only for favicons, app icons
-- **Monochrome:** Single color for limited palettes
-
-### Clear Space
-Minimum clear space = height of logo mark
-
-### Minimum Size
-- Digital: 80px width minimum
-- Print: 25mm width minimum
-
-### Don'ts
-- Don't rotate or skew
-- Don't change colors outside approved palette
-- Don't add effects (shadows, gradients)
-- Don't crop or modify proportions
-- Don't place on busy backgrounds
-
-## 4. Voice & Tone
-
-### Brand Personality
-{Trait 1}: {Description}
-{Trait 2}: {Description}
-{Trait 3}: {Description}
-
-### Voice Chart
-| Trait | We Are | We Are Not |
-|-------|--------|------------|
-| {Trait} | {Description} | {Anti-description} |
-
-### Tone by Context
-| Context | Tone | Example |
-|---------|------|---------|
-| Marketing | {tone} | "{example}" |
-| Support | {tone} | "{example}" |
-| Error Messages | {tone} | "{example}" |
-| Success | {tone} | "{example}" |
-
-### Prohibited Terms
-- {term 1} (reason)
-- {term 2} (reason)
-
-## 5. Imagery Guidelines
-
-### Photography Style
-- {Lighting preference}
-- {Subject guidelines}
-- {Color treatment}
-
-### Illustrations
-- Style: {description}
-- Colors: Brand palette only
-- Stroke: {weight}px
-
-### Icons
-- Style: {outlined/filled/duotone}
-- Size: 24px base grid
-- Corner radius: {value}px
-```
-
-## Usage
-
-1. Copy template above
-2. Fill in brand-specific values
-3. Save as `docs/brand-guidelines.md`
-4. Reference in content workflows
-
-## Extractable Fields
-
-Scripts can extract:
-- `colors.primary`, `colors.secondary`, `colors.neutral`
-- `typography.heading`, `typography.body`
-- `voice.traits`, `voice.prohibited`
-- `logo.variants`, `logo.minSize`

package/.opencode/skills/brand/references/color-palette-management.md

@@ -1,186 +0,0 @@
-# Color Palette Management
-
-Guidelines for defining, extracting, and enforcing brand colors.
-
-## Color System Structure
-
-### Hierarchy
-```
-Primary Colors (1-2)
-├── Main brand color - Used for CTAs, headers, key elements
-└── Supporting primary - Secondary emphasis
-
-Secondary Colors (2-3)
-├── Accent colors - Highlights, interactive states
-└── Supporting visuals - Icons, illustrations
-
-Neutral Palette (3-5)
-├── Background colors - Page, card, modal backgrounds
-├── Text colors - Headings, body, muted text
-└── UI elements - Borders, dividers, shadows
-
-Semantic Colors (4)
-├── Success - #22C55E (green)
-├── Warning - #F59E0B (amber)
-├── Error - #EF4444 (red)
-└── Info - #3B82F6 (blue)
-```
-
-## Color Documentation Format
-
-### Markdown Table
-```markdown
-| Name | Hex | RGB | HSL | Usage |
-|------|-----|-----|-----|-------|
-| Primary Blue | #2563EB | rgb(37,99,235) | hsl(217,91%,53%) | CTAs, links |
-```
-
-### CSS Variables
-```css
-:root {
-  /* Primary */
-  --color-primary: #2563EB;
-  --color-primary-light: #3B82F6;
-  --color-primary-dark: #1D4ED8;
-
-  /* Secondary */
-  --color-secondary: #8B5CF6;
-  --color-accent: #F59E0B;
-
-  /* Neutral */
-  --color-background: #FFFFFF;
-  --color-surface: #F9FAFB;
-  --color-text-primary: #111827;
-  --color-text-secondary: #6B7280;
-  --color-border: #E5E7EB;
-}
-```
-
-### Tailwind Config
-```javascript
-colors: {
-  primary: {
-    DEFAULT: '#2563EB',
-    50: '#EFF6FF',
-    100: '#DBEAFE',
-    500: '#3B82F6',
-    600: '#2563EB',
-    700: '#1D4ED8',
-  }
-}
-```
-
-## Accessibility Requirements
-
-### Contrast Ratios (WCAG 2.1)
-| Level | Normal Text | Large Text | UI Components |
-|-------|-------------|------------|---------------|
-| AA | 4.5:1 | 3:1 | 3:1 |
-| AAA | 7:1 | 4.5:1 | 4.5:1 |
-
-### Checking Contrast
-```javascript
-// Formula for relative luminance
-function luminance(r, g, b) {
-  const [rs, gs, bs] = [r, g, b].map(v => {
-    v /= 255;
-    return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
-  });
-  return 0.2126 * rs + 0.7152 * gs + 0.0722 * bs;
-}
-
-function contrastRatio(l1, l2) {
-  const lighter = Math.max(l1, l2);
-  const darker = Math.min(l1, l2);
-  return (lighter + 0.05) / (darker + 0.05);
-}
-```
-
-## Color Extraction
-
-### From Images
-Use `extract-colors.cjs` script to:
-1. Load image file
-2. Extract dominant colors using k-means clustering
-3. Map to nearest brand colors
-4. Report compliance percentage
-
-### From Brand Guidelines
-Parse markdown to extract:
-- Hex values from tables
-- CSS variable definitions
-- Color names and usage descriptions
-
-## Brand Compliance Validation
-
-### Rules
-1. **Primary color ratio**: 60-70% of design
-2. **Secondary color ratio**: 20-30% of design
-3. **Accent color ratio**: 5-10% of design
-4. **Off-brand tolerance**: Max 20% non-palette colors
-
-### Validation Output
-```json
-{
-  "compliance": 85,
-  "colors": {
-    "brand": ["#2563EB", "#8B5CF6", "#FFFFFF"],
-    "offBrand": ["#FF5500"],
-    "dominant": "#2563EB"
-  },
-  "issues": [
-    "Off-brand color #FF5500 detected (15% coverage)",
-    "Primary color underused (45% vs 60% target)"
-  ]
-}
-```
-
-## Color Usage Guidelines
-
-### Do's
-- Use primary for main CTAs and key elements
-- Maintain consistent hover/active states
-- Test all combinations for accessibility
-- Document color decisions
-
-### Don'ts
-- Use more than 2-3 colors in single component
-- Mix warm and cool tones without intent
-- Use pure black (#000) for text (use #111 or similar)
-- Rely solely on color for meaning (use icons/text too)
-
-## Color Palette Examples
-
-### Tech/SaaS
-```
-Primary: #2563EB (Blue)
-Secondary: #8B5CF6 (Purple)
-Accent: #10B981 (Emerald)
-Background: #F9FAFB
-Text: #111827
-```
-
-### Marketing/Creative
-```
-Primary: #F97316 (Orange)
-Secondary: #EC4899 (Pink)
-Accent: #14B8A6 (Teal)
-Background: #FFFFFF
-Text: #1F2937
-```
-
-### Professional/Corporate
-```
-Primary: #1E40AF (Navy)
-Secondary: #475569 (Slate)
-Accent: #0EA5E9 (Sky)
-Background: #F8FAFC
-Text: #0F172A
-```
-
-## Tools & Resources
-
-- [Coolors](https://coolors.co) - Palette generation
-- [WebAIM Contrast Checker](https://webaim.org/resources/contrastchecker/)
-- [Tailwind Color Reference](https://tailwindcss.com/docs/customizing-colors)
-- [Color Hunt](https://colorhunt.co) - Curated palettes