ui-pro-forge-cli 2.5.0

package/assets/skills/banner-design/references/banner-sizes-and-styles.md

@@ -0,0 +1,118 @@
+# Banner Sizes & Art Direction Styles Reference
+
+## Complete Banner Sizes
+
+### Social Media
+| Platform | Type | Size (px) | Aspect Ratio |
+|----------|------|-----------|--------------|
+| Facebook | Cover (desktop) | 820 × 312 | ~2.6:1 |
+| Facebook | Cover (mobile) | 640 × 360 | ~16:9 |
+| Facebook | Event cover | 1920 × 1080 | 16:9 |
+| Twitter/X | Header | 1500 × 500 | 3:1 |
+| Twitter/X | Ad banner | 800 × 418 | ~2:1 |
+| LinkedIn | Company cover | 1128 × 191 | ~6:1 |
+| LinkedIn | Personal banner | 1584 × 396 | 4:1 |
+| YouTube | Channel art | 2560 × 1440 | 16:9 |
+| YouTube | Safe area | 1546 × 423 | ~3.7:1 |
+| Instagram | Stories | 1080 × 1920 | 9:16 |
+| Instagram | Post | 1080 × 1080 | 1:1 |
+| Pinterest | Pin | 1000 × 1500 | 2:3 |
+
+### Web / Display Ads (Google Display Network)
+| Name | Size (px) | Notes |
+|------|-----------|-------|
+| Medium Rectangle | 300 × 250 | Highest CTR |
+| Leaderboard | 728 × 90 | Top of page |
+| Wide Skyscraper | 160 × 600 | Sidebar |
+| Half Page | 300 × 600 | Premium |
+| Large Rectangle | 336 × 280 | High performer |
+| Mobile Banner | 320 × 50 | Mobile default |
+| Large Mobile | 320 × 100 | Mobile hero |
+| Billboard | 970 × 250 | Desktop hero |
+
+### Website
+| Type | Size (px) |
+|------|-----------|
+| Full-width hero | 1920 × 600–1080 |
+| Section banner | 1200 × 400 |
+| Blog header | 1200 × 628 |
+| Email header | 600 × 200 |
+
+### Print
+| Type | Size |
+|------|------|
+| Roll-up | 850mm × 2000mm |
+| Step-and-repeat | 8ft × 8ft |
+| Vinyl outdoor | 6ft × 3ft |
+| Trade show | 33in × 78in |
+
+## 22 Art Direction Styles
+
+1. **Minimalist** — White space dominant, single focal element, 1-2 colors, clean sans-serif
+2. **Bold Typography** — Type IS the design; oversized, expressive letterforms fill canvas
+3. **Gradient / Color Wash** — Smooth transitions, mesh gradients, chromatic blends
+4. **Photo-Based** — Full-bleed photography with text overlay; hero lifestyle imagery
+5. **Illustrated / Hand-Drawn** — Custom illustrations, bespoke icons, artisan feel
+6. **Geometric / Abstract** — Shapes, lines, grids as primary visual elements
+7. **Retro / Vintage** — Distressed textures, muted palettes, serif type, halftone dots
+8. **Glassmorphism** — Frosted glass panels, blur backdrop, subtle border glow
+9. **3D / Sculptural** — Rendered objects, depth, shadows; product-centric
+10. **Neon / Cyberpunk** — Dark backgrounds, glowing neon accents, high contrast
+11. **Duotone** — Two-color photo treatment; bold brand color overlay on image
+12. **Editorial / Magazine** — Grid-heavy layouts, pull quotes, journalistic composition
+13. **Collage / Mixed Media** — Cut-paper textures, photo cutouts, layered elements
+14. **Retro Futurism** — Space-age nostalgia, chrome, gradients, optimism
+15. **Expressive / Anti-Design** — Chaotic layouts, mixed fonts, deliberate "wrong" composition
+16. **Digi-Cute / Kawaii** — Rounded shapes, pastel gradients, pixel art, playful characters
+17. **Tactile / Sensory** — Puffy/squishy textures, hyper-real materials, embossed feel
+18. **Data / Infographic** — Stats front-and-center, charts, numbers as heroes
+19. **Dark Mode / Moody** — Near-black backgrounds, rich jewel tones, high contrast
+20. **Flat / Solid Color** — Single background color, clean icons, no gradients
+21. **Nature / Organic** — Earthy tones, botanical motifs, sustainable brand feel
+22. **Motion-Ready / Kinetic** — Designed for animation; layered elements, loopable
+
+## Design Principles
+
+### Visual Hierarchy (3-Zone Rule)
+- **Top**: Logo or main value prop
+- **Middle**: Supporting message + visuals
+- **Bottom**: CTA (button/QR/URL)
+
+### Safe Zones
+- Critical content in central 70-80% of canvas
+- Avoid text/CTA within 50-100px of edges
+- YouTube: 1546 × 423px safe area inside 2560 × 1440
+- Meta/Instagram: central 80% to avoid UI chrome
+
+### CTA Rules
+- One CTA per banner
+- High contrast vs background
+- Bottom-right placement (terminal area)
+- Min 44px height for mobile tap targets
+- Action verbs: "Get", "Start", "Download", "Claim"
+
+### Typography
+- Max 2 typefaces per banner
+- Min 16px body, ≥32px headline (digital)
+- Min 4.5:1 contrast ratio
+- Max 7 words/line, 3 lines for ads
+
+### Text-to-Image Ratio
+- Ads: under 20% text (Meta penalizes)
+- Social covers: 60/40 image-to-text
+- Print: 70pt+ headlines for 3-5m viewing distance
+
+### Print Specs
+- 300 DPI minimum (150 DPI for large format)
+- 3-5mm bleed all sides
+- CMYK color mode
+- 1pt per foot viewing distance rule
+
+## Pinterest Research Queries
+
+Use these search queries on Pinterest for art direction references:
+- `[purpose] banner design [style]` (e.g., "social media banner minimalist")
+- `[platform] cover design inspiration` (e.g., "youtube channel art design")
+- `creative banner layout [industry]` (e.g., "creative banner layout tech startup")
+- `[style] graphic design 2026` (e.g., "gradient graphic design 2026")
+- `banner ad design [product type]` (e.g., "banner ad design saas")

package/assets/skills/brand/SKILL.md

@@ -0,0 +1,97 @@
+---
+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: kterfan
+  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/assets/skills/brand/references/approval-checklist.md

@@ -0,0 +1,169 @@
+# 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/assets/skills/brand/references/asset-organization.md

@@ -0,0 +1,157 @@
+# 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/assets/skills/brand/references/brand-guideline-template.md

@@ -0,0 +1,140 @@
+# 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`