ClaudeMarketing/docs/reference/AUTONOMOUS_MARKETING_PLAN.md

# The Autonomous Marketing Team — Full Plan

**Your role:** Gatekeeper. You approve or reject. That's it.
**The system:** Researches trends, writes scripts, generates images, creates videos, writes copy, schedules posts — all autonomously.
**Goal:** Drive app downloads on Instagram, TikTok, and Nextdoor.

---

## How Image & Video Generation Actually Works

### Image Generation (Static Ads)

You're not designing anything. Here's what happens under the hood:

```
You say: "Create a campaign for [feature X]"

1. Research Agent finds trending angles, competitor hooks, keywords
2. Ad Creative Designer reads research + brand knowledge files
3. Claude writes a prompt → sends to NanoBanana MCP
4. NanoBanana (powered by Gemini) generates the image INSIDE your Claude session
5. Claude builds an HTML/CSS layout around the image:
   - Your headline, subtext, CTA button
   - Brand colors, fonts, spacing from knowledge files
   - Sized to exact platform dimensions
6. Playwright opens a headless browser → loads the HTML → screenshots it
7. You get a pixel-perfect PNG ad ready to upload

Cost: ~$0.04-0.13 per image
Time: ~30-60 seconds
```

**What you control:** The knowledge files dictate brand colors, fonts, CTA style, tone. Change the knowledge files = change every ad the system produces.

**What Claude controls:** Layout decisions, image prompts, copy placement, visual hierarchy — all guided by your brand rules.

### Video Generation (Remotion)

Remotion turns React code into video. Think of it as After Effects but written in code:

```
You say: "Create a TikTok ad for [feature X]"

1. Research Agent finds pain points + trending hooks
2. Video Ad Specialist reads research + brand knowledge
3. Claude writes a scene plan (JSON):
   {
     "scenes": [
       { "type": "hook", "duration": 3, "text": "Still doing X the hard way?", "animation": "scale-in" },
       { "type": "problem", "duration": 4, "text": "The old way is broken", "animation": "slide-left" },
       { "type": "solution", "duration": 5, "text": "Meet [Your App]", "animation": "fade-in" },
       { "type": "proof", "duration": 3, "text": "50K+ downloads", "animation": "bounce" },
       { "type": "cta", "duration": 3, "text": "Download Free", "animation": "pulse" }
     ]
   }
4. Claude generates React components for each scene:
   - SVG icons, text overlays, transitions
   - Motion via Remotion's interpolate() and spring() functions
   - Brand colors/fonts from knowledge files
5. Remotion renders frame-by-frame → outputs MP4
6. No manual step — video goes straight to outputs/

Cost: Free (Remotion is open source)
Time: ~2-5 minutes for a 15-30s video
```

**The style parameter matters:**
- `style: "polished"` → clean motion graphics, brand colors (Instagram Reels)
- `style: "authentic"` → rougher cuts, text-heavy, trend-pacing (TikTok)
- `style: "local"` → warm, simple, community feel (Nextdoor)

### AI UGC Videos (The Next Level)

For ads that look like a real person talking about your app, add one of these:

