[!NOTE]
TidyFactor Marketing is the AI direct-response marketing and growth track within the TidyFactor Ecosystem. It equips autonomous coding and growth agents (Google Antigravity, Claude Code, Cursor, Windsurf, Roo Code) and human growth marketers with deterministic, data-backed marketing playbooks across all 7 stages of customer acquisition, retention, and monetization.

🌟 Overview & Value Proposition

🏛️ Ecosystem Architecture

tidyfactor-marketing/
├── .tidyfactor                        ← Ecosystem JSON metadata manifest
├── brand.json                         ← Brand token defaults & voice principles (v2 schema)
├── AGENTS.md                          ← Workspace rules & agent execution routing
├── SKILL.md                           ← Master Command Dispatcher (28 Capabilities)
├── SKILL-REGISTRY.md                  ← Unified naming, CLI commands, and metadata
├── VISION.md                          ← Track summary aligned with TidyFactor Vision
├── CHANGELOG.md                       ← Semantic release notes (v1.2.0)
├── requirements.txt                   ← Python conversion & data analytics tooling
├── package.json                       ← NPM package config (@alwkala/tidyfactor-marketing)
├── README.md & README.ar.md           ← Bilingual documentation
├── bin/                               ← CLI executables (create-kit.js, add-skill.js, remove-skill.js)
├── references/
│   ├── commands/                      ← 7 Intent-routed command dispatchers
│   ├── workflows/                     ← 7 Step-by-step outcome workflows with validation checklists
│   └── memory/                        ← 7 Operational memory modules (copywriting, metrics, specs, math)
├── .claude-skill/                     ← Claude Code & Cursor native wrapper
└── .agents/skills/tidyfactor-marketing/ ← Google Antigravity & Windsurf native wrapper

🧠 Contextual Decision Layer (CDL v1.0) & /brief

To prevent AI agents from generating disconnected or generic marketing campaigns, tidyfactor-marketing implements the Contextual Decision Layer:

1. Pre-flight Discovery Interview (/brief): Executes a structured 3-question interview and caches project baselines into .tidyfactor/marketing-brief.md.
2. Deterministic Boolean Skip Conditions: Bypasses elicitation automatically if a brief exists, if parameters are declared in the prompt, or if direct commands are called.
3. Single-Round Batching & Priority Hierarchy: Batches unresolved ambiguities into at most 3 questions with strict priority:
   $$\mathbf{M1 \text{ (Market/Region)}} > \mathbf{M2 \text{ (Voice Archetype)}} > \mathbf{M3 \text{ (Funnel Stage)}} > \mathbf{M4 \text{ (Offer)}} > \mathbf{M5 \text{ (Depth)}}$$
