@tidyfactor/marketing 1.3.0

package/references/workflows/campaign-launch.md

@@ -0,0 +1,73 @@
+# Workflow: campaign-launch
+
+One outcome: A complete, data-backed Campaign Strategy or Product Launch Plan with brand positioning, competitive differentiation, phased milestones, ICE experiment prioritization, channel allocation, and KPI targets.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), funnel stage (M3), and core offer (M4).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. Brand Positioning & Mechanism Diagnosis
+Using `../memory/frameworks.md`:
+- **Positioning Statement**: Formulate the canonical statement: `For [Audience], [Brand] is the [Category] that [Benefit], because [Factual Proof].`
+- **Competitive Differentiation**: Compare against 2-3 named alternatives and designate the **ONE attribute to own**.
+- **Anti-Cliché Review**: Verify zero filler buzzwords ("cutting-edge", "innovative solutions") per `../memory/quality-bar.md`.
+- **Target Buyer Avatar & Regional Calibration**: Define acute pain points, alternatives tried, core transformation, and target market (e.g. KSA, UAE, Egypt, or Global).
+
+### 2. Positioning & Angle Architecture
+Select 3 core campaign angles using `../memory/frameworks.md`:
+- **Angle 1**: Pain / Problem-focused (Loss Aversion / PAS).
+- **Angle 2**: Logic / Efficiency & Transformation (BAB / Anchoring).
+- **Angle 3**: Social Status / Aspirational.
+
+### 3. Phased Orchestration Architecture
+Structure the rollout into 3 distinct operational phases:
+
+#### Phase A: Pre-Launch / Warm-up (T-30 to T-1 Days)
+- Build VIP waitlist / early-bird opt-in with a high-value lead magnet.
+- Tease behind-the-scenes, problem validation content, and customer interviews.
+- Goal: Secure 30-50% of launch revenue pipeline before Day 1.
+
+#### Phase B: Launch Day / Live Blitz (T-0 to T+3 Days)
+- Multi-channel synchronized blast: Email broadcast + Organic Social blitz + Paid Ads launch.
+- Early bird bonuses / fast-action incentives active for first 48 hours only.
+- Live stream, community Q&A, or real-time proof sharing.
+
+#### Phase C: Momentum & Retention (T+4 to T+14 Days)
+- Case studies and early adopter reviews spotlight.
+- Cart close / deadline reminder sequence (last 24 hours).
+- Post-purchase onboarding and automated review collection.
+
+### 4. Growth Experimentation (ICE Score Prioritization)
+Using `../memory/metrics-benchmarks.md`:
+- Prioritize top 3 launch experiments using the ICE Score ($\text{Impact} \times \text{Confidence} \times \text{Ease}$).
+- Document exact scientific hypotheses before spending budget.
+
+### 5. Channel Budget & KPI Scorecard
+Define budget allocation across channels and set quantitative benchmarks using `../memory/metrics-benchmarks.md`:
+- Channel Split (% Organic, % Meta/Google Paid, % Email, % Influencer).
+- Expected CPA, CVR, Target ROAS, and Stop-Loss thresholds.
+
+### 6. Pre-Emit Quality Self-Critique
+Before emitting the final strategy, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] Canonical positioning statement formulated with concrete proof (no generic slogans)
+- [ ] Competitive differentiation table designates 1 primary attribute to own
+- [ ] 3 distinct psychological messaging angles articulated
+- [ ] Top 3 launch experiments scored and ranked using ICE scoring model
+- [ ] Phased timeline contains explicit milestones for Pre-launch, Launch Day, and Post-launch
+- [ ] Channel budget split sums to 100% with concrete dollar/percentage allocations
+- [ ] Numeric target KPIs included (Expected CVR %, Target CPA $, Minimum ROAS)
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/references/workflows/content-engine.md

