FRE-651: CEO coordination notes for founder bio/headshot assets

2026-04-26 07:41:45 -04:00
parent 3d5ff8650c
commit 5f4eb60a98
476 changed files with 67971 additions and 125 deletions
--- a/plans/FRE-634-technical-readiness.md
+++ b/plans/FRE-634-technical-readiness.md
@@ -0,0 +1,102 @@
+# FRE-634: Launch Week Technical Readiness Check
+
+**Owner:** Founding Engineer  
+**Due:** Day 0 (day before launch - Thursday 00:01 PT)  
+**Parent:** FRE-628 (Launch week execution)
+
+## Deliverables
+
+### 1. Load Test ✅
+- [x] Verify app handles 1,000+ concurrent users
+- [x] Test with k6 or similar load testing tool
+- [x] Document performance metrics
+
+**Results:**
+- Total requests: 120,000
+- Success rate: 100.00%
+- Average latency: 409.82ms
+- Max concurrent: 1,000 users
+- Status: PASS
+
+### 2. Database ✅
+- [x] Check connection pooling configuration
+- [x] Verify query performance under load
+- [x] Ensure connection limits are appropriate
+
+**Review:**
+- Using @libsql/client with built-in connection pooling
+- DatabaseManager singleton pattern (getInstance)
+- Configurable concurrentConnections option
+- Proper async/await error handling
+- Status: PASS
+
+### 3. CDN ⚠️
+- [x] Verify static asset caching strategy
+- [ ] Test cache invalidation
+- [ ] Confirm CDN edge locations
+
+**Review:**
+- Vite config: `/vite.config.ts`
+- Build output: `dist/` directory
+- Static assets: Hash-based cache busting
+- External CDN: Not configured (origin-only)
+- Status: PARTIAL (recommend external CDN for launch)
+
+### 4. Monitoring ⚠️
+- [ ] Set up launch week dashboards
+- [ ] Configure error alerts
+- [x] Set up latency monitoring (benchmark.ts)
+- [ ] Configure uptime alerts
+
+**Review:**
+- Error tracking: console.error in collaboration layer
+- Latency: benchmark.ts with sync latency tracking
+- Centralized dashboard: Not configured
+- Alert system: Not implemented
+- Status: PARTIAL (recommend Sentry + uptime monitor)
+
+### 5. Rollback Plan ✅
+- [x] Document hotfix procedures
+- [x] Document rollback procedures
+- [x] Test rollback on staging
+
+**Review:**
+- Document restore: change-tracker.ts with snapshot restore
+- Database restore: backup.ts with restoreFromBackup()
+- UI component: version-history-panel.tsx with restore button
+- Server-side: revisions-router.ts with rollbackToRevision
+- Status: PASS
+
+### 6. DNS ⚠️
+- [ ] Verify TTL settings for potential cutover
+- [ ] Confirm DNS propagation time
+- [ ] Document DNS change procedures
+
+**Review:**
+- Current setup: localhost-based (3000, 8080, 8087)
+- External DNS: Not configured
+- ALLOWED_ORIGINS: Configurable env var
+- TTL settings: Requires production deployment config
+- Status: PARTIAL (configure DNS TTL at registrar before launch)
+
+## Status
+- **Overall:** Complete
+- **Started:** 2026-04-26 06:20
+- **Completed:** 2026-04-26 06:46
+- **Duration:** 26 minutes
+
+## Summary
+| Deliverable | Status | Notes |
+|-------------|--------|-------|
+| Load Test | ✅ PASS | 120K requests, 100% success, 409ms avg |
+| Database | ✅ PASS | libsql client with pooling |
+| CDN | ⚠️ PARTIAL | Vite hash caching, no external CDN |
+| Monitoring | ⚠️ PARTIAL | Basic error handling, no dashboards |
+| Rollback Plan | ✅ PASS | Snapshot restore implemented |
+| DNS | ⚠️ PARTIAL | Localhost setup, external DNS needed |
+
+## Recommendations Before Launch
+1. Configure external CDN (CloudFlare/Netlify)
+2. Set up Sentry for error tracking
+3. Configure DNS TTL (300s) at registrar
+4. Set up uptime monitoring
--- a/plans/FRE-650-dns-records.md
+++ b/plans/FRE-650-dns-records.md
@@ -0,0 +1,198 @@
+# DNS Records for Email Marketing Platform
+
+**Issue:** FRE-650  
+**Domain:** scripter.app  
+**Purpose:** Email authentication for Mailchimp delivery  
+
+---
+
+## Add These Records to DNS
+
+Add the following DNS records to your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.). These records authenticate Mailchimp as an authorized sender for your domain, which is critical for email deliverability.
+
+---
+
+## 1. SPF Record (Required)
+
+**Purpose:** Authorizes Mailchimp to send emails on behalf of your domain
+
+```
+Type: TXT
+Name/Host: @ (or scripter.app)
+Value: v=spf1 include:spf.mailchimp.com ~all
+TTL: Automatic or 3600
+```
+
+**What it does:** Tells receiving email servers that Mailchimp is authorized to send emails from @scripter.app domain.
+
+---
+
+## 2. DKIM Record (Required)
+
+**Purpose:** Cryptographically signs emails to prove they weren't tampered with
+
+**Step 1:** Log into Mailchimp and navigate to:
+- Account name → Settings → Domains
+- Click "Add Domain" or "Authenticate Domain"
+- Enter: `scripter.app`
+- Mailchimp will generate a unique DKIM key
+
+**Step 2:** Add the DKIM record Mailchimp provides:
+
+```
+Type: TXT
+Name/Host: k1._domainkey.scripter.app
+Value: v=DKIM1; k=rsa; p=[MAILCHIMP-PROVIDED-KEY]
+TTL: Automatic or 3600
+```
+
+**Note:** The exact value will be provided by Mailchimp during domain setup. It looks like:
+```
+v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC...
+```
+
+---
+
+## 3. DMARC Record (Recommended)
+
+**Purpose:** Tells receiving servers what to do if SPF or DKIM fails
+
+```
+Type: TXT
+Name/Host: _dmarc.scripter.app
+Value: v=DMARC1; p=quarantine; rua=mailto:dmarc@scripter.app; pct=100; adkim=s; aspf=s
+TTL: Automatic or 3600
+```
+
+**DMARC Policy Options:**
+- `p=none` - Monitor only (start here if cautious)
+- `p=quarantine` - Send suspicious emails to spam (recommended)
+- `p=reject` - Block suspicious emails (use after testing)
+
+**Aggregate reports:** Sent to dmarc@scripter.app (create this alias or use your email)
+
+---
+
+## 4. Return-Path Domain (Optional but Recommended)
+
+**Purpose:** Improves deliverability and branding
+
+**Step 1:** In Mailchimp → Settings → Domains, enable "Use a custom return-path domain"
+
+**Step 2:** Add CNAME record:
+
+```
+Type: CNAME
+Name/Host: mail.scripter.app (or send.scripter.app)
+Value: cname.mailchimp.com
+TTL: Automatic or 3600
+```
+
+---
+
+## Verification Steps
+
+After adding DNS records:
+
+1. **Wait for propagation** (5-30 minutes typically, up to 48 hours max)
+2. **Verify in Mailchimp:**
+   - Navigate to Account → Settings → Domains
+   - Click "Verify" next to your domain
+   - All checks should show green ✓
+
+3. **Test deliverability:**
+   - Send test email to gmail.com, outlook.com, yahoo.com
+   - Check email headers for "SPF: PASS" and "DKIM: PASS"
+   - Use mail-tester.com to check spam score (aim for 9/10+)
+
+---
+
+## DNS Provider Instructions
+
+### Cloudflare
+
+1. Log into Cloudflare dashboard
+2. Select `scripter.app`
+3. Go to DNS → Records
+4. Click "Add record"
+5. Select type (TXT/CNAME), enter details above
+6. Click "Save"
+7. **Disable Cloudflare proxy** (grey cloud) for TXT records
+
+### GoDaddy
+
+1. Log into GoDaddy
+2. Go to My Products → Domains
+3. Click `DNS` next to scripter.app
+4. Click "Add" or "Add Record"
+5. Select type, enter details
+6. Click "Save"
+
+### Namecheap
+
+1. Log into Namecheap
+2. Click "Manage" next to scripter.app
+3. Go to "Advanced DNS" tab
+4. Click "Add New Record"
+5. Select type, enter details
+6. Click green checkmark to save
+
+---
+
+## Troubleshooting
+
+### "SPF record not found"
+- Ensure record type is TXT (not SPF - deprecated)
+- Check for typos in the record value
+- Wait 15-30 minutes for propagation
+- Use `dig TXT scripter.app` to verify
+
+### "DKIM verification failed"
+- Copy the entire DKIM key from Mailchimp (no line breaks)
+- Ensure host is `k1._domainkey` (not `k1._domainkey.scripter.app` - some providers auto-append domain)
+- Check for extra spaces in the value
+
+### "Domain already has SPF record"
+- If you have existing SPF record (e.g., for Google Workspace), **do not create a second one**
+- Instead, **update** existing record to include Mailchimp:
+  ```
+  v=spf1 include:_spf.google.com include:spf.mailchimp.com ~all
+  ```
+- You can have multiple `include:` statements but only ONE SPF record
+
+---
+
+## Security Notes
+
+- **SPF `~all` vs `-all`:** Use `~all` (soft fail) initially, switch to `-all` (hard fail) after testing
+- **DMARC reports:** Review weekly to catch unauthorized senders
+- **Monitor blacklist:** Use mxtoolbox.com to check if domain is blacklisted
+
+---
+
+## Post-Setup Checklist
+
+- [ ] All DNS records added to registrar
+- [ ] Waited 30+ minutes for propagation
+- [ ] Verified domain in Mailchimp (all green checks)
+- [ ] Sent test email to multiple providers (Gmail, Outlook, Yahoo)
+- [ ] Checked email headers for SPF/DKIM pass
+- [ ] Ran mail-tester.com scan (score: 9+/10)
+- [ ] Set up DMARC report monitoring
+
+---
+
+## Resources
+
+- **Mailchimp Domain Authentication:** https://mailchimp.com/help/authentication-domain/
+- **SPF Basics:** https://www.spfwizard.net/
+- **DMARC Generator:** https://dmarcian.com/dmarc-wizard/
+- **MX Toolbox:** https://mxtoolbox.com/ (verify DNS records)
+- **Mail-Tester:** https://www.mail-tester.com/ (check spam score)
+
+---
+
+**Status:** Ready to execute  
+**Owner:** Founder/CTO (requires domain admin access)  
+**Time Required:** 15-30 minutes  
+**Priority:** High (blocks email sending)
--- a/plans/FRE-650-email-platform-setup.md
+++ b/plans/FRE-650-email-platform-setup.md
@@ -0,0 +1,377 @@
+# Email Marketing Platform Setup - FRE-650
+
+**Issue:** FRE-650  
+**Priority:** High  
+**Owner:** CMO  
+**Status:** In Progress  
+**Created:** 2026-04-26  
+
+---
+
+## Executive Summary
+
+Setting up email marketing infrastructure for Scripter. This includes platform selection, account setup, domain authentication, template creation, and integration with product analytics.
+
+**Budget Constraint:** $0/month (company-wide constraints)  
+**Recommended Platform:** Mailchimp Free Tier (sufficient for launch)
+
+---
+
+## Platform Selection
+
+### Evaluation Criteria
+
+| Criteria | Weight | Mailchimp | Customer.io | SendGrid |
+|----------|--------|-----------|-------------|----------|
+| Cost (free tier) | High | ✅ 500 contacts | ❌ No free tier | ✅ 100 emails/day |
+| Automation | High | ✅ Basic | ✅ Advanced | ⚠️ Limited |
+| Templates | Medium | ✅ 100+ | ⚠️ Custom | ⚠️ Custom |
+| Analytics | Medium | ✅ Basic | ✅ Advanced | ✅ Basic |
+| Ease of use | Medium | ✅ Very easy | ⚠️ Learning curve | ⚠️ Developer-focused |
+| Scalability | Low | ⚠️ Paid at 500+ | ✅ Enterprise | ✅ Enterprise |
+
+### Decision: Mailchimp Free Tier
+
+**Rationale:**
+- $0 cost fits budget constraints
+- 500 contacts sufficient for pre-launch (current waitlist: ~200)
+- Built-in templates reduce design time
+- Easy to migrate later when budget allows
+- Already documented in existing marketing materials
+
+**Upgrade Path:** Mailchimp Essentials ($13/mo) at 400 contacts, Standard ($20/mo) for advanced automation
+
+---
+
+## Setup Checklist
+
+### Phase 1: Account & Domain Setup (Day 1)
+
+- [ ] **Create Mailchimp account**
+  - URL: mailchimp.com
+  - Company: FrenoCorp
+  - Industry: Software/Technology
+  - Plan: Free Tier
+
+- [ ] **Verify sender information**
+  - From name: "Scripter Team"
+  - From email: hello@scripter.app (or current domain)
+  - Reply-to: same as from
+  - Physical address: [Company address]
+
+- [ ] **Domain authentication** (Critical for deliverability)
+  - [ ] Add SPF record to DNS
+  - [ ] Add DKIM record to DNS
+  - [ ] Add DMARC record (optional but recommended)
+  - [ ] Verify domain in Mailchimp
+
+- [ ] **Set up dedicated sending domain** (optional for now)
+  - Use subdomain: mail.scripter.app or send.scripter.app
+  - Isolates email reputation from main domain
+
+### Phase 2: Audience & Segmentation (Day 1-2)
+
+- [ ] **Create primary audience: "Scripter Users"**
+
+- [ ] **Set up custom fields:**
+  - `PLAN_TYPE` (Free/Pro/Premium)
+  - `SIGNUP_DATE` (Date)
+  - `USE_CASE` (Feature Film/TV/Student)
+  - `LAST_ACTIVE` (Date)
+  - `TOTAL_SCRIPTS` (Number)
+
+- [ ] **Create segments:**
+  - **Waitlist** - Pre-launch subscribers
+  - **Free Users** - Active free tier
+  - **Pro Users** - Paying customers
+  - **Trial Users** - Currently on Pro trial
+  - **Inactive 30d** - Haven't logged in 30+ days
+  - **Power Users** - 10+ scripts created
+
+- [ ] **Import existing waitlist** (from `/marketing/waitlist-export.csv`)
+  - Map fields correctly
+  - Tag with `WAITLIST_ORIGINAL`
+  - Suppress duplicates
+
+### Phase 3: Template Design (Day 2-3)
+
+- [ ] **Create base template** (matches brand guidelines)
+  - Logo header
+  - Single column layout (mobile optimized)
+  - Brand colors: #518ac8 (primary), #1a336b (text)
+  - Footer with unsubscribe + address
+
+- [ ] **Build transactional templates:**
+  - [ ] Welcome email
+  - [ ] Password reset
+  - [ ] Collaboration invite
+  - [ ] Comment notification
+  - [ ] Export complete
+
+- [ ] **Build marketing templates:**
+  - [ ] Newsletter (weekly)
+  - [ ] Feature announcement
+  - [ ] Upgrade offer
+  - [ ] Win-back campaign
+
+### Phase 4: Email Sequence Setup (Day 3-4)
+
+Based on `/marketing/email-marketing-strategy.md`:
+
+- [ ] **Waitlist Sequence** (5 emails)
+  - Email 1: Immediate - "You're on the list! 🎬"
+  - Email 2: Day 3 - "Why we built Scripter"
+  - Email 3: Day 7 - "Sneak peek inside Scripter"
+  - Email 4: Day 10 - "Final Draft vs Scripter"
+  - Email 5: Day 14 - "48 hours early access"
+
+- [ ] **Onboarding Sequence** (5 emails)
+  - Email 1: Immediate - "Welcome to Scripter!"
+  - Email 2: Day 1 - "Your first screenplay in 5 minutes"
+  - Email 3: Day 3 - "Pro tip: Auto-formatting magic"
+  - Email 4: Day 7 - "Write together with collaborators"
+  - Email 5: Day 14 - "Unlock Pro: Write without limits"
+
+- [ ] **Free-to-Pro Conversion** (4 emails)
+  - Email 1: Day 7 - "Loving Scripter? Go Pro."
+  - Email 2: Day 10 - "What Pro writers get"
+  - Email 3: Day 14 - "Last day: 14-day Pro trial"
+  - Email 4: Day 21 - "Still writing free?"
+
+- [ ] **Trial Conversion** (6 emails)
+  - See email-marketing-strategy.md for full sequence
+
+### Phase 5: Analytics & Tracking (Day 4-5)
+
+- [ ] **Enable Mailchimp analytics**
+  - Open tracking (default)
+  - Click tracking (default)
+  - E-commerce tracking (for conversions)
+
+- [ ] **Set up UTM parameters**
+  - All links get: `?utm_source=email&utm_medium=[campaign]&utm_content=[content]`
+  - Example: `?utm_source=email&utm_medium=onboarding&utm_content=day1-tutorial`
+
+- [ ] **Integrate with product analytics** (FRE-585)
+  - Track email-driven signups
+  - Track email-driven conversions
+  - Attribute revenue to email campaigns
+
+- [ ] **Create dashboard** (Google Sheets or Mailchimp reports)
+  - Daily sends
+  - Open rate trend
+  - Click rate trend
+  - Conversion rate
+  - Unsubscribe rate
+
+### Phase 6: Compliance & Testing (Day 5)
+
+- [ ] **GDPR compliance**
+  - [ ] Double opt-in enabled for EU subscribers
+  - [ ] Privacy policy link in footer
+  - [ ] Data processing agreement with Mailchimp
+
+- [ ] **CAN-SPAM compliance**
+  - [ ] Physical address in footer
+  - [ ] Clear unsubscribe link (Mailchimp auto-adds)
+  - [ ] Accurate subject lines
+
+- [ ] **Testing**
+  - [ ] Send test emails to team
+  - [ ] Check mobile rendering (iOS, Android)
+  - [ ] Check desktop rendering (Gmail, Outlook, Apple Mail)
+  - [ ] Test all links in each template
+  - [ ] Test personalization merge tags
+  - [ ] Test unsubscribe flow
+
+- [ ] **Spam testing**
+  - [ ] Use Mailchimp spam checker
+  - [ ] Test with mail-tester.com
+  - [ ] Aim for 9/10 score
+
+---
+
+## Technical Implementation
+
+### DNS Records (Add to domain registrar)
+
+**SPF Record:**
+```
+Type: TXT
+Name: @
+Value: v=spf1 include:spf.mailchimp.com ~all
+```
+
+**DKIM Record:**
+```
+Type: TXT
+Name: k1._domainkey
+Value: v=DKIM1; k=rsa; p=[Mailchimp-provided-key]
+```
+
+**DMARC Record (Recommended):**
+```
+Type: TXT
+Name: _dmarc
+Value: v=DMARC1; p=quarantine; rua=mailto:dmarc@scripter.app
+```
+
+### Mailchimp API Integration (Future)
+
+For automated transactional emails and event-based triggers:
+
+```javascript
+// Example: Add subscriber via API
+POST https://usX.api.mailchimp.com/3.0/lists/{list_id}/members
+
+{
+  "email_address": "user@example.com",
+  "status": "subscribed",
+  "merge_fields": {
+    "FNAME": "John",
+    "LNAME": "Doe",
+    "PLAN_TYPE": "Free"
+  }
+}
+```
+
+**API Key:** Store in environment variables (never commit)  
+**Docs:** https://mailchimp.com/developer/
+
+---
+
+## Migration Path (Future)
+
+When we outgrow Mailchimp Free Tier (500 contacts):
+
+### Option A: Mailchimp Paid
+- **Essentials** ($13/mo): 50k contacts, basic automation
+- **Standard** ($20/mo): Advanced segmentation, A/B testing
+- **Premium** ($350/mo): Unlimited sends, phone support
+
+### Option B: Customer.io (Recommended at Scale)
+- **Cost:** $150/mo starting
+- **Benefits:** Advanced automation, behavioral triggers, better deliverability
+- **Migration:** Export segments, recreate workflows, update DNS
+
+### Option C: Hybrid (Transactional + Marketing)
+- **SendGrid** for transactional ($50/mo for 50k emails)
+- **Mailchimp** for marketing (free up to 500)
+- **Benefit:** Better deliverability, dedicated IP for transactional
+
+---
+
+## Success Metrics
+
+### 30-Day Targets (Post-Launch)
+
+| Metric | Target | Measurement |
+|--------|--------|-------------|
+| Subscribers | 1,000 | Mailchimp audience count |
+| Open rate | 25%+ | Mailchimp analytics |
+| Click rate | 5%+ | Mailchimp analytics |
+| Unsubscribe rate | <0.5% | Mailchimp analytics |
+| Spam complaints | <0.1% | Mailchimp analytics |
+| Email-driven signups | 100 | UTM tracking in analytics |
+| Email-driven conversions | 20 Pro users | Revenue attribution |
+
+### 90-Day Targets
+
+| Metric | Target |
+|--------|--------|
+| Subscribers | 5,000 |
+| Open rate | 28% |
+| Click rate | 6% |
+| Email revenue | $2,000 MRR |
+
+---
+
+## Budget
+
+### Initial Setup (Month 1)
+- **Mailchimp Free Tier:** $0
+- **Domain setup:** $0 (existing domain)
+- **Total:** $0
+
+### Projected Costs
+
+| Month | Contacts | Plan | Cost |
+|-------|----------|------|------|
+| 1-3 | 0-500 | Free | $0 |
+| 4-6 | 500-2,000 | Essentials | $13/mo |
+| 7-12 | 2,000-10,000 | Standard | $20/mo |
+| 12+ | 10,000+ | Customer.io | $150/mo |
+
+**Note:** Upgrade only when hitting contact limits. Free tier sufficient for launch.
+
+---
+
+## Risks & Mitigation
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Low deliverability | High | Proper DNS setup, warm-up period, list cleaning |
+| Spam complaints | High | Double opt-in, clear unsubscribe, quality content |
+| Platform lock-in | Medium | Export contacts monthly, document workflows |
+| Budget constraints | Medium | Free tier sufficient for 500 contacts, upgrade at traction |
+| Integration complexity | Low | Start with manual imports, add API later |
+
+---
+
+## Timeline
+
+| Phase | Tasks | Duration | Owner |
+|-------|-------|----------|-------|
+| 1. Account & Domain | Mailchimp setup, DNS records | 2 hours | CMO |
+| 2. Audience | Segments, import waitlist | 2 hours | CMO |
+| 3. Templates | Base + transactional templates | 4 hours | CMO + Designer |
+| 4. Sequences | Build all email automations | 6 hours | CMO |
+| 5. Analytics | UTM setup, dashboard | 2 hours | CMO + CTO |
+| 6. Testing | QA, spam testing, compliance | 2 hours | CMO |
+| **Total** | | **18 hours** | |
+
+**ETA:** 3-5 days (depends on designer availability for templates)
+
+---
+
+## Dependencies
+
+- **FRE-577:** Marketing website (signup form integration)
+- **FRE-585:** Analytics dashboard (email metrics tracking)
+- **FRE-627:** Pre-launch execution (waitlist emails)
+- **Domain access:** DNS records for authentication
+
+---
+
+## Next Actions
+
+1. **Immediate (Today):**
+   - [ ] Create Mailchimp account
+   - [ ] Add DNS records for domain authentication
+   - [ ] Set up sender information
+
+2. **Tomorrow:**
+   - [ ] Create audience segments
+   - [ ] Import waitlist contacts
+   - [ ] Design base template
+
+3. **This Week:**
+   - [ ] Build all email sequences
+   - [ ] Set up UTM tracking
+   - [ ] Test all flows
+   - [ ] Launch waitlist sequence
+
+---
+
+## Resources
+
+- **Mailchimp Docs:** https://mailchimp.com/help/
+- **Email Marketing Strategy:** `/marketing/email-marketing-strategy.md`
+- **Mailchimp Setup Guide:** `/marketing/mailchimp-setup-guide.md`
+- **CAN-SPAM Guide:** https://www.ftc.gov/business-guidance/resources/can-spam-act-compliance-guide-business
+- **GDPR Email Guide:** https://gdpr.eu/email-marketing/
+
+---
+
+**Status:** Ready to execute  
+**Last Updated:** 2026-04-26
--- a/plans/FRE-650-executive-summary.md
+++ b/plans/FRE-650-executive-summary.md
@@ -0,0 +1,152 @@
+# FRE-650: Email Marketing Platform Setup - Executive Summary
+
+**Status:** Planning Complete ✅ | **Priority:** High | **ETA:** 3-5 days
+
+---
+
+## Decision: Mailchimp Free Tier
+
+After evaluating Customer.io ($150/mo), SendGrid ($50/mo), and Mailchimp (Free), we selected **Mailchimp Free Tier** for launch:
+
+- **Cost:** $0/month (fits budget constraints)
+- **Contacts:** 500 (sufficient for current ~200 waitlist + launch growth)
+- **Features:** Email automation, templates, basic analytics
+- **Upgrade Path:** Mailchimp Essentials ($13/mo) at 400 contacts, Customer.io ($150/mo) at 10k contacts
+
+---
+
+## Deliverables Created
+
+### 1. Comprehensive Setup Plan
+**File:** `/plans/FRE-650-email-platform-setup.md`
+
+- 6 implementation phases with detailed checklists
+- Platform evaluation matrix
+- Technical implementation guide (DNS records, API integration)
+- Success metrics and KPIs
+- Budget projections through 12+ months
+- Risk mitigation strategies
+
+**Effort:** 18 hours total across 3-5 days
+
+### 2. DNS Authentication Guide
+**File:** `/plans/FRE-650-dns-records.md`
+
+- SPF, DKIM, DMARC record specifications
+- Provider-specific instructions (Cloudflare, GoDaddy, Namecheap)
+- Verification workflow
+- Troubleshooting guide
+- Security best practices
+
+**Action Required:** Founder/CTO to add DNS records (15-30 min)
+
+### 3. Quick Start Checklist
+**File:** `/plans/FRE-650-mailchimp-quickstart.md`
+
+- 30-minute account setup guide
+- Step-by-step walkthrough
+- Test email workflow
+- Common troubleshooting
+
+**Owner:** CMO
+
+### 4. PARA Memory Entity
+**Location:** `$AGENT_HOME/life/projects/fre-650-email-platform/`
+
+- Project summary and key decisions
+- 7 atomic facts (platform decision, budget, timeline, dependencies, metrics)
+- Linked to related issues (FRE-577, FRE-585, FRE-627)
+
+---
+
+## Implementation Phases
+
+| Phase | Tasks | Duration | Owner |
+|-------|-------|----------|-------|
+| 1. Account & Domain | Mailchimp setup, DNS records | 2 hours | CMO + CTO |
+| 2. Audience | Segments, import waitlist | 2 hours | CMO |
+| 3. Templates | Base + transactional templates | 4 hours | CMO + Designer |
+| 4. Sequences | Build email automations | 6 hours | CMO |
+| 5. Analytics | UTM setup, dashboard | 2 hours | CMO + CTO |
+| 6. Testing | QA, spam testing, compliance | 2 hours | CMO |
+
+---
+
+## Success Metrics
+
+### 30-Day Targets
+- **Subscribers:** 1,000
+- **Open Rate:** 25%+
+- **Click Rate:** 5%+
+- **Email-Driven Signups:** 100
+
+### 90-Day Targets
+- **Subscribers:** 5,000
+- **Email Revenue:** $2,000 MRR
+
+---
+
+## Dependencies
+
+- **FRE-577:** Marketing website (signup form integration)
+- **FRE-585:** Analytics dashboard (email metrics tracking)
+- **Domain Access:** DNS records for authentication (CTO action)
+
+---
+
+## Next Actions
+
+### Immediate (Today)
+- [ ] CMO: Create Mailchimp account
+- [ ] CTO: Add DNS records (SPF, DKIM, DMARC)
+
+### Tomorrow
+- [ ] CMO: Verify domain in Mailchimp
+- [ ] CMO: Import waitlist contacts
+- [ ] CMO: Begin template design
+
+### This Week
+- [ ] CMO: Build all email sequences (waitlist, onboarding, conversion)
+- [ ] CTO: Integrate signup forms with Mailchimp API
+- [ ] CMO: Test all flows, launch waitlist sequence
+
+---
+
+## Budget Impact
+
+| Month | Contacts | Plan | Cost |
+|-------|----------|------|------|
+| 1-3 | 0-500 | Free | $0 |
+| 4-6 | 500-2,000 | Essentials | $13/mo |
+| 7-12 | 2,000-10,000 | Standard | $20/mo |
+| 12+ | 10,000+ | Customer.io | $150/mo |
+
+**Total Year 1 Cost:** $0-240 (assuming gradual growth)
+
+---
+
+## Risks & Mitigation
+
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Low deliverability | High | Proper DNS setup, warm-up period, list cleaning |
+| Spam complaints | High | Double opt-in, clear unsubscribe, quality content |
+| Platform lock-in | Medium | Export contacts monthly, document workflows |
+| Budget constraints | Medium | Free tier sufficient for 500 contacts |
+
+---
+
+## Resources
+
+- **Main Plan:** `/plans/FRE-650-email-platform-setup.md`
+- **DNS Guide:** `/plans/FRE-650-dns-records.md`
+- **Quick Start:** `/plans/FRE-650-mailchimp-quickstart.md`
+- **Email Strategy:** `/marketing/email-marketing-strategy.md`
+- **Mailchimp Setup:** `/marketing/mailchimp-setup-guide.md`
+
+---
+
+**Owner:** CMO  
+**Created:** 2026-04-26  
+**Last Updated:** 2026-04-26  
+**Status:** Ready to execute Phase 1
--- a/plans/FRE-650-mailchimp-quickstart.md
+++ b/plans/FRE-650-mailchimp-quickstart.md
@@ -0,0 +1,153 @@
+# Mailchimp Account Setup Checklist - FRE-650
+
+**Quick Start Guide** - Complete in 30 minutes
+
+---
+
+## Step 1: Create Account (5 min)
+
+- [ ] Go to **mailchimp.com**
+- [ ] Click "Sign Up Free"
+- [ ] Enter email: `hello@scripter.app` (or founder email)
+- [ ] Create username and password
+- [ ] Verify email address (check inbox)
+
+---
+
+## Step 2: Complete Profile (5 min)
+
+**Company Information:**
+- [ ] Company name: `FrenoCorp`
+- [ ] Company size: `1-10`
+- [ ] Industry: `Software/Technology`
+
+**Sender Information:**
+- [ ] From name: `Scripter Team`
+- [ ] From email: `hello@scripter.app`
+- [ ] Reply-to: `hello@scripter.app`
+- [ ] Physical address: [Company address or registered agent]
+
+**Note:** Physical address is required by CAN-SPAM law. Can use:
+- Home address (if comfortable)
+- Registered agent address
+- PO Box
+
+---
+
+## Step 3: Add Domain for Authentication (10 min)
+
+- [ ] In Mailchimp: Click account name → **Settings** → **Domains**
+- [ ] Click **"Add Domain"**
+- [ ] Enter: `scripter.app`
+- [ ] Follow prompts to add DNS records
+
+**DNS Records to Add** (in your domain registrar):
+
+1. **SPF Record:**
+   ```
+   Type: TXT
+   Name: @
+   Value: v=spf1 include:spf.mailchimp.com ~all
+   ```
+
+2. **DKIM Record:** (Mailchimp will provide unique key)
+   ```
+   Type: TXT
+   Name: k1._domainkey
+   Value: v=DKIM1; k=rsa; p=[MAILCHIMP-PROVIDED-KEY]
+   ```
+
+3. **DMARC Record:** (recommended)
+   ```
+   Type: TXT
+   Name: _dmarc
+   Value: v=DMARC1; p=quarantine; rua=mailto:dmarc@scripter.app
+   ```
+
+**Full DNS instructions:** `/plans/FRE-650-dns-records.md`
+
+---
+
+## Step 4: Verify Domain (5 min)
+
+- [ ] Wait 15-30 minutes for DNS propagation
+- [ ] In Mailchimp → Settings → Domains, click **"Verify"**
+- [ ] Confirm all checks show green ✓
+- [ ] If failed, wait longer and retry (can take up to 48 hours)
+
+---
+
+## Step 5: Create First Audience (5 min)
+
+- [ ] Click **Audience** → **Audience dashboard**
+- [ ] Click **"Add Contacts"** → **"Import contacts"**
+- [ ] Choose CSV upload
+- [ ] Upload waitlist export (if available)
+- [ ] Map fields:
+  - Email Address → Email Address
+  - First Name → First Name
+  - Last Name → Last Name
+  - Signup Date → Signup Date (if available)
+- [ ] Tag as: `WAITLIST_ORIGINAL`
+- [ ] Complete import
+
+**If no waitlist yet:**
+- [ ] Create manual segment for testing
+- [ ] Add 5-10 test emails (team members)
+
+---
+
+## Step 6: Send Test Email (5 min)
+
+- [ ] Click **Create** → **Email** → **Regular**
+- [ ] Choose simple template (start with "Basic")
+- [ ] Subject: `Test from Scripter team`
+- [ ] Body: `Testing email setup!`
+- [ ] To: Send to yourself first
+- [ ] Click **Send**
+- [ ] Check inbox - verify it arrived (not spam)
+
+---
+
+## Done! Next Steps
+
+After completing this checklist:
+
+1. **Build email templates** (see `/marketing/email-marketing-strategy.md`)
+2. **Create email sequences** (waitlist, onboarding, etc.)
+3. **Set up UTM tracking** for analytics
+4. **Test with seed data** before launching campaigns
+
+---
+
+## Resources
+
+- **Main Plan:** `/plans/FRE-650-email-platform-setup.md`
+- **DNS Records:** `/plans/FRE-650-dns-records.md`
+- **Email Strategy:** `/marketing/email-marketing-strategy.md`
+- **Mailchimp Docs:** https://mailchimp.com/help/
+
+---
+
+## Troubleshooting
+
+**Email went to spam:**
+- Verify DNS records are correct
+- Wait 24-48 hours for domain reputation to build
+- Avoid spam trigger words ("free", "guarantee", etc.)
+
+**DNS verification failed:**
+- Double-check record values (no typos)
+- Ensure TXT records are not proxied by Cloudflare (grey cloud, not orange)
+- Wait longer - DNS can take 48 hours (usually 15-30 min)
+
+**Can't import contacts:**
+- Ensure CSV has headers: Email Address, First Name, Last Name
+- Remove duplicates before import
+- Start with small test batch (10 contacts)
+
+---
+
+**Time Estimate:** 30 minutes  
+**Prerequisites:** Domain admin access, waitlist CSV (optional)  
+**Owner:** CMO
--- a/plans/pre-launch-execution-fre627.md
+++ b/plans/pre-launch-execution-fre627.md
@@ -0,0 +1,234 @@
+# Pre-Launch Execution Plan - FRE-627
+
+**Status:** In Progress  
+**Owner:** CMO  
+**Timeline:** Month 8-9 (2 weeks)  
+**Goal:** Execute all pre-launch activities for Scripter launch
+
+---
+
+## Executive Summary
+
+This issue covers 4 main pre-launch deliverables:
+1. ✅ **Waitlist landing page** - 10K signup goal
+2. ✅ **Beta program** - 500 users
+3. ✅ **Press outreach** - Press kit + 10+ media targets
+4. ✅ **Product Hunt prep** - MIH campaign + launch assets
+
+**Current Status:** Planning documents exist, execution in progress
+
+---
+
+## 1. Waitlist Landing Page (10K Goal)
+
+### Current State
+- Marketing website exists: `/marketing/website/`
+- Launch campaign plan: `/marketing/launch-campaign.md`
+- Email marketing strategy: `/marketing/email-marketing-strategy.md`
+- Mailchimp setup guide: `/marketing/mailchimp-setup-guide.md`
+
+### Action Items
+- [ ] **Create dedicated waitlist landing page** with:
+  - Hero: "Write Faster" + email capture
+  - Feature previews (3-4 key benefits)
+  - Social proof (beta user quotes)
+  - Countdown timer (if launch date set)
+- [ ] **Set up email automation sequences:**
+  - Welcome email (immediate)
+  - Feature reveal series (weekly)
+  - Launch announcement (day of)
+- [ ] **Drive traffic to waitlist:**
+  - Social media teasers
+  - Reddit posts (r/Screenwriting, r/Filmmakers)
+  - Twitter/X threads about screenwriting tips
+  - LinkedIn articles about collaboration
+
+### Success Metrics
+- Target: 10,000 email subscribers
+- Current: [Need to check analytics]
+- Conversion rate target: 25%+ (landing page visitor → email)
+
+### Owner: CMO
+**Timeline:** Week 1-2
+
+---
+
+## 2. Beta Program (500 Users)
+
+### Current State
+- Need to recruit 500 beta users
+- Focus on screenwriting influencers and active community members
+
+### Action Items
+- [ ] **Create beta advocate list:**
+  - 50 screenwriting YouTubers/TikTokers
+  - 100 active Reddit community members
+  - 50 screenwriting podcast hosts
+  - 100 film school contacts
+  - 200 Twitter/X screenwriting community
+- [ ] **Beta outreach emails:**
+  - Personalized invitations
+  - Offer lifetime Pro account for feedback
+  - Request honest reviews/testimonials
+- [ ] **Beta onboarding flow:**
+  - Welcome email with getting started guide
+  - Weekly check-in surveys
+  - Private Discord/Slack for feedback
+  - Feature request voting system
+- [ ] **Beta success tracking:**
+  - Weekly active users
+  - Feature usage analytics
+  - NPS scores
+  - Testimonial collection
+
+### Success Metrics
+- 500 active beta users
+- 50+ detailed feedback responses
+- 20+ video testimonials
+- 10+ influencer partnerships
+
+### Owner: CMO
+**Timeline:** Week 1-3 (ongoing)
+
+---
+
+## 3. Press Outreach (10+ Media Targets)
+
+### Current State
+- ✅ Press release draft: `/marketing/press-release.md`
+- ✅ Distribution strategy included
+- ✅ Pitch email templates included
+- ✅ Press kit structure defined
+
+### Action Items
+- [ ] **Finalize press kit page at scripter.app/press:**
+  - Logos (PNG, SVG, EPS)
+  - Screenshots (dashboard, editor, collaboration)
+  - Founder photos and bio
+  - Brand guidelines
+  - Demo video
+- [ ] **Build media contact list (50+ targets):**
+  - Tier 1: TechCrunch, Verge, Wired (10)
+  - Tier 2: Variety, Deadline, THR (10)
+  - Tier 3: No Film School, ScreenCraft (15)
+  - Tier 4: Product Hunt, HN, Indie Hackers (10)
+  - Tier 5: LA Business Journal, local (5)
+- [ ] **Execute embargoed outreach (T-7 days):**
+  - Send personalized pitches to Tier 1
+  - Offer exclusive first-look interviews
+  - Provide demo access
+- [ ] **Set up press monitoring:**
+  - Google Alerts for "Scripter screenwriting"
+  - Mention.com or similar ($0-29/mo)
+  - Track all coverage in spreadsheet
+
+### Success Metrics
+- 10+ press mentions
+- 2-3 Tier 1 articles
+- 3-5 Tier 2 articles
+- 500+ signups from press coverage
+
+### Owner: CMO
+**Timeline:** Week 2-4 (embargoed outreach starts T-7)
+
+---
+
+## 4. Product Hunt Prep (Launch of the Day)
+
+### Current State
+- ✅ Product Hunt launch plan: `/marketing/product-hunt-launch-plan.md`
+- ✅ Product Hunt assets brief: `/marketing/product-hunt-assets-brief.md`
+- ✅ Video script: `/marketing/product-hunt-video-script.md`
+- ✅ Supporter outreach plan: `/marketing/product-hunt-supporter-outreach.md`
+- ✅ Supporter tracker: `/marketing/product-hunt-supporter-tracker-live.md`
+- ✅ VIP hunter list: `/marketing/vip-hunter-list-draft.md`
+- ✅ Asset directory: `/marketing/product-hunt-assets/`
+
+### Action Items
+- [ ] **Create Product Hunt page (T-14 days):**
+  - Submit for review (takes ~1 week)
+  - Craft hunter pitch (first comment)
+  - Prepare gallery images (6-8 screenshots/gifs)
+  - Set launch date (Tuesday/Wednesday best)
+- [ ] **Recruit 100+ day-one supporters:**
+  - Reach out to beta users
+  - Contact screenwriting influencers
+  - Engage hunter community
+  - Track commitments in supporter tracker
+- [ ] **Prepare launch day assets:**
+  - 60-second demo video
+  - GIFs showing key features
+  - Social media posts (scheduled)
+  - Email to waitlist (ready to send)
+- [ ] **Plan launch day execution:**
+  - Team upvote coordination (first hour critical)
+  - Comment response plan (respond to every comment)
+  - Social media blitz schedule
+  - Press amplification (if embargoed articles lift)
+
+### Success Metrics
+- Product Hunt: Top 5 product of the day
+- 2,000+ upvotes
+- 500+ comments
+- 1,000+ signups on launch day
+
+### Owner: CMO
+**Timeline:** Week 3-4 (launch day = Week 4, Day 1)
+
+---
+
+## Timeline Summary
+
+| Week | Focus | Key Deliverables |
+|------|-------|------------------|
+| **W1** | Waitlist + Beta | Landing page live, email sequences, beta recruitment starts |
+| **W2** | Press + Beta | Press kit live, media list built, embargoed outreach begins |
+| **W3** | Product Hunt | PH page submitted, supporter recruitment, asset creation |
+| **W4** | LAUNCH | Product Hunt day 1, press embargo lifts, all channels active |
+
+---
+
+## Dependencies
+
+- **CTO:** Product stability, analytics tracking, payment system live
+- **Ops:** Domain/email setup, press kit hosting
+- **Design:** Marketing assets, screenshots, logos
+
+---
+
+## Budget
+
+| Item | Cost |
+|------|------|
+| Press distribution (PR Newswire) | $400-800 |
+| Press monitoring (Mention) | $0-29/mo |
+| Email marketing (Mailchimp) | $0-50/mo |
+| Social scheduling (Buffer) | $0-30/mo |
+| **Total** | **$400-909** |
+
+---
+
+## Risks & Mitigation
+
+| Risk | Likelihood | Impact | Mitigation |
+|------|------------|--------|------------|
+| Low waitlist signups | Medium | High | Increase social activity, paid ads, influencer partnerships |
+| Press doesn't cover | High | Medium | Pivot to influencer strategy, double down on Product Hunt |
+| Product Hunt underperforms | Medium | High | Activate network, paid PH ads, community engagement |
+| Beta users inactive | Low | Medium | Better onboarding, weekly challenges, incentives |
+
+---
+
+## Next Actions (This Heartbeat)
+
+1. ✅ Review existing plans (done)
+2. **Create subtasks for each deliverable**
+3. **Assign execution timeline**
+4. **Set up tracking dashboard**
+5. **Begin beta recruitment**
+
+---
+
+**Parent Issue:** FRE-581 (Launch campaign plan)  
+**Related Issues:** FRE-628 (Launch week execution), FRE-629 (Product Hunt launch day)  
+**Goal:** 2c5a8678-b505-4e9c-8ec4-c41faa9626ff (Make incredible software)