@mytechtoday/augment-extensions 0.4.0 → 0.7.0

package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/asset-management.md

@@ -0,0 +1,418 @@
+# Asset Management
+
+## Overview
+
+Programmatic asset handling for marketing materials including colors, logos, fonts, and media files. Ensures consistency, accessibility, and efficient organization of brand assets.
+
+---
+
+## File Organization
+
+### Directory Structure
+
+```
+assets/
+├── brand/
+│   ├── logos/
+│   │   ├── primary/
+│   │   ├── secondary/
+│   │   └── variations/
+│   ├── colors/
+│   │   └── palettes.json
+│   └── fonts/
+│       ├── web/
+│       └── print/
+├── media/
+│   ├── images/
+│   │   ├── hero/
+│   │   ├── thumbnails/
+│   │   └── icons/
+│   ├── videos/
+│   └── audio/
+└── templates/
+    ├── email/
+    ├── social/
+    └── print/
+```
+
+### Naming Conventions
+
+**Logos:**
+- `{brand}-logo-{variant}-{size}.{ext}`
+- Example: `acme-logo-primary-1200x600.svg`
+
+**Images:**
+- `{category}-{description}-{dimensions}.{ext}`
+- Example: `hero-homepage-banner-1920x1080.jpg`
+
+**Colors:**
+- Use semantic names in code
+- Example: `brand-primary`, `accent-blue`, `neutral-gray-100`
+
+**Fonts:**
+- `{family}-{weight}-{style}.{ext}`
+- Example: `roboto-700-italic.woff2`
+
+---
+
+## Color Management
+
+### Color Palette JSON Schema
+
+```json
+{
+  "brand": {
+    "primary": {
+      "hex": "#0066CC",
+      "rgb": "0, 102, 204",
+      "cmyk": "100, 50, 0, 20",
+      "pantone": "PMS 300 C",
+      "usage": "Primary brand color for CTAs and headers"
+    },
+    "secondary": {
+      "hex": "#FF6600",
+      "rgb": "255, 102, 0",
+      "cmyk": "0, 60, 100, 0",
+      "pantone": "PMS 1655 C",
+      "usage": "Accent color for highlights"
+    }
+  },
+  "neutral": {
+    "gray-100": "#F5F5F5",
+    "gray-500": "#9E9E9E",
+    "gray-900": "#212121"
+  },
+  "semantic": {
+    "success": "#4CAF50",
+    "warning": "#FFC107",
+    "error": "#F44336",
+    "info": "#2196F3"
+  }
+}
+```
+
+### Accessibility Requirements
+
+- **Contrast Ratio:** Minimum 4.5:1 for normal text, 3:1 for large text (WCAG AA)
+- **Color Blindness:** Don't rely on color alone for information
+- **Testing:** Use tools like WebAIM Contrast Checker
+
+---
+
+## Logo Management
+
+### Logo Variants
+
+**Required Variants:**
+1. **Primary:** Full color, standard usage
+2. **Secondary:** Simplified version for small sizes
+3. **Monochrome:** Black, white, single-color versions
+4. **Reversed:** For dark backgrounds
+
+### Logo Formats
+
+**Digital:**
+- SVG (vector, preferred for web)
+- PNG (transparent background, multiple sizes)
+- WebP (optimized for web)
+
+**Print:**
+- EPS or AI (vector)
+- High-res PNG/TIFF (300 DPI minimum)
+
+### Logo Usage Rules
+
+```yaml
+logo_usage:
+  minimum_size:
+    digital: "120px width"
+    print: "1 inch width"
+  clear_space:
+    rule: "Minimum clear space = height of logo"
+  backgrounds:
+    light: "Use primary logo"
+    dark: "Use reversed logo"
+    busy: "Use logo with background plate"
+  prohibited:
+    - "Stretching or distorting"
+    - "Changing colors"
+    - "Adding effects (shadows, gradients)"
+    - "Placing on low-contrast backgrounds"
+```
+
+---
+
+## Font Management
+
+### Web Fonts
+
+**Loading Strategy:**
+```html
+<!-- Preload critical fonts -->
+<link rel="preload" href="/fonts/roboto-400.woff2" as="font" type="font/woff2" crossorigin>
+
+<!-- Font face declaration -->
+<style>
+@font-face {
+  font-family: 'Roboto';
+  src: url('/fonts/roboto-400.woff2') format('woff2'),
+       url('/fonts/roboto-400.woff') format('woff');
+  font-weight: 400;
+  font-style: normal;
+  font-display: swap;
+}
+</style>
+```
+
+**Performance:**
+- Use `font-display: swap` to prevent FOIT (Flash of Invisible Text)
+- Subset fonts to include only needed characters
+- Use WOFF2 format (best compression)
+
+### Font Pairing
+
+```json
+{
+  "typography": {
+    "headings": {
+      "family": "Montserrat",
+      "weights": [600, 700],
+      "usage": "H1-H6, display text"
+    },
+    "body": {
+      "family": "Open Sans",
+      "weights": [400, 600],
+      "usage": "Paragraphs, UI text"
+    }
+  }
+}
+```
+
+---
+
+## Media Asset Management
+
+### Image Optimization
+
+**Formats:**
+- **JPEG:** Photos, complex images (use 80-85% quality)
+- **PNG:** Graphics with transparency, simple images
+- **WebP:** Modern format, 25-35% smaller than JPEG
+- **SVG:** Icons, logos, simple graphics
+
+**Responsive Images:**
+```html
+<picture>
+  <source srcset="hero-1920.webp" type="image/webp" media="(min-width: 1200px)">
+  <source srcset="hero-1200.webp" type="image/webp" media="(min-width: 768px)">
+  <source srcset="hero-768.webp" type="image/webp">
+  <img src="hero-1200.jpg" alt="Hero banner" loading="lazy">
+</picture>
+```
+
+**Image Sizes:**
+```json
+{
+  "image_sizes": {
+    "thumbnail": "150x150",
+    "small": "300x300",
+    "medium": "768x768",
+    "large": "1200x1200",
+    "hero": "1920x1080",
+    "og_image": "1200x630"
+  }
+}
+```
+
+### Video Assets
+
+**Formats:**
+- **MP4 (H.264):** Universal compatibility
+- **WebM:** Smaller file size, modern browsers
+- **Poster Image:** Always provide fallback image
+
+**Optimization:**
+```json
+{
+  "video_settings": {
+    "resolution": "1080p maximum",
+    "bitrate": "5000 kbps for 1080p",
+    "codec": "H.264 (MP4) or VP9 (WebM)",
+    "audio": "AAC 128 kbps",
+    "compression": "Two-pass encoding"
+  }
+}
+```
+
+---
+
+## Asset Inventory System
+
+### Metadata Schema
+
+```json
+{
+  "asset_id": "img-hero-homepage-001",
+  "type": "image",
+  "category": "hero",
+  "file": {
+    "name": "hero-homepage-banner-1920x1080.jpg",
+    "path": "/assets/media/images/hero/",
+    "size": "245KB",
+    "dimensions": "1920x1080",
+    "format": "JPEG"
+  },
+  "metadata": {
+    "title": "Homepage Hero Banner",
+    "description": "Main hero image for homepage",
+    "alt_text": "Team collaborating on project",
+    "keywords": ["teamwork", "collaboration", "office"],
+    "created_date": "2026-01-15",
+    "created_by": "design-team",
+    "license": "proprietary",
+    "usage_rights": "internal-only"
+  },
+  "versions": [
+    {
+      "size": "1920x1080",
+      "file": "hero-homepage-banner-1920x1080.jpg"
+    },
+    {
+      "size": "1200x675",
+      "file": "hero-homepage-banner-1200x675.jpg"
+    },
+    {
+      "size": "768x432",
+      "file": "hero-homepage-banner-768x432.jpg"
+    }
+  ],
+  "usage": [
+    {
+      "location": "homepage",
+      "url": "https://example.com",
+      "date_added": "2026-01-20"
+    }
+  ]
+}
+```
+
+---
+
+## Version Control for Assets
+
+### Git LFS (Large File Storage)
+
+**Setup:**
+```bash
+# Install Git LFS
+git lfs install
+
+# Track asset types
+git lfs track "*.psd"
+git lfs track "*.ai"
+git lfs track "*.mp4"
+git lfs track "*.mov"
+
+# Commit .gitattributes
+git add .gitattributes
+git commit -m "Configure Git LFS for design assets"
+```
+
+### Asset Versioning
+
+**Naming Convention:**
+```
+{asset-name}-v{major}.{minor}.{ext}
+```
+
+**Examples:**
+- `logo-primary-v1.0.svg` → Initial version
+- `logo-primary-v1.1.svg` → Minor update
+- `logo-primary-v2.0.svg` → Major redesign
+
+---
+
+## CDN and Delivery
+
+### CDN Configuration
+
+```json
+{
+  "cdn": {
+    "provider": "Cloudflare / CloudFront",
+    "base_url": "https://cdn.example.com",
+    "cache_control": {
+      "images": "public, max-age=31536000, immutable",
+      "fonts": "public, max-age=31536000, immutable",
+      "videos": "public, max-age=86400"
+    },
+    "compression": {
+      "gzip": true,
+      "brotli": true
+    }
+  }
+}
+```
+
+### Asset URLs
+
+**Structure:**
+```
+https://cdn.example.com/{type}/{category}/{filename}
+```
+
+**Examples:**
+- `https://cdn.example.com/images/hero/homepage-banner.jpg`
+- `https://cdn.example.com/fonts/roboto-400.woff2`
+- `https://cdn.example.com/logos/primary/logo.svg`
+
+---
+
+## Best Practices
+
+### DO
+
+✅ Use semantic naming for colors and assets
+✅ Provide multiple formats (SVG, PNG, WebP)
+✅ Optimize images before uploading (compress, resize)
+✅ Use version control for all assets
+✅ Document asset usage and licensing
+✅ Implement lazy loading for images
+✅ Use CDN for asset delivery
+✅ Maintain asset inventory with metadata
+
+### DON'T
+
+❌ Hardcode color values in multiple places
+❌ Use generic names like "image1.jpg"
+❌ Upload unoptimized, full-resolution images
+❌ Mix asset types in same directory
+❌ Forget to provide alt text for images
+❌ Use copyrighted assets without permission
+❌ Serve assets from origin server without CDN
+
+---
+
+## Tools and Resources
+
+### Asset Management Tools
+
+- **DAM Systems:** Bynder, Brandfolder, Cloudinary
+- **Image Optimization:** TinyPNG, ImageOptim, Squoosh
+- **Color Tools:** Coolors, Adobe Color, Paletton
+- **Font Tools:** Google Fonts, Adobe Fonts, Font Squirrel
+
+### Validation Tools
+
+- **Contrast Checker:** WebAIM, Contrast Ratio
+- **Image Analysis:** PageSpeed Insights, GTmetrix
+- **Accessibility:** WAVE, axe DevTools
+
+---
+
+## Related Rules
+
+- **brand-consistency.md** - Brand voice and visual identity
+- **legal-compliance.md** - Copyright and licensing
+- **universal-marketing.md** - Cross-cutting standards
+

