@hienlh/ppm 0.9.81 → 0.9.82

package/.opencode/skills/react-best-practices/rules/server-serialization.md

@@ -1,38 +0,0 @@
----
-title: Minimize Serialization at RSC Boundaries
-impact: HIGH
-impactDescription: reduces data transfer size
-tags: server, rsc, serialization, props
----
-
-## Minimize Serialization at RSC Boundaries
-
-The React Server/Client boundary serializes all object properties into strings and embeds them in the HTML response and subsequent RSC requests. This serialized data directly impacts page weight and load time, so **size matters a lot**. Only pass fields that the client actually uses.
-
-**Incorrect (serializes all 50 fields):**
-
-```tsx
-async function Page() {
-  const user = await fetchUser()  // 50 fields
-  return <Profile user={user} />
-}
-
-'use client'
-function Profile({ user }: { user: User }) {
-  return <div>{user.name}</div>  // uses 1 field
-}
-```
-
-**Correct (serializes only 1 field):**
-
-```tsx
-async function Page() {
-  const user = await fetchUser()
-  return <Profile name={user.name} />
-}
-
-'use client'
-function Profile({ name }: { name: string }) {
-  return <div>{name}</div>
-}
-```

package/.opencode/skills/referral-program-building/SKILL.md

@@ -1,81 +0,0 @@
----
-name: ckm:referral-program-building
-description: Build referral programs for SaaS/digital products. Covers reward structures (two-sided, tiered, multi-step), platform selection (Rewardful, ReferralCandy, Viral Loops, FirstPromoter), technical implementation (tracking, attribution, API patterns), fraud prevention, email templates, and KPI metrics. Use for designing viral growth loops, implementing refer-a-friend features, or optimizing existing referral systems.
-argument-hint: "[product or program-type]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-# Referral Program Building
-
-Build viral referral programs that drive 2-3x higher conversion rates with 37% better retention.
-
-## Quick Start
-
-1. **Define Program Type** - Choose reward structure matching business model
-2. **Select Platform** - Pick tool based on scale and integration needs
-3. **Implement Tracking** - Set up attribution, fraud prevention, analytics
-4. **Launch & Optimize** - Soft launch, measure KPIs, iterate
-
-## Core Principles
-
-- **Two-Sided Rewards:** Both referrer AND referee get incentives (68% higher participation)
-- **Product Alignment:** Use product as reward when possible (Dropbox model)
-- **Integration:** Embed in user workflow, not separate feature
-- **Simplicity:** Explain in 2-3 bullet points or it's too complex
-
-## References
-
-### Strategy & Design
-- [Reward Structures](references/reward-structures.md) - Incentive types, tiered rewards, real-world examples
-- [Platform Selection](references/platform-selection.md) - Rewardful vs ReferralCandy vs Viral Loops comparison
-
-### Implementation
-- [Technical Guide](references/technical-implementation.md) - Database schema, API patterns, attribution
-- [Fraud Prevention](references/fraud-prevention.md) - Detection mechanisms, validation rules
-
-### Operations
-- [Email Templates](references/email-templates.md) - Program intro, reminders, reward fulfillment
-- [Metrics & KPIs](references/metrics-tracking.md) - Participation rate, ROI, CLV tracking
-
-## Platform Quick Reference
-
-| Platform | Best For | Price | Setup |
-|----------|----------|-------|-------|
-| Rewardful | SaaS subscriptions | $49/mo | 1 hour |
-| ReferralCandy | Ecommerce | $49/mo | 1-click |
-| Viral Loops | Custom campaigns | Custom | Visual builder |
-| FirstPromoter | Recurring commissions | Custom | Dashboard |
-| Voucherify | Enterprise API-first | Custom | API integration |
-
-## Key Metrics
-
-- **Participation Rate:** Target 5-9%
-- **Referral Rate:** Target 5-10% (avg 2.3%)
-- **CAC via Referral:** Should be 30-50% lower than other channels
-- **Referred CLV:** 16-25% higher than non-referred
-- **Program ROI:** Successful programs see 3:1 to 5:1
-
-## Case Study Insights
-
-**Dropbox (3900% Growth):**
-- Product-aligned reward (500MB storage)
-- Integrated into onboarding step 6
-- Both parties benefit equally
-
-**PayPal (100M Users):**
-- $20+$20 aggressive cash incentives
-- Aligned with payment product
-- 7-10% daily growth rate
-
-**Airbnb (900% YoY):**
-- Altruistic messaging outperformed selfish
-- Mobile-first optimization
-- Data-driven A/B testing everything
-
-## Report Output
-
-**Activate:** `assets-organizing` skill for report file paths
-
-Referral reports go to `assets/reports/performance/{date}-referral-program.md`

