A Claude Code-powered ad creative engine for DTC (direct-to-consumer) Facebook and Instagram ads. The Iterator generates performance ad creative — strategy, copy, images, and Meta-ready exports — using a proprietary D2C Engine framework and a multi-agent pipeline.
The Iterator takes a client brief and produces ready-to-launch Meta ad batches through a 4-stage pipeline:
- Strategy — Maps client inputs through the D2C Engine: deep desires, problem/solution framing, angle + format selection
- Copywriting — Produces in-image text (headline, supporting lines, bottom strip) and Meta ad copy (headline + primary text)
- Scoring Panel — 8 specialized agents score the creative for persona fit, angle execution, emotion, brand consistency, copy craft, format compliance, editing, and image QA
- Art Direction — Generates ad images via AI image generation, controlled by the Engine's creative direction
Human checkpoints between stages. Approve, reject, or revise at any point.
See SETUP.md for full instructions.
# 1. Clone the template
# 2. Configure MCP servers (.mcp.json)
# 3. Onboard a client
/onboard {Client Name}
# 4. Generate an ad batch
/iterate {client}
# 5. Review and ship
/review-batch {client}
/ship {client}engine/ — D2C Ad Creative Engine (desires, angles, formats, message structure, Meta specs)
.claude/agents/ — Subagent definitions (strategist, copywriter, reviewer, art-director, 8 scorers)
.claude/skills/ — Skill orchestration (iterate, onboard, review-batch, ship, etc.)
templates/ — Client brief + winner annotation templates
references/ — Copy classics, swipe file, visual library + scraper
config/ — Per-operator config templates (ship targets, etc.)
clients/ — Your client data (gitignored, local to each operator)
- Claude Code with Claude Opus access
- Node.js v20+ (for MCP servers)
- API keys: Google AI (image gen), Firecrawl (web scraping), Google Drive (optional, for asset sync + shipping)
The D2C Engine in engine/ is the creative direction system. It contains:
- Deep Desires — The emotional drivers that make people act (Safety, Esteem, Belonging, etc.)
- Angles — Strategic frames for each ad (Us vs Them, Agitate & Solve, Social Proof, etc.)
- Formats — Visual layouts (Hero Product, Before/After, Lifestyle, Bold Headline, etc.)
- Message & Concept Structure — How to build the ad from desire to deliverable
- Meta Best Practices — Platform specs, character limits, placement rules
Every ad concept maps: Deep Desire → Problem → Solution → Angle → Format → Message → Copy + Visual.
MIT