@tidyfactor/marketing 1.3.0

package/references/memory/decision-points.md

@@ -0,0 +1,73 @@
+# Marketing Contextual Decision Layer (CDL) — Thin Arbitration Protocol
+
+> **Purpose**: Governs pre-generation marketing elicitation. Resolves strategic, market, and copy ambiguities before campaign or copy emission without generating duplicate memory catalogs or conversational slop.
+
+---
+
+## 🏛️ Marketing Decision Matrix (M1 – M5)
+
+When a marketing workflow begins and the request contains ambiguous parameters, the agent arbitrates across 5 standardized decision points:
+
+| ID | Decision Dimension | Reference SSOT Catalog | Conservative Default |
+|:---|:---|:---|:---|
+| **M1** | **Target Market & Regional Calibration** | `memory/frameworks.md` & `platform-specs.md` | `Bilingual / MENA-Ready (GCC + Egypt)` |
+| **M2** | **Brand Voice Archetype & Tone** | `memory/frameworks.md` | `Authoritative Challenger (Direct, ROI-backed)` |
+| **M3** | **Funnel Stage & User Sophistication** | `memory/lifecycle-flows.md` & `ad-copy-templates.md` | `Middle-of-Funnel (Solution-Aware)` |
+| **M4** | **Conversion Model & Core Offer** | `memory/promotions-math.md` & `frameworks.md` | `Value-First / Discovery Call / Freemium` |
+| **M5** | **Output Density & Asset Depth** | `memory/frameworks.md` | `Full Campaign Blueprint (Multi-Channel)` |
+
+---
+
+## 🚦 Deterministic Boolean Skip Conditions
+
+The agent MUST skip asking questions and proceed directly to execution when any of the following conditions evaluate to `true`:
+
+```text
+1. Cached Brief Exists         → .tidyfactor/marketing-brief.md exists on disk
+2. Explicit Dimension in Prompt → User prompt explicitly specifies Region, Tone, Audience, or Offer
+3. Direct Command Invocation   → User called specific sub-command (e.g. /email, /advertising, /promotions)
+4. Copy Refresh / Optimization → Existing copy or campaign is provided for iterative rewrite
+5. Fast-Track Flag             → User appended --yes, -y, or "do not ask questions"
+```
+
+---
+
+## 🎯 Direct Invocation vs. Refresh Invariants
+
+1. **Direct Invocation Invariant**: When a user explicitly runs `/advertising`, `/email`, `/promotions`, or `/strategy`, the agent skips general discovery and uses targeted command parameters immediately.
+2. **Zero-Regression Copy Refresh Bias**: When auditing, refreshing, or rewriting existing campaigns, the agent silently preserves the established brand voice, regional calibration, and offer economics unless an overhaul is explicitly requested.
+
+---
+
+## ⚡ Single-Round Batching & Priority Hierarchy
+
+If multiple marketing dimensions remain ambiguous and no skip condition is met:
+
+1. **Maximum Questions**: Present at most **3 focused questions in a single round**. Never conduct multi-round interrogations.
+2. **Strict Priority Hierarchy**:
+   $$\mathbf{M1 \text{ (Region/Market)}} > \mathbf{M2 \text{ (Brand Voice)}} > \mathbf{M3 \text{ (Funnel Stage)}} > \mathbf{M4 \text{ (Offer)}} > \mathbf{M5 \text{ (Depth)}}$$
+3. **Priority Overflow**: If more than 3 dimensions are unknown, ask M1, M2, and M3; resolve M4 and M5 silently using the **Conservative Defaults**.
+
+---
+
+## 🛑 Terminal Hard-Stop Contract
+
+When presenting decision options to the user, the agent MUST end its turn immediately and await user selection. It MUST NOT output partial marketing plans, draft placeholder copy, or speculate on unconfirmed choices in the same turn.
+
+---
+
+## 💾 Brief Persistence Schema (`.tidyfactor/marketing-brief.md`)
+
+When `/brief` runs or decisions are confirmed, save them to `.tidyfactor/marketing-brief.md`:
+
+```markdown
+# Marketing Brief Baseline
+
+- **Product / Brand**: [Name]
+- **Target Market (M1)**: [MENA-GCC | MENA-Egypt | Global-US]
+- **Brand Voice (M2)**: [Authoritative Challenger | Empathetic Guide | Luxury Premium | Direct Response]
+- **Funnel Stage (M3)**: [Problem-Aware | Solution-Aware | Product-Aware / Most Aware]
+- **Core Offer (M4)**: [Lead Magnet | Free Trial | Discovery Call | Direct Transaction]
+- **Deliverable Scope (M5)**: [Sprint Copy | Full Campaign Blueprint]
+- **Last Updated**: [YYYY-MM-DD]
+```

package/references/memory/frameworks.md