package/augment-extensions/domain-rules/marketing-standards/seo-sales-marketing/rules/brand-consistency.md

@@ -0,0 +1,210 @@
+# Brand Consistency Standards
+
+## Overview
+
+Guidelines for maintaining consistent brand voice, visual identity, and messaging across all marketing channels.
+
+---
+
+## Brand Voice Guidelines
+
+### Voice Characteristics
+
+Define your brand voice using 3-5 adjectives:
+
+**Examples**:
+- **Professional**: Formal, authoritative, expert
+- **Conversational**: Friendly, approachable, casual
+- **Authoritative**: Confident, knowledgeable, trustworthy
+- **Playful**: Fun, energetic, creative
+- **Empathetic**: Understanding, supportive, caring
+
+### Tone Variations by Context
+
+| Context | Tone | Example |
+|---------|------|---------|
+| Blog Post | Educational, helpful | "Here's how to..." |
+| Social Media | Casual, engaging | "We're excited to share..." |
+| Email | Personal, direct | "You asked, we listened..." |
+| Sales Copy | Persuasive, urgent | "Don't miss out on..." |
+| Support | Empathetic, patient | "We understand your concern..." |
+
+### Voice Consistency Checklist
+
+- [ ] Use consistent pronouns (we/you vs. I/they)
+- [ ] Maintain consistent formality level
+- [ ] Apply consistent humor/seriousness balance
+- [ ] Use consistent industry terminology
+- [ ] Align with brand personality traits
+
+---
+
+## Color Theory and Palette Management
+
+### Color Palette Structure
+
+**Primary Colors** (1-2 colors):
+- Main brand color
+- Used in logos, CTAs, headers
+
+**Secondary Colors** (2-4 colors):
+- Supporting colors
+- Used for accents, highlights, backgrounds
+
+**Neutral Colors** (2-3 colors):
+- Grays, whites, blacks
+- Used for text, backgrounds, borders
+
+### Color Specifications
+
+For each color, define:
+- **Hex**: `#FF5733`
+- **RGB**: `rgb(255, 87, 51)`
+- **CMYK**: `cmyk(0, 66, 80, 0)` (for print)
+- **Pantone**: `PMS 1788 C` (for print)
+
+### Accessibility Requirements
+
+- **Text Contrast**: Minimum 4.5:1 ratio for normal text (WCAG AA)
+- **Large Text Contrast**: Minimum 3:1 ratio for 18pt+ text
+- **Interactive Elements**: Minimum 3:1 contrast for buttons, links
+
+**Tools**: WebAIM Contrast Checker, Coolors.co
+
+---
+
+## Logo Development and Usage Rules
+
+### Logo Variants
+
+**Required Variants**:
+1. **Primary Logo**: Full-color, horizontal
+2. **Secondary Logo**: Full-color, stacked
+3. **Monochrome Logo**: Single-color (black/white)
+4. **Favicon**: 16x16px, 32x32px, 64x64px
+
+### Logo Usage Guidelines
+
+**DO**:
+- Use official logo files (vector formats: SVG, EPS, AI)
+- Maintain minimum clear space (equal to logo height)
+- Use approved color variations only
+- Scale proportionally
+
+**DON'T**:
+- Stretch, skew, or rotate the logo
+- Change logo colors
+- Add effects (shadows, gradients, outlines)
+- Place logo on busy backgrounds
+
+### Minimum Sizes
+
+- **Print**: 0.5 inches wide
+- **Digital**: 120px wide
+- **Favicon**: 32x32px minimum
+
+---
+
+## Typography and Font Stacks
+
+### Font Hierarchy
+
+**Primary Font** (Headings):
+- Font family: `"Montserrat", sans-serif`
+- Weights: 600 (Semi-Bold), 700 (Bold)
+- Use for: H1, H2, H3, CTAs
+
+**Secondary Font** (Body):
+- Font family: `"Open Sans", sans-serif`
+- Weights: 400 (Regular), 600 (Semi-Bold)
+- Use for: Paragraphs, lists, captions
+
+**Monospace Font** (Code):
+- Font family: `"Fira Code", monospace`
+- Use for: Code snippets, technical content
+
+### Font Stack Best Practices
+
+```css
+/* Primary Font Stack */
+font-family: "Montserrat", "Helvetica Neue", Arial, sans-serif;
+
+/* Secondary Font Stack */
+font-family: "Open Sans", "Segoe UI", Roboto, sans-serif;
+
+/* Monospace Font Stack */
+font-family: "Fira Code", "Courier New", monospace;
+```
+
+### Typography Scale
+
+- **H1**: 2.5rem (40px)
+- **H2**: 2rem (32px)
+- **H3**: 1.5rem (24px)
+- **H4**: 1.25rem (20px)
+- **Body**: 1rem (16px)
+- **Small**: 0.875rem (14px)
+
+---
+
+## Visual Identity Consistency
+
+### Image Style Guidelines
+
+- **Photography**: Bright, natural lighting; authentic, candid shots
+- **Illustrations**: Flat design, consistent color palette
+- **Icons**: Line-based, 2px stroke weight, rounded corners
+- **Graphics**: Minimal, clean, data-driven
+
+### Design Principles
+
+1. **Simplicity**: Avoid clutter, use white space
+2. **Consistency**: Repeat visual patterns
+3. **Hierarchy**: Guide eye with size, color, placement
+4. **Alignment**: Use grid systems (12-column)
+5. **Contrast**: Create visual interest with color, size, weight
+
+---
+
+## Tone and Style Guides
+
+### Writing Style
+
+- **Sentence Length**: 15-20 words average
+- **Paragraph Length**: 3-5 sentences
+- **Active Voice**: Preferred over passive
+- **Contractions**: Use for conversational tone
+- **Jargon**: Avoid unless targeting technical audience
+
+### Formatting Standards
+
+- **Headings**: Title case for H1, sentence case for H2-H6
+- **Lists**: Use bullets for unordered, numbers for sequential
+- **Links**: Descriptive anchor text (not "click here")
+- **Emphasis**: Bold for importance, italics for emphasis
+- **Dates**: Month DD, YYYY (e.g., January 31, 2026)
+
+---
+
+## Brand Consistency Checklist
+
+Before publishing any content:
+
+- [ ] Voice matches brand personality
+- [ ] Colors match brand palette
+- [ ] Logo usage follows guidelines
+- [ ] Typography uses approved fonts
+- [ ] Images align with visual style
+- [ ] Tone appropriate for channel
+- [ ] Formatting follows standards
+- [ ] Accessibility requirements met
+
+---
+
+## Resources
+
+- **Color Tools**: Adobe Color, Coolors.co, Paletton
+- **Typography**: Google Fonts, Adobe Fonts, Font Squirrel
+- **Accessibility**: WebAIM, WAVE, axe DevTools
+- **Design**: Figma, Adobe XD, Canva
+