@@ -0,0 +1,68 @@
+# Workflow: content-engine
+
+One outcome: A complete multi-channel content batch, SEO Pillar + Cluster content plan, 30-day publishing calendar, or high-open newsletter blueprint.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), and deliverable depth (M5).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. Content Pillar & Format Selection
+Establish 4 core content pillars:
+- **Pillar 1: Authority & Case Studies (30%)** — Real metrics, teardowns, client transformations, frameworks.
+- **Pillar 2: Contrarian / Perspective (25%)** — Debunking industry myths, hot takes, "why [common practice] is dead".
+- **Pillar 3: Tactical / How-To (25%)** — Step-by-step checklists, code snippets, templates, workflows.
+- **Pillar 4: Culture & Behind-the-Scenes (20%)** — Founder journey, design iterations, team wins/losses.
+
+### 2. Multi-Platform Post Batch Generation
+Using `../memory/platform-specs.md` and `../memory/frameworks.md`:
+- Craft **3-Second Visual & Verbal Hooks** tailored to each selected platform (LinkedIn, X, Instagram, TikTok).
+- Apply **LinkedIn B2B frameworks** (POV opinions, breakdown of client transformations, behind-the-build lessons).
+- Write high-retention body copy with line-break rhythm, bulleted insights, and zero filler prose.
+- Attach specific, low-friction **Calls-to-Action (CTAs)**.
+
+### 3. SEO Pillar + Cluster Strategy (If SEO Intent)
+Using `../memory/frameworks.md`:
+- Map target keywords across **3 Intent Buckets**: Informational (TOFU), Commercial (MOFU), and Transactional (BOFU).
+- Formulate 1 comprehensive **Pillar Guide** (2,500 - 3,500 words).
+- Architect 3-5 **Supporting Cluster Posts** targeting long-tail queries with bidirectional internal linking.
+- Review Technical & On-Page checklist (H1/H2 hierarchy, Title/Meta caps, Schema markup).
+
+### 4. Editorial Calendar & Distribution Grid
+Assemble a weekly or monthly grid:
+- **Date & Time**: Day of week + optimal posting window.
+- **Platform**: Destination channel.
+- **Pillar & Topic**: Core subject and theme.
+- **Format**: Video (Reels/Shorts/TikTok), Carousel, Thread/Article, or Image + Caption.
+- **Visual Asset Brief**: Image/video prompt, slide count, or screen-recording cue.
+
+### 5. Newsletter Blueprint (If Requested)
+Structure the newsletter layout:
+- **Subject Line Options**: 3 A/B test variations (Curiosity, Direct Benefit, Urgency).
+- **Preview Text**: 1 punchy sentence under 50 characters.
+- **Main Story / Deep Dive**: 400-800 words following Hook-Story-Offer.
+- **Quick Links / Curated Value**: 3 bulleted high-value resources.
+- **Primary CTA & P.S. Hook**: Clear link to core offer + curiosity-inducing postscript.
+
+### 6. Pre-Emit Quality Self-Critique
+Before emitting the final content assets, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] Every post includes a 0-3s attention hook matching platform specs
+- [ ] Content pillars balanced across authority, tactical value, and contrarian perspectives
+- [ ] If SEO content: Keywords categorized into Informational, Commercial, or Transactional intent
+- [ ] Formatting is clean with line breaks, bullets, and platform-appropriate character lengths
+- [ ] Every post or newsletter issue has an explicit, measurable Call to Action
+- [ ] 3 distinct A/B subject lines provided for newsletters / long-form articles
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/references/workflows/email-lifecycle.md

