# AI Marketing Agent — Operator-Grade Marketing Harness

An agent-agnostic marketing operator (Hermes / Claude Code / Codex) that researches a business
deeply, diagnoses the real growth constraint, and executes specific, honest, results-driven
marketing — including AI ad creative. Built to operate at the level of a senior growth operator,
not a generic "post more content" bot.

The premise: **the product's own marketing is a live demonstration of the product.** If the
marketing is generic or dishonest, the demo fails in public. So every output must be specific,
sourced, and real.

## Layers (see `ARCHITECTURE.md`)

1. **Brain** — `knowledge/marketing.md` (strategic operating system: operating contract,
   diagnosis-first, Hormozi + GaryVee frameworks, anti-generic enforcement) and
   `knowledge/viral-growth-engine.md` (Higgsfield-grade creator-distribution playbook with
   built-in honesty guardrails), plus `knowledge/unit-economics.md` (the profit lens: CAC, LTV,
   payback, contribution margin, and the scale gates every spend decision must pass).
2. **Recon** — `skills/market-research/` deep multi-hop research with dispatchable subagents;
   outputs a Research Brief and writes `.agents/product-marketing.md`.
3. **Tactical execution** — 40+ adopted skills (`skills/`) and 90+ real-tool integration docs
   (`tools/`) from Corey Haines' MIT library, governed by the brain and fed by the recon.
4. **AI creative** *(in progress)* — `skills/ad-image-gen/` (nano banana 2 / GPT Image 2),
   `skills/ad-video-gen/` (Seedance 2), `knowledge/ad-prompting.md`.

## What makes it different

- A strategic **diagnosis-first brain** that refuses generic advice (enforced, not hoped).
- A **deep research engine** with subagents and a validate→extract→fallback→review loop.
- The **Higgsfield viral/distribution engine** — creator-as-distribution, templatization,
  persistent personas, ship-velocity, a virality-predictor gate — with the ethical guardrails
  Higgsfield fatally lacked.
- **AI ad creative** generation wired to the research, not decorative stock.
- The **recursive-demo discipline**: everything real, everything specific.

## The engagement flow

intake → deep research (writes `.agents/product-marketing.md`) → diagnose the one constraint →
site/brand audit → strategy + offer → distribution plan → (consent + budget gate) → execute +
generate creative → measure and close the loop.

## Status

- ✅ `knowledge/marketing.md` — strategic brain (OS-grade)
- ✅ `knowledge/viral-growth-engine.md` — Higgsfield-grade distribution engine
- ✅ `knowledge/unit-economics.md` — profit brain (CAC/LTV/payback + scale gates)
- ✅ `knowledge/verticals/` — SaaS / ecommerce / local-services / info-products packs (priors + diagnosis overrides)
- ✅ 8-role research bench + `<synthesis_conflict_protocol>` (journey mapper, proof auditor added)
- ✅ `skills/market-research/` — research engine + subagents + extraction/review loop
- ✅ 40+ tactical skills + 90+ tool docs adopted (Corey Haines, MIT) and bridged
- ✅ `ARCHITECTURE.md`, `vendor/ATTRIBUTION.md`
- ✅ `CLAUDE.md` / system prompt — the conductor: identity + intake gate + engagement flow + skill routing + gates + client state
- ✅ `skills/ad-static-nano-banana`, `skills/ad-static-gpt-image`, `skills/ad-video-seedance` — the AI creative arm (Layer 4)
- ⬜ Course packaging + Whop tiering (Free / $97 / $897)

## Licenses & attribution

See `vendor/ATTRIBUTION.md`. Adopted skills are MIT (Corey Haines); mayooear's company-researcher
was pattern-studied only (no code copied); grounding corpus is GaryVee/Hormozi transcripts and a
primary Higgsfield growth teardown.
