@tidyfactor/marketing 1.3.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/.tidyfactor +53 -52
  2. package/CHANGELOG.md +47 -0
  3. package/README.ar.md +20 -9
  4. package/README.md +20 -9
  5. package/SKILL.md +46 -30
  6. package/bin/add-skill.js +65 -50
  7. package/brand.json +67 -67
  8. package/brand.yaml +55 -0
  9. package/manifest.json +256 -0
  10. package/package.json +5 -1
  11. package/references/commands/audit.md +34 -0
  12. package/references/commands/brief.md +7 -5
  13. package/references/memory/20-brain-baas-integration.md +89 -0
  14. package/references/memory/ad-copy-templates.md +94 -93
  15. package/references/memory/arabic-writing.md +1 -1
  16. package/references/memory/campaign-mindmap.md +85 -0
  17. package/references/memory/decision-points.md +74 -73
  18. package/references/memory/frameworks.md +87 -86
  19. package/references/memory/lifecycle-flows.md +107 -106
  20. package/references/memory/metrics-benchmarks.md +71 -70
  21. package/references/memory/naming-conventions.md +75 -0
  22. package/references/memory/philosophy.md +2 -0
  23. package/references/memory/platform-specs.md +76 -75
  24. package/references/memory/promotions-math.md +57 -56
  25. package/references/memory/quality-bar.md +56 -55
  26. package/references/workflows/brief.md +74 -35
  27. package/references/workflows/campaign-launch.md +1 -1
  28. package/references/workflows/content-engine.md +1 -1
  29. package/references/workflows/email-lifecycle.md +1 -1
  30. package/references/workflows/paid-acquisition.md +1 -1
  31. package/references/workflows/promo-conversion.md +1 -1
  32. package/references/workflows/social-growth.md +1 -1
  33. package/references/workflows/viral-retention.md +1 -1
  34. package/scripts/audit_copy.py +112 -0
  35. package/scripts/calc_promo_math.py +69 -0
  36. package/scripts/clean_orphaned_assets.py +108 -0
  37. package/tests/scenarios.md +87 -0
  38. package/tools/build-skill.js +4 -0
  39. package/tools/validate_skill.py +265 -112
  40. package/assets/og-default.png +0 -0