@@ -0,0 +1,86 @@
+# Marketing Memory: Copywriting, Psychological Models & Positioning
+
+Operational direct-response frameworks, 12 psychological mental models, B2B ICP definitions, anti-cliché replacement rules, and SaaS pricing architectures.
+
+---
+
+## 1. Core Direct Response Frameworks
+
+### AIDA (Attention, Interest, Desire, Action)
+- **Attention**: Pattern interrupt or controversial statement that stops scrolling.
+- **Interest**: Surprising data point, shared frustration, or insider secret relevant to their situation.
+- **Desire**: Paint the after-state transformation; stack benefits, proof, and risk reversal.
+- **Action**: Single clear call-to-action with low friction and immediacy.
+
+### PAS (Problem, Agitate, Solve)
+- **Problem**: Name the exact acute symptom they are feeling right now.
+- **Agitate**: Dig into the emotional and financial cost of leaving it unsolved (the compounding pain).
+- **Solve**: Introduce the mechanism of your product as the logical, effortless relief.
+
+### BAB (Before, After, Bridge)
+- **Before**: Current state of struggle, friction, or wasted resources.
+- **After**: Desired dream reality where the problem is completely eliminated.
+- **Bridge**: The roadmap, vehicle, or tool that gets them from Before to After.
+
+### Hook - Story - Offer (Russell Brunson Framework)
+- **Hook**: First 3 seconds or headline grabbing attention on the core vehicle.
+- **Story**: Epiphany bridge narrative illustrating the struggle, the realization, and the new opportunity.
+- **Offer**: Irresistible stack of primary product + high-value bonuses + risk reversal guarantee + scarcity/urgency.
+
+---
+
+## 2. The 12 Psychological Mental Models of Persuasion
+
+| Mental Model | Psychological Mechanism | Direct Response Application |
+|---|---|---|
+| **1. Anchoring** | People rely heavily on the first piece of information offered. | Display original/enterprise price crossed out before revealing the actual offer. |
+| **2. Decoy Effect** | Adding a less attractive 3rd option makes the target option look superior. | 3-tier pricing where Tier 2 ($99) is vastly better value than Tier 1 ($79). |
+| **3. Loss Aversion** | Pain of losing is 2x more powerful than pleasure of gaining. | Highlight costs of inaction, lost revenue, and expiring discounts. |
+| **4. Social Proof Stacking** | Humans look to peers to determine correct behavior. | Combine customer count ("10,000+ teams"), logos, Trustpilot ratings, and video quotes. |
+| **5. Zeigarnik Effect** | People remember uncompleted tasks better than completed ones. | Use progress bars on multi-step forms starting at 50% completed. |
+| **6. Goal Gradient** | Effort increases as the goal gets closer. | "You're 1 step away from your personalized growth report." |
+| **7. Paradox of Choice** | Too many options causes decision paralysis and zero conversion. | Limit landing page to ONE primary CTA; limit pricing to 3 clean tiers. |
+| **8. Framing Effect** | Decisions change based on how information is presented. | "Save $1,200/year" converts higher than "$100/mo discount". |
+| **9. Scarcity & Urgency** | Perceived value surges when availability is restricted. | Real stock counters, limited batch cohorts, and strict 72-hour countdown clocks. |
+| **10. Sunk Cost Fallacy** | People continue an endeavor once an investment is made. | Micro-commitments (interactive quiz/calculator) before asking for email/credit card. |
+| **11. Halo Effect** | Positive impression in one area influences opinion in another. | Feature press mentions (Forbes, TechCrunch) and SOC2/Security badges above the fold. |
+| **12. Endowment Effect** | People value things more when they feel ownership. | Interactive free demos, sandbox playgrounds, or instant 14-day free trials. |
+
+---
+
+## 3. The Strict Anti-Cliché Banishment Engine
+
+Every sentence must carry a **falsifiable claim, a mechanism, or a concrete number**. Banish the following filler phrases:
+
+### English Banned List -> Mandatory Replacement
+- ❌ *"Cutting-edge / State-of-the-art"* -> ✅ Name the exact tech/stack (e.g. `Next.js 16 + Postgres RLS`).
+- ❌ *"Seamless experience / Seamless integration"* -> ✅ State the speed/steps (e.g. `Connects in 2 clicks with 0 code`).
+- ❌ *"Innovative solutions / Customized solutions"* -> ✅ State the exact capability (e.g. `Custom multi-tenant auth module`).
+- ❌ *"Take your business to the next level"* -> ✅ State the quantifiable outcome (e.g. `Increase checkout CVR by 25%`).
+- ❌ *"Quality you can trust / Committed to excellence"* -> ✅ State the verification step (e.g. `Tested under 5,000 concurrent requests`).
+- ❌ *"One-stop shop"* -> ✅ List the explicit inclusions (e.g. `Hosting + AutoSSL + Daily Backups included`).
+
+### Arabic Banned List -> Mandatory Replacement (قائمة الكليشيهات المحظورة بالعربية)
+- ❌ *"نسعى دائماً لتقديم الأفضل / نحرص على التميز"* -> ✅ اذكر الإجراء الفعلي (مثال: `نختبر سرعة التحميل وتوافق الجوال قبل إطلاق أي صفحة`).
+- ❌ *"فريق من الخبراء المتخصصين / فريق محترف"* -> ✅ اذكر سابقة الأعمال بالأرقام (مثال: `أكثر من 8 سنوات من إدارة حملات الـ B2B في الخليج`).
+- ❌ *"حلول متكاملة ومبتكرة"* -> ✅ اذكر المنتج والميزة التقنية (مثال: `منظومة ربط إلكتروني متكاملة مع بوابات مدى وتمارا`).
+- ❌ *"في عالمنا الرقمي المتسارع / في ظل التطور التكنولوجي"* -> ✅ احذف المقدمة الإنشائية وابدأ فوراً بالمشكلة والحل.
+- ❌ *"الجودة هي شعارنا"* -> ✅ اذكر الضمان (مثال: `ضمان استرداد كامل للأموال خلال 30 يوماً بدون أسئلة`).
+
+---
+
+## 4. SaaS Pricing & Packaging Architecture
+
+### 1. Value Metric Rules
+Tie pricing to how the customer measures success:
+- *Per Seat/User*: Best for collaboration/workflow software (Slack, Figma).
+- *Per Usage/Volume*: Best for developer tools/infrastructure (API calls, GB stored, emails sent).
+- *Per Feature Tier*: Best for distinct operational sizes (SMB vs Enterprise).
+
+### 2. The 3-Tier Packaging Structure
+- **Tier 1 (Starter)**: Low barrier entry for individuals; covers 80% of basic needs; acts as price floor.
+- **Tier 2 (Pro / Growth) [THE TARGET ANCHOR]**: Contains the core value drivers (unlimited limits, automation, priority support); highlighted with a "Most Popular" badge.
+- **Tier 3 (Enterprise / Custom)**: High-touch security, SAML SSO, dedicated account manager, custom SLA.
+
+### 3. Annual vs. Monthly Discount Rule
+Offer a **15% to 20% annual discount** (e.g. "Get 2 Months Free"). Discounts > 25% erode cash flow without meaningfully lifting conversion.

