expxagents 0.1.0

package/assets/core/best-practices/email-newsletter.md

@@ -0,0 +1,84 @@
+---
+platform: email
+format: newsletter
+constraints:
+  max_chars: null
+  image_ratio: "600px-wide"
+  max_hashtags: null
+---
+
+# Best Practices: Email — Newsletter
+
+## Format Rules
+
+- Subject line: 30–50 characters (mobile preview shows ~35 chars); avoid ALL CAPS and excessive punctuation
+- Preview text: 40–90 characters; extends the subject line narrative
+- Email width: 600px maximum for universal client rendering
+- Images: inline 600px wide; always include alt text for image-disabled clients
+- CTA buttons: minimum 44px height, 200px width; one primary CTA per section
+- Unsubscribe link: legally required (CAN-SPAM, GDPR) — include in footer
+- Plain text version: required alongside HTML for deliverability and accessibility
+- Send frequency: weekly or bi-weekly performs best for engagement; daily acceptable for daily-format newsletters
+
+## Structure
+
+```
+[FROM NAME] — Personal name or brand name (not "noreply@")
+[SUBJECT LINE] — Curiosity or value, not clickbait
+[PREVIEW TEXT] — Sentence that completes the subject line's promise
+
+---
+
+[HEADER]
+- Logo or brand name
+- Issue number or date (builds ritual habit)
+
+[GREETING]
+- "Hi [First Name]," or "Hey," for conversational newsletters
+
+[INTRO — 2–3 sentences]
+- What's in this issue and why it matters
+
+[SECTION 1 — Main Story / Primary Value]
+- 150–300 words
+- One CTA button: [Read More] or [Get Access]
+
+[SECTION 2 — Secondary Content]
+- Curated link, quick tip, or community highlight
+- 50–100 words
+
+[SECTION 3 — Optional: sponsor or product mention]
+- Clearly labeled "Sponsored" or "From our partners"
+
+[FOOTER]
+- Unsubscribe | Preferences | View in browser
+- Mailing address (required legally)
+- Social links
+```
+
+## Guidelines
+
+- **Subject line determines open rate.** Split test at least 2 subject lines per send with 20%/20%/60% splits.
+- Use the reader's first name in the subject line sparingly — it works but loses impact if overused.
+- One primary CTA per email. Multiple equally-weighted CTAs reduce clicks on all of them.
+- Write in a consistent voice that matches a specific, recognizable personality. Subscribers subscribe to a person, not a publication.
+- Send at consistent times and days — subscribers form habits around your send schedule.
+- Re-engagement campaigns: email inactive subscribers (90+ days) with a re-confirm or goodbye sequence before purging.
+- Maintain list hygiene: remove hard bounces immediately; suppress soft bounces after 3 failures.
+- Deliverability: authenticate with SPF, DKIM, and DMARC; avoid spam trigger words; maintain list quality.
+
+## Examples
+
+**Subject line formulas:**
+- "[Number] things I learned from [unusual experience]"
+- "The [adjective] guide to [topic] (in 5 minutes)"
+- "Quick question for you..."
+- "[First Name], you might want to see this"
+
+**Preview text that extends the subject:**
+- Subject: "We need to talk about your content strategy"
+- Preview: "...because most people are building on the wrong foundation."
+
+**CTA button copy (strong vs. weak):**
+- Strong: "Get the free template", "Watch the 10-minute walkthrough", "Join 12,000 readers"
+- Weak: "Click here", "Learn more", "Submit"

package/assets/core/best-practices/email-sales.md

@@ -0,0 +1,91 @@
+---
+platform: email
+format: sales
+constraints:
+  max_chars: null
+  image_ratio: null
+  max_hashtags: null
+---
+
+# Best Practices: Email — Sales Email
+
+## Format Rules
+
+- Subject line: 6–10 words; curiosity or benefit-forward; never misleading
+- Length: 100–300 words for cold outreach; 300–600 for warm/nurture sequences
+- Paragraphs: 1–3 sentences each; wide white space between paragraphs
+- One CTA: one link or one ask per email — not multiple options
+- Personalization tokens: {first_name}, {company_name}, {role} at minimum
+- Signature: real name, role, company, phone number, and one social link
+- Images: minimal (can trigger spam filters); avoid in cold outreach
+
+## Structure — AIDA Framework
+
+```
+[SUBJECT LINE — curiosity or specific benefit]
+
+Hi {first_name},
+
+[ATTENTION — 1–2 sentences]
+- Specific, relevant hook: reference their company, a pain point, or a trigger event
+- NOT: "My name is X and I work at Y..."
+
+[INTEREST — 2–3 sentences]
+- Explain the problem you solve in concrete, non-jargon terms
+- Use numbers and specificity where possible: "We help [target persona] achieve [result] in [timeframe]"
+
+[DESIRE — 2–3 sentences]
+- Social proof: a customer name, outcome, or case study result
+- "We recently helped [similar company] [specific outcome]"
+
+[ACTION — 1 sentence]
+- Clear, low-friction ask
+- "Would you be open to a 15-minute call on Thursday or Friday?"
+- Avoid: "Let me know if you're interested" (too vague, puts effort on recipient)
+
+[SIGNATURE]
+{sender_name}
+{role} at {company}
+{phone}
+```
+
+## Guidelines
+
+- **The goal of every sales email is one thing: the reply.** Not the sale — the conversation.
+- Cold email subject lines should not look like marketing emails. They should look like emails from a person.
+- Personalize beyond {first_name}: reference a recent blog post, funding round, job posting, or product change.
+- Keep the first email short (under 150 words for cold). Earn the right to say more.
+- Follow-up sequence: 4–6 touches across 2–3 weeks. Persistence closes deals; abandonment is the #1 failure.
+- Never guilt-trip in follow-ups. Add new value: a case study, a relevant article, an offer.
+- A/B test: subject line, CTA wording, opening line, and send time.
+- Measure reply rate, not just open rate. Opens are vanity; replies are pipeline.
+
+## Examples
+
+**Cold outreach email:**
+```
+Subject: Idea for {company_name}'s onboarding flow
+
+Hi {first_name},
+
+I noticed {company_name} recently launched [feature/product] — congrats on the release.
+
+I work with SaaS teams to reduce onboarding drop-off after signup. One of our clients, [Company], cut their time-to-activation by 40% in 6 weeks using a method I'd love to walk you through.
+
+Would a 15-minute call this week or next work for you?
+
+[Name]
+```
+
+**Follow-up #2 (adding value):**
+```
+Subject: Re: Idea for {company_name}'s onboarding flow
+
+Hi {first_name},
+
+Following up on my last note — I wanted to share a short case study from [similar company] that you might find relevant: [link]
+
+Happy to apply the same approach to {company_name}. Worth a quick call?
+
+[Name]
+```

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