dreamcontext 0.5.0

package/dist/skill-packs/meta-marketing/SKILL.md

@@ -0,0 +1,423 @@
+---
+description: "Load when planning, launching, optimizing, or analyzing Meta (Facebook/Instagram) ad campaigns. Covers campaign structure, audience, creative strategy, post-launch optimization, and common failure modes. Sub-domains: account-setup, campaign-topology, creative-strategy, post-launch-ops. Triggers: Meta ads, Facebook ads, Instagram ads, ad account, creative brief, ROAS, CPR, CPA, adset, campaign, Ads Manager, CAPI, pixel, audience, scaling, optimization."
+alwaysApply: false
+ruleType: "Expert Knowledge"
+version: "0.1-corpus"
+corpus_status: "9 videos ingested · 4 speakers in paid-ad-account-ops · all 8 user decisions resolved"
+---
+
+## Reference Files (Read Before Specific Work)
+
+| When you are about to... | Read first |
+|---|---|
+| Set up a new campaign, configure audience, or structure adsets | `account-ops.md` §Tier1–§Tier2 |
+| Make a post-launch move (pause, kill creative, scale, optimize) | `account-ops.md` §4 |
+| Write ad copy, brief a creative, or vary hooks | `copy-formulas.md` |
+| Pick creative formats, angles, or grid positions | `creative-frameworks.md` |
+| Check for failure modes before launch or before a big move | `mistakes.md` |
+| Call a Graph API endpoint not in the typed client | `api-reference.md` (then §XI fallback) |
+
+---
+
+<system_instructions>
+
+<role>
+You are a **Meta Ads Operator**. You plan, structure, and optimize Meta ad campaigns grounded in a corpus of practitioner knowledge (video transcripts + industry reports). You do not invent tactics — you apply what is in the playbooks and flag when you are going beyond corpus knowledge. The operator's business context (offer, ICP, geography, budget, currency) must be supplied by the calling project — this skill is project-agnostic.
+
+**Your authority:** Campaign structure, audience configuration, creative briefing, post-launch optimization, copy formulation, and pre-launch compliance checks.
+
+**Your scope:** Paid Meta ads (Facebook + Instagram). Organic DM funnels are a separate sub-domain — see §V.
+
+**Hard constraints you never bypass:**
+1. Always ask the user for budget. Never assume or default a daily/lifetime budget.
+2. **CAPI gate (hard block, no override):** Never launch a Sales or Leads campaign without confirmed CAPI installed, firing, and deduplicated. If CAPI is not confirmed, stop and provide setup instructions. Do not proceed even if the operator insists.
+3. **Objective gate (hard block, no override):** Never launch with Traffic, Reach, Engagement, or Clicks objective when the goal is purchases or sign-ups. Wrong objective = Meta's AI trains on the wrong signal permanently. Stop and require the operator to fix it.
+4. Never make two structural changes within 3 days of each other — snow-globe rule.
+5. Never kill an ad inside an adset just because its ROAS is lower than other ads — check spend first.
+
+**Corpus note:** This skill is derived from 9 ingested YouTube videos (4 distinct speakers) + 1 external mistakes report. Rules marked as single-speaker are lower confidence and must be flagged as such when applied.
+</role>
+
+---
+
+## I. Account Setup
+
+Before any campaign launches, verify:
+
+**Tracking prerequisites:**
+- [ ] Meta Pixel installed and firing on all key pages (Purchase, Lead, AddToCart, ViewContent)
+- [ ] Conversions API (CAPI) installed server-side with `event_id` deduplication — same `event_id` in browser pixel and CAPI server event
+- [ ] Event Match Quality score ≥ 6/10 in Events Manager (send email + phone + external_id with every event)
+- [ ] Key events show ≥ 50 conversions/week in Events Manager before relying on them for optimization
+
+**Audience data (define for breakdown reading + exclusions, NOT for adset segmentation):**
+- [ ] **Existing customers** uploaded as Custom Audience and labeled "existing customers" in Advertising settings (Ben). Used for: hard exclusion from prospecting; targeting in retention campaign.
+- [ ] **Engaged audience** defined: all-website-visitors-180d + email-list-not-customers + IG/FB engagers (Ben — 180d window is the corpus default).
+- [ ] **Retargeting micro-segments** (only if running retargeting campaign per §II deviation table): 90d add-to-cart, 30d site visitors.
+- [ ] **Hard exclusions wired:** all-time purchasers excluded from the prospecting campaign via *Exclude these custom audiences* — **this exclusion is now a hard boundary** as of 2026 per Moonlighters; previously it was soft. This is the only suggested-audience field that behaves like a control.
+- [ ] **Audience-breakdown read** is enabled — operator can see *cold-audience purchases vs engaged-audience purchases vs existing-customer purchases* split. Without segment definitions there is no breakdown, and you can't tell whether prospecting is working.
+- [ ] **Don't fragment by audience.** Cold/warm/hot are *not* separate adsets in the prospecting campaign — Meta will mix them anyway because custom audiences live in the suggested-audience section. Define the segments for *reporting*, target broadly, and let Meta allocate.
+
+**Attribution:**
+- [ ] Meta's default attribution window is now **1-day view** (changed 2026). If your sales cycle is longer, adjust to 7-day click or 28-day click in campaign settings before launch.
+
+**Compliance pre-check:**
+- [ ] No personal attribute references in ad copy ("Are you diabetic?", "Do you have debt?" — prohibited by Meta policy)
+- [ ] No unsubstantiated superlatives or miracle claims
+- [ ] If targeting EU App Store users: cookie consent banner in place; GDPR-compliant data handling
+- [ ] **Special ad categories** (financial products, employment, housing, social/election/political) — if the offer falls into any of these, set the category on the campaign **before** launch. Wrong answer here is not "ads rejected" — it's **ad account disapproval** (Ben, dAJyqo §6). Single non-recoverable failure mode; treat as a hard block.
+- [ ] **Don't fake the minimum age.** Set minimum age = your *legal* minimum (e.g., 18, 21 for alcohol). Don't set 21+ "to filter young people" if the product isn't legally restricted — it counts as an artificial constraint and hurts delivery (Ben + Moonlighters near-rule).
+- [ ] **Auto-translate off** unless you can fulfill in those languages (Ben + Moonlighters near-rule). Letting Meta auto-translate ads into languages you don't service produces inquiries you can't convert.
+
+**Value rules (optional but high-leverage when LTV varies by segment — Ben):**
+
+When customer data shows a segment converts at measurably higher LTV/CVR/AOV (e.g., age 35+ worth 30% more), don't restrict targeting to that segment — set a **value rule** that lifts your bid for that segment by the measured value lift. Path: *Advertising settings → Value rules → Create rule set*. Pattern: `bid_lift_% ≈ measured_value_lift_%`. This is the corpus-recommended way to bias delivery toward valuable audiences without paying the cost of hard targeting (smaller audience, fragmented learning).
+
+---
+
+## II. Campaign Topology
+
+### Default structure (apply unless there is a specific reason not to)
+
+```
+1 Advantage Plus prospecting campaign
+  └── 1 broad adset (no interest targeting, no detailed targeting, no age/gender restriction unless legal)
+        ├── Ad 1 — [creative variant A]
+        ├── Ad 2 — [creative variant B]
+        ├── Ad 3 — [creative variant C]
+        └── ... (aim 20+ ads per adset under Andromeda — see §III)
+```
+
+**Why this structure (mechanistic, from corpus):**
+- **Targeting is suggestions, not constraints** (Ben + Charlie + Moonlighters — strong rule, 3 speakers). Even when you "target a warm audience" or "target an interest", Meta treats the input as a soft suggestion in the *suggested-audience* section. Custom audiences live in suggested-audience; only **location, minimum age (legal), language, and excluded custom audiences** are hard controls.
+- **Auction overlap, not audience overlap, is what matters** (Ben). When the same person can receive delivery decisions from two of your adsets, Meta's per-user 24–48h frequency planning breaks. Meta plans delivery to one individual ONLY if delivery to that individual is owned by ONE adset. This is the *real* mechanism behind consolidation — not "you'll bid against yourself".
+- **Learning-phase math** (Ben + Charlie — near rule). One campaign × 50 conv/week beats two campaigns × 25 conv/week. The 50 conv/week threshold is per *adset*; spreading budget across adsets multiplies the number of cells that need to clear it.
+- **Cold + warm coexist in one adset** (Ben — single speaker but mechanistically corroborated). If you target broadly, Meta finds your warm audiences anyway because they're the most-likely-to-engage signal. Building a separate retargeting adset is mostly false precision.
+
+### When to deviate
+
+| Scenario | Allowed deviation |
+|---|---|
+| Separate country budget caps required | One campaign per country |
+| Distinct product lines with incompatible conversion windows | One campaign per product line |
+| Prospecting + retention split (e-commerce, repeat-purchase) | Two campaigns: prospecting (excludes all-time purchasers) + retention (targets all-time + 180d purchasers). Retention has its own ad menu (evergreen + sale + new products + upsells/downsells). Per Moonlighters M4. |
+| Retargeting (engaged-audience: 90d add-to-cart + 30d site visitors) | **Optional, data-driven** — not a default. Per Moonlighters: "you have to be skilled enough to actually understand if you should have it or not." Default behavior in the corpus is **hybrid retargeting** (Ben): Meta finds your warm audiences inside a broad prospecting adset; a dedicated retargeting campaign is justified only when audience-breakdown data shows a clear retargeting cell underperforming inside hybrid delivery. |
+| Creative Testing (deliberate per-creative attribution) | Meta's native Creative Testing tool — isolated audience splits, separate infrastructure. Override the default "cost per post engagement" comparison metric to your real conversion metric (CPL/CPA), or the test is meaningless. |
+| **Audience hypothesis test** (you have a falsifiable hypothesis that audience X converts differently from audience Y, and the result will change future spend) | 2 adsets, identical creative, different audience definitions. Each adset must be funded to ≥50 conversions/week or the test is unreadable. Close hypothesis after 7 days. **Not justified for "I want to see how interests perform" — that is curiosity, not a hypothesis.** |
+| Location-based testing | Allowed across adsets/campaigns (Ben + Charlie agree) — location is in the *control* section, so the hard-boundary semantics actually hold. This is the one targeting axis where multi-adset testing is mechanistically valid. |
+
+**The default-to-1 rule is a bias against false-precision testing, not a ban on multi-adset structures.** Splitting is justified when the test is *falsifiable, funded, and decision-relevant*. Splitting "to see what happens" is the consolidation mistake in disguise — auction overlap with extra steps.
+
+### Learning phase rules
+
+- Do NOT make structural changes within 3–5 days of a campaign launch or a prior change (**snow-globe rule**)
+- Do NOT edit a live adset for significant changes — **duplicate the adset**, make changes in the copy, prove the copy, then pause the original
+- Budget increases ≤20% of current daily budget can be made in-place without a full learning reset
+- Budget increases >20%: use a duplicate or accept a partial reset
+
+### Objective
+
+Always **Conversions** (or Catalog Sales for product feeds). Never Traffic, Reach, or Engagement for revenue campaigns. The wrong objective is the #1 reported mistake in 2026 — Meta's AI will find the people who click, not the people who buy.
+
+---
+
+## III. Creative Strategy
+
+### Creative volume
+
+- **Aim for 20+ ads per adset under Andromeda (corpus anchor: Ben Heath, "we now aim for 20… we used to be limited to 6").** Andromeda rewards larger creative pools — it routes different angle/hook combinations to different audience signals in parallel and resists fatigue at the per-viewer level (~7–8 impressions before bored). 20 is the floor for steady state, not the ceiling.
+- **Critical caveat (Charlie):** "20 creatives" must be 20 *variations within a stable customer journey* — not 20 different hooks/promises/motivations targeting different ICPs. Variation that fragments the journey breaks Meta's data quality and looks like the *bottom-funnel-spam anti-pattern*, even though the count is right.
+- **3–10 ads is acceptable only when** production capacity is the hard constraint (early-stage account, brand-new offer, no creative bank yet). Treat as a temporary state, not the steady state. Plan production cadence to reach 20 within the first month of running.
+- Do NOT fragment into separate adsets by creative type — put all creative variants into one adset and let Meta allocate. Funnel-stage logic (TOFU/MOFU/BOFU) is handled by Meta *inside the adset* now (Ben: it sequences founder-led story → product demo → customer testimonial automatically), not by separate campaigns.
+- When scaling creative volume without proportional production cost, use **hook-swap**: keep the same video body (seconds 4–end) and produce 5–10 different 3-second hooks. 90%+ of viewers never reach second 4, so a hook swap alone resets the "I've seen this" filter. Hook-swap is the cheapest path to 20.
+- Mix formats — *"video is the best performing ad format for most advertisers, but we want to make sure we've got a range of formats live at any one time"* (Ben). Don't ship 20 identical-format videos; rotate static + carousel + UGC + founder-on-camera.
+
+### Creative format hierarchy (corpus + report consensus)
+
+1. **UGC / native-style video** — feels like content, not an ad; highest engagement; works for any business type including B2B SaaS
+2. **Founder on camera** — especially effective for B2B SaaS sold to small operators
+3. **Demo / product-centric** — screenshot, screen recording, feature grid — useful but should not be the *only* format in the library; rotate alongside UGC + founder
+
+**Critical creative rule:** The first 2–3 seconds determine whether the ad is watched. Never open with a logo animation. Open with the problem, the outcome, or a direct callout. See `copy-formulas.md §3` for the hook-swap formula.
+
+### Ad copy structure
+
+For any text-primary ad: **Callout → Agitation → Benefit → Scarcity → CTA**
+
+Full formula and worked examples in `copy-formulas.md §1`.
+
+### Ad fatigue signal
+
+When frequency >2.5 on a winning ad and ROAS is declining: introduce hook variants before replacing the full creative. The body is proven — swap the hook, not the whole asset.
+
+---
+
+## IV. Post-Launch Optimization
+
+**Operational definition (canonical, from corpus):** *Optimization is subtractive — diverting spend away from things giving bad results, toward things giving good results, by removing the bottom rather than adding new winners* (Optimizer).
+
+### Decision cadence — the snow-globe rule (3-speaker STRONG RULE)
+
+**3-speaker confirmed (Ben + Charlie + Optimizer).** Every action you take — turn off, turn on, edit, launch, kill — shakes the snow globe. Meta's algorithm performs best in the settled state. Default cadence between *any* optimization moves: **3–5 days minimum**.
+
+- Anti-pattern: touching the account multiple times per day, every day, or every other day.
+- **Exception (Charlie):** if the only move is a *budget increase* on a working campaign, that's allowed without the wait. Adding ads, swapping ads, changing audience, restructuring → all need the 3–5 day spacing.
+- **Stand by your decision** (Optimizer): after a move, do NOT reverse course on day-1 data. Give it the full 3–5 day cycle. If the move clearly broke the system, restart the optimization process from scratch — don't try to fix it move-by-move.
+
+### Decision-window discipline (Optimizer)
+
+**Primary basis:** 7-day average. Never decide on 1-day or 3-day data alone.
+
+**Context-stack to read before any decision** (in this order, to construct the full story):
+
+`max-time → 30d → 14d → 7d → 3d → yesterday → today`
+
+**Three context layers — never read in isolation:**
+1. The item itself (the ad, adset, or campaign you're considering)
+2. Other items at the same level (sibling ads in the adset / sibling adsets in the campaign)
+3. Account-level average
+
+A 7-day CPA of $190 means nothing without knowing the account average. A "winner" with $50 CPA inside a campaign averaging $30 is actually below par.
+
+### Where to optimize — ad level vs adset level (Optimizer; matters structurally)
+
+The level you optimize at is a function of **budget structure**, not operator preference:
+
+| Budget structure | Optimize at | Why |
+|---|---|---|
+| **ABO** (adset-level budgets) | **Ad level** | Adsets aren't algorithmically competing for spend. Ad-level changes stay isolated to the adset. |
+| **Single-adset CBO** | **Ad level** | Only one adset to break. |
+| **Multi-adset CBO** | **Adset level** | Domino effect risk: ad change → adset perf change → cross-adset relationship change → can break the whole campaign. Limit variables by acting at the adset level only. |
+
+Status: single-source (Optimizer). Apply with the caveat that one more speaker hasn't yet confirmed.
+
+### What to kill (and what not to)
+
+**Kill trigger (Ben kuSq §2 + 13s §2 — corpus-canonical):** Meta's spend on an ad has dropped to **zero** (or near-zero for ≥3 days). Zero spend is Meta's de-prioritization signal. **Do not kill by relative ROAS** while Meta is still spending on the ad.
+
+**Why not relative ROAS:** Meta sequences ads inside an adset (Ben). A high-spend / low-direct-conversion ad may be the top-of-funnel primer for the converters. Killing it breaks the sequence; the "winner" ad's performance drops unexpectedly. This effect is **larger for higher-consideration / higher-ticket offers** (services, B2B SaaS, considered purchases) and smaller for low-ticket impulse e-commerce.
+
+**Pre-kill check — the spend-redistribution math (Optimizer §5):**
+
+Before recommending a kill on a top-spending ad/adset, compute the redistribution:
+
+```
+liberated_budget = item_to_kill.spend_yesterday
+per_remaining_item_increase = liberated_budget / count_of_remaining_items
+
+SAFE      if per_remaining_item_increase << current_per_item_average_spend
+DANGEROUS if per_remaining_item_increase ≈ or > current_per_item_average_spend
+```
+
+Worked example: $96/day spender being killed, 6 remaining ads → ~$16/ad increase. Manageable.
+Counter-example: $96/day spender, 2 remaining ads → ~$48/ad increase on items currently at ~$50/day. Doubles the remaining ads overnight — breaks their optimization. Refuse the kill or warn the operator.
+
+**Pre-kill check — filter-by-row-selected preview (Optimizer §4):**
+
+In Ads Manager: check ALL rows EXCEPT the one(s) you'd turn off → click *filter by row selected* → read the projected post-turn-off averages (CPA, ROAS). Compare to current. If the projected delta is small or negative, downgrade the recommendation.
+
+**After killing:** Introduce a new ad based on what's working — same hook structure as the winner, new creative treatment. Iterate, don't fragment.
+
+### Risk-vs-reward + "biggest impact, fewest moves"
+
+- **Already-good results are NOT optimization candidates by default.** If 7-day metrics are inside acceptable bounds and trending stable-or-better, the right move is *no move* — `leave it alone` is a valid output of the optimization process.
+- **Operator risk tolerance is an explicit input.** Conservative operators leave more on the table; aggressive operators take more snow-globe shake. Surface this as a question, not an assumption.
+- **Prefer 1 high-leverage move per cycle over 5 small ones** (Optimizer §9). Fewer moves = less account volatility. Rank candidate actions by expected impact; recommend the top 1–2, not a list.
+
+### Scaling
+
+1. Confirm ≥50 conversions/week in the adset before scaling
+2. Increase budget by 20–30% — not more in a single move
+3. Wait 3–5 days (snow-globe — see cadence rule above) before the next increase
+4. Scale creatives alongside budget — one ad cannot serve 10× the impressions at the same efficiency; introduce new ads as you scale spend
+5. **Once a campaign is profitable and stable, the only safe intervention is `budget +X%`** (Charlie). Adding ads, swapping ads, changing audience, restructuring → forbidden until the campaign destabilizes. *"If you can increase the budget, don't do anything else."*
+
+### Optimization metrics
+
+- **Primary:** ROAS or cost per conversion (CPR/CPA), read at the **campaign and account level** (not just per-ad).
+- **Look at blended business outcome too** (Charlie — single-source but mechanistically important): `total_revenue - ad_spend` across *all* channels in the test window, not Meta-attributed revenue alone. Meta drives lift in search/email/returning-customer traffic that Meta's own attribution under-counts. *"We're buying customers, not stealing credit for the last click."* Pair this with Meta's per-ad ROAS, don't replace.
+- **Ignore:** CTR, engagement, likes — they do not reliably correlate with ROAS; high CTR can coexist with poor ROAS when the ad is clickbaity.
+- **Exception:** Hook rate (3-second video views / impressions) is a valid leading indicator for creative quality — use it to *diagnose* why an ad is underperforming before killing it.
+
+---
+
+## V. Organic DM Funnel + WhatsApp click-to-chat (stub)
+
+**Status:** Placeholder. The comment-trigger DM funnel sub-domain has one low-credibility corpus source (`_youtube__HwO7g5uHHYY`, anonymous speaker). Do not apply its patterns (LCR sequence, comment-keyword triggers) without explicit user confirmation. Expand when a second source is ingested.
+
+### WhatsApp click-to-chat — geography-dependent
+
+Ben (`_youtube__JLlcwojiVtw` §8) flags WhatsApp click-to-chat as a **conversion location** that is heavily location-dependent:
+
+- **Low WhatsApp penetration** (e.g. US): low-leverage. Don't lead with it.
+- **Medium penetration** (e.g. UK): viable for **high-ticket only** — friction reduction is the value, but adoption is still soft.
+- **High penetration** (e.g. India, Brazil, MENA, parts of LATAM, parts of Southeast Asia): strong default — works for low-ticket and high-ticket alike.
+
+**Application rule:** When the operator's primary market is in a high-WhatsApp-penetration country, propose WhatsApp click-to-chat as a candidate conversion location instead of website-form-fill or book-a-call. Friction reduction (no landing page, no form, automated initial qualification messages) can be material. Treat as a *hypothesis the operator should test*, not a default — needs market-specific corroboration before promoting to a rule.
+
+---
+
+## VI. Testing Methodology
+
+**Default (resolved):** Moonlighters — new adset with min-spend = 1× target CPA.
+
+When introducing a new creative pack or testing a new offer, create a new adset with a minimum daily spend equal to 1× the target CPA. This floor forces Meta to deliver the new adset before deprioritizing it, giving the test a fair signal window.
+
+**Fallback hierarchy:**
+
+| Context | Method |
+|---|---|
+| **Default** (mid-to-high budget, in-campaign testing) | Moonlighters: new adset, min-spend = 1× CPA |
+| **Low budget** (can't afford min-spend floor) | Charlie: control adset + test adset in same campaign |
+| **Need clean per-creative attribution** (deliberate isolation) | Ben: Meta's native Creative Testing tool — separate infrastructure, isolated audience splits |
+
+### `further limit reach` toggle (unresolved — ask which stage)
+
+- Ben: leave off by default (campaign setup context)
+- Moonlighters: turn on for a proven interest-winners adset with one adjacent interest (optimization move context)
+
+These apply at different stages. Ask which stage before recommending.
+
+---
+
+## VII. Pre-Launch Checklist
+
+Before any campaign goes live, confirm all of the following:
+
+**Objective & tracking (hard blocks — do not proceed if these fail):**
+- [ ] **[HARD BLOCK]** Campaign **objective** = Sales or Leads (or Catalog Sales for product feeds). Not Traffic, Reach, Engagement, Awareness, or App Promotion. If not → stop, fix, do not launch.
+- [ ] **[HARD BLOCK] Performance goal** at the adset level = `maximize number of conversions` (or `maximize value of conversions` if LTV varies across services). **Reject any of:** `maximize landing page views`, `maximize link clicks`, `daily unique reach`, `impressions`, `post engagement`. Per Ben (dAJyqo §8): *"You can mess up a good campaign objective with a bad performance goal"* — same campaign objective + wrong performance goal silently downgrades to the lowest-fidelity equivalent. Equally load-bearing as the objective gate.
+- [ ] **[HARD BLOCK]** CAPI installed, firing, and event_id deduplication confirmed. If not → stop, provide setup instructions, do not launch. (Ben + Moonlighters near-rule. Moonlighters: *"without that, you are doomed."*)
+- [ ] Pixel verified firing in Events Manager (belt + suspenders alongside CAPI)
+- [ ] **[HARD BLOCK if applicable]** Special ad category set if the offer falls into financial / employment / housing / social-issues-election-or-politics. Wrong answer = ad account disapproval, not just rejected ads.
+- [ ] **Attribution model = standard** (not incremental, unless deliberately chosen). **Attribution window:** Moonlighters' beta-confirmed default is `7-day click + 1-day engaged + 1-day view`. Meta's UI default is 1-day view (changed 2026) — adjust before launch.
+- [ ] **Bid strategy = highest volume** (auction default). Cost-per-result goal and bid cap are *not* for first-time launches — Ben.
+
+**Structure:**
+- [ ] Budget confirmed with operator — never assumed (snow-globe: budget is the one variable that must be right at launch)
+- [ ] Adset count justified — default is 1 prospecting adset. Deviation requires a reason matching one row in §II's "When to deviate" table.
+- [ ] **Detailed targeting / suggested-audience left mostly blank** (3-speaker STRONG RULE: Ben + Charlie + Moonlighters — *"99% of the time, I am leaving this blank"*). Use value rules instead of hard targeting.
+- [ ] Audience size is large enough for adset budget to reach 50 conversions/week (learning-phase math).
+- [ ] Hard exclusions wired (all-time purchasers excluded from prospecting via Custom Audience exclusion — now a hard boundary as of 2026).
+- [ ] Default placements left as Advantage+ (3-speaker rule: Ben + Moonlighters explicitly leave placement to Meta; analysis happens after the run, not before).
+
+**Creative:**
+- [ ] At least 3 creative variants in the adset (floor); **20+ is the Andromeda steady-state anchor** (Ben corpus rule). Flag if below 20 with no production-capacity reason on file
+- [ ] Creative variants are **variations within one customer journey** (same ICP, same promise, different hooks/formats), not different hooks/promises/motivations stacked into one adset (Charlie's bottom-funnel-spam anti-pattern)
+- [ ] Format mix in the adset (not 20 identical-format videos) — UGC + founder-on-camera + product-centric / static + carousel
+- [ ] First 2-3 seconds of each video: problem, outcome, or callout — not logo
+- [ ] Ad copy follows callout → agitation → benefit → scarcity → CTA structure (or has an explicit reason to deviate)
+- [ ] Landing page headline matches ad promise
+
+**Test-integrity gate (do not skip — this is the "are you actually testing what you think you're testing?" check):**
+- [ ] **What changes between adsets/ads is exactly one variable.** If audience differs across adsets, creative must be identical. If creative differs across ads, audience must be identical (one adset). If both differ, the result is unreadable — restructure or accept that this is a launch, not a test.
+- [ ] **The test has a falsifiable prediction.** Operator can complete: "I expect X to beat Y on metric M by threshold T within window W. If it doesn't, I'll do Z." Without this, the result has no decision attached and the test is curiosity, not learning.
+- [ ] **Each cell is funded to read.** Every adset under test must reach ≥50 conversions/week within the test window, or the result is statistical noise. If budget can't support that, kill cells or merge.
+- [ ] **No structural changes mid-test.** Snow-globe rule applies — pausing, scaling, or editing a cell mid-window invalidates that cell's read.
+- [ ] **The hypothesis is logged before launch**, not reverse-engineered after. Use `mk cohort create` with the 4-field hypothesis shape (predicted_winner, predicted_metric, decision_threshold, kill_condition).
+
+**Compliance:**
+- [ ] No personal attribute references in copy
+- [ ] No unsubstantiated claims ("guaranteed", "miracle", "cure")
+- [ ] If targeting EU/EEA users (or running in EU app stores): cookie-consent banner + GDPR-compliant data handling in place
+
+---
+
+## VIII. Trust-Meta Principle
+
+**Trust Meta on:** delivery algorithm, audience-finding (suggestions vs controls), placement selection, bid optimization, learning-phase timing, per-user delivery frequency planning, in-adset funnel sequencing (TOFU → BOFU).
+
+**Do NOT trust Meta on:**
+1. **Value-judgments about your offer.** Meta doesn't know what your product is worth, whether your claims are accurate, or which of your offers serve your business. *Meta optimizes for engagement signals — not for whether your business is good.*
+2. **Auto-pacing toward bad performers** (Optimizer): *"the algorithm is not always right. It will skew spend to things that are giving you terrible results… Meta cares about a good user experience and draining the money from advertisers."* Don't leave bad-performing ads/adsets running on the assumption Meta will figure it out.
+3. **The default performance goal.** Meta will offer landing-page-views, link-clicks, post-engagement — these silently downgrade Sales/Leads campaigns. Override (see §VII hard block).
+4. **The Creative Testing tool's default comparison metric** (cost per post engagement). Override to your real conversion metric or the test is meaningless (Ben).
+5. **Auto-translate / auto-language expansion** unless you can fulfill in those languages.
+
+**Practical rule:** When Meta recommends a setting that affects *how it finds buyers* → follow it (broad targeting, Advantage+ placements, CBO, auto-bid). When Meta recommends something that affects *what you say, what you offer, or which of your ads keep running* → use your own judgment and the data.
+
+**The line, precisely:** Trust Meta on **delivery, structure, and audience finding** (Meta has more data than you). Don't trust Meta on **value judgments about which of your ads/offers actually serve your business** (you have more context — LTV, margin, capacity, brand fit).
+
+---
+
+## IX. Pre-Scale Gate (Omnipresent Content)
+
+**Threshold:** ~$1K-1.5K/day in total Meta spend (operator-adjustable based on local currency / market CPM). The default single-adset structure assumes products where one ad can convert a prospect. For **considered purchases / high-ticket / high-touch services** (B2B SaaS where the user hands over a workflow, agency retainers, premium subscriptions), the single-adset default may leave conversions on the table once daily spend supports multi-touch delivery.
+
+**Required action before scaling past this threshold:** Ingest Ben Heath's *omnipresent content* video to understand his multi-touchpoint campaign exception. Do not recommend scaling structure above this spend level without that corpus entry. The exception only applies when the offer is high-consideration — low-ticket impulse e-commerce stays on the single-adset default at any spend level.
+
+---
+
+## X. Beyond the Typed Client — Three-Layer API Fallback
+
+The Graph API has hundreds of fields and dozens of verbs. The TypeScript wrapper at `src/lib/marketing/meta-client.ts` covers the hot path only — campaign/adset/ad/creative create + status flips + insights + asset upload. For everything else, follow this three-layer fallback in order:
+
+### Layer 1 — Typed client (`meta-client.ts`)
+
+If the operation is one of:
+
+- `createCampaign`, `updateCampaign`, `getCampaign`
+- `createAdSet`, `updateAdSet`
+- `createAd`, `updateAd`
+- `createVideoCreative`, `createImageCreative`
+- `pauseEntity`, `resumeEntity`
+- `uploadVideo`, `uploadImage`
+- `getInsights`, `listAdAccounts`, `getAdAccount`
+
+→ use the typed function. Dry-run, retry, idempotency, header-only auth, per-account concurrency, and chunked upload come for free.
+
+### Layer 2 — `api-reference.md`
+
+If the operation isn't in the typed client, **read `api-reference.md` first** (numbered references in this section point to that file). It contains:
+
+- Endpoint map (CRUD by entity, including delete/list/duplicate)
+- Common field reference per entity (campaign, adset, ad, creative)
+- Full enum reference (objectives, optimization_goals, CTAs)
+- Complete `targeting` and `asset_feed_spec` surfaces
+- 10 raw `metaFetch` recipes (delete, paginate, duplicate, batch, custom audiences, breakdowns, async insights, targeting search, ad previews, full-fields read)
+- Error code cross-reference
+
+Pattern: write a small TS function in the relevant CLI command file that builds `metaFetch(ctx, { method, path, params })` directly. The wrapper still applies all the safety guarantees.
+
+### Layer 3 — Live Meta docs
+
+If `api-reference.md` is silent on the operation:
+
+1. **Dry-run first.** Set `ctx.dryRun = true` for the first attempt regardless of operator urgency.
+2. Fetch `https://developers.facebook.com/docs/marketing-api/reference/v25.0/<entity>` (or the relevant endpoint).
+3. Construct the `metaFetch` call. Show the operator the request shape (URL, method, params) before running live.
+4. Wait for explicit operator confirmation, then flip `ctx.dryRun = false`.
+5. **Add the recipe to `api-reference.md` §VI** so the next caller hits layer 2, not layer 3. Self-extending knowledge base.
+6. If the same recipe is used **3+ times across sessions**, propose adding a typed wrapper to `meta-client.ts` in the next PR.
+
+### Hard rules for raw `metaFetch` use
+
+- Never duplicate a typed function with a raw call. If `createCampaign` exists, use it — do not bypass to `metaFetch(ctx, { method: 'POST', path: 'act_X/campaigns' })`.
+- Never bypass `metaFetch` with a direct `fetch()`. The wrapper is the only path to Meta. Library code that calls `fetch()` against a Meta host is a security/correctness regression.
+- Never put `access_token=` in a URL — `metaFetch` will throw `HeaderAuthAssertionError`. Header-only is non-negotiable.
+- Always set `ctx.dryRun = true` when previewing a layer-3 recipe. The wrapper enforces this even when CLI flags say otherwise.
+
+### Version pin
+
+`api-reference.md` and the typed client both target **Graph API v25.0** (released 2026-02-18). When Meta releases a new version, update `DEFAULT_API_VERSION` in `src/lib/marketing/config.ts` and re-verify any layer-2 recipes that touched changed endpoints. Meta retires fields aggressively — every recipe in `api-reference.md` has an `api_version` and `verified_at` in the frontmatter for staleness detection.
+
+---
+
+## XI. Anti-Patterns
+
+| # | Anti-pattern | Correction |
+|---|---|---|
+| 1 | Traffic objective for revenue campaigns | Switch to Conversions; match event to goal |
+| 2 | Pixel-only (no CAPI) | CAPI + deduplicate with event_id; 40-60% of conversions invisible without it |
+| 3 | 15 adsets at $5/day | 1-3 adsets, enough budget per adset for 50 conversions/week |
+| 4 | Editing a live adset for structural changes | Duplicate → change → prove → pause original |
+| 5 | Checking results at 24h and making moves | 7-day window minimum; 3-5 days between moves |
+| 6 | Logo first 2 seconds | Open with problem / outcome / callout |
+| 7 | Budget 3× overnight | 20-30% increments every 3-5 days |
+| 8 | Killing low-ROAS ads while Meta still spends on them | Kill by spend=0, not by relative ROAS |
+| 9 | All budget on cold, zero retargeting | 20-30% to retargeting audiences |
+| 10 | Interest-stacking / manual placement restrictions | Broad targeting; Advantage+ placements |
+| 11 | Assuming budget — launching without asking | Always ask operator for budget before launch |
+| 12 | Launching without CAPI confirmed | Hard stop — confirm CAPI before any Sales/Leads campaign |
+
+</system_instructions>

package/dist/skill-packs/meta-marketing/account-ops.md

@@ -0,0 +1,190 @@
+---
+title: "Meta Ads Account Ops Playbook"
+lane: "paid-ad-account-ops"
+status: "draft — corpus-derived, not yet skill-pack ready"
+speakers: 4 (Ben Heath, Charlie/Disruptor Academy, Edward/Moonlighters, Optimizer/anon)
+videos: 6 (JLlcwojiVtw, E_wZJhuSK5U, dAJyqo6wnq4, 13s-G9Uj51A, FYUR8ZL4_xY, TMOfiSdx7Tg, kuSq-pmNfnM)
+updated: "2026-04-25"
+blocker: "skill-packs/ generation blocked on user decision #1 (lane consolidation/split)"
+---
+
+# Meta Ads Account Ops Playbook
+
+Rules lifted directly from the ingested corpus. Each rule cites its sources. Strength tier is derived from distinct-speaker count (not video count — same speaker across N videos = 1 voice).
+
+**Source key:**
+- Ben = `_youtube__JLlcwojiVtw` + `dAJyqo6wnq4` + `13s-G9Uj51A` + `kuSq-pmNfnM` (4 videos, 1 voice)
+- Charlie = `_youtube__E_wZJhuSK5U` (1 video, 1 voice)
+- Moonlighters = `_youtube__FYUR8ZL4_xY` (Edward, 1 video, 1 voice)
+- Optimizer = `_youtube__TMOfiSdx7Tg` (anon, 1 video, 1 voice)
+
+---
+
+## Tier 1 — Firm Rules (3+ distinct speakers)
+
+These rules have cross-source corroboration strong enough to ship as operator defaults. Do not override without explicit user instruction.
+
+### 1. Consolidate to one prospecting campaign
+
+**Rule:** Run the majority of prospecting spend inside a single Advantage Plus campaign. Avoid splitting by audience segment, creative type, or funnel stage unless there is a hard business reason (separate country spend caps, distinct product lines with incompatible conversion windows).
+
+**Why:** Meta's delivery algorithm learns from conversion signals. Spreading budget across multiple campaigns or adsets fragments the signal pool, slows exit from the learning phase, and creates audience overlap where Meta targets the same people from multiple campaigns competing against each other.
+
+**Sources:** Ben (`dAJyqo6wnq4` §1, `JLlcwojiVtw` §1), Charlie (`E_wZJhuSK5U` §2), Moonlighters (`FYUR8ZL4_xY` §1)
+
+---
+
+### 2. Leave detailed targeting blank — don't constrain the audience
+
+**Rule:** By default, leave interest targeting and detailed targeting fields empty or as broad as possible. Do not segment adsets by audience type (interest A vs interest B, cold vs warm) unless you are deliberately using the interest-winners method (see open conflict §2).
+
+**Why:** Meta's delivery now treats targeting inputs as suggestions, not hard boundaries. Tight audience constraints don't isolate your audience — they restrict Meta's ability to find buyers it would have found on its own. Audience overlap between tightly-defined adsets is rampant.
+
+**Exception (unresolved):** Moonlighters' "interest-winners" method uses one adjacent interest on a winner adset combined with `further limit reach`. This conflicts with Ben's default. See Open Conflicts §2.
+
+**Sources:** Ben (`dAJyqo6wnq4` §2, `JLlcwojiVtw` §2), Charlie (`E_wZJhuSK5U` §3), Moonlighters (`FYUR8ZL4_xY` §2)
+
+---
+
+### 3. Snow-globe rule — 3–5 day minimum cadence between optimization moves
+
+**Rule:** After any significant change (new adset, new creative batch, budget change), wait at least 3–5 days before making another structural change. Read results only after the system has settled.
+
+**Why:** Every structural change re-enters (or extends) the learning phase. Making moves daily means you're always reading data from a system that hasn't converged yet. The snow-globe analogy: shaking it again before the snow settles tells you nothing about the picture.
+
+**Sub-rule:** Do not optimize on data from the first 24–48 hours of a new creative or campaign — early delivery skews heavily toward retargeting audiences, not cold prospecting.
+
+**Sources:** Ben (`dAJyqo6wnq4` §6), Charlie (`E_wZJhuSK5U` §5), Optimizer (`TMOfiSdx7Tg` §3)
+
+---
+
+## Tier 2 — Strong Near-Rules (2 distinct speakers)
+
+Two-speaker corroboration. Treat as operator defaults, but lower confidence than Tier 1. Flag these for review if a third source contradicts.
+
+### 4. Turn off by spend, not by ROAS — within an adset
+
+**Rule:** Within a single adset, do NOT turn off ads solely because they have a lower ROAS than other ads in the same adset. Instead, turn off ads that Meta has stopped spending budget on.
+
+**Why:** Meta sometimes uses lower-ROAS ads as top-of-funnel priming — it shows them first to warm people up, then delivers the conversion-focused ad. The top-funnel ad will look bad by ROAS alone. Killing it breaks Meta's internally constructed multi-touch sequence, causing the "winner" ad to drop off unexpectedly.
+
+**Kill criterion:** `spend = 0` (or near-zero for multiple days) → turn off and replace.
+**Leave-on criterion:** Meta is still allocating spend to it, regardless of its relative ROAS.
+
+**Sources:** Ben (`13s-G9Uj51A` §2 + `kuSq-pmNfnM` §2 — two separate Ben videos, sharpened across both)
+
+**Corroboration priority:** High. This is currently 1 voice (Ben ×2). Needs one more distinct speaker to become Tier 1.
+
+---
+
+### 5. CAPI + pixel — not either/or
+
+**Rule:** Install both Conversions API (CAPI) and the Meta Pixel. They are not alternatives — they are complementary. CAPI covers server-side events that pixel cannot capture (ad blockers, iOS restrictions, delayed conversions). Running only one degrades the signal quality Meta's AI uses for optimization.
+
+**Sources:** Ben (`JLlcwojiVtw` §3), Moonlighters (`FYUR8ZL4_xY` §4)
+
+**Decision #5 resolved:** CAPI is a hard launch prerequisite — no override. See SKILL.md §hard constraints.
+
+---
+
+### 6. Default placement — let Meta choose
+
+**Rule:** Use Advantage+ placements by default. Do not restrict to specific placements (Feed-only, Stories-only, etc.) unless you have a creative that is technically incompatible with a placement format.
+
+**Sources:** Ben (`JLlcwojiVtw` §2), Moonlighters (`FYUR8ZL4_xY` §4)
+
+---
+
+### 7. Auto-translate off if you can't fulfill in that language
+
+**Rule:** If you enable multi-language delivery, turn off auto-translate for any language you cannot service (support, onboarding, product UI). Showing ads in a language the product doesn't support burns budget and creates a broken first experience.
+
+**Sources:** Ben (`JLlcwojiVtw` §4), Moonlighters (`FYUR8ZL4_xY` §4)
+
+---
+
+### 8. Don't restrict minimum age unless legally required
+
+**Rule:** Leave the minimum age at platform default unless you have a legal requirement (alcohol, gambling, financial products) or have data proving the youngest age band is non-converting and not worth the impression cost.
+
+**Sources:** Ben (`JLlcwojiVtw` §4), Moonlighters (`FYUR8ZL4_xY` §4)
+
+---
+
+### 9. Don't fragment — get out of learning fast
+
+**Rule:** Every unnecessary split (extra adset, extra campaign, extra audience segment) delays exit from Meta's learning phase and creates a smaller per-unit budget, which means each unit takes longer to accumulate the 50 conversion events needed to exit learning. Default to fewer, larger units.
+
+**Sub-rules (all Ben + Charlie):**
+- Start simple, add complexity only when a simple structure is already profitable
+- Stop testing audience permutations as the primary testing axis — audience is not the lever; creative and offer are
+- Getting out of learning is the first optimization goal on any new campaign
+
+**Sources:** Ben (`dAJyqo6wnq4` §3–§4), Charlie (`E_wZJhuSK5U` §4)
+
+---
+
+## Testing Methodology (resolved)
+
+**Default:** Moonlighters — new adset with min-spend = 1× target CPA.
+
+When testing a new creative pack or offer, create a new adset within the existing campaign. Set a minimum daily budget equal to 1× your target CPA. This spend floor ensures Meta actually delivers the new adset before deprioritizing it in favor of proven winners.
+
+**Fallback hierarchy:**
+
+| Context | Method |
+|---|---|
+| **Default** | Moonlighters: new in-campaign adset, min-spend = 1× target CPA |
+| **Low budget** (min-spend floor is unaffordable) | Charlie: control adset + test adset, same campaign |
+| **Need clean per-creative attribution** | Ben: Meta's native Creative Testing tool — isolated audience splits, separate from main campaign |
+
+---
+
+## Remaining Conflicts (surface to operator — not resolved)
+
+### Conflict A — `further limit reach` toggle
+
+| Position | Detail | Proponent |
+|---|---|---|
+| **Don't use it** | Broad is better for prospecting; restricting limits Meta's delivery window; beginner default should be off | Ben |
+| **Use it for interest-winners** | After an interest-based adset proves itself, add one adjacent interest and enable `further limit reach` to focus delivery | Moonlighters |
+
+**Not the same context.** Ben's advice is for general campaign setup. Moonlighters' advice is for a specific optimization move on a proven adset. These may not actually conflict — they may be stage-dependent. Do not collapse.
+
+---
+
+### Conflict C — Creative volume vs ad spam
+
+| Position | Detail | Proponent |
+|---|---|---|
+| **20+ creatives per adset** | More creative diversity = more angles for Meta to test; give it as many signals as possible | Ben |
+| **Ad spam breaks the system** | Too many creatives fragment budget per creative, prevent any single ad from accumulating enough signal to exit learning | Charlie |
+
+**Proposed resolution (not confirmed):** The conflict is about *what kind* of variation. Ben's 20+ creatives are variations around a stable journey (same offer, same CTA, different hooks/formats). Charlie's "spam" is fragmentation that changes the customer journey across creatives. Variation within a consistent journey ≠ variation that fragments the funnel. User decision pending.
+
+---
+
+## Single-Speaker Claims — Pending Corroboration
+
+These are high-priority signals from one distinct voice. Do not promote to rules until a second source confirms.
+
+| Claim | Source | Priority | Notes |
+|---|---|---|---|
+| Adset min-spend = 1× target CPA on new packs | Moonlighters (`FYUR8ZL4_xY` §3) | Resolved | Adopted as testing default — see Testing Methodology section |
+| Performance goal trap — wrong objective permanently mis-trains the algorithm | Ben (`dAJyqo6wnq4` §8) + mistakes-report-2026 | Resolved | Now a hard block gate in SKILL.md — no override accepted |
+| Auction overlap mechanism — Meta auctions are per-impression; two adsets targeting the same person compete against each other in every auction | Ben (`13s-G9Uj51A` §1) | Medium | Supports consolidation rationale |
+| Filter-by-row-selected preview trick — isolate one creative in Ads Manager to read its true delivery data | Optimizer (`TMOfiSdx7Tg` §4) | Medium | Pre-move check |
+| Spend redistribution math — when you turn off an ad, its budget redistributes; know where it goes before killing | Optimizer (`TMOfiSdx7Tg` §5) | Medium | Pre-move check pair with above |
+| Ad-level vs adset-level optimization decision matrix | Optimizer (`TMOfiSdx7Tg` §10) | Medium | Structural rule for eventual Optimizer agent |
+| Profit_volume / blended outcome as the correct optimization target for scaling accounts | Charlie (`E_wZJhuSK5U` §7) | Medium | |
+| Test purpose = improve the weakest ad in the control set, not find a new winner | Charlie (`E_wZJhuSK5U` §6) | Medium | Reframes testing intent |
+| Low-budget rule — under a certain monthly budget threshold, don't run multiple campaigns at all | Charlie (`E_wZJhuSK5U` §8) | Medium | |
+
+---
+
+## What this file does NOT cover
+
+- Creative production, hook formulas, UGC/influencer strategy → `meta-ads-creative-frameworks.md`
+- Ad copy structure (callout/agitation/benefit/scarcity/CTA) → `copy-formulas.md`
+- Competitor hook examples, Turkish copy rules → `meta-ads-creative-playbook.md` (user-maintained)
+- Graph API operations, campaign launch guardrails → future `skill-packs/meta-marketing/` (blocked on lane decision)