package/references/memory/lifecycle-flows.md

@@ -0,0 +1,106 @@
+# Marketing Memory: Email Lifecycle Flows & Retention Architectures
+
+Operational automation architectures, trigger delays, subject line formulas, churn prevention, win-back flows, and B2B outreach.
+
+---
+
+## 1. Core Automated Lifecycle Flows
+
+### Flow 1: 5-Part Welcome & Indoctrination Drip (High-Trust Nurture)
+
+| Email # | Timing Trigger | Objective | Subject Line Template | Content Architecture |
+|---|---|---|---|---|
+| **#1** | Immediate (0 min) | Deliver lead magnet + set expectations | `[Asset Inside] Here is your [Lead Magnet Name]` | Instant download link, 1-line mission, whitelist request, ask a simple reply question. |
+| **#2** | +24 hours | Founder Origin Story / Vulnerability | `Why I almost quit [Industry] in [Year]...` | Relatable struggle, epiphany realization, core philosophy that birthed the product. |
+| **#3** | +48 hours | Paradigm Shift / Bust Common Myth | `The biggest mistake [Target Audience] makes with [Topic]` | Disprove industry myth with case study proof; position your vehicle as the only logical path. |
+| **#4** | +72 hours | Social Proof / Customer Transformation | `How [Client Name] achieved [Result] without [Pain]` | Detailed step-by-step case study, screenshots/quotes, link to full story. |
+| **#5** | +96 hours | The Direct Offer + Time-Limited Incentive | `Ready to fix [Pain]? Here is a special invitation...` | Product overview, guarantee, fast-action bonus, direct CTA with deadline. |
+
+---
+
+### Flow 2: 3-Stage Abandoned Cart Recovery (E-Commerce & Digital Goods)
+
+```
+Cart Abandoned Event
+      │
+      ├── [Delay: 1 Hour]
+      │     └── Email 1: "Did you forget something?" (Helpful / Customer Support tone)
+      │           - Display abandoned items + 1-click restore link
+      │           - "Had trouble completing your order? Reply here to get instant help."
+      │           - No discounts yet (recovers 35-45% of genuine accidental drop-offs).
+      │
+      ├── [Delay: 24 Hours]
+      │     └── Email 2: "Still thinking it over?" (Social Proof & Objection Busting)
+      │           - Highlight 3 customer reviews/ratings
+      │           - Remind about free shipping, return policy, or warranty
+      │           - "Your cart is saved for the next 24 hours."
+      │
+      └── [Delay: 48 Hours]
+            └── Email 3: "Last chance: Here is 10% off before your cart expires" (Urgency & Incentive)
+                  - Dynamic coupon code valid for 12 hours only
+                  - Final countdown timer + clear refund policy
+                  - "After tonight, items will be released back to inventory."
+```
+
+---
+
+### Flow 3: At-Risk & Churn Prevention Drips (Trigger-Based)
+
+Triggered when product usage drops by > 50% over a 14-day window or 30 days before annual renewal:
+- **Email 1 (Gentle Check-In - Day 0)**:
+  - *Subject*: `Quick check-in on [Product/Goal]`
+  - *Body*: "Notice you haven't used [Feature] recently. Are you stuck or missing something? Hit reply and let me know."
+- **Email 2 (Pro-Tip / New Value - Day 5)**:
+  - *Subject*: `3 shortcuts top teams use to get [Result]`
+  - *Body*: Walkthrough video or 2-minute checklist to unlock immediate ROI.
+- **Email 3 (Executive Feedback Offer - Day 10)**:
+  - *Subject*: `Can I get your honest feedback?`
+  - *Body*: Offer 1-on-1 strategy call with product team to resolve roadblocks.
+
+---
+
+### Flow 4: Time-Boxed Win-Back Sequences (Lapsed Customers)
+
+- **30 Days Inactive (Warm Re-engagement)**:
+  - *Subject*: `We’ve added [New Feature/Product] since you last visited`
+  - *Focus*: Showcase improvements, trending items, or new case study.
+- **60 Days Inactive (Incentivized Reactivation)**:
+  - *Subject*: `Here is a $20 credit waiting in your account`
+  - *Focus*: Time-limited store credit or 1 month free reactivating discount.
+- **90+ Days Inactive (Sunset / Permission to Close File)**:
+  - *Subject*: `Should we delete your account? (Permission to close)`
+  - *Focus*: Direct, respectful breakup email asking if they wish to unsubscribe or stay.
+
+---
+
+## 2. 3-Touch B2B InMail / DM Outreach Sequence
+
+For LinkedIn and executive email outbound:
+
+```
+Touch 1 (Day 1): Value-First Opener (Zero Pitch)
+  - Reference a specific recent post or company milestone.
+  - Share 1 relevant insight, benchmark, or free teardown.
+  - End with a low-friction question: "Is this currently a focus for your team?"
+
+Touch 2 (Day 4): Social Proof & Specific Mechanism
+  - "Saw that [Competitor/Peer Company] recently solved [Pain Point] using [Mechanism]. 
+     Thought this 1-page breakdown might be useful for your team at [Company]."
+  - Soft CTA: "Happy to send over the template if you'd like to check it out."
+
+Touch 3 (Day 8): The Graceful Breakup / Direct Ask
+  - "Know you're swamped. Won't follow up again if this isn't relevant right now. 
+     If you ever want to explore how to [Core Outcome], feel free to reach back out."
+```
+
+---
+
+## 3. Subject Line Psychology & Split-Testing Formulas
+
+| Category | Formula | Example |
+|---|---|---|
+| **Curiosity / Open Loop** | `[Unusual statement] + [curiosity hook]` | "This 4-minute routine replaces caffeine..." |
+| **Direct Benefit & Speed** | `How to [desirable outcome] in [short timeframe]` | "How to audit your SEO in 12 minutes" |
+| **Social Proof / Numbers** | `[Number] [professionals] are using this to [result]` | "1,420 store owners fixed their checkout with this" |
+| **FOMO / Urgency** | `[Time left / Warning]: [Event happening]` | "Closing at midnight: Your 40% VIP voucher" |
+| **Personal & Casual** | `Quick question regarding [topic]` | "Quick question about your Google Ads account" |