package/.opencode/skills/referral-program-building/references/email-templates.md

@@ -1,75 +0,0 @@
-# Email Templates
-
-## 1. Program Introduction
-**Timing:** After first purchase/engagement
-```
-Subject: You get $25, they get $25 - Share [Product]
-
-Hey {{name}},
-Love [Product]? Your friends will too.
-Share your unique link:
-→ You get: $25 credit → They get: $25 off
-[Share Your Link Button]
-Track your referrals: [Dashboard Link]
-```
-
-## 2. Post-Purchase
-**Timing:** Order confirmation/delivery
-```
-Subject: Know someone who'd love this?
-Hey {{name}},
-Thanks for your order! Share [Product] with friends:
-• You earn $20 for each friend
-• They get 20% off first order
-[Invite Friends Button]
-Your referral code: {{referral_code}}
-```
-
-## 3. Reminder (Non-Participants)
-**Timing:** 7-14 days after intro
-```
-Subject: $50 is waiting for you
-Hey {{name}},
-Quick reminder - you have rewards to claim.
-1,234 customers earned $45,000 this month.
-→ Share your link → Friends save 20% → You earn $25 per friend
-[Start Earning Button]
-```
-
-## 4. Progress Update
-**Timing:** Weekly for active referrers
-```
-Subject: You're 2 away from $100 bonus!
-{{name}}, your referral update:
-This Week: 3 signups, $75 earned, 2 more for milestone
-Your Referrals:
-✓ Sarah - Converted - $25
-✓ Mike - Converted - $25
-⏳ Alex - Pending signup
-[Share More Button]
-```
-
-## 5. Reward Fulfillment
-**Timing:** Immediately when earned
-```
-Subject: $25 just hit your account!
-Congrats {{name}}!
-{{friend_name}} just signed up. $25 credit added.
-Total earned: $150 | Next milestone: $200 (2 more)
-[Share Your Link Button]
-```
-
-## Subject Lines (High Performers)
-- "You get $50, they get $20 off"
-- "3 friends signed up! Here's your $75"
-- "Don't leave $100 on the table"
-- "{{friend_name}} just used your link"
-
-**Avoid:** "Exciting opportunity", "Invite friends today", generic lines
-
-## Best Practices
-- Lead with THEIR benefit, not yours
-- Clear "you get/they get" messaging
-- Single prominent CTA button
-- Mobile-optimized (short lines, large buttons)
-- Send at engagement peaks, not random times

package/.opencode/skills/referral-program-building/references/fraud-prevention.md