4. 7-Axis Pre-Emit Self-Critique (P/H/E/S/R/V/D):
   /* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
   • P (Pain Specificity): Solves acute customer friction with zero fluff (1-5).
   • H (Hook Strength): 3-second visual and verbal curiosity hook (1-5).
   • E (Execution Completeness): Full asset copy, CTAs, and friction reducers (1-5).
   • S (Stage Fit): Matches Schwartz 5 Stages and regional vernacular (1-5).
   • R (Restraint & Margin): Protects unit gross margin and brand equity (1-5).
   • V (Voice Authenticity): Zero banned AI clichés or buzzwords (1-5).
   • D (Decision Alignment): 100% compliant with the confirmed .tidyfactor/marketing-brief.md (1-5).

⚡ 8 Marketing Commands & 28-Capability Registry

Every capability is routed through a dedicated command file, executed via a single-outcome workflow, and informed by operational memory anchors:

🧠 The 12 Psychological Mental Models of Persuasion

TidyFactor Marketing systematically applies behavioral science across every copy generation and pricing tier:

🌍 MENA Regional Intelligence & Payment Infrastructure

Built-in operational parameters for GCC and North African markets:

├── 🇸🇦 Saudi Arabia (KSA) ── Priority: Snapchat → X → TikTok → Instagram → YouTube
│     ├── Key Payments: Mada (+35-50% CVR lift), Tamara, Tabby (+25-40% AOV lift), Apple Pay
│     └── Cultural Flags: High purchasing power, mobile-first visual content, local dialect respect
│
├── 🇦🇪 United Arab Emirates (UAE) ── Priority: Instagram → LinkedIn (B2B) → TikTok → YouTube
│     ├── Key Payments: Apple Pay, Stripe, Tabby, Tamara
│     └── Cultural Flags: International expat & local blend, mandatory English/Arabic parity
│
├── 🇪🇬 Egypt ── Priority: Facebook / Meta (#1 for B2C & B2B) → WhatsApp → YouTube → TikTok
│     ├── Key Payments: InstaPay, Fawry (+40% drop-off recovery), Meeza, Vodafone Cash, ValU
│     └── Cultural Flags: WhatsApp closing culture, high price/ROI consciousness, longevity proof
│
├── 🇰🇼 Kuwait ── Priority: Instagram → Snapchat → TikTok → WhatsApp
│     ├── Key Payments: KNET (Universal necessity), Apple Pay, Tamara, Tabby
│     └── Cultural Flags: Exceptionally high AOV, VIP concierge support expectations
│
└── 🇶🇦 Qatar, 🇯🇴 Jordan, 🇲🇦 Morocco ── Dedicated localized payment & trust matrices

🛡️ Anti-Cliché Governance & Quality Bar

Every sentence generated by TidyFactor Marketing must pass the Mechanism Replacement Rule:

If an adjective does not carry a verifiable number, a technical mechanism, or an empirical proof point, it is banned.

Forbidden Fluff & Mandatory Replacements:

🚀 Quick Start & CLI Wizard

Option 1: Interactive Terminal Setup Wizard

Launch the step-by-step interactive CLI in your terminal:

npx @alwkala/tidyfactor-marketing

Prompts you for project niche, primary target market (Global vs MENA), and growth focus (B2B, E-Commerce, or 360° Suite).

Option 2: Skill Injection into Any Project

Instantly inject the full .agents/skills/tidyfactor-marketing/ tree into your current workspace:

npx @alwkala/tidyfactor-marketing add-skill

Option 3: AI Agent Slash Commands (Claude, Antigravity, Cursor)

Trigger specialized growth workflows directly inside your agent chat:

/marketing strategy  "Plan a phased launch for our new B2B SaaS in Saudi Arabia"
/marketing ads       "Write 3-angle Meta ad copy variations for an ergonomic office chair"
/marketing email     "Generate a 5-part welcome onboarding drip for our developer newsletter"
/marketing promo     "Design a 72-hour flash sale with margin protection and Tabby installments"
/marketing growth    "Diagnose churn drop-offs and design a 2-sided customer referral loop"

📊 Direct Response KPI Benchmarks

📜 Architecture & Compliance

• TidyFactor Skill Methodology: Strict compliance with spec.md (6/6 rules passed).
• Validation Tooling: Run python scratch/deep_audit_marketing_skill.py to verify 0 broken links and 100% path resolution.
• License: Released under the open-source MIT License by TidyFactor & Alwkala.

🏛️ TidyFactor Ecosystem Architecture

TidyFactor is a modular web architecture and AI coding agent skill ecosystem built on clear separation of concerns across the product lifecycle:

TidyFactor Organization (github.com/TidyFactor)
│
├── Design Skills
│   ├── Cinematic    → Experience / "Wow"     (Apple × Cartier Scroll-Driven Landing Pages)
│   ├── Design       → Prototype / "Build"    (Code-Native UI Design Engine & Figma Alternative)
│   └── Styler       → Production / "Ship"    (Framework Styler & RTL Polish Engine)
│
├── Development Skills
│   ├── HTML         → Content & Static       (Semantic SEO & Static Platform Starter)
│   ├── HTMX         → Hypermedia             (Server-Driven Micro-Interactions)
│   ├── JS           → Vanilla SPA            (Framework-Free Reactive ES Modules)
│   ├── PHP          → Server-Rendered        (Modern PHP 8.x Component UI & Architecture)
│   └── Next         → Multi-Tenant SaaS      (Next.js 16, React 19, Supabase RLS & Dev-Perf)
│
└── Growth Skills
    └── Marketing    → Growth / Revenue       (Direct Response, Pillar SEO & Content Lifecycles)

💎 Frontend Triad

                TidyFactor
                    │
          ┌─────────┼─────────┐
          │         │         │
      Cinematic   Design    Styler
          │         │         │
      Experience Prototype Production
          │         │         │
       "Wow"      "Build"   "Ship"

📦 Community Package & Skill Parity

👨‍💻 Organization & Support

• 🌐 Official Website: https://tidyfactor.com/
• 📚 Official Documentation: https://tidyfactor.com/documentation
• 🤝 Official Partner Website: Alwkala Digital Agency
• 🐙 GitHub Organization: github.com/TidyFactor
• 📧 Business Inquiries: [email protected]
• 📱 WhatsApp: +20 101 665 6899
• 📞 Phone: +20 101 665 6899
• 📍 Location: Cairo, Egypt

📜 License

Licensed under the Apache License 2.0. Copyright (c) 2026 TidyFactor & Alwkala.