@@ -0,0 +1,55 @@
+# Workflow: email-lifecycle
+
+One outcome: A complete email list growth blueprint, 5-part welcome onboarding sequence, 3-stage abandoned cart recovery flow, or broadcast email campaign.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), and funnel stage (M3).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. List Growth & Lead Magnet Engineering
+Define the lead capture mechanism:
+- **Lead Magnet Format**: Specific checklist, cheat sheet, calculator, mini-course, or discount voucher (must deliver immediate win in under 10 minutes).
+- **Opt-in Form Copy**: Headline focused on the outcome, 2 bullet points of what's inside, single low-friction form field (Email only).
+- **Placement Strategy**: Sticky header bar, inline blog callout, exit-intent popup (triggered on mouse leave or 60s dwell time).
+
+### 2. 5-Part Welcome & Indoctrination Drip Sequence
+Using `../memory/lifecycle-flows.md` and `../memory/frameworks.md`, draft full copy for each email:
+- **Email 1 (Day 0 - Immediate)**: Delivery + Whitelist instruction + Expectation setting.
+- **Email 2 (Day 1 - 24h)**: Origin Story & Epiphany Bridge (Building emotional connection).
+- **Email 3 (Day 2 - 48h)**: Paradigm Shift / Myth Busting (Overcoming internal objections).
+- **Email 4 (Day 3 - 72h)**: Case Study & Proof (Overcoming external objections).
+- **Email 5 (Day 4 - 96h)**: The Invitation / Fast-Action Offer with Urgency.
+
+### 3. 3-Stage Abandoned Cart Recovery (E-Commerce / Digital Offer)
+Draft the 3 sequential messages:
+- **Stage 1 (1 Hour)**: Helpful Customer Care & Cart Link (No discount).
+- **Stage 2 (24 Hours)**: Top 3 Customer Testimonials + FAQs & Guarantee.
+- **Stage 3 (48 Hours)**: Expiring 10% Discount Code or Free Bonus Gift + Deadline Countdown.
+
+### 4. Broadcast Campaign (Promotions / Newsletters)
+For one-off announcements or sales:
+- Structure copy using PAS or BAB.
+- Implement urgency triggers (closing date/time).
+
+### 5. Pre-Emit Quality Self-Critique
+Before emitting the final email copy or flows, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] Lead magnet promises a specific, actionable win achievable in < 10 minutes
+- [ ] Every email includes 3 distinct subject line options (Curiosity, Direct, Urgency)
+- [ ] Delay intervals and triggers explicitly specified for every automated step
+- [ ] Mobile-optimized layout with short paragraphs (1-3 sentences) and distinct button/text CTAs
+- [ ] Cart recovery flow escalates logically from support -> social proof -> discount urgency
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/references/workflows/paid-acquisition.md

@@ -0,0 +1,66 @@
+# Workflow: paid-acquisition
+
+One outcome: Multi-variation ad copy matrices (3 distinct psychological angles), high-converting landing page wireframe messaging, 7-Dimension CRO audit, Meta/Google campaign architectures, or a first test campaign setup.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), funnel stage (M3), and core offer (M4).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. Direct Response Ad Copy Generation (Anti-Cliché Rule)
+Using `../memory/ad-copy-templates.md` and `../memory/frameworks.md`:
+- Draft **3 distinct ad variations** across psychological angles:
+  - **Variation A (Pain / Agitation - Loss Aversion)**: Target the specific daily friction and cost of doing nothing.
+  - **Variation B (Logic / Efficiency / ROI - Anchoring)**: Highlight speed, metrics, math, and seamless automation.
+  - **Variation C (Aspirational / Social Proof)**: Highlight peer success and transformation.
+- Enforce the **Anti-Cliché Replacement Rule**: Zero generic filler adjectives ("cutting-edge", "seamless", "innovative") per `../memory/quality-bar.md`. Replace every adjective with a specific number, mechanism, or proof point.
+- For each variation provide: Primary Text, 3 Catchy Headlines (< 30 chars), Description (< 90 chars), Recommended CTA Button.
+
+### 2. Google Responsive Search Ads (RSA) Matrix
+- 15 Diverse Headlines following the distribution rule (Keywords, Benefits, Social Proof, Urgency).
+- 4 Compelling Descriptions (< 90 characters each).
+- List of 10 Negative Keywords to prevent wasted spend.
+
+### 3. High-Converting Landing Page Messaging & 7-Dimension CRO Architecture
+Structure the landing page wireframe section by section:
+- **Section 1: Hero (Above the Fold - 5-Second Clarity Test)**:
+  - Eyebrow badge / Category label.
+  - Main Headline (Outcome + Timeframe without Pain).
+  - Subheadline (The Mechanism).
+  - Primary CTA Button + Trust Badge + 1-Click Mobile Checkout Cue.
+  - Hero visual mockup description.
+- **Section 2: Social Proof Bar**: Logos of trusted clients or press mentions.
+- **Section 3: The Old Way vs. The New Way**: 2-column contrast table.
+- **Section 4: Core Features & Benefits**: 3 benefit cards with screenshots/icons.
+- **Section 5: Customer Video/Written Testimonials**: Detailed case study transformation.
+- **Section 6: Pricing / Offer Stack (Anchoring & Decoy Effect)**: Price, inclusions, bonuses, and risk-reversal guarantee.
+- **Section 7: FAQ Accordion**: Answering the top 5 buying objections.
+- **Section 8: Final Call to Action Banner**: Urgency reminder + CTA button.
+
+### 4. Campaign Budget & Testing Architecture
+- Campaign type (Advantage+ / CBO vs. ABO).
+- Testing budget rules ($20-$50/day test split across 3-5 creatives for 72 hours).
+- Kill / Scale rules: Kill creatives with CTR < 1.0% or CPC > 2x target CPA; Scale winning creatives by +20% every 48 hours.
+
+### 5. Pre-Emit Quality Self-Critique
+Before emitting ad copy or landing page wireframes, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] At least 3 distinct psychological ad copy angles produced
+- [ ] Zero banned marketing clichés present (verified against `../memory/quality-bar.md`)
+- [ ] Google RSA includes 15 unique headlines and 4 descriptions matching character caps
+- [ ] Landing page messaging covers all 8 wireframe sections and passes the 5-second clarity test
+- [ ] Concrete campaign testing budget and scaling/kill thresholds defined
+- [ ] Ad copy and landing page headlines share matching messaging to prevent bounce
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/references/workflows/promo-conversion.md