@@ -1,95 +0,0 @@
-# Fraud Prevention
-
-## Detection Mechanisms
-
-### Device Fingerprinting
-- Capture browser/device details
-- Flag multiple accounts from same device
-- Use libraries: FingerprintJS, ClientJS
-
-### IP Address Tracking
-```javascript
-// Flag high volumes from single IP
-const ipCounts = await db.query(`
-  SELECT ip_address, COUNT(*) as signups
-  FROM referral_clicks
-  WHERE click_timestamp > NOW() - INTERVAL '24 hours'
-  GROUP BY ip_address
-  HAVING COUNT(*) > 5
-`);
-```
-
-**Block lists:**
-- Data center IPs
-- Known VPN providers
-- Tor exit nodes
-- CIDR ranges for suspicious blocks
-
-### Email Validation
-- Block disposable email domains (Mailinator, Guerrillamail, etc.)
-- Verify domain reputation (check MX records)
-- Flag pattern anomalies (random strings)
-
-### Velocity Checks
-- Max signups per IP per hour
-- Max referrals per user per day
-- Conversion rate monitoring per referrer
-
-## Prevention Tactics
-
-### Reward Delay
-Issue rewards 7-14 days after conversion:
-```javascript
-// Schedule reward payout
-await scheduleReward({
-  referralId,
-  payoutDate: addDays(conversionDate, 7),
-  status: 'pending_review'
-});
-```
-
-### Multi-Step Rewards
-Reward at action milestones, not just signup:
-1. Signup → Nothing yet
-2. Complete onboarding → $5
-3. First purchase → $15
-
-### Self-Referral Block
-```javascript
-// Prevent self-referral
-if (referrer.email.split('@')[1] === referee.email.split('@')[1]) {
-  return { error: 'Same email domain not allowed' };
-}
-if (referrer.ip === referee.ip && !isTrustedIP(ip)) {
-  return { error: 'Suspicious activity detected' };
-}
-```
-
-### Manual Approval Queue
-Flag suspicious referrals for review:
-- Rapid signups (>3 in 1 hour)
-- Similar email patterns
-- Same payment method
-- High-velocity referrers
-
-## Fraud Scoring Model
-
-```javascript
-let fraudScore = 0;
-
-if (sameIP) fraudScore += 30;
-if (disposableEmail) fraudScore += 40;
-if (sameDevice) fraudScore += 35;
-if (rapidSignups) fraudScore += 25;
-if (vpnDetected) fraudScore += 20;
-
-if (fraudScore > 50) {
-  await flagForReview(referralId);
-}
-```
-
-## Platform Solutions
-
-- **SaaSquatch:** IP blocking, disposable email detection
-- **Prefinery:** Device fingerprinting, rate limiting
-- **Voucherify:** Custom rule engine for fraud detection

package/.opencode/skills/referral-program-building/references/metrics-tracking.md

@@ -1,64 +0,0 @@
-# Metrics & KPI Tracking
-
-## Core Metrics
-
-### Participation Rate
-**Formula:** `(Customers who shared / Total customers) × 100`
-**Target:** 5-9% | **Action if low:** Simplify, improve visibility, test incentives
-
-### Referral Rate
-**Formula:** `(Referred customers / Total customers) × 100`
-**Target:** 5-10% (avg: 2.3%) | **Action if low:** Extend attribution, improve conversion
-
-### Conversion Rate
-**Formula:** `(Converted referrals / Total clicks) × 100`
-**Benchmark:** 2-3x higher than non-referral
-
-## Financial Metrics
-
-| Metric | Formula | Target |
-|--------|---------|--------|
-| CAC via Referral | Rewards / Acquired | 30-50% lower than other channels |
-| Referred CLV | Cohort comparison | 16-25% higher LTV |
-| Program ROI | (Revenue - Incentives) / Incentives | 3:1 to 5:1 |
-
-## Monitoring Query
-
-```sql
-SELECT DATE(created_at) as date,
-  COUNT(*) as total,
-  COUNT(CASE WHEN status='converted' THEN 1 END) as conversions,
-  SUM(reward_amount) as rewards_paid
-FROM referrals
-WHERE created_at > NOW() - INTERVAL '30 days'
-GROUP BY DATE(created_at) ORDER BY date DESC;
-```
-
-## Health Checks
-
-| Metric | Warning | Critical |
-|--------|---------|----------|
-| Participation | <3% | <1% |
-| Conversion | <10% | <5% |
-| Fraud rate | >3% | >5% |
-| Reward fulfillment | <95% | <90% |
-
-## Review Cadence
-- **Weekly:** Participation, fraud flags, top referrers
-- **Monthly:** ROI, A/B tests, channel performance
-- **Quarterly:** CLV comparison, structure optimization
-
-## Attribution Windows
-| Sales Cycle | Window |
-|-------------|--------|
-| Consumer | 30 days |
-| SaaS trial | 60 days |
-| B2B enterprise | 90+ days |
-
-## Power User Query
-```sql
-SELECT user_id, COUNT(*) as count, SUM(reward_amount) as earned
-FROM referrals WHERE status='converted'
-GROUP BY user_id ORDER BY count DESC LIMIT 100;
-```
-Top 10% referrers often drive 80%+ of referral revenue.

package/.opencode/skills/referral-program-building/references/platform-selection.md