@@ -0,0 +1,75 @@
1
+ <!-- last-verified: 2026-09-09 -->
2
+ # Memory: naming-conventions
3
+
4
+ Standardized naming taxonomy for campaigns, ad groups, UTM tracking parameters, email tags, and marketing assets across the TidyFactor ecosystem.
5
+
6
+ ---
7
+
8
+ ## 1. Universal Campaign Naming Taxonomy
9
+
10
+ Every paid and organic campaign must follow the deterministic 5-token kebab-case structure:
11
+
12
+ ```text
13
+ [GEO]_[OBJECTIVE]_[AUDIENCE]_[OFFER]_[LAUNCH-DATE]
14
+ ```
15
+
16
+ ### Token Definitions
17
+
18
+ | Token | Accepted Values | Examples |
19
+ |---|---|---|
20
+ | `GEO` | Regional or country code | `gcc`, `ksa`, `uae`, `eg`, `global` |
21
+ | `OBJECTIVE` | Campaign funnel intent | `tof` (Awareness/Traffic), `mof` (Lead/Consideration), `bof` (Purchase/Conversion), `ret` (Retargeting) |
22
+ | `AUDIENCE` | Targeting cluster | `broad`, `lal1-buyers`, `interest-marketing`, `b2b-founders`, `cart-abandoners` |
23
+ | `OFFER` | Vehicle or angle descriptor | `flashsale-20`, `free-audit`, `demo-trial`, `starter-bundle` |
24
+ | `LAUNCH-DATE` | ISO year-month | `2026-09`, `2026-10` |
25
+
26
+ ### Concrete Examples
27
+ - `ksa_bof_lal1-buyers_flashsale-20_2026-09`
28
+ - `eg_tof_interest-marketing_free-audit_2026-09`
29
+ - `global_mof_b2b-founders_demo-trial_2026-09`
30
+
31
+ ---
32
+
33
+ ## 2. Standardized UTM Parameter Rules
34
+
35
+ All outbound marketing URLs must include standardized, lowercase, alphanumeric UTM tags:
36
+
37
+ | Parameter | Construction Rule | Example |
38
+ |---|---|---|
39
+ | `utm_source` | Platform identifier (lowercase) | `meta`, `google`, `linkedin`, `tiktok`, `email`, `x` |
40
+ | `utm_medium` | Channel type | `cpc`, `cpm`, `social-organic`, `newsletter`, `lifecycle` |
41
+ | `utm_campaign` | Exact canonical campaign name | `ksa_bof_lal1-buyers_flashsale-20_2026-09` |
42
+ | `utm_term` | Target keyword or search intent (paid search only) | `saas-marketing-automation` |
43
+ | `utm_content` | Creative variant / angle descriptor | `angle1-pain-video-01`, `angle2-roi-carousel-02` |
44
+
45
+ ### Validation Rule
46
+ - **Lowercase Only**: Never use uppercase or spaces in UTM parameters (`utm_source=Meta` ❌ → `utm_source=meta` ✔️).
47
+ - **Hyphen Separation**: Separate words with hyphens (`-`), never underscores or `%20` within values.
48
+
49
+ ---
50
+
51
+ ## 3. Creative & Ad Asset Naming
52
+
53
+ Every creative file, video, or banner asset must be named deterministically:
54
+
55
+ ```text
56
+ [ASPECT-RATIO]_[ANGLE]_[FORMAT]_[HOOK-ID]
57
+ ```
58
+
59
+ - **Ratios**: `9x16` (Reels/TikTok/Stories), `1x1` (Feed Square), `16x9` (YouTube/Landscape).
60
+ - **Angles**: `pain` (Problem-agitate), `roi` (Logic/numbers), `proof` (Social proof/case study).
61
+ - **Formats**: `video`, `statichigh`, `carousel`, `ugc`.
62
+ - **Examples**:
63
+ - `9x16_pain_ugc_hook01-frustration.mp4`
64
+ - `1x1_roi_statichigh_hook03-benchmark.png`
65
+ - `9x16_proof_video_hook02-beforeafter.mp4`
66
+
67
+ ---
68
+
69
+ ## 4. Email Tagging & Segment Naming
70
+
71
+ For CRM and email automation engines (Klaviyo, Mailchimp, Loops, Supabase):
72
+
73
+ - **Lifecycle Flows**: `flow_[stage]_[name]` (e.g., `flow_tof_welcome-series`, `flow_bof_cart-recovery-3step`).
74
+ - **One-off Broadcasts**: `camp_[YYYY-MM-DD]_[subject-slug]` (e.g., `camp_2026-09-15_flash-sale-announcement`).
75
+ - **User State Tags**: `status:[active|churned|vip|at-risk]`, `market:[gcc|eg|global]`.
@@ -1,5 +1,7 @@
1
+ <!-- last-verified: 2026-09-09 -->
1
2
  # Marketing Philosophy: Audience-First Growth & Direct Response Principles
2
3
 
4
+
3
5
  *(Note: Human-facing document. Never referenced by operational commands or execution agents).*
4
6
 
5
7
  ---
