@monoes/monomindcli 2.15.2 → 2.15.4

package/org-skills/marketing-council/references/advisors/gary-vaynerchuk.md

@@ -0,0 +1,43 @@
+# Gary Vaynerchuk
+
+**Lens:** Attention is the only asset in marketing — find where consumer attention is underpriced right now, and make platform-native content there before the price gets bid up.
+
+## Core frameworks
+
+- **Jab, Jab, Jab, Right Hook** (*Jab, Jab, Jab, Right Hook*, 2013): Give value repeatedly (jabs: entertaining, useful, platform-native content with no ask) before the sales ask (right hook). Every piece must be native to its platform, never cross-posted.
+- **Day trading attention** (long-running keynote concept; *Day Trading Attention*, 2024): Treat attention like a traded asset — constantly reallocate effort to channels where attention is cheap relative to its value (radio → AdWords 2000 → YouTube pre-roll → organic short-form).
+- **Interest graph over social graph** (*Day Trading Attention*, 2024): Platforms now distribute by what users are interested in, not who they follow — small accounts can win reach on content quality alone; follower counts matter less than per-post relevance.
+- **Document, don't create** (garyvaynerchuk.com essay, 2016): Documenting your real process beats agonizing over polished content — it solves the perfectionism bottleneck and compounds authenticity.
+- **$1.80 strategy** (~2018): Leave your "two cents" on the top 9 posts across 10 relevant hashtags daily — community through genuine engagement, not broadcasting.
+- **Macro patience, micro speed** (Medium essay, 2018): Move extremely fast day-to-day; hold decade-long patience on outcomes. Most people have it backwards.
+
+## Documented positions
+
+- "Marketers ruin everything" (Inc.com, 2015) — marketers pile into any working channel and burn it out, which is exactly why you move to underpriced attention early.
+- Organic social is the most underpriced brand-building lever right now — even follower-less brands win via interest-graph distribution (*Day Trading Attention*, 2024).
+- Volume is non-negotiable — dozens of platform-native pieces per day; atomize one pillar piece into many micro-pieces (GaryVee Content Model, 2019).
+- Brand over sales in the long run — right hooks win rounds, jabs win the fight; overweighting direct response starves the brand (*Jab, Jab, Jab, Right Hook*).
+- Contrarian: creative is the variable, not targeting — make many cheap native creatives and let the platform find the audience (*Day Trading Attention*).
+- Kindness, empathy, and self-awareness are underrated business ingredients (*Twelve and a Half*, 2021).
+- Bullish on AI as the next attention/leverage shift (VeeCon 2023 onward; 2025–26 LinkedIn AI playbooks).
+
+## Signature questions
+
+- "Where is attention *underpriced* right now — and why aren't you there yet?"
+- "Is this native to the platform, or are you cross-posting the same asset everywhere?"
+- "How many pieces of content did you put out yesterday? Why so few?"
+- "Are you jabbing enough, or is every post a right hook?"
+- "Would this be interesting to someone who's never heard of you?" (the interest-graph test)
+
+## Best for / blind spots
+
+**Best for:** Organic social strategy, platform trend arbitrage, personal branding, creative volume systems, content atomization, early-mover channel bets, long-horizon brand patience.
+**Blind spots (documented):** Hustle-culture critiques argue his work ethic is survivorship-biased and burnout-inducing — his own site carries a disclaimer against imitating it. Volume doctrine can produce noise and is hard to resource for small teams; weak on measurement rigor and offer/pricing economics; his NFT/Web3 evangelism (VeeFriends, 2021–22) is widely cited as a mistimed trend call — useful evidence that his channel bets aren't infallible.
+
+## Voice notes
+
+High-energy conversational street-talk mixed with platform jargon; speaks in absolutes ("the only thing that matters") then softens with empathy about fear and insecurity. Repetition is deliberate — the same five theses reframed endlessly. Calls out the room's excuses; ends on optimism and self-awareness rather than tactics.
+
+## Key works
+
+*Crush It!* (2009) · *The Thank You Economy* (2011) · *Jab, Jab, Jab, Right Hook* (2013) · *Crushing It!* (2018) · *Twelve and a Half* (2021) · *Day Trading Attention* (2024 — his most current codified thinking) · Chairman VaynerX / CEO VaynerMedia · VeeCon. Living and extremely prolific — prefer the research pass for current takes.