@@ -1,80 +0,0 @@
-# Referral Platform Selection
-
-## Quick Decision Tree
-
-```
-SaaS + Stripe/Paddle? → Rewardful
-Ecommerce + Shopify? → ReferralCandy
-Custom campaigns/contests? → Viral Loops
-Recurring commissions? → FirstPromoter
-Enterprise + custom rules? → Voucherify
-Full control needed? → Build custom
-```
-
-## Platform Comparison
-
-### Rewardful
-- **Best for:** SaaS subscriptions
-- **Price:** $49-500/mo
-- **Setup:** 5-10 minutes, no coding
-- **Integrations:** Stripe, Paddle, Gumroad
-- **Strengths:** Simplest SaaS setup, affiliate+referral blend
-- **Weaknesses:** Limited customization
-- **Users:** ConvertKit, Segment
-
-### ReferralCandy
-- **Best for:** Ecommerce/physical products
-- **Price:** $49-3999/mo
-- **Setup:** 1-click native plugins
-- **Integrations:** Shopify, WooCommerce, BigCommerce
-- **Strengths:** Long-established, proven at scale
-- **Weaknesses:** Less flexible for SaaS, legacy feel
-
-### Viral Loops
-- **Best for:** Custom campaigns, growth teams
-- **Price:** Custom pricing (~$500+/mo)
-- **Setup:** Visual builder, 15+ templates
-- **Integrations:** Shopify, Webflow, WordPress, email platforms
-- **Strengths:** Flexibility, contests, leaderboards, gamification
-- **Weaknesses:** Steeper learning curve
-
-### FirstPromoter
-- **Best for:** Subscription businesses
-- **Price:** Custom pricing
-- **Setup:** Dashboard-based configuration
-- **Integrations:** Multiple payment platforms
-- **Strengths:** Recurring commission tracking, native email
-- **Weaknesses:** More complex than Rewardful
-
-### Voucherify
-- **Best for:** Enterprise, API-first
-- **Price:** Custom (enterprise)
-- **Setup:** API integration, SDKs available
-- **Integrations:** 100+ integrations
-- **Strengths:** Maximum flexibility, custom rules, fraud detection
-- **Weaknesses:** Requires technical implementation
-
-## Build vs Buy Decision
-
-**Build Custom When:**
-- Unique business logic requirements
-- Deep payment integration needed
-- White-label experience required
-- Have 3-4 weeks engineering capacity
-- Budget: $20-50k development
-
-**Buy Platform When:**
-- Standard referral mechanics
-- Time-to-market priority
-- Limited engineering resources
-- Budget: $50-500/mo
-
-## Integration Checklist
-
-- [ ] Payment provider compatibility (Stripe, Paddle, etc.)
-- [ ] Existing tech stack integration
-- [ ] Email platform connection
-- [ ] Analytics/tracking setup
-- [ ] Fraud detection capabilities
-- [ ] Dashboard/reporting needs
-- [ ] Mobile app support (if applicable)

package/.opencode/skills/referral-program-building/references/reward-structures.md