package/references/memory/metrics-benchmarks.md

@@ -0,0 +1,70 @@
+# Marketing Memory: Industry Benchmarks, ICE Scoring & Funnel Formulas
+
+Operational quantitative anchors for marketing audits, paid ad budgets, B2B pipeline, retention health, growth experiments, and regional conversion benchmarks.
+
+---
+
+## 1. Core Marketing & Growth Formulas
+
+```
+CTR (Click-Through Rate)      = (Clicks / Impressions) * 100
+CPC (Cost Per Click)           = Total Ad Spend / Total Clicks
+CVR (Conversion Rate)         = (Conversions / Visitors) * 100
+CPA (Cost Per Acquisition)     = Total Ad Spend / Total Conversions
+ROAS (Return on Ad Spend)     = Total Revenue from Ads / Total Ad Spend
+AOV (Average Order Value)     = Total Revenue / Total Orders
+LTV (Customer Lifetime Value) = AOV * Purchase Frequency * Customer Lifespan
+LTV : CAC Ratio               = LTV / CAC  (Target: >= 3.0x for SaaS/Subscriptions)
+Break-Even ROAS               = 1 / Gross Margin %
+CAC Payback Period (mo)       = CAC / (Average Monthly Gross Margin per Customer)
+```
+
+---
+
+## 2. Growth Experimentation: The ICE Scoring Model
+
+Prioritize marketing & CRO test ideas using the formula:
+$$\text{ICE Score} = \text{Impact (1-10)} \times \text{Confidence (1-10)} \times \text{Ease (1-10)}$$
+
+- **Impact (1-10)**: If this experiment succeeds, how much will it lift our primary conversion metric?
+- **Confidence (1-10)**: How sure are we based on prior data, customer interviews, or proven case studies?
+- **Ease (1-10)**: How fast and low-resource is this to implement? (10 = 1 hour / 0 code; 1 = 3 weeks of engineering).
+
+### Scientific Hypothesis Template:
+> *"If we [implement change X] on [page/channel Y], then [primary metric Z] will increase by [W%] because [psychological reason]."*
+
+---
+
+## 3. Platform & Regional Conversion Benchmarks
+
+### Global Traffic Benchmarks
+
+| Metric | E-Commerce (B2C) | B2B SaaS | Local Services | Info / Courses |
+|---|---|---|---|---|
+| **Meta CTR (Outbound)** | 1.50% - 2.80% | 0.80% - 1.60% | 1.20% - 2.50% | 1.80% - 3.20% |
+| **Meta CPC** | $0.40 - $1.20 | $2.50 - $6.00 | $1.50 - $4.00 | $0.80 - $2.00 |
+| **LinkedIn CPC** | N/A | $5.00 - $14.00 | N/A | $3.50 - $8.00 |
+| **Google Search CTR** | 2.50% - 4.50% | 3.00% - 6.00% | 4.00% - 8.00% | 2.50% - 5.00% |
+| **Landing Page CVR** | 2.00% - 4.50% | 3.00% - 8.00% (Lead) | 5.00% - 12.00% (Call) | 4.00% - 10.00% (Opt-in) |
+| **Target ROAS (Blended)** | 2.8x - 4.5x | 1.5x - 2.5x (Front-end) | N/A (Pay-per-lead) | 3.0x - 5.0x |
+
+### MENA Payment Method Conversion Lifts
+- **Enabling Mada & Apple Pay in Saudi Arabia (KSA)**: Lifts checkout conversion rate by **+35% to +50%**.
+- **Enabling BNPL (Tabby / Tamara)**: Lifts Average Order Value (AOV) by **+25% to +40%** for orders above $80 (300 SAR/AED).
+- **Enabling InstaPay / Fawry in Egypt**: Recovers **+40% of drop-offs** compared to credit-card-only checkouts.
+
+---
+
+## 4. B2B Pipeline Benchmarks
+
+```
+Impressions ──> Engagements ──> Profile Visits ──> Inbound DMs
+      │
+      └──> MQL (Marketing Qualified Lead)   [Benchmark: 15-25% from Inbound]
+            └──> SQL (Sales Qualified Lead) [Benchmark: 40-60% from MQL]
+                  └──> Opportunity / Demo   [Benchmark: 50-70% from SQL]
+                        └──> Closed Won     [Benchmark: 20-35% from Demo]
+```
+
+- **Target CAC Payback Period**: < 12 months for SMB SaaS; < 18 months for Enterprise.
+- **Monthly Logo Churn**: < 1.0% (Enterprise), < 2.5% (SMB).

