v1.0.04 — Closed-loop Execution 🎯

🎯 Closing the loop: from plan to launched campaigns

v1.0.03 brought you the guided strategy flow. v1.0.04 adds the guided execution flow — the second half of the loop.

/ads blueprint produces the plan. Now /ads blueprint-execution puts it into practice.

What /ads blueprint-execution does

Reads your existing ADS-Blueprint/ folder (the one /ads blueprint produced) and coaches you through every remaining step:

1. 🔴 Gate check — close residual blocking issues (missing pixel, landing health <60, compliance gaps) with step-by-step fixes
2. 🛠️ Pre-launch tracking setup — Meta Pixel + CAPI, GA4, LinkedIn Insight, UTM templates, Consent Mode V2 — with verification checks after each
3. 🎯 Campaign build — for each active platform, click-by-click instructions with your actual copy, audiences, budgets, and bid strategies pre-filled from the blueprint files. Covers Meta, Google, LinkedIn, TikTok, Microsoft, Apple.
4. 🚀 Launch day — exact activation sequence + 2h / 24h / 48h check-ins + the "do nothing in learning phase" rule
5. 📅 Learning phase — weekly observation-only check-ins until the platforms exit learning
6. 📊 Optimization cycle — every 2 weeks: you paste metrics (or export CSV), the skill mechanically applies:
   • 3× Kill Rule — any ad set with CPA >3× target gets killed
   • 20% Scaling Rule — winners get +20% budget every 3-5 days
   • Creative fatigue detection — frequency >3.0 or CTR drop >30% triggers refresh
   • And gives you the exact edit instructions to execute in the ad platform

Live HTML dashboard

Every session regenerates ADS-Blueprint/Execution/live-dashboard.html — a self-contained interactive page showing:

• Current stage + overall progress
• KPI cards (campaigns live, daily spend, 30-day conversions, blended CPA, blockers open, decisions this month)
• Per-platform build status
• Latest audit decisions (kill / scale / hold / refresh per ad set)
• Recent session log (timeline component)
• Recommended next action

Data input — your choice

Paste text, CSV, or screenshots — the skill handles all three:

• Paste: quick and approximate — best for day-7 sanity checks
• CSV: accurate — preferred for decision-making bi-weekly audits (drop files in ADS-Blueprint/Execution/live-data/)
• Screenshot: best-effort OCR-style parsing of pasted text

Output files

Everything lives in a clean folder tree:

ADS-Blueprint/
├── Phase-0 … Phase-4/              ← from /ads blueprint
├── EXECUTION-STATE.json            ← tracked by the new skill
└── Execution/
    ├── live-dashboard.html         ← interactive dashboard
    ├── EXECUTION-LOG.md            ← session-by-session diary
    ├── pretrack-verification-report.md
    ├── utm-templates.md
    ├── meta-setup-instructions.md
    ├── google-setup-instructions.md
    ├── …one per active platform…
    ├── launch-day-sequence.md
    └── live-data/                  ← drop CSV exports here

Honest scope

Claude Code cannot click buttons in Meta/Google Ads Manager. What it CAN do (and this skill does):

✓ Tell you exactly what to click, in what order, with exact copy and budget
✓ Read your blueprint files and pre-fill every number, copy variant, persona, keyword
✓ Analyze pasted metrics / CSVs / screenshots to decide kill/scale/refresh
✓ Keep a log of every session so nothing gets lost

Adaptive — same 3 modes as the blueprint

• 🎓 Beginner: every setup guide and audit gets a plain-language -Beginner.md twin
• 📊 Intermediate: technical files end with "📚 In plain English" section
• 🚀 Expert: technical files only

Upgrade

/plugin marketplace update maxym-plugins

Already-installed users get v1.0.04 automatically with both guided skills.

Install fresh

/plugin marketplace add Maxymize/maxym-ai-ads
/plugin install maxym-ai-ads@maxym-plugins

Invoke the new skill