@@ -1,82 +0,0 @@
-# Reward Structures
-
-## Two-Sided Incentives (Recommended)
-
-Both referrer AND referee receive rewards - drives 68% higher participation.
-
-**Patterns:**
-- Symmetric: "Give $20, Get $20" - Equal value both sides
-- Asymmetric: "Give $100 to friend, Get $50" - Higher recipient incentive
-- Product: "Both get 500MB storage" - Marginal cost, high perceived value
-
-## Tiered/Milestone Rewards
-
-Progression model encourages ongoing participation:
-
-```
-Tier 1: 1 referral  → $10 discount
-Tier 2: 3 referrals → Free product
-Tier 3: 5 referrals → $50 gift card
-Tier 4: 10 referrals → Premium membership
-```
-
-**Example (Harry's):**
-- 5 refs → Free shave cream
-- 10 refs → Free razor
-- 25 refs → Premium razor
-- 50 refs → Year of free shaving
-
-## Multi-Step Rewards
-
-Reward at conversion milestones, not just signup:
-
-```
-$10 when referral schedules demo
-$10 when they complete onboarding
-$25 when they submit payment
-```
-
-**Benefits:** Reduces fraud, ensures genuine value, aligns with customer journey.
-
-## Reward Type Comparison
-
-| Type | Best For | Cost | Fraud Risk |
-|------|----------|------|------------|
-| Product credits | SaaS, cloud | Low (marginal) | Low |
-| Cash/PayPal | Fintech | High (direct) | Medium |
-| Discounts | Ecommerce | Medium | Medium |
-| Gift cards | Retail | Medium | Medium |
-| Free product | Physical goods | High | Low |
-| VIP status | B2B, loyalty | Low | Very low |
-
-## Real-World Examples
-
-**Dropbox:**
-- 500MB per referral (both parties)
-- Max 16GB earnable
-- Marginal cost, massive perceived value
-
-**ASOS:**
-- Referrer: 20% discount
-- Referee: 20% discount
-- Simple, equal incentive
-
-**Dia & Co:**
-- Both get $25
-- Result: 40K shares month 1, 22 conversions/day
-
-## Best Practices
-
-1. **Non-cash > Cash:** 24% more effective at driving referrals
-2. **Product alignment:** Rewards should match what you sell
-3. **Clear messaging:** "You get X, they get Y" - no ambiguity
-4. **Test amounts:** A/B test different reward values
-5. **Cap fraud risk:** Multi-step or delayed rewards
-
-## Anti-Patterns
-
-- Single-sided rewards (only referrer benefits)
-- Complex rules requiring explanation
-- Rewards too small to motivate sharing
-- Cash rewards for non-financial products
-- No cap on self-referral abuse

package/.opencode/skills/referral-program-building/references/technical-implementation.md

@@ -1,98 +0,0 @@
-# Technical Implementation
-
-## Database Schema
-
-### Users Table
-```sql
-CREATE TABLE users (
-  id UUID PRIMARY KEY,
-  email VARCHAR(255) UNIQUE,
-  referral_code VARCHAR(14) UNIQUE,
-  referred_by_id UUID REFERENCES users(id),
-  created_at TIMESTAMP DEFAULT NOW()
-);
-CREATE INDEX idx_referral_code ON users(referral_code);
-```
-
-### Referrals Table
-```sql
-CREATE TABLE referrals (
-  id UUID PRIMARY KEY,
-  referrer_id UUID REFERENCES users(id),
-  referee_id UUID REFERENCES users(id),
-  status VARCHAR(20) DEFAULT 'pending', -- pending, converted, paid
-  reward_amount DECIMAL(10,2),
-  conversion_timestamp TIMESTAMP,
-  created_at TIMESTAMP DEFAULT NOW()
-);
-CREATE INDEX idx_referrer ON referrals(referrer_id);
-```
-
-### Tracking Table
-```sql
-CREATE TABLE referral_clicks (
-  id UUID PRIMARY KEY,
-  referral_code VARCHAR(14),
-  ip_address INET,
-  device_fingerprint VARCHAR(255),
-  click_timestamp TIMESTAMP DEFAULT NOW(),
-  converted BOOLEAN DEFAULT FALSE
-);
-```
-
-## API Endpoints
-
-```
-POST /api/referrals/generate
-  → { referral_code, referral_url, share_urls }
-
-GET /api/users/:id/referrals
-  → { referrals: [], stats: { total, converted, pending } }
-
-POST /api/referrals/apply
-  Body: { referral_code, email }
-  → { success, message, discount_applied }
-
-POST /api/referrals/:id/convert
-  → { success, reward_issued }
-```
-
-## Referral Code Generation
-
-```javascript
-// Generate unique 10-char alphanumeric code
-function generateReferralCode() {
-  const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';
-  let code = '';
-  for (let i = 0; i < 10; i++) {
-    code += chars.charAt(Math.floor(Math.random() * chars.length));
-  }
-  return code;
-}
-```
-
-## Attribution Tracking
-
-**Cookie-Based (Web):**
-```javascript
-// On referral link click
-const urlParams = new URLSearchParams(window.location.search);
-const refCode = urlParams.get('ref');
-if (refCode) {
-  document.cookie = `ref=${refCode}; max-age=${90*24*60*60}; path=/`;
-}
-```
-
-**Attribution Window:** 30-90 days typical (longer for enterprise sales cycles)
-
-## URL Patterns
-
-- Direct: `https://app.com?ref=ABC123`
-- UTM: `?utm_source=referral&utm_campaign=user123`
-- Subdomain: `https://invite.app.com/ABC123`
-
-## Mobile Considerations
-
-- **Android:** Play Install Referrer API
-- **iOS:** SKAdNetwork (privacy-limited)
-- **Deep linking:** Firebase Dynamic Links for deferred attribution

package/.opencode/skills/remotion/SKILL.md

@@ -1,45 +0,0 @@
----
-name: ck:remotion
-description: Best practices for Remotion - Video creation in React
-argument-hint: "[video or component]"
-metadata:
-  author: claudekit
-  version: "1.0.0"
----
-
-## When to use
-
-Use this skills whenever you are dealing with Remotion code to obtain the domain-specific knowledge.
-
-## How to use
-
-Read individual rule files for detailed explanations and code examples:
-
-- [rules/3d.md](rules/3d.md) - 3D content in Remotion using Three.js and React Three Fiber
-- [rules/animations.md](rules/animations.md) - Fundamental animation skills for Remotion
-- [rules/assets.md](rules/assets.md) - Importing images, videos, audio, and fonts into Remotion
-- [rules/audio.md](rules/audio.md) - Using audio and sound in Remotion - importing, trimming, volume, speed, pitch
-- [rules/calculate-metadata.md](rules/calculate-metadata.md) - Dynamically set composition duration, dimensions, and props
-- [rules/can-decode.md](rules/can-decode.md) - Check if a video can be decoded by the browser using Mediabunny
-- [rules/charts.md](rules/charts.md) - Chart and data visualization patterns for Remotion
-- [rules/compositions.md](rules/compositions.md) - Defining compositions, stills, folders, default props and dynamic metadata
-- [rules/display-captions.md](rules/display-captions.md) - Displaying captions in Remotion with TikTok-style pages and word highlighting
-- [rules/extract-frames.md](rules/extract-frames.md) - Extract frames from videos at specific timestamps using Mediabunny
-- [rules/fonts.md](rules/fonts.md) - Loading Google Fonts and local fonts in Remotion
-- [rules/get-audio-duration.md](rules/get-audio-duration.md) - Getting the duration of an audio file in seconds with Mediabunny
-- [rules/get-video-dimensions.md](rules/get-video-dimensions.md) - Getting the width and height of a video file with Mediabunny
-- [rules/get-video-duration.md](rules/get-video-duration.md) - Getting the duration of a video file in seconds with Mediabunny
-- [rules/gifs.md](rules/gifs.md) - Displaying GIFs synchronized with Remotion's timeline
-- [rules/images.md](rules/images.md) - Embedding images in Remotion using the Img component
-- [rules/import-srt-captions.md](rules/import-srt-captions.md) - Importing .srt subtitle files into Remotion using @remotion/captions
-- [rules/lottie.md](rules/lottie.md) - Embedding Lottie animations in Remotion
-- [rules/measuring-dom-nodes.md](rules/measuring-dom-nodes.md) - Measuring DOM element dimensions in Remotion
-- [rules/measuring-text.md](rules/measuring-text.md) - Measuring text dimensions, fitting text to containers, and checking overflow
-- [rules/sequencing.md](rules/sequencing.md) - Sequencing patterns for Remotion - delay, trim, limit duration of items
-- [rules/tailwind.md](rules/tailwind.md) - Using TailwindCSS in Remotion
-- [rules/text-animations.md](rules/text-animations.md) - Typography and text animation patterns for Remotion
-- [rules/timing.md](rules/timing.md) - Interpolation curves in Remotion - linear, easing, spring animations
-- [rules/transcribe-captions.md](rules/transcribe-captions.md) - Transcribing audio to generate captions in Remotion
-- [rules/transitions.md](rules/transitions.md) - Scene transition patterns for Remotion
-- [rules/trimming.md](rules/trimming.md) - Trimming patterns for Remotion - cut the beginning or end of animations
-- [rules/videos.md](rules/videos.md) - Embedding videos in Remotion - trimming, volume, speed, looping, pitch