@@ -0,0 +1,58 @@
+# Workflow: promo-conversion
+
+One outcome: A profitable seasonal or flash sale plan, Decoy Effect pricing structure, a viral contest/giveaway architecture, or a margin-safe discount and coupon strategy.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), and conversion model (M4).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. Margin Safeguard & Discount Math
+Using `../memory/promotions-math.md`:
+- Input Product Price ($) and Unit Cost / COGS ($) to determine Gross Margin %.
+- Calculate the maximum allowable discount that maintains positive net contribution.
+- If margin is < 40%, route away from flat percentage discounts to **Threshold Bundling** (e.g. "Spend $100 Get $15") or **Value-Add Free Bonuses**.
+
+### 2. Pricing Architecture & Psychological Anchoring
+Using `../memory/frameworks.md`:
+- Structure 3-Tier Good/Better/Best pricing table.
+- Implement the **Decoy Effect**: Position the middle tier as the irresistible target by making the lower tier slightly less attractive and the top tier the high-anchor enterprise tier.
+- Frame annual billing with a 15-20% discount ("Get 2 Months Free").
+- If MENA market: Add localized BNPL installment messaging ("Split into 4 interest-free payments of X SAR/AED with Tabby/Tamara").
+
+### 3. 72-Hour Flash Sale & Seasonal Promotion Execution Plan
+Structure the promotional timeline:
+- **T-3 Days (Pre-Announcement Teaser)**: VIP early-access signup with exclusive bonus for first 50 buyers.
+- **Day 1 (Hour 0 - Launch Blitz)**: Main launch email broadcast + top banner on website + retargeting ad surge.
+- **Day 2 (Hour 24 - Momentum & FAQs)**: Social proof highlights + answers to common questions.
+- **Day 3 (Hour 48 - Last Chance / Hard Close)**: 3-part urgency email cadence (Morning, Afternoon, 2-Hours-Left) + countdown timer banner.
+
+### 4. Viral Giveaway & Contest Architecture
+Design a high-ROI contest:
+- **Niche-Specific Prize**: Value proposition tailored exclusively to ideal customers (not generic electronics/cash).
+- **Entry Funnel**: Verified email signup (1 entry) -> Redirect to Thank-You Page with unique viral referral link.
+- **Viral Gamification**: +5 entries per friend who joins through referral link.
+- **Non-Winner Conversion Offer**: On announcement day, deliver a surprise 48-hour voucher to all non-winning participants.
+
+### 5. Pre-Emit Quality Self-Critique
+Before emitting pricing, promotions, or sale mechanics, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] Discount structure verified against gross margins to prevent profit erosion
+- [ ] Decoy Effect and price anchoring applied to 3-tier pricing setups
+- [ ] 72-hour promotional calendar contains hourly triggers for email, web banners, and ads
+- [ ] Giveaway prize is strictly relevant to dream customer avatar
+- [ ] Non-winner consolation offer included in contest design
+- [ ] Expiration deadlines and urgency mechanisms are explicit and realistic
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/references/workflows/social-growth.md