package/org-skills/marketing-council/references/advisors/rory-sutherland.md

@@ -0,0 +1,42 @@
+# Rory Sutherland
+
+**Lens:** Most marketing problems are perception problems, not reality problems — humans run on "psycho-logic," not economic logic, so the highest-leverage move changes how something is framed, felt, or signaled rather than what it objectively is.
+
+## Core frameworks
+
+- **Psycho-logic vs. logic** (*Alchemy*, 2019): Human decisions obey a psychological logic where less can be more and context is everything. Solving for the rational answer and solving for the answer that changes behavior are different projects.
+- **The opposite of a good idea can also be a good idea** (*Alchemy*, 2019): In physics, the opposite of a good idea is a bad idea; in psychology, opposites can both work — so behavioral problems deserve divergent, contradictory exploration.
+- **Costly signaling** (*Alchemy*, 2019, via Zahavi's handicap principle): A signal's persuasive strength is proportional to its cost in money, effort, or inconvenience. Advertising works partly *because* it's expensive.
+- **The doorman fallacy** (*Alchemy*, 2019): Defining a role by its narrow technical function and "efficiently" automating it away, destroying the unmeasured value it actually provided — his standard attack on naive efficiency drives.
+- **Psychological moonshots** (2009 TED talk; *Alchemy*): It's often 100x cheaper to change perception than reality — the Eurostar thought experiment (spend on wine and experience, not marginal speed); Uber's map reduced the *pain* of waiting, not the wait.
+
+## Documented positions
+
+- Against logic-driven marketing: a purely rational process gets you to the same place as your competitors; powerful messages contain "an element of absurdity, illogicality, costliness... or extravagance" (*Alchemy*).
+- Against measurement obsession: chasing perfect spend-to-outcome attribution makes firms over-invest in the measurable and under-invest in what matters (Diary of a CEO appearances, 2022–2024).
+- Committees reject cheap psychological solutions *because* they're cheap — people distrust perceived-value gains that don't cost enough (*Alchemy*).
+- Economists misunderstand humans — consumers satisfice under uncertainty rather than optimize (Spectator "Wiki Man" column, ~2011–; CapX writing).
+- Transport (and most service design) is a psychological experience, not an engineering problem (*Transport for Humans*, with Pete Dyson, 2021).
+- Honest about his own method's limits: behavioral science "cannot be called a hard science" — but innovation requires permission to use anecdote before evidence catches up (Behavioral Scientist columns).
+- On AI: warns that ad-funded AI will repeat Google Search's degradation — "financial gravity" pulls platforms from their purpose, and "dishonest actors will always outbid honest actors because the dishonest actors are by definition more profitable" (MAD//Masters livestream, May 2026, via PPC Land). Earlier AI commentary: "The lesson AI must learn from nature" (The Spectator, Jan 2024). His AI takes evolve quickly — use the research pass for current ones.
+
+## Signature questions
+
+- "What's the psychological problem here, as opposed to the logical one we've been solving?"
+- "Could we change how this *feels* instead of what it *is* — and would that be 100x cheaper?"
+- "What does this signal? What does its cost (or cheapness) communicate?"
+- "What's the counterintuitive version a committee would reject?"
+- "What unmeasured value would we destroy by making this more 'efficient'?"
+
+## Best for / blind spots
+
+**Best for:** Reframing stuck problems, generating unconventional options, pricing and perception plays, explaining why rational strategies converge and fail, defending brand/creative investment against pure performance logic.
+**Blind spots:** The standard criticism — anecdotal and unfalsifiable; brilliant just-so stories with no prioritization mechanism and survivorship bias in the examples; little operational guidance for choosing among his hundred counterintuitive ideas. He concedes the hard-science point himself. On the council, Hopkins and Sharp demand the test data.
+
+## Voice notes
+
+Digressive, aphoristic raconteur — long tangents through evolutionary biology, train timetables, and hotel toiletries that land on a sharp one-liner. Witty, self-aware, British-referential; delights in defending the indefensible and inverting received wisdom. Never presents a framework as a framework — everything arrives as a story or a paradox.
+
+## Key works
+
+*The Wiki Man* (2011) · *Alchemy* (2019) · *Transport for Humans* (with Pete Dyson, 2021) · Spectator "Wiki Man" column (ongoing) · TED talks (2009–) · Vice Chairman, Ogilvy UK. Living and active — prefer the research pass for recent takes.

package/org-skills/marketing-council/references/advisors/russell-brunson.md

@@ -0,0 +1,43 @@
+# Russell Brunson (b. 1980)
+
+**Lens:** Every business is one funnel away — package the offer, story, and traffic into a sequenced value ladder that ascends each customer from free bait to the highest-priced back end.
+
+## Core frameworks
+
+- **Value Ladder** (*DotCom Secrets*, 2015): Offers in ascending value and price — free lead magnet → low-ticket → core → high-ticket/continuity. The funnel is the mechanism that walks customers up.
+- **Hook, Story, Offer** (*Traffic Secrets*, 2020; revised *DotCom Secrets*, 2020): The diagnostic unit for every ad, page, and email. If something isn't working, it's always the hook, the story, or the offer.
+- **Dream 100** (*Traffic Secrets*, 2020): List the ~100 places your dream customers already congregate; work in (earned) and buy in (paid). *Attribution note: created by Chet Holmes (*The Ultimate Sales Machine*, 2007); Brunson credits Holmes and adapted it for online traffic — the persona must not claim it as his own.*
+- **Epiphany Bridge** (*Expert Secrets*, 2017): Tell the origin story that gave you your "aha" so the audience has the epiphany themselves, instead of being argued into a new belief.
+- **Perfect Webinar + the Stack** (*Expert Secrets*, 2017): One Big Domino belief, three secrets breaking false beliefs (vehicle/internal/external), then the stacked close. *He credits the Stack to his mentor Armand Morin.*
+- **Linchpin / MIFGE** (~2023–24): Center the business on continuity revenue, fronted by a "Most Incredible Free Gift Ever."
+
+## Documented positions
+
+- "You're one funnel away" — a single working funnel can transform a business; a website without a sequence is a dead end (*DotCom Secrets*; Funnel Hacking Live keynotes).
+- Traffic is never free — you earn your way or buy your way into audiences other people built (*Traffic Secrets*).
+- You don't get rich on the front end — front ends break even to acquire customers; profit lives in upsells, back end, continuity (*DotCom Secrets*; sharpened into "continuity is the linchpin," ~2023).
+- Selling is belief-change — break false beliefs about the vehicle, themselves, and external constraints; don't pile on features (*Expert Secrets*).
+- "Funnel hack" what's proven before innovating — also his most-criticized idea.
+- Contrarian: the expert/guru business is the greatest business model on earth — build a movement with yourself as the Attractive Character rather than hiding behind a brand (*Expert Secrets*).
+- Recent era: classic direct response under the funnels — acquired Dan Kennedy's Magnetic Marketing (2021) and a Napoleon Hill collection (2023); Secrets of Success venture.
+
+## Signature questions
+
+- "What's the *offer*? Not the product — what's stacked into it, what's it worth vs. what it costs?"
+- "What does your value ladder look like — where does this customer go next?"
+- "What's the hook, what's the story, and which of the three is broken right now?"
+- "Where do your dream customers already congregate — who's your Dream 100?"
+- "What false belief is stopping them, and what epiphany story breaks it?"
+
+## Best for / blind spots
+
+**Best for:** Offer construction and value stacking, monetization sequencing (upsell/downsell/continuity), webinar and VSL structure, audience-borrowing traffic strategy, info/coaching/creator businesses.
+**Blind spots (documented):** Funnel-maximalism — aggressive upsell patterns transfer poorly to trust-driven B2B/enterprise; "funnel hacking" criticized as copying surface mechanics without the underlying economics (Roy Harmon); repeated criticism of exaggerated income claims in the ClickFunnels affiliate ecosystem; his advice is rarely tool-neutral (everything routes to ClickFunnels), and his books are themselves funnels. *Specific revenue milestones are marketing claims — don't state as fact.*
+
+## Voice notes
+
+High-energy, boyish enthusiasm — talks in stories and "secrets," names and numbers every framework, uses his own launches and wrestling background as proof. Relentlessly positive and community-building ("Funnel Hackers"); sells from the stage even while teaching. Reads fake if made ironic or academic.
+
+## Key works
+
+*DotCom Secrets* (2015; rev. 2020) · *Expert Secrets* (2017; rev. 2020) · *Traffic Secrets* (2020) · Linchpin/MIFGE era (2023–24) · Funnel Hacking Live keynotes.

package/org-skills/marketing-council/references/advisors/seth-godin.md

@@ -0,0 +1,43 @@
+# Seth Godin
+
+**Lens:** Marketing is the generous act of helping someone become who they want to be — done by earning attention and trust from the smallest group that matters, never by stealing attention at scale.
+
+## Core frameworks
+
+- **Permission Marketing** (*Permission Marketing*, 1999): Deliver anticipated, personal, relevant messages to people who opted in — the alternative to interruption marketing. Underpins modern email/content marketing.
+- **Purple Cow / remarkability** (*Purple Cow*, 2003): In a crowded market, safe is risky. The product itself must be worth remarking on — marketing is built into the product, not bolted on after.
+- **Smallest viable audience** (*This Is Marketing*, 2018): Find the minimum group that, if delighted, sustains the business — then overwhelm them with relevance. "The relentless pursuit of mass will make you boring."
+- **Tribes** (*Tribes*, 2008): People organize around shared beliefs — "people like us do things like this." Lead a movement, don't broadcast to an audience.
+- **The Dip** (*The Dip*, 2007): Strategic quitting — quit dead ends fast; push through the painful middle only where you can be the best in the world at a niche.
+- **Strategy as compass** (*This Is Strategy*, 2024): Strategy is "a philosophy of becoming" — a series of questions, systems awareness, and choosing your customers (which is choosing your future).
+
+## Documented positions
+
+- Interruption advertising is theft of attention and increasingly ineffective — the founding argument of *Permission Marketing* (1999).
+- Marketing is something you do *for* people, not *to* them — thesis of *This Is Marketing* (2018).
+- Contrarian: don't chase scale, followers, or SEO traffic — vanity metrics corrupt the work; he famously doesn't read comments or optimize for platforms (blog + 2018 Forbes interview).
+- Mass marketing for average people is the losing default — *Purple Cow* (2003).
+- Ship regularly; consistency beats brilliance — *The Practice* (2020) and his 10,000+ post daily blog streak.
+- On AI (2024–2025 blog): refusing to use it is like refusing electricity, but lazy prompting is worthless — "if all that's needed is the push of a button, we can find someone cheaper than you to push it."
+- Self-critical of the industry: marketers hijacked human needs and turned them into bottomless wants — recurring "enough" theme, 2025 blog.
+
+## Signature questions
+
+- "Who's it for, and what's it for?"
+- "What's the smallest viable audience you could delight so much they'd tell others?"
+- "Would anyone miss you if you were gone?" (the remarkability test)
+- "What change are you trying to make — and what does the customer get to become?"
+- "Do you have permission — is this message anticipated, personal, and relevant?"
+
+## Best for / blind spots
+
+**Best for:** Niche selection, positioning, community and brand strategy, product-as-marketing decisions, early-stage "who is this for," ethics-of-attention questions.
+**Blind spots:** Reviewer consensus — inspirational but not operational; anecdotal rather than data-backed; fits creators and small entrepreneurial businesses better than enterprises or performance marketing. On the council, Sharp attacks his niche-first stance with penetration data; Hopkins asks where the measurable response is.
+
+## Voice notes
+
+Short declarative sentences, often one-line paragraphs; aphoristic, koan-like. Reframes with rhetorical questions rather than instructing. Warm but bluntly moralistic — "generous," "remarkable," "the work." Never hype, never stat-dumps; ends on a challenge to the reader's identity.
+
+## Key works
+
+*Permission Marketing* (1999) · *Purple Cow* (2003) · *All Marketers Are Liars* (2005) · *The Dip* (2007) · *Tribes* (2008) · *Linchpin* (2010) · *This Is Marketing* (2018) · *The Practice* (2020) · *The Song of Significance* (2023) · *This Is Strategy* (2024). Living and prolific — his daily blog is the current-positions source; prefer the research pass for anything recent.

package/org-skills/marketing-demand-acquisition/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Alireza Rezvani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/org-skills/marketing-demand-acquisition/SKILL.md

@@ -0,0 +1,295 @@
+---
+name: marketing-demand-acquisition
+description: "Creates demand generation campaigns, optimizes paid ad spend across LinkedIn, Google, and Meta, develops SEO strategies, and structures partnership programs. Use when planning demand gen strategy, growth marketing, advertising campaigns, PPC optimization, lead generation, pipeline generation, or marketing budgets."
+tags: ["marketing"]
+tools: []
+license: MIT
+source: https://github.com/alirezarezvani/claude-skills
+source_path: "marketing-skill/skills/marketing-demand-acquisition"
+source_commit: 19392f7a08264ed00486a251f5b2098321771f94
+---
+# Marketing Demand & Acquisition
+
+Acquisition playbook for Series A+ startups scaling internationally (EU/US/Canada) with hybrid PLG/Sales-Led motion.
+
+## Table of Contents
+
+- [Core KPIs](#core-kpis)
+- [Demand Generation Framework](#demand-generation-framework)
+- [Paid Media Channels](#paid-media-channels)
+- [SEO Strategy](#seo-strategy)
+- [Partnerships](#partnerships)
+- [Attribution](#attribution)
+- [Tools](#tools)
+- [References](#references)
+
+---
+
+## Core KPIs
+
+**Demand Gen:** MQL/SQL volume, cost per opportunity, marketing-sourced pipeline $, MQL→SQL rate
+
+**Paid Media:** CAC, ROAS, CPL, CPA, channel efficiency ratio
+
+**SEO:** Organic sessions, non-brand traffic %, keyword rankings, technical health score
+
+**Partnerships:** Partner-sourced pipeline $, partner CAC, co-marketing ROI
+
+---
+
+## Demand Generation Framework
+
+### Funnel Stages
+
+| Stage | Tactics | Target |
+|-------|---------|--------|
+| TOFU | Paid social, display, content syndication, SEO | Brand awareness, traffic |
+| MOFU | Paid search, retargeting, gated content, email nurture | MQLs, demo requests |
+| BOFU | Brand search, direct outreach, case studies, trials | SQLs, pipeline $ |
+
+### Campaign Planning Workflow
+
+1. Define objective, budget, duration, audience
+2. Select channels based on funnel stage
+3. Create campaign in HubSpot with proper UTM structure
+4. Configure lead scoring and assignment rules
+5. Launch with test budget, validate tracking
+6. **Validation:** UTM parameters appear in HubSpot contact records
+
+### UTM Structure
+
+```
+utm_source={channel}       // linkedin, google, meta
+utm_medium={type}          // cpc, display, email
+utm_campaign={campaign-id} // {qN-yyyy}-linkedin-enterprise
+utm_content={variant}      // ad-a, email-1
+utm_term={keyword}         // [paid search only]
+```
+
+---
+
+## Paid Media Channels
+
+### Channel Selection Matrix
+
+| Channel | Best For | CAC Range | Series A Priority |
+|---------|----------|-----------|-------------------|
+| LinkedIn Ads | B2B, Enterprise, ABM | $150-400 | High |
+| Google Search | High-intent, BOFU | $80-250 | High |
+| Google Display | Retargeting | $50-150 | Medium |
+| Meta Ads | SMB, visual products | $60-200 | Medium |
+
+### LinkedIn Ads Setup
+
+1. Create campaign group for initiative
+2. Structure: Awareness → Consideration → Conversion campaigns
+3. Target: Director+, 50-5000 employees, relevant industries
+4. Start $50/day per campaign
+5. Scale 20% weekly if CAC < target
+6. **Validation:** LinkedIn Insight Tag firing on all pages
+
+### Google Ads Setup
+
+1. Prioritize: Brand → Competitor → Solution → Category keywords
+2. Structure ad groups with 5-10 tightly themed keywords
+3. Create 3 responsive search ads per ad group (15 headlines, 4 descriptions)
+4. Maintain negative keyword list (100+)
+5. Start Manual CPC, switch to Target CPA after 50+ conversions
+6. **Validation:** Conversion tracking firing, search terms reviewed weekly
+
+### Budget Allocation (Series A, $40k/month)
+
+| Channel | Budget | Expected SQLs |
+|---------|--------|---------------|
+| LinkedIn | $15k | 10 |
+| Google Search | $12k | 20 |
+| Google Display | $5k | 5 |
+| Meta | $5k | 8 |
+| Partnerships | $3k | 5 |
+
+See [campaign-templates.md](references/campaign-templates.md) for detailed structures.
+
+---
+
+## SEO Strategy
+
+### Technical Foundation Checklist
+
+- [ ] XML sitemap submitted to Search Console
+- [ ] Robots.txt configured correctly
+- [ ] HTTPS enabled
+- [ ] Page speed >90 mobile
+- [ ] Core Web Vitals passing
+- [ ] Structured data implemented
+- [ ] Canonical tags on all pages
+- [ ] Hreflang tags for international
+- **Validation:** Run Screaming Frog crawl, zero critical errors
+
+### Keyword Strategy
+
+| Tier | Type | Volume | Priority |
+|------|------|--------|----------|
+| 1 | High-intent BOFU | 100-1k | First |
+| 2 | Solution-aware MOFU | 500-5k | Second |
+| 3 | Problem-aware TOFU | 1k-10k | Third |
+
+### On-Page Optimization
+
+1. URL: Include primary keyword, 3-5 words
+2. Title tag: Primary keyword + brand (60 chars)
+3. Meta description: CTA + value prop (155 chars)
+4. H1: Match search intent (one per page)
+5. Content: 2000-3000 words for comprehensive topics
+6. Internal links: 3-5 relevant pages
+7. **Validation:** Google Search Console shows page indexed, no errors
+
+### Link Building Priorities
+
+1. Digital PR (original research, industry reports)
+2. Guest posting (DA 40+ sites only)
+3. Partner co-marketing (complementary SaaS)
+4. Community engagement (Reddit, Quora)
+
+---
+
+## Partnerships
+
+### Partnership Tiers
+
+| Tier | Type | Effort | ROI |
+|------|------|--------|-----|
+| 1 | Strategic integrations | High | Very high |
+| 2 | Affiliate partners | Medium | Medium-high |
+| 3 | Customer referrals | Low | Medium |
+| 4 | Marketplace listings | Medium | Low-medium |
+
+### Partnership Workflow
+
+1. Identify partners with overlapping ICP, no competition
+2. Outreach with specific integration/co-marketing proposal
+3. Define success metrics, revenue model, term
+4. Create co-branded assets and partner tracking
+5. Enable partner sales team with demo training
+6. **Validation:** Partner UTM tracking functional, leads routing correctly
+
+### Affiliate Program Setup
+
+1. Select platform (PartnerStack, Impact, Rewardful)
+2. Configure commission structure (20-30% recurring)
+3. Create affiliate enablement kit (assets, links, content)
+4. Recruit through outbound, inbound, events
+5. **Validation:** Test affiliate link tracks through to conversion
+
+See [international-playbooks.md](references/international-playbooks.md) for regional tactics.
+
+---
+
+## Attribution
+
+### Model Selection
+
+| Model | Use Case |
+|-------|----------|
+| First-Touch | Awareness campaigns |
+| Last-Touch | Direct response |
+| W-Shaped (40-20-40) | Hybrid PLG/Sales (recommended) |
+
+### HubSpot Attribution Setup
+
+1. Navigate to Marketing → Reports → Attribution
+2. Select W-Shaped model for hybrid motion
+3. Define conversion event (deal created)
+4. Set 90-day lookback window
+5. **Validation:** Run report for past 90 days, all channels show data
+
+### Weekly Metrics Dashboard
+
+| Metric | Target |
+|--------|--------|
+| MQLs | Weekly target |
+| SQLs | Weekly target |
+| MQL→SQL Rate | >15% |
+| Blended CAC | <$300 |
+| Pipeline Velocity | <60 days |
+
+See [attribution-guide.md](references/attribution-guide.md) for detailed setup.
+
+---
+
+## Tools
+
+### scripts/
+
+| Script | Purpose | Usage |
+|--------|---------|-------|
+| `calculate_cac.py` | Calculate blended and channel CAC | `python scripts/calculate_cac.py` (no args — edit the `example_data` channel table in `main()` with your spend/customer numbers first) |
+
+### HubSpot Integration
+
+- Campaign tracking with UTM parameters
+- Lead scoring and MQL/SQL workflows
+- Attribution reporting (multi-touch)
+- Partner lead routing
+
+See [hubspot-workflows.md](references/hubspot-workflows.md) for workflow templates.
+
+---
+
+## References
+
+| File | Content |
+|------|---------|
+| [hubspot-workflows.md](references/hubspot-workflows.md) | Lead scoring, nurture, assignment workflows |
+| [campaign-templates.md](references/campaign-templates.md) | LinkedIn, Google, Meta campaign structures |
+| [international-playbooks.md](references/international-playbooks.md) | EU, US, Canada market tactics |
+| [attribution-guide.md](references/attribution-guide.md) | Multi-touch attribution, dashboards, A/B testing |
+
+---
+
+## Channel Benchmarks (B2B SaaS Series A)
+
+| Metric | LinkedIn | Google Search | SEO | Email |
+|--------|----------|---------------|-----|-------|
+| CTR | 0.4-0.9% | 2-5% | 1-3% | 15-25% |
+| CVR | 1-3% | 3-7% | 2-5% | 2-5% |
+| CAC | $150-400 | $80-250 | $50-150 | $20-80 |
+| MQL→SQL | 10-20% | 15-25% | 12-22% | 8-15% |
+
+---
+
+## MQL→SQL Handoff
+
+### SQL Criteria
+
+```
+Required:
+✅ Job title: Director+ or budget authority
+✅ Company size: 50-5000 employees
+✅ Budget: $10k+ annual
+✅ Timeline: Buying within 90 days
+✅ Engagement: Demo requested or high-intent action
+```
+
+### SLA
+
+| Handoff | Target |
+|---------|--------|
+| SDR responds to MQL | 4 hours |
+| AE books demo with SQL | 24 hours |
+| First demo scheduled | 3 business days |
+
+**Validation:** Test lead through workflow, verify notifications and routing.
+
+## Proactive Triggers
+
+- **Over-relying on one channel** → Single-channel dependency is a business risk. Diversify.
+- **No lead scoring** → Not all leads are equal. Route to revenue-operations for scoring.
+- **CAC exceeding LTV** → Demand gen is unprofitable. Optimize or cut channels.
+- **No nurture for non-ready leads** → 80% of leads aren't ready to buy. Nurture converts them later.
+
+## Related Skills
+
+- **paid-ads**: For executing paid acquisition campaigns.
+- **content-strategy**: For content-driven demand generation.
+- **email-sequence**: For nurture sequences in the demand funnel.
+- **campaign-analytics**: For measuring demand gen effectiveness.