/ads blueprint-execution                  # auto-detect current stage
/ads blueprint-execution audit            # jump to bi-weekly audit
/ads blueprint-execution --fresh          # restart from gate check

Documentation

• README — full closed-loop narrative
• BLUEPRINT-ZERO-TO-SALES.md — new 'After the plan: execute it' section links to the new skill
• CHANGELOG.md — full v1.0.04 changes

v1.0.03 — Adaptive Blueprint UX 📚

📚 Three big UX improvements to the guided blueprint

Based on real-use feedback from v1.0.02, three pain points are now fixed:

1. 🗣️ One question at a time

The intake questionnaire no longer dumps all questions in one message. You now see a preview of the 11 questions upfront (so you're mentally prepared), then the skill asks each one individually with per-question suggestions and examples, waits for your answer, echoes it back, and moves on to the next.

No more copy-paste marathons.

2. 📂 Clean folder-per-phase output structure

All outputs now land in a single, organized ADS-Blueprint/ folder in your CWD, with subfolders per phase:

ADS-Blueprint/
├── ADS-STRATEGY-REPORT.pdf            ← final deliverable
├── ADS-BLUEPRINT-REPORT.html          ← final deliverable
├── ADS-LAUNCH-CHECKLIST.md            ← final deliverable
├── ADS-BLUEPRINT-STATE.json           ← state for --resume
├── Phase-0-Reality-Check/
├── Phase-1-Intelligence/
├── Phase-2-Budget-Funnel/
├── Phase-3-Creative/
└── Phase-4-Landing-Test/

Replaces the flat-file-dump-in-CWD from earlier versions.

3. 📚 Adaptive to your experience level ★ NEW

A new 11th intake question asks your level of paid-ads experience. The output adapts accordingly:

Level	What you get
🎓 Beginner	Every technical file gets a full -Beginner.md twin — a standalone rewrite in plain language. Not a summary. Full coverage, with analogies, glossary, and a 'what to do next' section.
📊 Intermediate	Every technical file ends with a '📚 In plain English' section (200-500 words, defines acronyms, lists key takeaways).
🚀 Expert	Technical files only (fastest output, pre-1.0.03 behavior).

This makes maxym-ai-ads the first paid-ads skill that adapts its own documentation to your level. Non-marketers get a companion document that assumes zero prior knowledge — not a marketer's report they have to decode.

The HTML report shows the chosen mode in the hero and includes a contextual banner pointing to the plain-language companion content (for beginner/intermediate modes).

Upgrade

/plugin marketplace update maxym-plugins

Already-installed users get v1.0.03 automatically. Existing phases remain compatible; --resume still works for flows started under v1.0.02 (will use the new phase-folder structure for remaining phases).

Install fresh

/plugin marketplace add Maxymize/maxym-ai-ads
/plugin install maxym-ai-ads@maxym-plugins

Documentation

• Full README with the new adaptive-by-experience feature highlighted
• BLUEPRINT-ZERO-TO-SALES.md now advertises the adaptive modes as a distinguishing selling point
• CHANGELOG.md for full details

v1.0.02 — Guided Blueprint 🌟

🌟 New: /ads blueprint — the guided zero-to-sales workflow

This release adds a fully guided, interactive workflow that runs the entire Zero-to-Sales Blueprint for you. Instead of remembering 25 commands in the right order, you run one:

/ads blueprint                         # full interactive flow
/ads blueprint https://your-site.com   # pre-fills URL
/ads blueprint --resume                # resume after interruption

How it works

1. Initial questionnaire — one message, 10 quick questions (URL, industry, budget, goal, platforms, language, etc.)
2. Automatic phase execution — the skill runs each of the 5 Blueprint phases for you
3. Phase-boundary checkpoints — you confirm at the end of each phase; no rapid-fire yes/no
4. Critical decision gates — the workflow blocks only when it really needs to (Phase 0 score <40, Phase 2 break-even CPA impossible)
5. Three final deliverables at the end:
   • 📄 ADS-STRATEGY-REPORT.pdf — client-ready
   • 🌐 ADS-BLUEPRINT-REPORT.html — interactive dark-themed HTML with persistent checklist
   • ✅ ADS-LAUNCH-CHECKLIST.md — pre-launch / launch-day / week-1 / week-2 tasks

Interactive HTML report

The new HTML template is:

• Self-contained — zero external dependencies, no CDN, works offline
• Dark-themed and professional — optimized for sharing with clients
• Persistent — localStorage saves your checklist progress in the browser
• Printable — print-friendly CSS for PDF export via browser

Two ways to run the Blueprint

Both paths produce identical results — pick what fits you:

• 🅰️ Guided: /ads blueprint — first time, client handoffs, minimum typing
• 🅱️ Manual: follow BLUEPRINT-ZERO-TO-SALES.md — fine-grained control, collaborative workflows

Upgrade

If you already installed v1.0.01:

/plugin marketplace update maxym-plugins

The new /ads blueprint command will appear automatically. Existing skills are unchanged.

Install fresh

/plugin marketplace add Maxymize/maxym-ai-ads
/plugin install maxym-ai-ads@maxym-plugins

Changes in v1.0.02

• Added ads-blueprint skill (+1 sub-skill, total 30)
• Added standalone interactive HTML report template
• Three-file deliverable flow (PDF + HTML + Markdown checklist)
• Installer updated to copy .html files alongside .md files in skill assets
• README + BLUEPRINT doc now prominently feature the dual-mode (guided vs manual) choice

Full details in CHANGELOG.md.

v1.0.01 — Launch 🚀

🚀 Launch Release

maxym-ai-ads is now a native Claude Code plugin, installable in two commands.

Install

/plugin marketplace add Maxymize/maxym-ai-ads
/plugin install maxym-ai-ads@maxym-plugins

What's inside

• Unified /ads orchestrator with 30 sub-commands
• Full multi-platform audit across Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple — 250+ weighted checks
• 5-agent parallel strategy build (/ads strategy <url>) → Ad Readiness Score 0-100
• 6-agent parallel audit (/ads audit) → Ads Health Score 0-100
• Creative generation pipeline — brand DNA → campaign brief → AI images → 5-style product photoshoot
• Platform-specific copy for Google RSA/PMax, Meta, LinkedIn, TikTok, YouTube, Pinterest
• 11 industry strategy templates: SaaS, e-commerce, local-service, B2B, info-products, mobile-app, real-estate, healthcare, finance, agency, generic
• 15 specialized subagents: 6 audit + 4 creative pipeline + 5 strategy
• 25 RAG reference files with 2026-current benchmarks and compliance
• Dual-mode workflows for landing pages, budget, and competitor intelligence

🗺️ New: Zero-to-Sales Blueprint

A complete playbook to go from "I have a product" to "my ads print money" in 8–12 days of prep, with zero wasted budget.

👉 Read the Blueprint

Covers all 5 phases (Reality Check → Intelligence → Budget/Funnel → Creative → Launch → Optimize) with flowcharts, decision gates, the 3 sacred rules of paid ads optimization, and a printable quick-reference card.

Changes in v1.0.01

• Restructured to Claude Code plugin layout (skills/ads/ for the orchestrator)
• Added .claude-plugin/plugin.json and .claude-plugin/marketplace.json
• Simplified installers: single loop copies every skill + assets/references
• Added the Zero-to-Sales Blueprint in docs/

Quality gates enforced

• 3× Kill Rule, 20% Scaling Rule, Learning-phase protection
• Special Ad Categories enforcement (housing/employment/credit/finance)
• Andromeda creative diversity check (Meta)
• Consent Mode V2 verification

Requirements

• Claude Code CLI
• Python 3.10+ (installer handles dependencies)
• Git 2.30+

Credits

MIT-licensed. Portions derive from prior MIT-licensed projects — see NOTICES.md.