@@ -0,0 +1,65 @@
+# Workflow: social-growth
+
+One outcome: A comprehensive social media audit, a tactical 0-to-1,000 follower roadmap, platform-specific growth playbooks (Instagram, TikTok, LinkedIn B2B), or targeted hashtag architecture.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), and funnel stage (M3).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. Social Profile Audit & Conversion Architecture
+Audit the profile against conversion anchors:
+- **Handle & Name Field**: Contains primary searchable keywords (e.g. `@name | Next.js & SaaS Marketing`).
+- **Bio Formula (3 Lines)**:
+  - *Line 1 (Target & Result)*: Who you help + transformation delivered.
+  - *Line 2 (Authority & Proof)*: Key metric, credential, or recognizable client.
+  - *Line 3 (Lead Magnet CTA)*: Clear arrow pointing to link in bio.
+- **Link in Bio**: Single primary destination or cleanly organized hub.
+- **Story Highlights / Pinned Posts**: 3 pinned anchors: (1) Origin Story, (2) Case Study / Proof, (3) Core Offer.
+
+### 2. The 0-to-1,000 Follower Sprint (60-Day Action Plan)
+Break down the cold-start playbook without ad spend:
+- **Outbound Value Engagement (The $1.80 Strategy)**: Leave 10 insightful, high-value comments daily on top 10 creator accounts in your niche.
+- **Collaborative Flywheels**: Co-authoring carousel posts, podcast appearances, and live streams with peers at similar audience sizes (500-2,000 followers).
+- **Algorithmic Asset Ratio**: 70% short-form video (Reels/TikTok) for non-follower discovery + 30% carousels/stories for follower retention and conversion.
+
+### 3. LinkedIn B2B & Founder Personal Branding Playbook
+Using `../memory/platform-specs.md` and `../memory/lifecycle-flows.md`:
+- **Personal vs Company Page Split**: Position founder profile as the primary thought-leadership engine; use company page for verification, hiring, and ad retargeting.
+- **4 B2B Post Types**: Draft POV opinion posts, teardowns of client transformations, behind-the-build lessons, and tactical engagement questions.
+- **3-Touch Outbound InMail / DM Sequence**: Execute value-first connection request -> relevant social proof -> graceful soft CTA.
+
+### 4. Instagram & TikTok Growth Playbook
+Using `../memory/platform-specs.md`:
+- Script **5 Short-Form Video Hooks** with on-screen visual directions and pacing cues.
+- Define posting frequency and best times to publish.
+- Outline daily Story engagement sequence (Poll -> Question Box -> Behind-the-scenes -> Offer CTA).
+
+### 5. Hashtag & Search Keyword Taxonomy
+Generate a tiered hashtag block using the 3-Tier Rule:
+- 2 Broad Tier (Category scale)
+- 4 Niche Tier (Community focus)
+- 2 Micro / Branded Tier
+
+### 6. Pre-Emit Quality Self-Critique
+Before emitting social media playbooks or profile copy, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] Bio is optimized with clear target, authority proof, and single action CTA
+- [ ] Pinned content / highlights strategy covers About, Proof, and Offer
+- [ ] 0-to-1k plan includes daily outbound actions, not just passive posting
+- [ ] If B2B LinkedIn: Founder personal branding strategy and 3-touch outreach sequence defined
+- [ ] Short-form video scripts include visual hook direction in first 3 seconds
+- [ ] Hashtags adhere strictly to the 3-tier distribution rule (5-10 tags max)
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/references/workflows/viral-retention.md