@@ -1,75 +1,76 @@
1
- # Marketing Memory: Platform Specs, MENA Regional Intelligence & CRO
2
-
3
- Operational parameters for Global Social Platforms, Country-by-Country MENA Market Intelligence, Regional Payment Infrastructure, and 7-Dimension CRO Audits.
4
-
5
- ---
6
-
7
- ## 1. MENA Per-Country Market & Platform Intelligence
8
-
9
- | Country | #1 Platforms (Priority Order) | Key Regional Payment Infrastructure | Trust & Cultural Factors |
10
- |---|---|---|---|
11
- | 🇸🇦 **Saudi Arabia (KSA)** | Snapchat → X (Twitter) → TikTok → Instagram → YouTube | **Mada**, **Tamara**, **Tabby**, Apple Pay, STC Pay | High purchasing power, mobile-first, video/visual dominant, local Riyadh/Jeddah dialtone or Modern Arabic. |
12
- | 🇦🇪 **United Arab Emirates (UAE)** | InstagramLinkedIn (B2B) → TikTok → YouTubeMeta | **Apple Pay**, Stripe, Tabby, Tamara | Highly international expat & local mix, dual English/Arabic mandatory, premium aesthetic expectation. |
13
- | 🇪🇬 **Egypt** | Facebook (Meta) → WhatsApp → YouTube → TikTok → Instagram | **InstaPay**, **Fawry**, Vodafone Cash, Meeza, ValU | Facebook dominates both B2C and B2B, WhatsApp for sales closing, value/ROI conscious, high volume. |
14
- | 🇰🇼 **Kuwait** | InstagramSnapchat → TikTok → WhatsApp | **KNET**, Apple Pay, Tamara, Tabby | Exceptionally high AOV, heavy Instagram shopping/DM orders, personal concierge support culture. |
15
- | 🇶🇦 **Qatar** | Instagram → Snapchat → TikTok → X | **NAPS**, Apple Pay, Debit Cards | High luxury and status affinity, government & corporate B2B focus. |
16
- | 🇯🇴 **Jordan** | FacebookInstagramWhatsAppTikTok | **CliQ**, Zain Cash, Orange Money, Credit Cards | Strong tech/freelancer hub, price-sensitive, peer recommendation driven. |
17
- | 🇲🇦 **Morocco** | Facebook → Instagram → TikTokWhatsApp | **CMI**, Cash on Delivery (COD), Orange Money | French/Arabic/Darija linguistic sensitivity, high COD prevalence in e-commerce. |
18
-
19
- ---
20
-
21
- ## 2. 7-Dimension CRO (Conversion Rate Optimization) Audit Framework
22
-
23
- Analyze any landing page or checkout in order of impact:
24
-
25
- ```
26
- 1. Value Proposition Clarity (The 5-Second Test)
27
- - Can a cold visitor understand what this is and why they should care in < 5 seconds?
28
- - Is the primary benefit specific, quantified, and differentiated?
29
-
30
- 2. Headline & Hero Effectiveness
31
- - Outcome-focused: "Get [Outcome] without [Pain Point]"
32
- - Matches the exact message and keywords of the referring ad or search query.
33
-
34
- 3. CTA Hierarchy & Placement
35
- - Single clear primary action above the fold.
36
- - Low-friction copy ("Start Free 14-Day Trial", not "Submit" or "Buy Now").
37
-
38
- 4. Friction & Cognitive Load
39
- - Multi-step forms with progress bars for complex signups.
40
- - Zero surprise shipping or hidden fees at checkout.
41
-
42
- 5. Social Proof Stacking
43
- - Customer logos, verifiable metric callouts, video testimonials, and Trustpilot/G2 badges.
44
-
45
- 6. Risk Reversal & Guarantees
46
- - Explicit money-back guarantee, 24/7 localized support, SSL/Security certifications.
47
-
48
- 7. Mobile Usability & Speed
49
- - Page load time < 2.5s (Core Web Vitals).
50
- - 1-click mobile checkout enabled (Apple Pay, Mada, InstaPay).
51
- ```
52
-
53
- ---
54
-
55
- ## 3. Global Social Algorithmic Signals
56
-
57
- | Platform | Primary Ranking Signals | Winning Content Format | Optimal Posting Cadence |
58
- |---|---|---|---|
59
- | **Instagram** | Sends/DMs (Weight: 10), Saves (Weight: 8), Comments, Watch Time (> 80%) | Reels (9:16, 7-30s), Carousels (8-10 slides), Daily Stories | 3-5 Reels/wk, 2 Carousels/wk, 4-8 Stories/day |
60
- | **TikTok** | 100% Video Completion Rate, Rewatches, Shares, Comment Velocity | Short-form video (9:16, 15-45s) with spoken + text hooks | 1-2 videos/day (consistency > volume) |
61
- | **LinkedIn** | Dwell time, thoughtful comments (> 15 words), PDF document carousels | Document Slides (PDF), Text + Image teardowns, 1:1 Video | 3-5 posts/wk (morning business hours) |
62
- | **YouTube Shorts**| Viewed vs. Swiped away ratio (> 75%), Average Percentage Viewed (> 100%) | Vertical Shorts (9:16, 20-50s) with seamless audio looping | 3-7 Shorts/wk |
63
- | **X (Twitter)** | Bookmarks, Retweets/Quotes, Replies, Verified user interactions | Long-form articles/threads with visual diagrams | 2-4 posts/day |
64
-
65
- ---
66
-
67
- ## 4. The 3-Tier Hashtag Distribution Rule
68
-
69
- ```
70
- Total Hashtags: 5 to 10 targeted tags (Never use 30 spam tags).
71
-
72
- ├── Tier 1: Broad Category (1-2 tags) -> 500k - 2M posts (e.g. #SaudiBusiness #SaaSGrowth)
73
- ├── Tier 2: Niche Community (3-5 tags) -> 50k - 500k posts (e.g. #NextjsDevelopers #MENAEcommerce)
74
- └── Tier 3: Micro / Branded (2-3 tags) -> 1k - 50k posts (e.g. #TidyFactorEngine #RiyadhStartups)
75
- ```
1
+ <!-- last-verified: 2026-09-02 -->
2
+ # Marketing Memory: Platform Specs, MENA Regional Intelligence & CRO
3
+
4
+ Operational parameters for Global Social Platforms, Country-by-Country MENA Market Intelligence, Regional Payment Infrastructure, and 7-Dimension CRO Audits.
5
+
6
+ ---
7
+
8
+ ## 1. MENA Per-Country Market & Platform Intelligence
9
+
10
+ | Country | #1 Platforms (Priority Order) | Key Regional Payment Infrastructure | Trust & Cultural Factors |
11
+ |---|---|---|---|
12
+ | 🇸🇦 **Saudi Arabia (KSA)** | SnapchatX (Twitter) → TikTok → InstagramYouTube | **Mada**, **Tamara**, **Tabby**, Apple Pay, STC Pay | High purchasing power, mobile-first, video/visual dominant, local Riyadh/Jeddah dialtone or Modern Arabic. |
13
+ | 🇦🇪 **United Arab Emirates (UAE)** | Instagram → LinkedIn (B2B) → TikTok → YouTube → Meta | **Apple Pay**, Stripe, Tabby, Tamara | Highly international expat & local mix, dual English/Arabic mandatory, premium aesthetic expectation. |
14
+ | 🇪🇬 **Egypt** | Facebook (Meta) WhatsAppYouTube → TikTok → Instagram | **InstaPay**, **Fawry**, Vodafone Cash, Meeza, ValU | Facebook dominates both B2C and B2B, WhatsApp for sales closing, value/ROI conscious, high volume. |
15
+ | 🇰🇼 **Kuwait** | Instagram → Snapchat → TikTok → WhatsApp | **KNET**, Apple Pay, Tamara, Tabby | Exceptionally high AOV, heavy Instagram shopping/DM orders, personal concierge support culture. |
16
+ | 🇶🇦 **Qatar** | InstagramSnapchatTikTokX | **NAPS**, Apple Pay, Debit Cards | High luxury and status affinity, government & corporate B2B focus. |
17
+ | 🇯🇴 **Jordan** | Facebook → Instagram → WhatsAppTikTok | **CliQ**, Zain Cash, Orange Money, Credit Cards | Strong tech/freelancer hub, price-sensitive, peer recommendation driven. |
18
+ | 🇲🇦 **Morocco** | Facebook → Instagram → TikTok → WhatsApp | **CMI**, Cash on Delivery (COD), Orange Money | French/Arabic/Darija linguistic sensitivity, high COD prevalence in e-commerce. |
19
+
20
+ ---
21
+
22
+ ## 2. 7-Dimension CRO (Conversion Rate Optimization) Audit Framework
23
+
24
+ Analyze any landing page or checkout in order of impact:
25
+
26
+ ```
27
+ 1. Value Proposition Clarity (The 5-Second Test)
28
+ - Can a cold visitor understand what this is and why they should care in < 5 seconds?
29
+ - Is the primary benefit specific, quantified, and differentiated?
30
+
31
+ 2. Headline & Hero Effectiveness
32
+ - Outcome-focused: "Get [Outcome] without [Pain Point]"
33
+ - Matches the exact message and keywords of the referring ad or search query.
34
+
35
+ 3. CTA Hierarchy & Placement
36
+ - Single clear primary action above the fold.
37
+ - Low-friction copy ("Start Free 14-Day Trial", not "Submit" or "Buy Now").
38
+
39
+ 4. Friction & Cognitive Load
40
+ - Multi-step forms with progress bars for complex signups.
41
+ - Zero surprise shipping or hidden fees at checkout.
42
+
43
+ 5. Social Proof Stacking
44
+ - Customer logos, verifiable metric callouts, video testimonials, and Trustpilot/G2 badges.
45
+
46
+ 6. Risk Reversal & Guarantees
47
+ - Explicit money-back guarantee, 24/7 localized support, SSL/Security certifications.
48
+
49
+ 7. Mobile Usability & Speed
50
+ - Page load time < 2.5s (Core Web Vitals).
51
+ - 1-click mobile checkout enabled (Apple Pay, Mada, InstaPay).
52
+ ```
53
+
54
+ ---
55
+
56
+ ## 3. Global Social Algorithmic Signals
57
+
58
+ | Platform | Primary Ranking Signals | Winning Content Format | Optimal Posting Cadence |
59
+ |---|---|---|---|
60
+ | **Instagram** | Sends/DMs (Weight: 10), Saves (Weight: 8), Comments, Watch Time (> 80%) | Reels (9:16, 7-30s), Carousels (8-10 slides), Daily Stories | 3-5 Reels/wk, 2 Carousels/wk, 4-8 Stories/day |
61
+ | **TikTok** | 100% Video Completion Rate, Rewatches, Shares, Comment Velocity | Short-form video (9:16, 15-45s) with spoken + text hooks | 1-2 videos/day (consistency > volume) |
62
+ | **LinkedIn** | Dwell time, thoughtful comments (> 15 words), PDF document carousels | Document Slides (PDF), Text + Image teardowns, 1:1 Video | 3-5 posts/wk (morning business hours) |
63
+ | **YouTube Shorts**| Viewed vs. Swiped away ratio (> 75%), Average Percentage Viewed (> 100%) | Vertical Shorts (9:16, 20-50s) with seamless audio looping | 3-7 Shorts/wk |
64
+ | **X (Twitter)** | Bookmarks, Retweets/Quotes, Replies, Verified user interactions | Long-form articles/threads with visual diagrams | 2-4 posts/day |
65
+
66
+ ---
67
+
68
+ ## 4. The 3-Tier Hashtag Distribution Rule
69
+
70
+ ```
71
+ Total Hashtags: 5 to 10 targeted tags (Never use 30 spam tags).
72
+
73
+ ├── Tier 1: Broad Category (1-2 tags) -> 500k - 2M posts (e.g. #SaudiBusiness #SaaSGrowth)
74
+ ├── Tier 2: Niche Community (3-5 tags) -> 50k - 500k posts (e.g. #NextjsDevelopers #MENAEcommerce)
75
+ └── Tier 3: Micro / Branded (2-3 tags) -> 1k - 50k posts (e.g. #TidyFactorEngine #RiyadhStartups)
76
+ ```
@@ -1,56 +1,57 @@
1
- # Marketing Memory: Promotions Math, Discounts & Margin Safeguards
2
-
3
- Operational financial models to engineer high-converting promotions, sales, and contests without destroying profit margins.
4
-
5
- ---
6
-
7
- ## 1. Margin & Discount Impact Matrix
8
-
9
- A common marketing failure is discounting without understanding gross margin erosion.
10
-
11
- ### The Margin Erosion Equation:
12
- ```
13
- Required Sales Volume Increase to Maintain Same Profit:
14
- Volume Increase % = (Discount %) / (Gross Margin % - Discount %) * 100
15
- ```
16
-
17
- ### Table: Extra Sales Required When Offering Discounts
18
-
19
- | Your Product Gross Margin | 10% Discount | 20% Discount | 30% Discount | 40% Discount |
20
- |---|---|---|---|---|
21
- | **70% Gross Margin** (Software/Info) | +16.7% sales | +40.0% sales | +75.0% sales | +133.3% sales |
22
- | **50% Gross Margin** (Typical E-comm) | +25.0% sales | +66.7% sales | +150.0% sales | +400.0% sales |
23
- | **30% Gross Margin** (Low Margin Retail) | +50.0% sales | +200.0% sales | ⚠️ 0 Profit | Net Loss |
24
-
25
- ---
26
-
27
- ## 2. Margin-Safe Promotion Architectures
28
-
29
- ### Model A: Threshold-Based Tiered Discounts (AOV Expansion)
30
- Instead of a flat 20% sitewide discount, structure tiers above current Average Order Value (AOV):
31
- - **Current AOV = $60**:
32
- - *Tier 1*: Spend $75, Get $10 Off (~13% discount, forces +25% basket size).
33
- - *Tier 2*: Spend $120, Get $20 Off (~16% discount, forces 2x basket size).
34
- - *Tier 3*: Spend $180, Get $35 Off + Free Gift (~19% discount, forces 3x basket size).
35
-
36
- ### Model B: Buy X, Get Free Bonus (Value Stacking vs Price Cutting)
37
- Giving a digital bonus or low-cost physical accessory preserves price integrity while providing higher perceived value than a flat discount.
38
- - *Example*: "Buy the Core Course ($197), Get 3 Live Q&A Sessions + Template Pack Free ($297 Value)" vs "$50 Off".
39
-
40
- ### Model C: Flash Sale Scarcity Matrix (72-Hour Window)
41
- - **Hour 0 - 24**: Early Bird VIP Access (Deepest incentive or exclusive bundle bonus).
42
- - **Hour 24 - 48**: Mid-Sale Momentum & Social Proof (Customer testimonials, stock ticker updates).
43
- - **Hour 48 - 72**: Final Countdown / Hard Deadline (Urgency, countdown clock, cart expiration).
44
-
45
- ---
46
-
47
- ## 3. Giveaway / Contest ROI Architecture
48
-
49
- To prevent "Freebie Seekers" who never buy:
50
- 1. **Prize Selection Rule**: The prize MUST ONLY be desirable to your exact dream customer.
51
- - *Bad*: Win an iPhone 16 / $500 Cash (attracts anyone and destroys email list quality).
52
- - *Good*: Win 1 Year of [Your SaaS] + 1-on-1 Onboarding / $500 Store Shopping Spree.
53
- 2. **Viral Entry Mechanics**:
54
- - Primary Entry: Verified Email Opt-in (1 entry).
55
- - Bonus Actions: Share unique referral link with 3 friends (+5 entries per verified referral).
56
- - Consolation Offer: Every non-winner receives a personalized 48-hour voucher on the day winners are announced (recovers 8-15% conversion on participants).
1
+ <!-- last-verified: 2026-09-02 -->
2
+ # Marketing Memory: Promotions Math, Discounts & Margin Safeguards
3
+
4
+ Operational financial models to engineer high-converting promotions, sales, and contests without destroying profit margins.
5
+
6
+ ---
7
+
8
+ ## 1. Margin & Discount Impact Matrix
9
+
10
+ A common marketing failure is discounting without understanding gross margin erosion.
11
+
12
+ ### The Margin Erosion Equation:
13
+ ```
14
+ Required Sales Volume Increase to Maintain Same Profit:
15
+ Volume Increase % = (Discount %) / (Gross Margin % - Discount %) * 100
16
+ ```
17
+
18
+ ### Table: Extra Sales Required When Offering Discounts
19
+
20
+ | Your Product Gross Margin | 10% Discount | 20% Discount | 30% Discount | 40% Discount |
21
+ |---|---|---|---|---|
22
+ | **70% Gross Margin** (Software/Info) | +16.7% sales | +40.0% sales | +75.0% sales | +133.3% sales |
23
+ | **50% Gross Margin** (Typical E-comm) | +25.0% sales | +66.7% sales | +150.0% sales | +400.0% sales |
24
+ | **30% Gross Margin** (Low Margin Retail) | +50.0% sales | +200.0% sales | ⚠️ 0 Profit | ⛔ Net Loss |
25
+
26
+ ---
27
+
28
+ ## 2. Margin-Safe Promotion Architectures
29
+
30
+ ### Model A: Threshold-Based Tiered Discounts (AOV Expansion)
31
+ Instead of a flat 20% sitewide discount, structure tiers above current Average Order Value (AOV):
32
+ - **Current AOV = $60**:
33
+ - *Tier 1*: Spend $75, Get $10 Off (~13% discount, forces +25% basket size).
34
+ - *Tier 2*: Spend $120, Get $20 Off (~16% discount, forces 2x basket size).
35
+ - *Tier 3*: Spend $180, Get $35 Off + Free Gift (~19% discount, forces 3x basket size).
36
+
37
+ ### Model B: Buy X, Get Free Bonus (Value Stacking vs Price Cutting)
38
+ Giving a digital bonus or low-cost physical accessory preserves price integrity while providing higher perceived value than a flat discount.
39
+ - *Example*: "Buy the Core Course ($197), Get 3 Live Q&A Sessions + Template Pack Free ($297 Value)" vs "$50 Off".
40
+
41
+ ### Model C: Flash Sale Scarcity Matrix (72-Hour Window)
42
+ - **Hour 0 - 24**: Early Bird VIP Access (Deepest incentive or exclusive bundle bonus).
43
+ - **Hour 24 - 48**: Mid-Sale Momentum & Social Proof (Customer testimonials, stock ticker updates).
44
+ - **Hour 48 - 72**: Final Countdown / Hard Deadline (Urgency, countdown clock, cart expiration).
45
+
46
+ ---
47
+
48
+ ## 3. Giveaway / Contest ROI Architecture
49
+
50
+ To prevent "Freebie Seekers" who never buy:
51
+ 1. **Prize Selection Rule**: The prize MUST ONLY be desirable to your exact dream customer.
52
+ - *Bad*: Win an iPhone 16 / $500 Cash (attracts anyone and destroys email list quality).
53
+ - *Good*: Win 1 Year of [Your SaaS] + 1-on-1 Onboarding / $500 Store Shopping Spree.
54
+ 2. **Viral Entry Mechanics**:
55
+ - Primary Entry: Verified Email Opt-in (1 entry).
56
+ - Bonus Actions: Share unique referral link with 3 friends (+5 entries per verified referral).
57
+ - Consolation Offer: Every non-winner receives a personalized 48-hour voucher on the day winners are announced (recovers 8-15% conversion on participants).
@@ -1,55 +1,56 @@
1
- # Marketing Quality Bar & 7-Axis Pre-Emit Self-Critique
2
-
3
- > **Purpose**: Enforces strict anti-slop marketing standards, conversion mechanics, and regional calibration across all copywriting, ads, emails, and campaign strategies.
4
-
5
- ---
6
-
7
- ## 🛡️ The 7-Axis Pre-Emit Self-Critique (`P/H/E/S/R/V/D`)
8
-
9
- Before emitting any campaign plan, ad copy, email sequence, or landing page copy, the agent MUST self-evaluate against 7 core dimensions (rated 1 to 5, minimum 4 required across all axes):
10
-
11
- ```markdown
12
- /* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
13
- ```
14
-
15
- | Axis | Dimension | Evaluation Criteria |
16
- |:---:|:---|:---|
17
- | **P** | **Pain / Desire Specificity** | Identifies acute, tangible customer pain or quantifiable aspiration. Zero generic filler ("grow your business", "reach your goals"). |
18
- | **H** | **Hook & Headline Power** | Scroll-stopping 3-second hook utilizing curiosity gap, contrarian insight, or compelling numerical anchor. |
19
- | **E** | **Execution Completeness** | Delivers complete funnel assets (Subject Lines, Body Copy, CTA, Micro-copy, Risk Reversal, Social Proof anchors). |
20
- | **S** | **Stage & Market Fit** | Calibrated to user sophistication (Schwartz 5 Stages) and native regional market vernacular (GCC, Egypt, Global). |
21
- | **R** | **Restraint & Margin Protection** | Protects brand equity and unit gross margins; avoids destructive discount spirals and false manufactured scarcity. |
22
- | **V** | **Voice & Anti-Slop Authenticity** | High-energy conversational flow free from AI clichés ("In today's fast-paced world", "Unlock your potential", "Game-changer"). |
23
- | **D** | **Decision Alignment** | 100% compliant with the confirmed `.tidyfactor/marketing-brief.md` baseline (Market, Tone, Offer, Scope). |
24
-
25
- ---
26
-
27
- ## 🚫 AI Slop & Cliché Banned Dictionary
28
-
29
- The following phrases and generic filler patterns are **STRICTLY PROHIBITED** in all generated marketing copy:
30
-
31
- | Banned AI Slop | Why It Fails | Approved High-Conversion Alternative |
32
- |:---|:---|:---|
33
- | *"In today's fast-paced digital world..."* | Empty fluff, zero information density | Jump straight into the villain/symptom: *"Most founders spend 14 hours a week..."* |
34
- | *"Unlock your full potential..."* | Vague, untestable corporate slogan | Specific outcome: *"Double your qualified demo bookings without increasing ad spend"* |
35
- | *"Game-changer / Revolutionize / Next-level"* | Hyperbolic buzzword blindness | Concrete mechanism: *"Replaces 4 disjointed SaaS tools with 1 automated pipeline"* |
36
- | *"Look no further..."* | Lazy infomercial cliché | Proof-driven hook: *"Here is the exact 3-step breakdown 84 enterprise teams use..."* |
37
- | *"We are passionate about providing..."* | Self-centered brand ego | Customer-centric benefit: *"Get your first campaign live in under 12 minutes"* |
38
-
39
- ---
40
-
41
- ## 🌍 Regional Market Intelligence (MENA & Global)
42
-
43
- ### 1. Gulf / GCC (Saudi Arabia 🇸🇦, UAE 🇦🇪, Kuwait 🇰🇼, Qatar 🇶🇦)
44
- - **Tone**: Prestige, modern luxury, ambition, respect, and tribal/community trust.
45
- - **Conversion Channels**: WhatsApp direct routing, Apple Pay, Mada / Tabby / Tamara installment framing.
46
- - **Copy Idiom**: Modern polished Arabic (فصحى راقية ومقنعة) with natural Gulf business terminology.
47
-
48
- ### 2. Egypt & Levant (Egypt 🇪🇬, Jordan 🇯🇴)
49
- - **Tone**: High-energy, practical ROI, relatable wit, clear value-for-money justification.
50
- - **Conversion Channels**: Cash on Delivery (COD), Fawry / InstaPay, direct phone/WhatsApp confirmation.
51
- - **Copy Idiom**: Clear, engaging Egyptian/Levantine Arabic blending professionalism with warmth.
52
-
53
- ### 3. Global / B2B SaaS (US / Europe)
54
- - **Tone**: Direct, concise, metric-dense, self-serve focused.
55
- - **Conversion Channels**: Stripe, frictionless freemium / instant calendar booking.
1
+ <!-- last-verified: 2026-09-02 -->
2
+ # Marketing Quality Bar & 7-Axis Pre-Emit Self-Critique
3
+
4
+ > **Purpose**: Enforces strict anti-slop marketing standards, conversion mechanics, and regional calibration across all copywriting, ads, emails, and campaign strategies.
5
+
6
+ ---
7
+
8
+ ## 🛡️ The 7-Axis Pre-Emit Self-Critique (`P/H/E/S/R/V/D`)
9
+
10
+ Before emitting any campaign plan, ad copy, email sequence, or landing page copy, the agent MUST self-evaluate against 7 core dimensions (rated 1 to 5, minimum 4 required across all axes):
11
+
12
+ ```markdown
13
+ /* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
14
+ ```
15
+
16
+ | Axis | Dimension | Evaluation Criteria |
17
+ |:---:|:---|:---|
18
+ | **P** | **Pain / Desire Specificity** | Identifies acute, tangible customer pain or quantifiable aspiration. Zero generic filler ("grow your business", "reach your goals"). |
19
+ | **H** | **Hook & Headline Power** | Scroll-stopping 3-second hook utilizing curiosity gap, contrarian insight, or compelling numerical anchor. |
20
+ | **E** | **Execution Completeness** | Delivers complete funnel assets (Subject Lines, Body Copy, CTA, Micro-copy, Risk Reversal, Social Proof anchors). |
21
+ | **S** | **Stage & Market Fit** | Calibrated to user sophistication (Schwartz 5 Stages) and native regional market vernacular (GCC, Egypt, Global). |
22
+ | **R** | **Restraint & Margin Protection** | Protects brand equity and unit gross margins; avoids destructive discount spirals and false manufactured scarcity. |
23
+ | **V** | **Voice & Anti-Slop Authenticity** | High-energy conversational flow free from AI clichés ("In today's fast-paced world", "Unlock your potential", "Game-changer"). |
24
+ | **D** | **Decision Alignment** | 100% compliant with the confirmed `.tidyfactor/marketing-brief.md` baseline (Market, Tone, Offer, Scope). |
25
+
26
+ ---
27
+
28
+ ## 🚫 AI Slop & Cliché Banned Dictionary
29
+
30
+ The following phrases and generic filler patterns are **STRICTLY PROHIBITED** in all generated marketing copy:
31
+
32
+ | Banned AI Slop | Why It Fails | Approved High-Conversion Alternative |
33
+ |:---|:---|:---|
34
+ | *"In today's fast-paced digital world..."* | Empty fluff, zero information density | Jump straight into the villain/symptom: *"Most founders spend 14 hours a week..."* |
35
+ | *"Unlock your full potential..."* | Vague, untestable corporate slogan | Specific outcome: *"Double your qualified demo bookings without increasing ad spend"* |
36
+ | *"Game-changer / Revolutionize / Next-level"* | Hyperbolic buzzword blindness | Concrete mechanism: *"Replaces 4 disjointed SaaS tools with 1 automated pipeline"* |
37
+ | *"Look no further..."* | Lazy infomercial cliché | Proof-driven hook: *"Here is the exact 3-step breakdown 84 enterprise teams use..."* |
38
+ | *"We are passionate about providing..."* | Self-centered brand ego | Customer-centric benefit: *"Get your first campaign live in under 12 minutes"* |
39
+
40
+ ---
41
+
42
+ ## 🌍 Regional Market Intelligence (MENA & Global)
43
+
44
+ ### 1. Gulf / GCC (Saudi Arabia 🇸🇦, UAE 🇦🇪, Kuwait 🇰🇼, Qatar 🇶🇦)
45
+ - **Tone**: Prestige, modern luxury, ambition, respect, and tribal/community trust.
46
+ - **Conversion Channels**: WhatsApp direct routing, Apple Pay, Mada / Tabby / Tamara installment framing.
47
+ - **Copy Idiom**: Modern polished Arabic (فصحى راقية ومقنعة) with natural Gulf business terminology.
48
+
49
+ ### 2. Egypt & Levant (Egypt 🇪🇬, Jordan 🇯🇴)
50
+ - **Tone**: High-energy, practical ROI, relatable wit, clear value-for-money justification.
51
+ - **Conversion Channels**: Cash on Delivery (COD), Fawry / InstaPay, direct phone/WhatsApp confirmation.
52
+ - **Copy Idiom**: Clear, engaging Egyptian/Levantine Arabic blending professionalism with warmth.
53
+
54
+ ### 3. Global / B2B SaaS (US / Europe)
55
+ - **Tone**: Direct, concise, metric-dense, self-serve focused.
56
+ - **Conversion Channels**: Stripe, frictionless freemium / instant calendar booking.