package/references/memory/philosophy.md

@@ -0,0 +1,16 @@
+# Marketing Philosophy: Audience-First Growth & Direct Response Principles
+
+*(Note: Human-facing document. Never referenced by operational commands or execution agents).*
+
+---
+
+## 1. The Direct Response Mindset
+Marketing is not speculative art; it is measurable human psychology applied through distribution channels. Every campaign, post, email, and ad exists to solve a genuine problem for an audience in exchange for attention, trust, and capital.
+
+## 2. Anti-Slop & Quality Standards
+- **Zero Platitudes**: Banish generic advice like "create high-quality engaging content" or "build brand awareness." Replace them with specific, falsifiable hypotheses, clear numbers, testable hooks, and exact distribution cadences.
+- **Respect Audience Attention**: High conversion comes from extreme relevance, clarity of mechanism, and immediate proof — not clickbait deceit.
+- **Margin Protection**: Growth at the expense of negative unit economics is vanity. Sustainable businesses grow by optimizing Customer Acquisition Cost (CAC) against high Lifetime Value (LTV) and healthy gross margins.
+
+## 3. Cultural Nuance & Global Reach
+Great marketing speaks natively. Whether drafting English direct-response sales copy or modern Arabic campaigns for MENA markets, the tone must reflect cultural dignity, natural vernacular, and genuine value.

package/references/memory/platform-specs.md

