format: apply repo prettier (3.8.1) to the folded skills tree

963 markdown files reformatted with the repository's pinned prettier so pnpm format:check covers the folded tree like every other repo file. The formatter's embedded-language pass also normalized code fences (TS semicolons, closed HTML tags in examples, lowercased CSS hex colors, one renumbered list that skipped an index). Alphanumeric token deltas vs the fold commit were audited file-by-file; all are formatter-equivalent markup normalizations plus the four sanitized skills.
2026-08-19 14:37:17 -05:00
parent d2eeb64433
commit 1a822493ba
962 changed files with 29594 additions and 27188 deletions
@@ -16,22 +16,26 @@ If `.mosaic/product-marketing-context.md` exists, read it before asking question
 Gather this context (ask if not provided):

 ### 1. Program Type
+
 - Customer referral program, affiliate program, or both?
 - B2B or B2C?
 - What's the average customer LTV?
 - What's your current CAC from other channels?

 ### 2. Current State
+
 - Existing referral/affiliate program?
 - Current referral rate (% who refer)?
 - What incentives have you tried?

 ### 3. Product Fit
+
 - Is your product shareable?
 - Does it have network effects?
 - Do customers naturally talk about it?

 ### 4. Resources
+
 - Tools/platforms you use or consider?
 - Budget for referral incentives?

@@ -42,11 +46,13 @@ Gather this context (ask if not provided):
 ### Customer Referral Programs

 **Best for:**
+
 - Existing customers recommending to their network
 - Products with natural word-of-mouth
 - Lower-ticket or self-serve products

 **Characteristics:**
+
 - Referrer is an existing customer
 - One-time or limited rewards
 - Higher trust, lower volume
@@ -54,11 +60,13 @@ Gather this context (ask if not provided):
 ### Affiliate Programs

 **Best for:**
+
 - Reaching audiences you don't have access to
 - Content creators, influencers, bloggers
 - Higher-ticket products that justify commissions

 **Characteristics:**
+
 - Affiliates may not be customers
 - Ongoing commission relationship
 - Higher volume, variable trust
@@ -76,6 +84,7 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
 ### Step 1: Identify Trigger Moments

 **High-intent moments:**
+
 - Right after first "aha" moment
 - After achieving a milestone
 - After exceptional support
@@ -84,6 +93,7 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
 ### Step 2: Design Share Mechanism

 **Ranked by effectiveness:**
+
 1. In-product sharing (highest conversion)
 2. Personalized link
 3. Email invitation
@@ -107,12 +117,14 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
 ### Improving Referral Rate

 **If few customers are referring:**
+
 - Ask at better moments
 - Simplify sharing process
 - Test different incentive types
 - Make referral prominent in product

 **If referrals aren't converting:**
+
 - Improve landing experience for referred users
 - Strengthen incentive for new users
 - Ensure referrer's endorsement is visible
@@ -127,13 +139,13 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)

 ### Common Problems & Fixes

-| Problem | Fix |
-|---------|-----|
-| Low awareness | Add prominent in-app prompts |
-| Low share rate | Simplify to one click |
-| Low conversion | Optimize referred user experience |
-| Fraud/abuse | Add verification, limits |
-| One-time referrers | Add tiered/gamified rewards |
+| Problem            | Fix                               |
+| ------------------ | --------------------------------- |
+| Low awareness      | Add prominent in-app prompts      |
+| Low share rate     | Simplify to one click             |
+| Low conversion     | Optimize referred user experience |
+| Fraud/abuse        | Add verification, limits          |
+| One-time referrers | Add tiered/gamified rewards       |

 ---

@@ -142,11 +154,13 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
 ### Key Metrics

 **Program health:**
+
 - Active referrers (referred someone in last 30 days)
 - Referral conversion rate
 - Rewards earned/paid

 **Business impact:**
+
 - % of new customers from referrals
 - CAC via referral vs. other channels
 - LTV of referred customers
@@ -163,6 +177,7 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
 ## Launch Checklist

 ### Before Launch
+
 - [ ] Define program goals and success metrics
 - [ ] Design incentive structure
 - [ ] Build or configure referral tool
@@ -173,12 +188,14 @@ Trigger Moment → Share Action → Convert Referred → Reward → (Loop)
 - [ ] Test complete referral flow

 ### Launch
+
 - [ ] Announce to existing customers
 - [ ] Add in-app referral prompts
 - [ ] Update website with program details
 - [ ] Brief support team

 ### Post-Launch (First 30 Days)
+
 - [ ] Review conversion funnel
 - [ ] Identify top referrers
 - [ ] Gather feedback
@@ -236,13 +253,13 @@ They get [their reward] too.

 For implementation, see the [tools registry](../../tools/REGISTRY.md). Key tools for referral programs:

-| Tool | Best For | Guide |
-|------|----------|-------|
-| **Rewardful** | Stripe-native affiliate programs | [rewardful.md](../../tools/integrations/rewardful.md) |
-| **Tolt** | SaaS affiliate programs | [tolt.md](../../tools/integrations/tolt.md) |
-| **Mention Me** | Enterprise referral programs | [mention-me.md](../../tools/integrations/mention-me.md) |
-| **Dub.co** | Link tracking and attribution | [dub-co.md](../../tools/integrations/dub-co.md) |
-| **Stripe** | Payment processing (for commission tracking) | [stripe.md](../../tools/integrations/stripe.md) |
+| Tool           | Best For                                     | Guide                                                   |
+| -------------- | -------------------------------------------- | ------------------------------------------------------- |
+| **Rewardful**  | Stripe-native affiliate programs             | [rewardful.md](../../tools/integrations/rewardful.md)   |
+| **Tolt**       | SaaS affiliate programs                      | [tolt.md](../../tools/integrations/tolt.md)             |
+| **Mention Me** | Enterprise referral programs                 | [mention-me.md](../../tools/integrations/mention-me.md) |
+| **Dub.co**     | Link tracking and attribution                | [dub-co.md](../../tools/integrations/dub-co.md)         |
+| **Stripe**     | Payment processing (for commission tracking) | [stripe.md](../../tools/integrations/stripe.md)         |

 ---

@@ -5,21 +5,25 @@ Detailed guidance for building and managing affiliate programs.
 ## Commission Structures

 **Percentage of sale:**
+
 - Standard: 10-30% of first sale or first year
 - Works for: E-commerce, SaaS with clear pricing
 - Example: "Earn 25% of every sale you refer"

 **Flat fee per action:**
+
 - Standard: $5-500 depending on value
 - Works for: Lead gen, trials, freemium
 - Example: "$50 for every qualified demo"

 **Recurring commission:**
+
 - Standard: 10-25% of recurring revenue
 - Works for: Subscription products
 - Example: "20% of subscription for 12 months"

 **Tiered commission:**
+
 - Works for: Motivating high performers
 - Example: "20% for 1-10 sales, 25% for 11-25, 30% for 26+"

@@ -29,19 +33,20 @@ Detailed guidance for building and managing affiliate programs.

 How long after click does affiliate get credit?

-| Duration | Use Case |
-|----------|----------|
-| 24 hours | High-volume, low-consideration purchases |
-| 7-14 days | Standard e-commerce |
-| 30 days | Standard SaaS/B2B |
-| 60-90 days | Long sales cycles, enterprise |
-| Lifetime | Premium affiliate relationships |
+| Duration   | Use Case                                 |
+| ---------- | ---------------------------------------- |
+| 24 hours   | High-volume, low-consideration purchases |
+| 7-14 days  | Standard e-commerce                      |
+| 30 days    | Standard SaaS/B2B                        |
+| 60-90 days | Long sales cycles, enterprise            |
+| Lifetime   | Premium affiliate relationships          |

 ---

 ## Affiliate Recruitment

 ### Where to find affiliates:
+
 - Existing customers who create content
 - Industry bloggers and reviewers
 - YouTubers in your niche
@@ -50,6 +55,7 @@ How long after click does affiliate get credit?
 - Consultants and agencies

 ### Outreach template:
+
 ```
 Subject: Partnership opportunity — [Your Product]

@@ -71,6 +77,7 @@ Would you be open to learning more?
 ## Affiliate Enablement

 Provide affiliates with:
+
 - [ ] Unique tracking links/codes
 - [ ] Product overview and key benefits
 - [ ] Target audience description
@@ -89,6 +96,7 @@ Provide affiliates with:
 ### Referral Program Tools

 **Full-featured platforms:**
+
 - ReferralCandy — E-commerce focused
 - Ambassador — Enterprise referral programs
 - Friendbuy — E-commerce and subscription
@@ -97,6 +105,7 @@ Provide affiliates with:
 - Viral Loops — Template-based campaigns

 **Built-in options:**
+
 - Stripe (basic referral tracking)
 - HubSpot (CRM-integrated)
 - Segment (tracking and analytics)
@@ -104,6 +113,7 @@ Provide affiliates with:
 ### Affiliate Program Tools

 **Affiliate networks:**
+
 - ShareASale — Large merchant network
 - Impact — Enterprise partnerships
 - PartnerStack — SaaS focused
@@ -111,12 +121,14 @@ Provide affiliates with:
 - FirstPromoter — SaaS affiliate management

 **Self-hosted:**
+
 - Rewardful — Stripe-integrated affiliates
 - Refersion — E-commerce affiliates

 ### Choosing a Tool

 Consider:
+
 - Integration with your payment system
 - Fraud detection capabilities
 - Payout management
@@ -129,6 +141,7 @@ Consider:
 ## Fraud Prevention

 ### Common Referral Fraud
+
 - Self-referrals (creating fake accounts)
 - Referral rings (groups referring each other)
 - Coupon sites posting referral codes
@@ -138,6 +151,7 @@ Consider:
 ### Prevention Measures

 **Technical:**
+
 - Email verification required
 - Device fingerprinting
 - IP address monitoring
@@ -145,12 +159,14 @@ Consider:
 - Minimum activity threshold

 **Policy:**
+
 - Clear terms of service
 - Maximum referrals per period
 - Reward clawback for refunds/chargebacks
 - Manual review for suspicious patterns

 **Structural:**
+
 - Require referred user to take meaningful action
 - Cap lifetime rewards
 - Pay rewards in product credit (less attractive to fraudsters)
@@ -7,6 +7,7 @@ Real-world examples of successful referral programs.
 **Program:** Give 500MB storage, get 500MB storage

 **Why it worked:**
+
 - Reward directly tied to product value
 - Low friction (just an email)
 - Both parties benefit equally
@@ -19,6 +20,7 @@ Real-world examples of successful referral programs.
 **Program:** Give $10 ride credit, get $10 when they ride

 **Why it worked:**
+
 - Immediate, clear value
 - Double-sided incentive
 - Easy to share (code/link)
@@ -29,12 +31,14 @@ Real-world examples of successful referral programs.
 ## Morning Brew

 **Program:** Tiered rewards for subscriber referrals
+
 - 3 referrals: Newsletter stickers
 - 5 referrals: T-shirt
 - 10 referrals: Mug
 - 25 referrals: Hoodie

 **Why it worked:**
+
 - Gamification drives ongoing engagement
 - Physical rewards are shareable (more referrals)
 - Low cost relative to subscriber value
@@ -47,6 +51,7 @@ Real-world examples of successful referral programs.
 **Program:** $10 credit per referral (education)

 **Why it worked:**
+
 - Targeted high-sharing audience (students)
 - Product naturally spreads in teams
 - Credit keeps users engaged
@@ -55,31 +60,34 @@ Real-world examples of successful referral programs.

 ## Incentive Types Comparison

-| Type | Pros | Cons | Best For |
-|------|------|------|----------|
-| Cash/credit | Universally valued | Feels transactional | Marketplaces, fintech |
-| Product credit | Drives usage | Only valuable if they'll use it | SaaS, subscriptions |
-| Free months | Clear value | May attract freebie-seekers | Subscription products |
-| Feature unlock | Low cost to you | Only works for gated features | Freemium products |
-| Swag/gifts | Memorable, shareable | Logistics complexity | Brand-focused companies |
-| Charity donation | Feel-good | Lower personal motivation | Mission-driven brands |
+| Type             | Pros                 | Cons                            | Best For                |
+| ---------------- | -------------------- | ------------------------------- | ----------------------- |
+| Cash/credit      | Universally valued   | Feels transactional             | Marketplaces, fintech   |
+| Product credit   | Drives usage         | Only valuable if they'll use it | SaaS, subscriptions     |
+| Free months      | Clear value          | May attract freebie-seekers     | Subscription products   |
+| Feature unlock   | Low cost to you      | Only works for gated features   | Freemium products       |
+| Swag/gifts       | Memorable, shareable | Logistics complexity            | Brand-focused companies |
+| Charity donation | Feel-good            | Lower personal motivation       | Mission-driven brands   |

 ---

 ## Incentive Sizing Framework

 **Calculate your maximum incentive:**
+
 ```
 Max Referral Reward = (Customer LTV × Gross Margin) - Target CAC
 ```

 **Example:**
+
 - LTV: $1,200
 - Gross margin: 70%
 - Target CAC: $200
 - Max reward: ($1,200 × 0.70) - $200 = $640

 **Typical referral rewards:**
+
 - B2C: $10-50 or 10-25% of first purchase
 - B2B SaaS: $50-500 or 1-3 months free
 - Enterprise: Higher, often custom
@@ -91,6 +99,7 @@ Max Referral Reward = (Customer LTV × Gross Margin) - Target CAC
 ### Key Metrics

 **Viral coefficient (K-factor):**
+
 ```
 K = Invitations × Conversion Rate

@@ -99,16 +108,19 @@ K < 1 = Amplified growth (referrals supplement other acquisition)
 ```

 **Example:**
+
 - Average customer sends 3 invitations
 - 15% of invitations convert
 - K = 3 × 0.15 = 0.45

 **Referral rate:**
+
 ```
 Referral Rate = (Customers who refer) / (Total customers)
 ```

 Benchmarks:
+
 - Good: 10-25% of customers refer
 - Great: 25-50%
 - Exceptional: 50%+
@@ -116,6 +128,7 @@ Benchmarks:
 **Referrals per referrer:**

 Benchmarks:
+
 - Average: 1-2 referrals per referrer
 - Good: 2-5
 - Exceptional: 5+
@@ -129,6 +142,7 @@ Program costs = Rewards paid + Tool costs + Management time
 ```

 **Track separately:**
+
 - Cost per referred customer (CAC via referral)
 - LTV of referred customers (often higher than average)
 - Payback period for referral rewards