@@ -0,0 +1,63 @@
+# Workflow: viral-retention
+
+One outcome: A complete customer retention diagnosis, loyalty program design (points/tiers/perks), 2-sided customer referral program, influencer outreach campaign, or brand awareness distribution engine.
+
+---
+
+## Execution Steps
+
+### 0. CDL Marketing Brief Resolution
+1. Check `.tidyfactor/marketing-brief.md`. If present, adopt established target market (M1), voice archetype (M2), and conversion model (M4).
+2. If absent and user prompt contains ambiguous parameters, run thin arbitration from `../memory/decision-points.md` (single-round batching, max 3 questions).
+3. If skip conditions apply, proceed immediately with conservative defaults.
+
+### 1. Customer Retention & Drop-Off Diagnosis
+Diagnose retention friction before designing loyalty incentives:
+- **SaaS / Subscription**: Diagnose time-to-first-value (onboarding "aha moment"), feature adoption drop-offs, and pre-renewal disengagement signals.
+- **E-Commerce / Retail**: Identify post-first-purchase drop-offs, lack of re-order triggers, and competitor price sensitivity.
+- **Service Businesses**: Address post-project check-in cadence, retainer transitions, and client relationship health.
+
+### 2. Loyalty Program Architecture (Matching Business Model)
+Select the optimal loyalty model:
+- **Points / Rewards**: For high-frequency, low-AOV purchases (retail, food, consumable goods).
+- **Tiered Status**: For businesses with a clear VIP heavy-user segment (Bronze / Silver / Gold).
+- **Perks-Based (No-Points)**: For early-stage brands and boutique SaaS (exclusive early access, free priority support/shipping, private community).
+- **Cashback / Store Credit**: Cleanest, lowest friction for general digital stores.
+
+### 3. Two-Sided Viral Referral Program Architecture
+Structure a self-sustaining referral loop:
+- **Incentive Structure (Give $X, Get $Y)**:
+  - *Inviter Reward*: $20 store credit / 1 free month / cash payout after referred friend's first purchase.
+  - *Invitee Reward*: 15% discount on their first order / extended 30-day trial.
+- **Trigger Touchpoints**: Post-purchase thank you page, positive NPS survey email (+7 to +14 days), inside user account dashboard.
+- **Gamified Milestones**: Unlock bonus tier rewards at 3, 5, and 10 successful referrals.
+
+### 4. Influencer Vetting & Cold Outreach Campaign
+Structure an influencer partnership pipeline:
+- **Vetting Criteria Scorecard**: Engagement Rate > 3.0%, comment authenticity, audience demographic alignment.
+- **Outreach Scripts (DM & Email)**: Personalized compliment on recent post + 1-sentence value proposition + zero-friction initial ask (gifting/sample).
+- **Compensation & Tracking**: Dedicated discount code (e.g. `INFLUENCER10`) + UTM tracking link.
+
+### 5. Brand Awareness & Organic Distribution Engine
+- **Podcast & Media Pitching**: 3 contrarian angles showcasing unique case studies.
+- **Co-Marketing**: Joint webinars, bundle drops, or newsletter swaps with complementary non-competing brands.
+- **Content Repurposing Flywheel**: 1 core long-form asset -> 5 short-form clips + 3 text posts + 1 newsletter.
+
+### 6. Pre-Emit Quality Self-Critique
+Before emitting loyalty programs, referral systems, or outreach scripts, evaluate against all 7 axes from `../memory/quality-bar.md` and stamp:
+```markdown
+/* Pre-emit critique: P5 H5 E5 S5 R5 V5 D5 */
+```
+
+---
+
+## Validation Checklist
+
+- [ ] CDL brief parameters resolved from `.tidyfactor/marketing-brief.md` or prompt defaults
+- [ ] Retention drop-off point diagnosed before prescribing loyalty mechanics
+- [ ] Loyalty model explicitly matches business model (Points vs Tiers vs Perks)
+- [ ] Referral loop defines concrete incentives for both the referrer and the new referee
+- [ ] Referral placement points mapped across customer journey (post-purchase, email, app dashboard)
+- [ ] Influencer vetting scorecard includes quantitative engagement and audience authenticity checks
+- [ ] Tracking mechanisms (UTMs, custom affiliate promo codes) defined for attribution
+- [ ] 7-Axis Quality Stamp included with scores >= 4/5