@@ -0,0 +1,75 @@
+# Marketing Memory: Platform Specs, MENA Regional Intelligence & CRO
+
+Operational parameters for Global Social Platforms, Country-by-Country MENA Market Intelligence, Regional Payment Infrastructure, and 7-Dimension CRO Audits.
+
+---
+
+## 1. MENA Per-Country Market & Platform Intelligence
+
+| Country | #1 Platforms (Priority Order) | Key Regional Payment Infrastructure | Trust & Cultural Factors |
+|---|---|---|---|
+| 🇸🇦 **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. |
+| 🇦🇪 **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. |
+| 🇪🇬 **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. |
+| 🇰🇼 **Kuwait** | Instagram → Snapchat → TikTok → WhatsApp | **KNET**, Apple Pay, Tamara, Tabby | Exceptionally high AOV, heavy Instagram shopping/DM orders, personal concierge support culture. |
+| 🇶🇦 **Qatar** | Instagram → Snapchat → TikTok → X | **NAPS**, Apple Pay, Debit Cards | High luxury and status affinity, government & corporate B2B focus. |
+| 🇯🇴 **Jordan** | Facebook → Instagram → WhatsApp → TikTok | **CliQ**, Zain Cash, Orange Money, Credit Cards | Strong tech/freelancer hub, price-sensitive, peer recommendation driven. |
+| 🇲🇦 **Morocco** | Facebook → Instagram → TikTok → WhatsApp | **CMI**, Cash on Delivery (COD), Orange Money | French/Arabic/Darija linguistic sensitivity, high COD prevalence in e-commerce. |
+
+---
+
+## 2. 7-Dimension CRO (Conversion Rate Optimization) Audit Framework
+
+Analyze any landing page or checkout in order of impact:
+
+```
+1. Value Proposition Clarity (The 5-Second Test)
+   - Can a cold visitor understand what this is and why they should care in < 5 seconds?
+   - Is the primary benefit specific, quantified, and differentiated?
+
+2. Headline & Hero Effectiveness
+   - Outcome-focused: "Get [Outcome] without [Pain Point]"
+   - Matches the exact message and keywords of the referring ad or search query.
+
+3. CTA Hierarchy & Placement
+   - Single clear primary action above the fold.
+   - Low-friction copy ("Start Free 14-Day Trial", not "Submit" or "Buy Now").
+
+4. Friction & Cognitive Load
+   - Multi-step forms with progress bars for complex signups.
+   - Zero surprise shipping or hidden fees at checkout.
+
+5. Social Proof Stacking
+   - Customer logos, verifiable metric callouts, video testimonials, and Trustpilot/G2 badges.
+
+6. Risk Reversal & Guarantees
+   - Explicit money-back guarantee, 24/7 localized support, SSL/Security certifications.
+
+7. Mobile Usability & Speed
+   - Page load time < 2.5s (Core Web Vitals).
+   - 1-click mobile checkout enabled (Apple Pay, Mada, InstaPay).
+```
+
+---
+
+## 3. Global Social Algorithmic Signals
+
+| Platform | Primary Ranking Signals | Winning Content Format | Optimal Posting Cadence |
+|---|---|---|---|
+| **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 |
+| **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) |
+| **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) |
+| **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 |
+| **X (Twitter)** | Bookmarks, Retweets/Quotes, Replies, Verified user interactions | Long-form articles/threads with visual diagrams | 2-4 posts/day |
+
+---
+
+## 4. The 3-Tier Hashtag Distribution Rule
+
+```
+Total Hashtags: 5 to 10 targeted tags (Never use 30 spam tags).
+
+├── Tier 1: Broad Category (1-2 tags) -> 500k - 2M posts (e.g. #SaudiBusiness #SaaSGrowth)
+├── Tier 2: Niche Community (3-5 tags) -> 50k - 500k posts (e.g. #NextjsDevelopers #MENAEcommerce)
+└── Tier 3: Micro / Branded (2-3 tags) -> 1k - 50k posts (e.g. #TidyFactorEngine #RiyadhStartups)
+```

package/references/memory/promotions-math.md

