@jack200714/mafw 4.5.1 → 4.8.0

package/.opencode/skills/brand/SKILL.md

@@ -1,97 +0,0 @@
----
-name: brand
-description: Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.
-argument-hint: "[update|review|create] [args]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-# Brand
-
-Brand identity, voice, messaging, asset management, and consistency frameworks.
-
-## When to Use
-
-- Brand voice definition and content tone guidance
-- Visual identity standards and style guide development
-- Messaging framework creation
-- Brand consistency review and audit
-- Asset organization, naming, and approval
-- Color palette management and typography specs
-
-## Quick Start
-
-**Inject brand context into prompts:**
-```bash
-node scripts/inject-brand-context.cjs
-node scripts/inject-brand-context.cjs --json
-```
-
-**Validate an asset:**
-```bash
-node scripts/validate-asset.cjs <asset-path>
-```
-
-**Extract/compare colors:**
-```bash
-node scripts/extract-colors.cjs --palette
-node scripts/extract-colors.cjs <image-path>
-```
-
-## Brand Sync Workflow
-
-```bash
-# 1. Edit docs/brand-guidelines.md (or use /brand update)
-# 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
-- `assets/design-tokens.json` → Token definitions
-- `assets/design-tokens.css` → CSS variables
-
-## Subcommands
-
-| Subcommand | Description | Reference |
-|------------|-------------|-----------|
-| `update` | Update brand identity and sync to all design systems | `references/update.md` |
-
-## References
-
-| Topic | File |
-|-------|------|
-| Voice Framework | `references/voice-framework.md` |
-| Visual Identity | `references/visual-identity.md` |
-| Messaging | `references/messaging-framework.md` |
-| Consistency | `references/consistency-checklist.md` |
-| Guidelines Template | `references/brand-guideline-template.md` |
-| Asset Organization | `references/asset-organization.md` |
-| Color Management | `references/color-palette-management.md` |
-| Typography | `references/typography-specifications.md` |
-| Logo Usage | `references/logo-usage-rules.md` |
-| Approval Checklist | `references/approval-checklist.md` |
-
-## Scripts
-
-| Script | Purpose |
-|--------|---------|
-| `scripts/inject-brand-context.cjs` | Extract brand context for prompt injection |
-| `scripts/sync-brand-to-tokens.cjs` | Sync brand-guidelines.md → design-tokens.json/css |
-| `scripts/validate-asset.cjs` | Validate asset naming, size, format |
-| `scripts/extract-colors.cjs` | Extract and compare colors against palette |
-
-## Templates
-
-| Template | Purpose |
-|----------|---------|
-| `templates/brand-guidelines-starter.md` | Complete starter template for new brands |
-
-## Routing
-
-1. Parse subcommand from `$ARGUMENTS` (first word)
-2. Load corresponding `references/{subcommand}.md`
-3. Execute with remaining arguments

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`