| Tool | What It Does | Cost | API? |
|------|-------------|------|------|
| **[HeyGen](https://heygen.com)** | AI avatars that talk — 500+ looks/voices | ~$24/mo | Yes |
| **[Arcads](https://arcads.ai)** | Real human footage + AI lip-sync (most authentic) | ~$100/mo | Yes |
| **[MakeUGC](https://makeugc.ai)** | Cheapest per-video, 200+ avatars | ~$10/video | Limited |

**These are optional but powerful** — UGC-style content gets 2-3x higher engagement than polished brand ads on TikTok/Instagram because the algorithms treat it like creator content, not advertising.

---

## The Ad Creative Framework That Drives Downloads

### The Hook-Body-CTA Formula

Every ad your system produces follows this structure:

```
HOOK (0-3 seconds) — Stop the scroll
  "Still doing [painful thing] the hard way?"
  "I found the app everyone's been hiding from you"
  "POV: you just discovered [your app]"

BODY (3-15 seconds) — Show the value
  Problem → Solution → Proof
  "The old way: [pain]. The new way: [your app does X]"
  Show the app in action (screen recording or motion graphic)
  Social proof: "50K downloads", "4.8★ rated", "Featured in [X]"

CTA (15-20 seconds) — Drive the action
  "Download free — link in bio"
  "Try it today" + app store badge animation
  "Your morning/workflow/life just got an upgrade"
```

### The 10-20 Variations Rule

**You don't create one ad. You create 10-20 variations** with different hooks on the same concept and let the platforms test winners:

```
Same body/CTA, but rotate hooks:
  Hook A: "Stop scrolling if you [pain point]..."
  Hook B: "I need to talk about this app..."
  Hook C: "Why is nobody talking about this?"
  Hook D: "POV: you just found [app name]"
  Hook E: "[Stat] people already switched to this"
```

The Research Agent identifies which hook angles are trending. The Video Ad Specialist generates all variations. You approve the batch.

### What Makes People Download (Ranked by Impact)

1. **Show the app in action** — screen recordings / animated mockups of the actual UI
2. **Lead with the problem, not the product** — "Your [problem] is about to be solved"
3. **Social proof** — download numbers, ratings, testimonials, "as seen in"
4. **Urgency without being salesy** — "just launched", "early access", "free for now"
5. **Platform-native feel** — looks like organic content, not an ad

---

## The 7-Agent Autonomous System

Here's your expanded pipeline. The original video used 5 agents. You need 7 for a truly autonomous system:

### Agent 1: Trend Scout (NEW)
```
Runs: Daily or every few days (automated via cron)
Does: Monitors trending content, competitor ads, viral hooks
Tools: Tavily AI + Exa AI for semantic search
Output: trend_report.json with:
  - Trending hooks on TikTok/Instagram this week
  - Competitor ad angles (what's working for similar apps)
  - Emerging content formats/sounds
  - Recommended content themes for next batch
```

### Agent 2: Research & Strategy Agent
```
Runs: Per campaign
Does: Deep research on specific campaign topic
Tools: Tavily AI (5 targeted queries)
Output: research_results.json + research_brief.md + interactive_report.html
  - Market data, audience insights
  - Content topics, marketing angles, keywords
  - Video concepts (mapped to Video Agent input format)
  - Ad hooks ranked by predicted scroll-stop rate
```

### Agent 3: Script Writer (NEW)
```
Runs: Per campaign
Does: Writes ad scripts from research output
Tools: Knowledge files only
Output: scripts/ folder with:
  - 5 hook variations per concept
  - Full scene-by-scene scripts (hook/body/CTA timed)
  - Platform-adapted versions (polished for IG, raw for TikTok, local for Nextdoor)
  - Voiceover text (if using HeyGen/Arcads)
```

### Agent 4: Ad Creative Designer (Static)
```
Runs: Per campaign
Does: Generates static image ads
Tools: NanoBanana MCP + Playwright
Output: ads/ folder with platform-specific PNGs:
  - instagram_feed_1080x1080.png
  - instagram_stories_1080x1920.png
  - nextdoor_spotlight_1200x1200.png
  - nextdoor_display_1200x628.png
  - Multiple variations per format (different hooks/visuals)
```

### Agent 5: Video Ad Producer
```
Runs: Per campaign
Does: Creates video ads from scripts
Tools: Remotion (motion graphics) + optionally HeyGen/Arcads (UGC-style)
Output: video/ folder with:
  - instagram_reel_1080x1920.mp4 (polished style)
  - tiktok_ad_1080x1920.mp4 (authentic style)
  - nextdoor_video_1080x1080.mp4 (local/warm style)
  - scene_plan.json per video
  - 3-5 hook variations per platform
```

### Agent 6: Copywriter Agent
```
Runs: Per campaign
Does: Writes all text/captions
Tools: Knowledge files + research output
Output: copy/ folder with:
  - instagram_captions.json (multiple variations)
  - tiktok_captions.json (with trending hashtags)
  - nextdoor_posts.json (neighborly tone, no hashtags)
  - copy_matrix.json (all variations mapped to all creatives)
```

### Agent 7: Distribution Agent
```
Runs: Per campaign (after your approval)
Does: Uploads media + publishes
Tools: Postiz API (Instagram + TikTok) + Nextdoor API (direct)
Output:
  - media_urls.json (Supabase public URLs)
  - Publish_{campaign}_{date}.md (the manifest YOU review)
  - Published post IDs per platform
```

---

## Your Daily/Weekly Workflow

### Automated (No Action from You)

```
Every 2-3 days:
  ┌─ Trend Scout runs automatically (cron/scheduled)
  │  Scans trending hooks, competitor ads, viral formats
  │  Saves trend_report.json
  └─ You get a Slack/email notification: "New trend report ready"
```

### Semi-Automated (You Trigger, System Executes)

```
When you're ready to create content:

Step 1: You type ONE prompt into Claude Code:
  "Create a campaign batch for [app feature X].
   Target: app downloads.
   Platforms: Instagram, TikTok, Nextdoor.
   Variations: 5 hooks per platform.
   Use latest trend report."

Step 2: System runs autonomously (~15-20 minutes):
  Research Agent     → market insights, hooks      (~2 min)
  Script Writer      → 15 ad scripts (5 per platform) (~3 min)
  Ad Creative        → 8-10 static ad variants      (~3 min)
  Video Producer     → 5-8 video variants            (~5 min)
  Copywriter         → captions for all variants     (~2 min)
  Distribution Agent → uploads to Supabase, writes Publish MD (~2 min)

Step 3: YOU review the Publish MD manifest:
  - Preview all creatives in outputs/ folder
  - Check copy for each platform
  - See recommended posting schedule
  - Approve, reject, or request changes

Step 4: You say "Publish" → system posts everything via Postiz + Nextdoor API
```

### What You're Actually Doing

| Task | Time | Frequency |
|------|------|-----------|
| Review trend reports | 5 min | Every few days |
| Write campaign trigger prompt | 2 min | Per campaign |
| Review outputs + approve/reject | 10-15 min | Per campaign |
| **Total time per campaign** | **~20 min** | — |

Everything else — research, scripting, design, video production, copywriting, scheduling, publishing — is handled by the agents.

---

## The Job Payload (What You Actually Type)

Here's a real example of what triggers a full campaign:

```
Create a campaign batch for our app's new [feature name].

Campaign goal: Drive app downloads
Target audience: [your audience]
Platforms: Instagram (Reels + Feed), TikTok, Nextdoor

Content requirements:
- Use the latest trend report for hook inspiration
- 5 hook variations per platform
- Static ads: Instagram feed (1080x1080) + Nextdoor spotlight (1200x1200)
- Video ads: Instagram Reel (9:16, polished) + TikTok (9:16, authentic/raw)
- Nextdoor: static image ad only (local/warm tone)

Key message: [What problem does this feature solve?]
Social proof: [Download count, rating, press mentions]
CTA: "Download free" / "Try it now"

Safety: dry_run: false, publish via Postiz for IG/TikTok
Output: outputs/[feature_name]_campaign_[date]/
```

That's it. One prompt. The system handles the rest.

---

## The Content Machine: What Gets Produced Per Campaign

| Asset | Quantity | Platforms |
|-------|----------|-----------|
| Static image ads | 6-10 variants | Instagram Feed, Nextdoor |
| Video ads (motion graphic) | 5-8 variants | Instagram Reels, TikTok |
| Video ads (UGC-style) | 3-5 variants (if HeyGen/Arcads added) | TikTok, Instagram Stories |
| Captions | 1 per creative per platform | All |
| Hashtag sets | 3-5 per platform | Instagram, TikTok |
| Research report | 1 interactive HTML dashboard | Internal use |
| Publish manifest | 1 per campaign | Internal review |
| **Total assets per campaign** | **~20-30 pieces** | — |

---

## Making Ads That Actually Drive Downloads

### The Three Ad Types That Convert for Apps

**Type 1: Problem-Solution (Highest conversion for cold audiences)**
```
Scene 1: "Still [doing painful thing]?" (3s)
Scene 2: Show the frustration visually (3s)
Scene 3: "There's an app for that." + app UI demo (5s)
Scene 4: "[X]K downloads. 4.8★ rated." (3s)
Scene 5: "Download free — link in bio" + app store badge (3s)
```

**Type 2: UGC/Testimonial (Highest trust signal)**
```
AI avatar or screen recording:
"Okay I HAVE to share this app with you guys..."
"I've been using [app] for 2 weeks and honestly..."
[Shows app in use]
"It completely changed how I [benefit]"
"Link in bio, you'll thank me later"
```

**Type 3: Trend-Jacking (Highest organic reach on TikTok)**
```
Use a trending sound/format
Adapt it to your app's value prop
"When [trending format] but you have [your app]"
Keep it under 15 seconds
CTA in caption only (not in video)
```

### Platform-Specific Creative Rules

| Rule | Instagram | TikTok | Nextdoor |
|------|-----------|--------|----------|
| **First 3 seconds** | Hook with motion | Hook with text overlay | Headline in image |
| **Sound** | Optional (80% watch muted) | Required (93% use sound) | N/A (mostly static) |
| **Style** | Polished, branded | Raw, authentic, creator-feel | Warm, local, neighborly |
| **CTA** | "Link in bio" / "Shop Now" | "Link in bio" / soft CTA | "Learn More" / "Visit Us" |
| **Hashtags** | 3-5 required | 3-5 trending + niche | None |
| **Length (video)** | 15-30s | 9-15s sweet spot | ≤30s |
| **Text on screen** | Minimal, clean | Bold, large, ≤6 words/frame | Clear headline |
| **What wins** | Aesthetic + value | Entertainment + authenticity | Trust + local relevance |

---

## Recommended Phased Rollout

### Phase 1: Foundation (Week 1)
- [ ] Set up project structure (folders, knowledge files, CLAUDE.md)
- [ ] Write brand_identity.md, platform_guidelines.md, product_campaign.md
- [ ] Install tools: Remotion, Playwright, Tavily, NanoBanana MCP
- [ ] Set up Supabase bucket + API keys (Instagram, TikTok)
- [ ] Apply for Nextdoor Ads API partnership
- [ ] Create the "Ultimate Skills Framework" doc

### Phase 2: Build Agents (Week 2)
- [ ] Build + test Research Agent individually
- [ ] Build + test Script Writer individually
- [ ] Build + test Ad Creative Designer individually
- [ ] Build + test Video Ad Producer individually
- [ ] Build + test Copywriter Agent individually
- [ ] Build + test Distribution Agent individually
- [ ] Update CLAUDE.md with all agents

### Phase 3: Connect Pipeline (Week 3)
- [ ] Wire up the full pipeline (single job payload → all agents in sequence)
- [ ] Set up Postiz (self-hosted or cloud) for Instagram + TikTok publishing
- [ ] Connect Nextdoor API directly
- [ ] Run first dry-run campaign end-to-end
- [ ] Review outputs, refine skills based on quality

### Phase 4: Go Live (Week 4)
- [ ] Run first real campaign with live publishing
- [ ] Set up Trend Scout on automated schedule
- [ ] Set up token refresh automation (TikTok daily, Instagram 60-day)
- [ ] Establish your review rhythm (approve batches 2-3x/week)

### Phase 5: Scale (Ongoing)
- [ ] Add HeyGen or Arcads for UGC-style video ads
- [ ] Add Creatomate for template-based video batch generation
- [ ] Build A/B testing feedback loop (which hooks win → feed back to Research Agent)
- [ ] Add more platforms as needed (YouTube, Threads, LinkedIn)

---

## Summary: Your Marketing Team

| Role | Agent | Runs Autonomously? |
|------|-------|--------------------|
| Trend Analyst | Trend Scout | Yes (scheduled) |
| Market Researcher | Research Agent | Yes (per campaign) |
| Creative Director / Scriptwriter | Script Writer | Yes (per campaign) |
| Graphic Designer | Ad Creative Designer | Yes (per campaign) |
| Video Producer | Video Ad Producer | Yes (per campaign) |
| Copywriter | Copywriter Agent | Yes (per campaign) |
| Social Media Manager | Distribution Agent + Postiz | Yes (after your approval) |
| **Marketing Director** | **You** | **Approve/reject only** |

Sources:
- [TikTok Ads Complete Guide 2026](https://creatify.ai/blog/tiktok-ads-complete-guide-to-creating-high-performing-creatives-in-2026)
- [12 Proven Ad Creative Frameworks 2026](https://www.modernmarketinginstitute.com/blog/12-proven-frameworks-for-building-high-roi-ad-creative-that-converts-in-2026)
- [Hook Rate to Hold Rate Guide](https://getkoro.app/blog/koro-hook-rate-to-hold-rate)
- [UGC Video Guide 2026](https://getkoro.app/blog/ugc-video-guide-2026)
- [Hook Stacking Strategy](https://ugcsocial.substack.com/p/hook-stacking-the-secret-to-longer)
- [Hook-Body-CTA Video Editor Guide](https://sovran.ai/blog/hook-body-cta-video-editor-the-ultimate-guide-to-creating-high-converting-video-ads-in-2025)
- [Remotion Fundamentals](https://www.remotion.dev/docs/the-fundamentals)
- [HeyGen UGC Avatars](https://www.heygen.com/avatars/ugc)
- [MakeUGC](https://www.makeugc.ai/)
- [Best AI UGC Generators 2026](https://videoai.me/blog/best-ai-ugc-generators-2026)