--- name: vertical-creator description: Domain-knowledge primer for the marketing & creator vertical (creators, newsletter writers, podcasters, course sellers) so architect/pm don't spec naively against incumbents (Substack ~10%, Patreon 8–12%, Kajabi $149+, beehiiv, Buffer/Hootsuite/Later). Supplies the vocabulary, the non-obvious take-rate/red-ocean rules, the entities a real scheduler/analytics/monetization/sponsorship product must model, and the per-product wedge — with sponsorship-crm flagged as the white-space wedge. Applied by architect/pm during spec authoring for any of the four products in this vertical — content-scheduler, analytics, monetization, sponsorship-crm. when_to_use: | Apply when: - architect is writing ARCH-*.md for a marketing/creator product (content-scheduler, analytics, monetization, sponsorship-crm) - pm is decomposing one of these into tasks and needs to model the domain entities (Sponsor, Deal, MediaKit, ScheduledPost, ChannelMetric) correctly - any spec touches creator monetization, take-rate, brand deals, or cross-channel publishing Do NOT apply for other verticals (home services, restaurants, etc.) — the economics here (platform take-rate as the competitive lever, sponsorship white-space) are specific. effort: low allowed-tools: Read, Write, Grep, Glob paths: - "docs/architecture/**" - "docs/plans/**" - "docs/design/**" --- # Vertical: marketing & creator — undercut the take-rate, own the white space Creators monetize an audience across channels they don't control. Their economics are dominated by **take-rate** (the platform's cut) and by **brand sponsorships** that most creators still manage in spreadsheets. Two of the four products here (scheduling, analytics) sit in **red oceans** owned by entrenched incumbents; one (**sponsorship-crm**) sits in genuine **white space**. Spec against that asymmetry — don't lead with the commodity. ## 1. Domain vocabulary - **CPM (cost per mille)** — ad/sponsor price per 1,000 impressions. The supply side. - **RPM (revenue per mille)** — revenue the creator actually earns per 1,000 views/opens, net of platform cut. RPM < CPM; the gap is fees and unfilled inventory. - **Sponsorship / brand deal** — a brand pays a creator to promote a product. The unit of white-space revenue here. - **Fee model** — how a deal pays: **flat fee** (fixed $ per deliverable), **affiliate** (% of referred sales), or **CPA** (cost-per-action — $ per signup/install). A single deal can mix them (flat + affiliate). - **Deliverables** — the concrete asset(s) owed: posts, stories, dedicated email, video **integration** (a segment inside a longer video), etc. Each has a channel and a due date. - **Usage rights** — whether/how long the brand may reuse the creator's content (e.g. "whitelisting" to run as paid ads). Priced separately; easy to give away by accident. - **Media kit** — the creator's sales one-pager: audience size, demographics, engagement, past brands. - **Rate card** — the creator's published prices per deliverable type. The negotiation anchor. - **Audience demographics** — geo, age, gender split — what a brand buys against. - **Engagement rate** — interactions ÷ reach/followers. The quality signal brands price on. - **Take rate (platform cut)** — the % a monetization platform skims (Substack ~10%, Patreon 8–12%). The single biggest competitive lever in this vertical. - **MRR** — monthly recurring revenue from memberships/subscriptions; the membership KPI. - **UTM** — campaign tracking params on a link; the raw input to attribution. - **Cross-channel attribution** — crediting a conversion/revenue back to the right channel and post across platforms with different IDs. Hard, and the analytics moat. ## 2. Non-obvious domain rules - **Scheduling and analytics are RED OCEANS — do not lead there.** Buffer, Hootsuite, and Later own cross-channel scheduling; every analytics vendor re-skins channel dashboards. Building "yet another scheduler" is a commodity play with no wedge. These two only earn their place as the *connective tissue* of a suite, never as the entry point. - **Sponsorship management is WHITE SPACE — this is the real wedge.** Most creators track brand sponsors, deals, and deliverables in **spreadsheets**. There is no entrenched category leader. A purpose-built sponsorship CRM is the one product here with a defensible reason to exist on day one. - **Monetization platforms take 8–12% — undercut on take-rate.** The competitive lever is not features, it's the cut. If the incumbent takes 10% and you take 3%, that *is* the pitch. Take-rate must be a first-class, configurable design decision, not an afterthought. - **Each social channel has a different API and content shape.** A "post" is not one thing: an X post, an IG story, a YouTube integration, and an email all differ in format, limits, metrics, and auth. Normalize at the model layer; never assume one channel's shape. - **Brand deals carry deliverables + usage rights + payment milestones.** A deal is not a line item — it's a small project: multiple deliverables across channels, usage-rights terms, and staged payments (e.g. 50% on signing, 50% on go-live). Model all three. ## 3. What a naive build gets wrong - **Building yet another scheduler** — treating content-scheduler as the hero product. It's a commodity in a red ocean; shipped standalone it competes head-on with Buffer and loses. - **sponsorship-crm as a generic CRM** — modeling a "deal" as a contact + amount + stage misses the domain. It needs **deliverables**, **rate card**, **usage rights**, **fee model**, and **payment milestones** — a generic pipeline CRM captures none of these. - **Analytics that just re-skins one channel** — pulling YouTube Studio numbers into a prettier chart adds nothing. The only defensible analytics is **normalized cross-channel** with attribution, not a single-channel mirror. - **Monetization that ignores take-rate as the lever** — copying Substack's feature set at Substack's 10% cut. If take-rate isn't the design center, there's no reason to switch. ## 4. Must-model entities Spec these explicitly; they recur across the four products. Build them [[migration-ready-schema]] (stable external IDs, soft-delete, audit timestamps) because creators arrive mid-stream from spreadsheets and incumbents and import open deals + members. - **Sponsor** — the brand: contact(s), past deals, status. Distinct from the Deal. - **Deal** — the unit of sponsorship revenue: **stage** (prospect → negotiating → signed → delivering → paid), **fee model** (flat / affiliate / CPA, possibly mixed), **deliverables** (each with channel + due date + status), **usage rights** (scope + duration), and **payment milestones** (amount + trigger + paid state). This is the white-space product — model it richly. - **MediaKit / RateCard** — audience stats + demographics + engagement (media kit) and per-deliverable prices (rate card). The sales surface; feeds the Deal negotiation. - **ScheduledPost** — one logical post with **per-channel variants** (content, format, limits, asset refs differ per channel), schedule time, and publish status per channel. Never a single body string shared across channels. - **ChannelMetric** — a **normalized cross-channel** metric row (channel, post ref, metric type, value, period) so analytics can sum/compare across platforms with different native IDs. - **Membership / Paywall tier** — name, price, interval, **take-rate**, entitlements, member count; the unit of recurring (MRR) monetization. ## 5. Per-product notes (wedge vs incumbent + the one thing to nail) - **sponsorship-crm** (crm) — **THE WEDGE. White space.** Creators do this in spreadsheets; no category leader. **Must nail: the Deal as a project, not a contact** — deliverables + rate card + usage rights + fee model + payment milestones, with a stage machine. A generic CRM is a non-answer. See [[vertical-onboarding]]: first activation = first sponsor + deal imported off the spreadsheet. - **monetization** (content) — wedge: **undercut take-rate**. Paywalls, memberships, tips at 3% vs incumbents' 8–12%. **Must nail: take-rate as a first-class, configurable design center** and MRR tracking; consent for member comms defers to [[lifecycle-messaging]]. - **content-scheduler** (content) — **commodity, red ocean.** Only worth building as the publishing layer of the suite, never standalone. **Must nail: per-channel post variants** (one calendar, N channel shapes) — that's the only non-commodity part. - **analytics** (dashboard) — **commodity unless cross-channel.** A single-channel re-skin is worthless. **Must nail: normalized cross-channel metrics + attribution**; ingestion of each channel's API is a [[connector-builder]] job, not bespoke glue. ## 6. Compliance (light) Keep this proportionate — defer money-movement and message-sending specifics to the relevant engineer/skill. - **FTC disclosure** — sponsored content must be clearly disclosed (`#ad` / "sponsored" / paid-partnership label). If the product publishes brand deals, surface and enforce the disclosure as part of the deliverable, not an optional toggle. - **1099 for creator income** — creators (and their sponsors/affiliates) generate reportable income; if the product touches payouts, track payee tax info for 1099-NEC/1099-K (US). Note it; don't build a tax engine into a CRM. - **Email/SMS consent for membership comms** — member announcements and lifecycle sends need consent (CAN-SPAM/TCPA, double opt-in, suppression). Defer the deliverability + consent posture entirely to [[lifecycle-messaging]]. - **Platform ToS for cross-posting** — each channel's terms govern API auth, automation, and re-posting. Cross-channel publishing must respect per-platform rate limits and automation rules; don't assume one channel's allowances apply to all. ## Output When applied, contribute a **Domain model** note to the architecture doc capturing: the products in scope and which are commodity vs wedge (sponsorship-crm = white space), the must-model entities above that this product owns, the **take-rate** decision if monetization is in scope, the **Deal** shape (deliverables + usage rights + fee model + payment milestones) if sponsorship-crm is in scope, and the **per-channel variant** + **normalized cross-channel** contract if scheduler/analytics is in scope.