@@ -0,0 +1,56 @@
+# Marketing Memory: Promotions Math, Discounts & Margin Safeguards
+
+Operational financial models to engineer high-converting promotions, sales, and contests without destroying profit margins.
+
+---
+
+## 1. Margin & Discount Impact Matrix
+
+A common marketing failure is discounting without understanding gross margin erosion.
+
+### The Margin Erosion Equation:
+```
+Required Sales Volume Increase to Maintain Same Profit:
+Volume Increase % = (Discount %) / (Gross Margin % - Discount %) * 100
+```
+
+### Table: Extra Sales Required When Offering Discounts
+
+| Your Product Gross Margin | 10% Discount | 20% Discount | 30% Discount | 40% Discount |
+|---|---|---|---|---|
+| **70% Gross Margin** (Software/Info) | +16.7% sales | +40.0% sales | +75.0% sales | +133.3% sales |
+| **50% Gross Margin** (Typical E-comm) | +25.0% sales | +66.7% sales | +150.0% sales | +400.0% sales |
+| **30% Gross Margin** (Low Margin Retail) | +50.0% sales | +200.0% sales | ⚠️ 0 Profit | ⛔ Net Loss |
+
+---
+
+## 2. Margin-Safe Promotion Architectures
+
+### Model A: Threshold-Based Tiered Discounts (AOV Expansion)
+Instead of a flat 20% sitewide discount, structure tiers above current Average Order Value (AOV):
+- **Current AOV = $60**:
+  - *Tier 1*: Spend $75, Get $10 Off (~13% discount, forces +25% basket size).
+  - *Tier 2*: Spend $120, Get $20 Off (~16% discount, forces 2x basket size).
+  - *Tier 3*: Spend $180, Get $35 Off + Free Gift (~19% discount, forces 3x basket size).
+
+### Model B: Buy X, Get Free Bonus (Value Stacking vs Price Cutting)
+Giving a digital bonus or low-cost physical accessory preserves price integrity while providing higher perceived value than a flat discount.
+- *Example*: "Buy the Core Course ($197), Get 3 Live Q&A Sessions + Template Pack Free ($297 Value)" vs "$50 Off".
+
+### Model C: Flash Sale Scarcity Matrix (72-Hour Window)
+- **Hour 0 - 24**: Early Bird VIP Access (Deepest incentive or exclusive bundle bonus).
+- **Hour 24 - 48**: Mid-Sale Momentum & Social Proof (Customer testimonials, stock ticker updates).
+- **Hour 48 - 72**: Final Countdown / Hard Deadline (Urgency, countdown clock, cart expiration).
+
+---
+
+## 3. Giveaway / Contest ROI Architecture
+
+To prevent "Freebie Seekers" who never buy:
+1. **Prize Selection Rule**: The prize MUST ONLY be desirable to your exact dream customer.
+   - ❌ *Bad*: Win an iPhone 16 / $500 Cash (attracts anyone and destroys email list quality).
+   - ✅ *Good*: Win 1 Year of [Your SaaS] + 1-on-1 Onboarding / $500 Store Shopping Spree.
+2. **Viral Entry Mechanics**:
+   - Primary Entry: Verified Email Opt-in (1 entry).
+   - Bonus Actions: Share unique referral link with 3 friends (+5 entries per verified referral).
+   - Consolation Offer: Every non-winner receives a personalized 48-hour voucher on the day winners are announced (recovers 8-15% conversion on participants).

package/references/memory/quality-bar.md

@@ -0,0 +1,55 @@
+# Marketing Quality Bar & 7-Axis Pre-Emit Self-Critique
+
+> **Purpose**: Enforces strict anti-slop marketing standards, conversion mechanics, and regional calibration across all copywriting, ads, emails, and campaign strategies.
+
+---
+
+## 🛡️ The 7-Axis Pre-Emit Self-Critique (`P/H/E/S/R/V/D`)
+
+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):
+
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+| Axis | Dimension | Evaluation Criteria |
+|:---:|:---|:---|
+| **P** | **Pain / Desire Specificity** | Identifies acute, tangible customer pain or quantifiable aspiration. Zero generic filler ("grow your business", "reach your goals"). |
+| **H** | **Hook & Headline Power** | Scroll-stopping 3-second hook utilizing curiosity gap, contrarian insight, or compelling numerical anchor. |
+| **E** | **Execution Completeness** | Delivers complete funnel assets (Subject Lines, Body Copy, CTA, Micro-copy, Risk Reversal, Social Proof anchors). |
+| **S** | **Stage & Market Fit** | Calibrated to user sophistication (Schwartz 5 Stages) and native regional market vernacular (GCC, Egypt, Global). |
+| **R** | **Restraint & Margin Protection** | Protects brand equity and unit gross margins; avoids destructive discount spirals and false manufactured scarcity. |
+| **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"). |
+| **D** | **Decision Alignment** | 100% compliant with the confirmed `.tidyfactor/marketing-brief.md` baseline (Market, Tone, Offer, Scope). |
+
+---
+
+## 🚫 AI Slop & Cliché Banned Dictionary
+
+The following phrases and generic filler patterns are **STRICTLY PROHIBITED** in all generated marketing copy:
+
+| Banned AI Slop | Why It Fails | Approved High-Conversion Alternative |
+|:---|:---|:---|
+| *"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..."* |
+| *"Unlock your full potential..."* | Vague, untestable corporate slogan | Specific outcome: *"Double your qualified demo bookings without increasing ad spend"* |
+| *"Game-changer / Revolutionize / Next-level"* | Hyperbolic buzzword blindness | Concrete mechanism: *"Replaces 4 disjointed SaaS tools with 1 automated pipeline"* |
+| *"Look no further..."* | Lazy infomercial cliché | Proof-driven hook: *"Here is the exact 3-step breakdown 84 enterprise teams use..."* |
+| *"We are passionate about providing..."* | Self-centered brand ego | Customer-centric benefit: *"Get your first campaign live in under 12 minutes"* |
+
+---
+
+## 🌍 Regional Market Intelligence (MENA & Global)
+
+### 1. Gulf / GCC (Saudi Arabia 🇸🇦, UAE 🇦🇪, Kuwait 🇰🇼, Qatar 🇶🇦)
+- **Tone**: Prestige, modern luxury, ambition, respect, and tribal/community trust.
+- **Conversion Channels**: WhatsApp direct routing, Apple Pay, Mada / Tabby / Tamara installment framing.
+- **Copy Idiom**: Modern polished Arabic (فصحى راقية ومقنعة) with natural Gulf business terminology.
+
+### 2. Egypt & Levant (Egypt 🇪🇬, Jordan 🇯🇴)
+- **Tone**: High-energy, practical ROI, relatable wit, clear value-for-money justification.
+- **Conversion Channels**: Cash on Delivery (COD), Fawry / InstaPay, direct phone/WhatsApp confirmation.
+- **Copy Idiom**: Clear, engaging Egyptian/Levantine Arabic blending professionalism with warmth.
+
+### 3. Global / B2B SaaS (US / Europe)
+- **Tone**: Direct, concise, metric-dense, self-serve focused.
+- **Conversion Channels**: Stripe, frictionless freemium / instant calendar booking.

