{"slug":"developers/LAUNCH_PLAYBOOK","title":"Launch Playbook: Two-Layer Connection Model","section":"developers","sectionLabel":"Developers","status":"unclassified","type":"document","path":"developers/LAUNCH_PLAYBOOK.mdx","bytes":10144,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n\n> **Tier C — Historical.** This document is a point-in-time snapshot preserved for reference. For current architecture, see [CANONICAL_PLATFORM_ARCHITECTURE.md](../architecture/CANONICAL_PLATFORM_ARCHITECTURE.md).\n\n## The Complete Go-To-Market Motion\n\n**Headline**: \"One marketplace connection, one auth. Your AI tools automatically access all your business systems.\"\n\n**Timeline**: 2 weeks to launch (complete build + deployment)\n\n---\n\n## What You're Building\n\n### Layer 1: Identity (User ↔ IntegrateWise)\n- User clicks marketplace app (Claude, ChatGPT, Perplexity, Replit, Lovable)\n- OAuth flow → IntegrateWise creates tenant + user\n- JWT token issued (24-hour expiration)\n- MPC client now authenticated\n\n### Layer 2: Connectivity (IntegrateWise ↔ Business Systems)\n- Admin connects HubSpot, Salesforce, Stripe, etc. to IntegrateWise\n- IntegrateWise stores OAuth tokens for each system\n- Spine now hydrated with data from all systems\n- All AI clients automatically access all systems\n\n### Result\n- 1 AI client × 10 systems = 10 integrations\n- 5 AI clients × 10 systems = still 10 integrations (shared Spine)\n- 5 AI clients × 28 systems = still 28 integrations (shared Spine)\n\n---\n\n## Week 1: Foundation\n\n### Day 1-2: OAuth Endpoint (CONTINUITY_BRIDGE_SIMPLE.md)\n\n**What to build**:\n- GET /auth/authorize endpoint (accepts email, org_name, app, redirect_uri)\n- JWT generation (tenant_id, user_id, exp=24h)\n- Redirect back to marketplace app with token\n\n**Code**: Copy from CONTINUITY_BRIDGE_SIMPLE.md\n- oauth-handler.ts\n- jwt-validator.ts\n- feature-gate.ts\n\n**Verification**:\n```bash\n# Test OAuth flow\ncurl https://integratewise.com/auth/authorize \\\n  -G \\\n  --data-urlencode \"app=claude\" \\\n  --data-urlencode \"redirect_uri=claude-extension://callback\" \\\n  --data-urlencode \"email=test@company.com\" \\\n  --data-urlencode \"org_name=Test%20Company\"\n\n# Expected: HTTP 302 redirect with token in query params\n```\n\n**Deployment**: Deploy to production (Cloudflare Workers)\n\n---\n\n### Day 3: Feature Gate (FEATURE_ACTIVATION_SIMPLE.md)\n\n**What to build**:\n- Frontend useAuth hook (checks localStorage for JWT)\n- ConnectButton component (redirects to OAuth)\n- OAuth callback handler (stores token, redirects to app)\n- Middleware: Automatic tenant scoping on all queries\n\n**Code**: Copy from FEATURE_ACTIVATION_SIMPLE.md\n- useAuth.ts (React hook)\n- ConnectButton.tsx\n- callback/page.tsx\n- tenant-scoping middleware\n\n**Verification**:\n```bash\n# Test without token\ncurl https://gateway.integratewise.com/api/v1/spine/accounts\n# Expected: 401 Unauthorized\n\n# Test with token\ncurl https://gateway.integratewise.com/api/v1/spine/accounts \\\n  -H \"Authorization: Bearer eyJhbGc...\"\n# Expected: 200 OK (with tenant filter applied)\n```\n\n**Deployment**: Deploy to all 5 frontends\n- Claude Desktop extension\n- ChatGPT action\n- Perplexity integration\n- Replit integration\n- Lovable integration\n\n---\n\n### Day 4-5: Frontend Integration\n\n**Update all 5 frontends**:\n- Add useAuth hook to pages\n- Show ConnectButton if not authenticated\n- Show features if authenticated\n- Handle OAuth callback\n\n**Test**:\n1. Open Claude Desktop\n2. Click \"Connect IntegrateWise\"\n3. Enter email + org\n4. Authorize\n5. Redirected back\n6. Token stored\n7. Features visible\n\n---\n\n### Day 6-7: System Connectivity\n\n**What admin does**:\n- Goes to IntegrateWise dashboard\n- Clicks \"Connect HubSpot\"\n- Authorizes with HubSpot OAuth\n- Backend stores HubSpot token in KV\n- Creates Connectivity record: tenant_id → hubspot_token\n- Repeats for Salesforce, Stripe, etc.\n\n**What engineers build**:\n- Dashboard UI (CloudFlare Pages + React)\n- Connector handlers (accept OAuth code, store token)\n- Connectivity table (tenant_id, system, token)\n- Hydration logic (query all connected systems)\n\n---\n\n## Week 2: Testing + Launch\n\n### Day 8-9: Integration Testing\n\n**Test scenarios**:\n1. Claude → IntegrateWise → Salesforce (full chain)\n   - Claude user queries opportunities\n   - Gateway validates JWT\n   - Spine fetches from Salesforce\n   - Returns data to Claude\n\n2. ChatGPT → IntegrateWise → HubSpot (full chain)\n   - ChatGPT user queries contacts\n   - Gateway validates JWT\n   - Spine fetches from HubSpot\n   - Returns data to ChatGPT\n\n3. Multiple AI clients (same tenant)\n   - Claude and ChatGPT both query Salesforce\n   - Both see same data\n   - Verify tenant scoping\n\n4. Multiple systems\n   - Query Salesforce + HubSpot + Stripe in one request\n   - Verify merging logic\n   - Verify normalization\n\n5. Failure scenarios\n   - Salesforce down → Still get HubSpot + Stripe data\n   - Token expired → Automatic refresh\n   - Invalid tenant → 403 Forbidden\n\n---\n\n### Day 10-11: Performance Testing\n\n**Load test**:\n- 100 concurrent users\n- 10 requests per second\n- Measure latency: Query → Response\n\n**Targets**:\n- OAuth: < 1 second\n- Query: < 500ms\n- Token validation: < 10ms\n\n**Monitor**:\n- Error rate: < 0.1%\n- Success rate: > 99.9%\n- P95 latency: < 1 second\n\n---\n\n### Day 12-13: Production Deployment\n\n**Deployment checklist**:\n- [ ] OAuth endpoint deployed (Cloudflare)\n- [ ] JWT validator middleware in Gateway\n- [ ] Feature gate middleware in Gateway\n- [ ] All 5 marketplace apps updated\n- [ ] Connectivity handlers deployed\n- [ ] Spine hydration updated\n- [ ] Monitoring dashboards live\n- [ ] Support playbooks ready\n\n**Verification**:\n- [ ] Claude marketplace app works\n- [ ] ChatGPT app works\n- [ ] Perplexity app works\n- [ ] Replit app works\n- [ ] Lovable app works\n- [ ] OAuth success rate > 99%\n- [ ] Feature visibility correct\n- [ ] Tenant scoping verified\n\n---\n\n### Day 14: Launch\n\n**Pre-launch (morning)**:\n- [ ] Final smoke tests\n- [ ] Monitor error rates\n- [ ] Team on standby\n\n**Launch (noon)**:\n- [ ] Publish Claude marketplace app\n- [ ] Announce on Product Hunt\n- [ ] Email beta list\n- [ ] Social media posts\n\n**Post-launch (afternoon)**:\n- [ ] Monitor OAuth success rate\n- [ ] Monitor first connections\n- [ ] Track feature usage\n- [ ] Check support tickets\n\n---\n\n## Success Metrics\n\n### Launch Day\n- OAuth success rate: > 99%\n- Time to features: < 2 minutes\n- First 50 users connected\n\n### Launch Week\n- 100+ connections\n- 50+ active users\n- All 5 platforms working\n- 0 support tickets about \"can't see features\"\n\n### Week 2\n- 500+ connections\n- 250+ active users\n- Multi-system queries working\n- Revenue tracked\n\n### Month 1\n- 5,000+ connections\n- 2,000+ active users\n- All 28 connectors available\n- $50k+ revenue\n\n---\n\n## Marketing Timeline\n\n### Week 1 (Build)\n- [ ] Product Hunt landing page\n- [ ] Social media assets\n- [ ] Email templates\n- [ ] Launch announcement\n\n### Week 2 (Pre-launch)\n- [ ] Product Hunt scheduling\n- [ ] Email list segmentation\n- [ ] Social media queue\n- [ ] Press outreach\n\n### Week 2-3 (Launch)\n- [ ] Product Hunt launch (Tuesday 10 AM)\n- [ ] Email to beta list\n- [ ] Social media blitz\n- [ ] Influencer outreach\n- [ ] Press coverage\n\n### Week 3-4 (Growth)\n- [ ] Case studies\n- [ ] User interviews\n- [ ] Feature announcements (Phase 2)\n- [ ] Enterprise outreach\n\n---\n\n## Sales Timeline\n\n### Week 1-2\n- [ ] Sales team training (product + GTM motion)\n- [ ] Sales deck ready\n- [ ] Demo script ready\n- [ ] Objection handling playbook\n\n### Week 3-4\n- [ ] Pilot customers (5-10)\n- [ ] Feedback collection\n- [ ] Case study development\n- [ ] Enterprise sales outreach\n\n---\n\n## Developer Responsibilities\n\n### Backend\n- OAuth endpoint (Day 1-2)\n- JWT validation (Day 3)\n- Feature gate (Day 3)\n- Connector handlers (Day 6-7)\n- Hydration logic (Day 6-7)\n\n### Frontend\n- useAuth hook (Day 4)\n- ConnectButton (Day 4)\n- OAuth callback (Day 4-5)\n- Feature visibility (Day 5)\n- Dashboard (Day 6-7)\n\n### DevOps\n- Deploy OAuth to Cloudflare (Day 2)\n- Deploy middleware to Gateway (Day 3)\n- Deploy frontend updates (Day 5)\n- Monitoring setup (Day 7)\n- Load testing (Day 10-11)\n\n### QA\n- Integration tests (Day 8-9)\n- Performance tests (Day 10-11)\n- Smoke tests (Day 14)\n\n---\n\n## Rollback Plan\n\nIf critical issues found:\n\n1. **Stop new signups** (disable Claude marketplace app)\n2. **Notify users** (pending features delayed)\n3. **Revert code** (rollback to previous version)\n4. **Debug** (identify root cause)\n5. **Fix** (implement solution)\n6. **Re-test** (full test suite)\n7. **Redeploy** (to production)\n8. **Resume signups** (re-enable marketplace app)\n\n**Target**: 30 minutes from detection to recovery\n\n---\n\n## Communication Plan\n\n### To Team\n- Daily standup (Slack #integratewise-launch)\n- Weekly sync (Tuesday 9 AM)\n- Escalation: Slack @here if critical issue\n\n### To Beta Users\n- Email: \"Launching this week, early access\"\n- Feature preview: \"Here's what you'll get\"\n- Post-launch: \"We're live!\"\n\n### To Public\n- Product Hunt: \"One marketplace connection, infinite business systems\"\n- Twitter: Show demo video\n- LinkedIn: Long-form post\n- Blog: Technical deep-dive\n\n---\n\n## Success Looks Like\n\n- [ ] OAuth success rate > 99% (no bugs)\n- [ ] Feature visibility correct (users see features)\n- [ ] All 5 platforms working (Claude, ChatGPT, Perplexity, Replit, Lovable)\n- [ ] First 100 users connected smoothly\n- [ ] Zero \"why can't I see features\" support tickets\n- [ ] Positive feedback from beta users\n- [ ] Product Hunt top 10\n- [ ] $10k+ ARR in first month\n\n---\n\n## Phase 2 (After Launch)\n\n- Week 3: Add memory + cross-domain metrics\n- Week 4: Activate Agent Lee\n- Week 5: Monetization (usage-based billing)\n- Week 6: Enterprise tier\n- Week 7-8: Scale to 10,000+ users\n\n---\n\n## Quick Reference\n\n**File structure**:\n- OAuth code: CONTINUITY_BRIDGE_SIMPLE.md\n- Feature gate: FEATURE_ACTIVATION_SIMPLE.md\n- Visual diagrams: TWO_LAYER_VISUAL_DIAGRAMS.md\n- Complete model: TWO_LAYER_CONNECTION_MODEL.md\n\n**Key URLs**:\n- OAuth endpoint: https://integratewise.com/auth/authorize\n- Gateway: https://gateway.integratewise.com\n- Dashboard: https://integratewise.com/dashboard\n- Claude app: Claude Marketplace (search \"IntegrateWise\")\n\n**Key contacts**:\n- Engineering lead: [name]\n- Product lead: [name]\n- Marketing lead: [name]\n- Executive sponsor: [name]\n\n---\n\n## You're Ready\n\nEverything is documented. All code is provided. Timeline is clear.\n\n**Start Day 1. Launch Week 2. Win Month 1.**\n\nGo build.\n"}