expxagents 0.25.1 → 0.25.2

package/assets/core/best-practices/image-design.md

@@ -0,0 +1,78 @@
+---
+platform: universal
+format: image-design
+constraints:
+  max_chars: null
+  image_ratio: null
+  max_hashtags: null
+---
+
+# Best Practices: Image Design
+
+## Core Principles
+
+Visual content communicates faster than text and sets the first impression. Every image asset should be intentional in its composition, on-brand in its aesthetics, and technically optimized for its delivery platform.
+
+- **Purpose first.** Ask: what should the viewer feel, understand, or do as a result of seeing this image?
+- **Brand cohesion.** Consistent color palette, typography, and visual style create recognition across touchpoints.
+- **Technical precision.** Deliver at the correct dimensions, resolution, and file format for each platform.
+
+## Technical Specifications by Platform
+
+| Platform | Format | Dimensions | Max File Size |
+|----------|--------|------------|---------------|
+| Instagram Feed | Square | 1080x1080px | 8MB |
+| Instagram Feed | Portrait | 1080x1350px | 8MB |
+| Instagram Stories / Reels | Vertical | 1080x1920px | 30MB |
+| LinkedIn Feed | Horizontal | 1200x627px | 5MB |
+| Twitter/X | Horizontal | 1200x675px | 5MB |
+| YouTube Thumbnail | Horizontal | 1280x720px | 2MB |
+| YouTube Shorts | Vertical | 1080x1920px | — |
+| Blog Featured | Horizontal | 1200x628px | < 200KB (web) |
+| Email Banner | Horizontal | 600x200px | < 100KB |
+| WhatsApp | Any | Max 1600px wide | 5MB |
+
+## Design Structure
+
+```
+[BRAND LAYER]
+- Color palette: 2–3 primary colors; 1–2 accent colors
+- Typography: 1 display font (headlines), 1 body font (captions)
+- Logo position: consistent corner placement at consistent size
+
+[HIERARCHY LAYER]
+- Focal point: one dominant element that the eye lands on first
+- Secondary elements: support without competing
+- Negative space: intentional emptiness that prevents visual noise
+
+[TEXT OVERLAY (if applicable)]
+- Max 20% of image area covered by text (for ad approval compliance)
+- Minimum font size: 24px for mobile readability
+- Text contrast: 4.5:1 minimum ratio against background (WCAG AA)
+
+[CTA LAYER (for ads/promotional assets)]
+- Button or arrow graphic indicating next action
+- Urgency element (countdown, "Limited", "Free")
+```
+
+## Guidelines
+
+- Use a 3-column, 3-row grid as the foundation for composition (rule of thirds).
+- High-contrast images perform better in feed environments — busy backgrounds cause content to disappear.
+- Real people and faces drive significantly more engagement than illustrations or product-only shots.
+- Accessible color contrast: use WebAIM Contrast Checker to verify text legibility.
+- Deliver web images as WebP (lossy compression, smaller files than JPEG at equivalent quality).
+- Maintain a master asset library with source files (Figma, Adobe) separate from exported deliverables.
+- Always include descriptive alt text when images are published digitally.
+- Test image performance: A/B test thumbnail variations using a 50/50 split for 48 hours before choosing a winner.
+
+## File Format Guide
+
+| Use Case | Format | Reason |
+|----------|--------|--------|
+| Photos with no transparency | JPEG / WebP | Smallest file size |
+| Logos, icons, graphics | PNG-24 | Lossless + transparency |
+| Animated graphics | GIF / WebP (animated) | Cross-platform animated |
+| Web images | WebP | Best quality-to-size ratio |
+| Print | TIFF / PDF | Lossless, print-ready |
+| Social media | JPEG or PNG | Universal compatibility |

package/assets/core/best-practices/instagram-feed.md