package/references/workflows/brief.md

@@ -0,0 +1,72 @@
+# Marketing Discovery & Brief Workflow
+
+> **Outcome**: Generates an authoritative `.tidyfactor/marketing-brief.md` file capturing target market, brand voice, funnel stage, conversion model, and delivery scope.
+
+---
+
+## 📋 Step 0: Check Existing Baseline
+
+1. Check if `.tidyfactor/marketing-brief.md` already exists on disk.
+2. If it exists and user did not specify `--force` or `--reset`:
+   - Display the active brief summary.
+   - Ask if the user wants to keep the existing baseline or update specific parameters.
+
+---
+
+## 💬 Step 1: Conduct 3-Question Targeted Discovery
+
+If no baseline exists, present at most 3 clear, structured questions in a single turn:
+
+### Question 1: Target Market & Regional Tone (M1)
+- **A) Gulf / GCC (Saudi Arabia 🇸🇦, UAE 🇦🇪, Kuwait 🇰🇼, Qatar 🇶🇦)** — High prestige, trust-first, WhatsApp/Installments framing, modern polished Arabic.
+- **B) Egypt & Levant (Egypt 🇪🇬, Jordan 🇯🇴)** — Practical ROI, high energy, relatable wit, cash-on-delivery & InstaPay framing.
+- **C) Global / B2B SaaS** — Direct, metric-dense, self-serve focused, English-first.
+- **D) Bilingual / Unified MENA** (Default).
+
+### Question 2: Brand Voice Archetype (M2)
+- **A) Authoritative Challenger** (Direct, contrarian, proof-backed, no-nonsense).
+- **B) Empathetic Guide** (Supportive, story-driven, transformational, warm).
+- **C) Elite Luxury / High-End** (Minimalist, aspirational, refined confidence).
+- **D) High-Energy Direct Response** (Urgent, benefit-stacked, conversion-focused).
+
+### Question 3: Funnel Focus & Core Offer (M3 + M4)
+- **A) Top-of-Funnel Lead Magnet** (Free guide, checklist, audit, quiz).
+- **B) Middle-of-Funnel Trial / Demo** (Product-led trial, 1-on-1 strategy call).
+- **C) Bottom-of-Funnel Direct Sale / Promo** (E-commerce purchase, limited-time launch offer).
+
+---
+
+## 💾 Step 2: Write `.tidyfactor/marketing-brief.md`
+
+Format and persist the confirmed choices:
+
+```markdown
+# Marketing Brief Baseline
+
+- **Product / Brand**: [Extracted or Confirmed Name]
+- **Target Market (M1)**: [Confirmed Selection]
+- **Brand Voice (M2)**: [Confirmed Archetype]
+- **Funnel Stage (M3)**: [Top / Middle / Bottom]
+- **Core Offer (M4)**: [Lead Magnet / Trial / Direct Transaction]
+- **Deliverable Scope (M5)**: [Sprint Copy / Multi-Channel Blueprint]
+- **Last Updated**: [Current Date]
+```
+
+---
+
+## 🎯 Step 3: Self-Critique & Handoff
+
+Stamp the 7-axis critique:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## ## Validation checklist
+
+- [ ] `.tidyfactor/marketing-brief.md` created or verified on disk.
+- [ ] Exactly 3 or fewer questions asked in a single round.
+- [ ] Regional calibration (GCC, Egypt, Global) explicitly recorded.
+- [ ] Brand voice archetype explicitly recorded.
+- [ ] Confirmed baseline summary displayed to user with next command suggestions (`/strategy`, `/advertising`, `/email`, `/content`).