package/tools/build-skill.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+/**
+ * build-skill.js — packages the distributable Claude Skill (.skill file)
+ * for tidyfactor-marketing from the repo's single source of truth,
+ * and synchronizes across all target agent locations.
+ */
+
+const fs = require("fs");
+const path = require("path");
+const { execFileSync, spawnSync } = require("child_process");
+
+const ROOT = path.resolve(__dirname, "..");
+const SKILL_NAME = "tidyfactor-marketing";
+const DIST_DIR = path.join(ROOT, "dist");
+const STAGE_DIR = path.join(DIST_DIR, SKILL_NAME);
+
+const HOME = process.env.USERPROFILE || process.env.HOME;
+const AGENTS_SKILL = path.resolve(ROOT, "..", ".agents", "skills", SKILL_NAME);
+const GLOBAL_CONFIG_SKILL = path.join(HOME, ".gemini", "config", "skills", SKILL_NAME);
+
+const args = process.argv.slice(2);
+const outFlagIdx = args.indexOf("--out");
+const OUT_FILE =
+  outFlagIdx !== -1 && args[outFlagIdx + 1]
+    ? path.resolve(ROOT, args[outFlagIdx + 1])
+    : path.join(DIST_DIR, `${SKILL_NAME}.skill`);
+
+const ROOT_COPIES = [
+  "SKILL.md",
+  "references",
+  "tools",
+  "bin",
+  "assets",
+  "brand.json",
+  ".tidyfactor",
+  "package.json",
+  "AGENTS.md",
+  "README.md",
+  "README.ar.md",
+  "README.fa.md",
+  "README.es.md",
+  "README.pt.md",
+  "README.zh.md",
+  "README.de.md",
+  "README.fr.md",
+  "LICENSE",
+  "CHANGELOG.md",
+];
+
+const EXCLUDED_PATTERNS = [
+  /__pycache__/,
+  /\.pyc$/,
+  /\.DS_Store$/,
+  /Thumbs\.db$/,
+  /\.git/,
+];
+
+function log(msg) {
+  console.log(`[build-skill] ${msg}`);
+}
+
+function rmrf(p) {
+  if (fs.existsSync(p)) fs.rmSync(p, { recursive: true, force: true });
+}
+
+function shouldExclude(filePath) {
+  return EXCLUDED_PATTERNS.some((pattern) => pattern.test(filePath));
+}
+
+function copyFiltered(src, dest) {
+  if (!fs.existsSync(src)) return;
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    if (shouldExclude(src)) return;
+    fs.mkdirSync(dest, { recursive: true });
+    for (const file of fs.readdirSync(src)) {
+      copyFiltered(path.join(src, file), path.join(dest, file));
+    }
+  } else {
+    if (shouldExclude(src)) return;
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+function zipArchive(stagePath, outFile, cwdDir) {
+  log("zipping Claude skill archive...");
+  if (fs.existsSync(outFile)) fs.rmSync(outFile);
+
+  const stageBasename = path.basename(stagePath);
+
+  // 1. Try native zip
+  try {
+    execFileSync("zip", ["-r", "-q", outFile, stageBasename], {
+      cwd: cwdDir,
+      stdio: "inherit",
+    });
+    return;
+  } catch (err) {}
+
+  // 2. Try Python built-in zipfile module
+  try {
+    const pythonCmd = process.platform === "win32" ? "python" : "python3";
+    execFileSync(pythonCmd, ["-m", "zipfile", "-c", outFile, stageBasename], {
+      cwd: cwdDir,
+      stdio: "inherit",
+    });
+    return;
+  } catch (pyErr) {}
+
+  // 3. Try PowerShell Compress-Archive
+  try {
+    const tmpZip = outFile.replace(/\.(skill|zip)$/, ".zip");
+    if (fs.existsSync(tmpZip)) fs.rmSync(tmpZip);
+    const result = spawnSync(
+      "powershell",
+      [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `Compress-Archive -Path "${stagePath}" -DestinationPath "${tmpZip}" -Force`,
+      ],
+      { stdio: "inherit" }
+    );
+    if (result.status === 0) {
+      if (tmpZip !== outFile) {
+        fs.renameSync(tmpZip, outFile);
+      }
+      return;
+    }
+  } catch (winErr) {}
+
+  throw new Error("Failed to create zip archive via zip, Python, or PowerShell.");
+}
+
+function syncToTargetLocation(targetDir) {
+  log(`synchronizing to target location: ${targetDir}`);
+  rmrf(targetDir);
+  fs.mkdirSync(targetDir, { recursive: true });
+  for (const item of ROOT_COPIES) {
+    const src = path.join(ROOT, item);
+    const dest = path.join(targetDir, item);
+    if (fs.existsSync(src)) {
+      copyFiltered(src, dest);
+    }
+  }
+}
+
+function runIntegrityValidation() {
+  log("running release validation checks...");
+  const validatorScript = path.join(ROOT, "tools", "validate_skill.py");
+  if (fs.existsSync(validatorScript)) {
+    const pythonCmd = process.platform === "win32" ? "python" : "python3";
+    const res = spawnSync(pythonCmd, [validatorScript], { stdio: "inherit" });
+    if (res.status !== 0) {
+      throw new Error("Validation checks failed. Build aborted.");
+    }
+  }
+}
+
+function main() {
+  log(`repo root: ${ROOT}`);
+  
+  // 1. Run Pre-Build Validation
+  runIntegrityValidation();
+
+  log("cleaning previous build...");
+  rmrf(STAGE_DIR);
+  fs.mkdirSync(STAGE_DIR, { recursive: true });
+
+  log("staging single-source-of-truth files from repo root (filtered)...");
+  for (const name of ROOT_COPIES) {
+    const src = path.join(ROOT, name);
+    const dest = path.join(STAGE_DIR, name);
+    copyFiltered(src, dest);
+    log(`  + ${name}`);
+  }
+
+  const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf8"));
+  const versionedOutFile = path.join(DIST_DIR, `${SKILL_NAME}-v${pkg.version}.skill`);
+
+  fs.mkdirSync(path.dirname(OUT_FILE), { recursive: true });
+  zipArchive(STAGE_DIR, OUT_FILE, DIST_DIR);
+  fs.copyFileSync(OUT_FILE, versionedOutFile);
+
+  const sizeKb = (fs.statSync(OUT_FILE).size / 1024).toFixed(1);
+  log(`done → ${path.relative(ROOT, OUT_FILE)} (${sizeKb} KB)`);
+  log(`✓ Created versioned archive → ${path.relative(ROOT, versionedOutFile)}`);
+
+  // Auto-sync to Skills-LAB root if located inside Skills-LAB
+  const skillLabRoot = path.resolve(ROOT, "..");
+  if (path.basename(skillLabRoot) === "Skills-LAB") {
+    const skillLabTarget = path.join(skillLabRoot, `${SKILL_NAME}.skill`);
+    const skillLabVersionedTarget = path.join(skillLabRoot, `${SKILL_NAME}-v${pkg.version}.skill`);
+    fs.copyFileSync(OUT_FILE, skillLabTarget);
+    fs.copyFileSync(OUT_FILE, skillLabVersionedTarget);
+    log(`✓ Updated Skills-LAB root archives → ${SKILL_NAME}.skill & ${SKILL_NAME}-v${pkg.version}.skill`);
+  }
+
+  // Cross-Agent Synchronization
+  syncToTargetLocation(AGENTS_SKILL);
+  syncToTargetLocation(GLOBAL_CONFIG_SKILL);
+  log(`✓ Completed 4-way cross-agent synchronization across all target locations.`);
+}
+
+main();