@@ -0,0 +1,70 @@
+---
+platform: instagram
+format: feed-post
+constraints:
+  max_chars: 2200
+  image_ratio: "1:1"
+  max_hashtags: 30
+---
+
+# Best Practices: Instagram — Feed Post
+
+## Format Rules
+
+- Caption limit: 2200 characters (only the first ~125 shown before "more")
+- Image aspect ratio: 1:1 (square) preferred; 4:5 portrait also supported; 1.91:1 landscape accepted
+- Resolution: minimum 1080x1080px for square; 1080x1350px for portrait
+- Hashtags: up to 30 allowed; 5–15 is the effective sweet spot
+- Emojis count toward character limit
+- First line must hook — it appears in the feed preview
+
+## Structure
+
+```
+[HOOK LINE — 1 punchy sentence]
+
+[BODY — 3 to 6 short paragraphs, each 1–3 lines]
+- Break up text with line breaks (double return)
+- Use emojis sparingly to guide the eye
+- End with a question or call-to-action
+
+[CTA — direct instruction: "Save this", "Tag a friend", "Link in bio"]
+
+[HASHTAGS — either inline or grouped at end, 5–15 relevant tags]
+```
+
+## Guidelines
+
+- **Hook is everything.** The first line determines whether the reader taps "more."
+- Write for skimmability: short paragraphs, clear breaks, bold ideas stated plainly.
+- Avoid engagement-bait phrases ("double tap if you agree") — they violate Instagram policies.
+- Mix broad hashtags (1M+ posts) with niche ones (10K–100K) for optimal reach.
+- Post carousel posts (up to 10 slides) for significantly higher engagement than single images.
+- Alt text should describe the image for accessibility and SEO.
+- Geo-tagging and product tags increase discovery.
+- Best posting times: weekdays 11 AM–1 PM and 7–9 PM (audience's local time).
+
+## Examples
+
+**Hook variants:**
+- "3 years ago I had zero clients. Here's what changed."
+- "Most people skip this step — and wonder why nothing works."
+- "Hot take: consistency beats creativity every single time."
+
+**Full caption (condensed example):**
+```
+Nobody tells you content creation is 80% strategy and 20% execution.
+
+Here's the framework that took me from 0 to 10K followers in 90 days:
+
+1. Pick ONE topic and go deep
+2. Post at least 4x per week
+3. Study your top 3 competitors
+4. Test hooks until one lands
+
+The platform rewards clarity over cleverness.
+
+Which step do you struggle with most? Drop it below.
+
+#contentcreator #instagramgrowth #socialmediatips #creatoreconomy #digitalmarketing
+```

package/assets/core/best-practices/instagram-reels.md

@@ -0,0 +1,75 @@
+---
+platform: instagram
+format: reels
+constraints:
+  max_chars: 2200
+  image_ratio: "9:16"
+  max_hashtags: 30
+  max_duration_seconds: 90
+---
+
+# Best Practices: Instagram — Reels
+
+## Format Rules
+
+- Duration: 15–90 seconds (15–30s performs best for reach)
+- Aspect ratio: 9:16 vertical (1080x1920px)
+- Safe zone: keep text and faces within center 70% — edges may be cropped in previews
+- Caption: same 2200-char limit as feed posts
+- Trending audio increases distribution significantly
+- First 3 seconds are the critical retention window
+
+## Structure
+
+```
+[0–3s: HOOK FRAME]
+- Visual surprise, bold text overlay, or direct address to camera
+- No logos, intros, or branding in the first 3 seconds
+
+[3–20s: SETUP / PROBLEM]
+- State the topic or tension immediately
+- Subtitles are mandatory (85% of Reels are watched on mute)
+
+[20–60s: VALUE / PAYOFF]
+- Deliver the promised value quickly
+- Use jump cuts to maintain pace; avoid long static shots
+
+[60–90s: CTA]
+- "Follow for more", "Save this", "Share with someone who needs this"
+- End card or text overlay recommended
+```
+
+## Guidelines
+
+- **Use trending audio.** Find it via the Reels audio library (marked with an arrow icon). Lip-sync to trending sounds and overlay your own meaning.
+- Add closed captions manually or via auto-captions for accessibility and watch time.
+- Shoot vertically native — do not repost landscape content with black bars.
+- Include a cover image that reads as a still photo in the grid.
+- Avoid watermarks from TikTok or other platforms (Instagram penalizes recycled content).
+- The algorithm prioritizes share rate and replays over likes. Create content people send to friends.
+- Hooks categories that work: "Did you know...", before/after, tutorials, contrarian opinions.
+
+## Examples
+
+**Hook scripts (first 3 seconds):**
+- [On screen text]: "Stop doing this on Instagram" [cut to list]
+- [To camera]: "I made $10K in one month from one Reel. Here's the breakdown."
+- [Visual]: Dramatic before/after transformation with no words — let curiosity drive it
+
+**CTA variants:**
+- "Follow me for one tip like this every week"
+- "Save this so you don't forget"
+- "Tag someone who needs to hear this"
+
+**Caption structure:**
+```
+The strategy nobody's talking about for 2024.
+
+I tested it for 30 days. Here's exactly what happened. 👇
+
+[1–3 bullet summary]
+
+Drop a comment if you want the full breakdown.
+
+#reels #instagramreels #contentmarketing #growthhacking #creatortips
+```

package/assets/core/best-practices/instagram-stories.md

@@ -0,0 +1,68 @@
+---
+platform: instagram
+format: stories
+constraints:
+  max_chars: null
+  image_ratio: "9:16"
+  max_hashtags: 10
+  max_duration_seconds: 15
+---
+
+# Best Practices: Instagram — Stories
+
+## Format Rules
+
+- Duration: up to 15 seconds per story card; video auto-continues across multiple cards
+- Aspect ratio: 9:16 (1080x1920px)
+- Safe zones: keep critical content within the center 1080x1420px area (avoid top and bottom 250px used by UI chrome)
+- Stories disappear after 24 hours unless saved to Highlights
+- Stickers (polls, questions, sliders, countdowns) dramatically increase engagement
+- Hashtag sticker: up to 10 tags; only 1 location sticker allowed
+
+## Structure
+
+```
+Card 1: [HOOK / ATTENTION]
+- Bold text or image that establishes the topic in under 2 seconds
+- Works as a standalone even if viewer swipes past
+
+Card 2–4: [CONTENT / VALUE]
+- One idea per card
+- Use text overlays on images or solid-color backgrounds with large text
+- Keep sentences under 7 words per card
+
+Card 5 (optional): [INTERACTION]
+- Poll sticker: "Agree or disagree?"
+- Question sticker: "Ask me anything"
+- Quiz sticker: trivia related to your brand
+
+Final Card: [CTA]
+- "Swipe up" / "Link in bio" / "DM me the word [X]"
+- Use countdown sticker for launches or deadlines
+```
+
+## Guidelines
+
+- Design for tap-through speed — viewers tap quickly. Each card must communicate in under 2 seconds.
+- Use brand colors, fonts, and consistent visual templates for recognition.
+- Behind-the-scenes and "day in the life" content outperforms polished ads in Stories.
+- Polls are the single highest-engagement sticker — use them to gather data AND boost algorithm reach.
+- Respond to every poll reply and question reply — it drives DM relationships.
+- Add your best story sets to Highlights with clear cover icons and descriptive titles.
+- Stories are where you build intimacy; feed is where you build credibility.
+
+## Examples
+
+**Story sequence for a product drop:**
+- Card 1: "Something big is coming tomorrow 👀" [countdown sticker]
+- Card 2: Teaser image (blurred or cropped product)
+- Card 3: Poll — "Are you ready? Yes / Not yet"
+- Card 4: "Link drops at 9 AM. Set a reminder 👆"
+
+**Engagement story sequence:**
+- Card 1: "Real question for you..."
+- Card 2: Question sticker — "What's your biggest struggle with [topic]?"
+- Card 3: "I'll answer every single one in tomorrow's post"
+
+**Highlight categories:**
+- About, Services, Testimonials, FAQ, Behind the Scenes, Tutorials