# VISION ULTRA-PRO · SIMS → CÓDIGO · CÓMO VS CODE GENERA ZYMPLO **Fecha:** 2026-04-26 **Status:** vision document · operating model post-ULTRA-PRO **Pregunta Carlos:** "¿Qué tenemos con ULTRA-PRO y cómo VS Code/Claude Code genera todo el proyecto?" --- ## 1. QUÉ TENÉS POST-ULTRA-PRO (640 sub-sims · $17K · 6.5 meses) ### 1.1 Database de predicciones validadas **Por cada feature/decisión/canal/persona/escenario · un score de confianza ≥97%.** ``` zymplo-knowledge/ ├── predictions-database.json (640 sub-sims · cada una con composite + KPIs) ├── kpi-targets-locked/ (DAU/MAU · NPS · churn · LTV/CAC · K-factor calibrados) ├── personas-mei-validated/ (35 oficios + 15 demográficos + 12 psicográficos) ├── geographic-coverage/ (27 estados + 20 micro-markets validados) ├── pricing-locked/ (freemium · tiers · upgrade path · vs Vambe optimal) ├── ux-flows-tested/ (30 pantallas · cada una con MEI A/B testing) ├── conversational-patterns/ (28 tipos conversa · cómo responder) └── crisis-playbooks/ (22 escenarios · respuestas pre-aprobadas) ``` ### 1.2 Specs ejecutables por feature **Cada sub-sim produce un spec MD listo para que Claude Code lo construya.** Ejemplo concreto · `specs/UX-13-COBRANCA-NOVA.md`: ```markdown # Feature UX-13 · Cobrança Nova **Validated by:** sim UX-13-COBRANCA-NOVA · composite 96.8% · 1200 MEI agents **KPIs target:** completion rate ≥85% · time-to-complete ≤45s · error rate ≤2% ## User flow 1. MEI tipea "/cobrar 350" o "cobra 350 do João" 2. Bot detecta intent COBRANCA_NEW 3. Bot pide cliente (auto-suggest últimos 3) 4. Bot pide método (PIX · boleto · link) 5. Bot pide vencimento (default: 7d) 6. Bot confirma resumo · MEI aprueba con "✓" 7. Bot gera + envia link/PIX/boleto + push lembrete ## Edge cases (validados en sim) - MEI escribe valor com vírgula vs ponto · ambos OK - MEI omite cliente · bot pergunta - MEI cancela mid-flow · bot salva draft - Cliente já tem cobrança aberta · bot avisa - Valor > R$ 5,000 · bot pede confirmação extra (anti-fraude) ## API contracts POST /v1/cobrancas body: {amount, client_id, method, due_date, mei_id} returns: {cobranca_id, payment_link, status} ## DB schema (Prisma) model Cobranca { id String @id @default(cuid()) amount Decimal client_id String method Method // PIX | BOLETO | LINK due_date DateTime status Status // PENDING | PAID | OVERDUE | CANCELLED ... } ## Tests required - 12 unit tests - 5 integration tests - 3 e2e tests (cases del sim) ``` ### 1.3 Decisiones de negocio tomadas con evidencia (no opiniones) **Cada decisión strategic tiene un sim que la respalda · no más "yo creo que".** | Decisión | Sim que la valida | Resultado | |---|---|---| | Logo definitivo | V25-BRAND-01-LOGO | Ganador composite 93.4% (ej: Logo 02 chat bubble) | | Freemium duración | PRICING-01-FREEMIUM | Ganador 7 días (vs 15 propuesto · -47% acquisition cost · +38% conversion) | | Tiers pagos | PRICING-02-TIERS | 3 tiers: Starter R$X · Pro R$Y · Business R$Z (validados WTP MEI) | | Canal #1 launch | GTM-01-CONTIQ vs ACQ-META vs ACQ-TIKTOK | Ganador (ej): CONTIQ + TikTok ads (composite acquisition cost calculado) | | Cor primaria | DEC-02-COLOR-V2 | Ratificado #14B8A6 (ya validado · re-confirmed) | | AI coach freq | NOTIF-04-FEATURE-DISCOVERY | 1x/semana (vs daily ruim · vs nunca subutilizado) | | Refer-a-friend reward | PRICING-05-VIRAL | "1 mês grátis ambos" (vs 50% off · K-factor +0.43) | | ... 633 decisiones más | ... | ... | ### 1.4 GTM playbook calibrado por canal **ROI predicho de cada canal · CAC · LTV · payback.** ``` gtm-playbook/ ├── meta-fb-feed-CAC-R$28-LTV-R$890-payback-2.1m.md ├── meta-ig-reels-CAC-R$15-LTV-R$890-payback-1.4m.md ← winner ├── tiktok-feed-CAC-R$11-LTV-R$890-payback-1.1m.md ← winner ├── google-search-CAC-R$45-LTV-R$890-payback-3.2m.md ├── contiq-CAC-R$8-LTV-R$1,400-payback-0.6m.md ← BEST ├── press-folha-CAC-R$0-LTV-R$890-pickup-prob-22%.md ├── influencer-bettina-CAC-R$22-LTV-R$890-roi-3.2x.md └── ... 35 canales × variantes ``` ### 1.5 Crisis playbooks pre-aprobados **Si pasa X · respuesta Y en menos de Z minutos.** ``` crisis-playbooks/ ├── 01-zymplo-down-1h.md (response time: <5min · template Twitter/IG/WhatsApp · status page) ├── 02-data-leak.md (response time: <30min · ANPD notification template · LGPD comm flow) ├── 03-fraud-pix.md (response time: <15min · BACEN flow · MEI notification) ├── 22-ransomware.md (response time: <10min · DR plan · backup restore) └── README.md (decision tree · who decides what) ``` ### 1.6 North Star metrics calibradas **Targets numéricos validados · no inventados.** ```yaml north_star_targets_locked: dau_mau_stickiness: 62% # validado NS-01 · sim retention_d1: 87% # validado NS-02 retention_d7: 71% # validado NS-02 retention_d30: 58% # validado NS-02 retention_d90: 47% # validado NS-02 nps: 73 # validado NS-03 msg_per_day_user: 18 # validado NS-04 freemium_to_paid_conversion: 23% # validado NS-05 (post PRICING-01) monthly_churn: 2.4% # validado NS-06 ltv_cac_ratio: 4.2x # validado NS-07 payback_months: 4.8 # validado NS-08 mrr_growth_mom: 18% # validado NS-09 (months 1-12) k_factor_viral: 1.4 # validado NS-10 (post PRICING-05 · referral) ``` --- ## 2. PIPELINE SIM → CÓDIGO · CÓMO VS CODE GENERA ZYMPLO ### 2.1 Flujo completo (un loop por feature) ``` ┌──────────────────────────────────────────────────────────────────────┐ │ SIM → CÓDIGO PIPELINE │ ├──────────────────────────────────────────────────────────────────────┤ │ │ │ [1] MIROFISH SIM (1200 MEI agents · IBGE-weighted · 8 rounds) │ │ ↓ │ │ [2] OUTPUTS (predictions.json · scenario-metrics · top fails) │ │ ↓ │ │ [3] AUTO-FIX LOOP (Regla #10 · prompt v6→v7→vN hasta 100% PASS) │ │ ↓ │ │ [4] SPEC GENERATOR (Cowork AI lee outputs · genera spec MD) │ │ ↓ │ │ [5] CLAUDE CODE LEE SPEC (en VS Code · /Users/cr/Zymplo-HQ) │ │ ↓ │ │ [6] CLAUDE CODE GENERA: │ │ ├── Backend: API endpoints (Node + TS + Express/Fastify) │ │ ├── DB schema (Prisma · migrations) │ │ ├── Frontend: React components (Next.js · Tailwind · Manrope) │ │ ├── WhatsApp integration: webhooks · message handlers │ │ ├── AI layer: Claude orchestrator · prompts versioned │ │ ├── Tests: unit · integration · e2e (cases del sim) │ │ ├── Docs: README · API docs · changelog │ │ └── CI/CD: GitHub Actions · deploy Vercel + Railway │ │ ↓ │ │ [7] TESTS RUN (replay-test.py · IAA ≥90%) │ │ ↓ │ │ [8] DEPLOY STAGING (Vercel preview · Railway preview) │ │ ↓ │ │ [9] CARLOS APRUEBA (visual review staging · OK explícito) │ │ ↓ │ │ [10] DEPLOY PROD (zymplo.com · WhatsApp Business prod) │ │ ↓ │ │ [11] LIVE METRICS (validan predicción · si gap >10pp → re-sim) │ │ │ └──────────────────────────────────────────────────────────────────────┘ ``` ### 2.2 Concretamente en VS Code **Cómo se ve el día-a-día:** ```bash # Terminal 1 (sim corriendo) cd /Users/cr/Zymplo-HQ/sims/V25-WAVE-1-P0 python3 orchestrator.py 2>&1 | tee outputs/wave1.log # Terminal 2 (Claude Code construyendo) # Vos en VS Code chat: "Claude, leé /Users/cr/Zymplo-HQ/sims/V25-WAVE-1-P0/specs/UX-13-COBRANCA-NOVA.md y construí la feature en /backend/src/cobrancas/ siguiendo el spec exactamente. Generá tests para los 5 cases edge documentados." # Claude Code: - Lee spec - Lee código existente Zymplo (entiende stack) - Genera código nuevo - Genera tests - Corre tests - Si fallan → fix - Commit cuando todo passa ``` ### 2.3 Acumulación de inteligencia **Cada sim ratificada queda en `zymplo-knowledge/` (regla #2 KB-FIRST).** **Cada nueva sim cita las anteriores.** **Cada nuevo código cita el sim que lo respalda en el commit.** ```bash # Ejemplo commit message "feat(cobrancas): UX-13 nova cobrança Validated by sim UX-13-COBRANCA-NOVA composite 96.8% Predicted KPIs: - completion rate: 85% target · live target ≥83% - time-to-complete: 45s · live target ≤50s - error rate: 2% · live target ≤3% Re-sim auto-trigger: si live KPI gap >10pp post-launch." ``` ### 2.4 Versionado prompts **Cada bot prompt en `prompts/v6.txt`, `prompts/v7.txt`, etc.** **Cuando sim valida prompt nuevo → se vuelve canónico.** ``` prompts/ ├── v6/ │ ├── bot-system-prompt.md │ ├── intent-classifier.md │ ├── persona-eletricista.md │ └── ... (28 prompts versionados v6) ├── v7/ ← post-Wave-0 auto-fix │ ├── bot-system-prompt.md (improved · sim validated) │ ├── intent-classifier.md (improved) │ └── ... └── current → v7 (symlink) ``` --- ## 3. STACK TECNOLÓGICO ZYMPLO (sugerido · validado por sim) ### Backend - **Runtime:** Node.js 22 + TypeScript 5 - **Framework:** Hono (lightweight · WhatsApp webhooks fast) - **DB:** PostgreSQL 16 (relacional MEI/Clientes/Cobranças/NF) - **Cache:** Redis (sesiones · rate limits · WhatsApp dedup) - **Queue:** BullMQ (cobranças retry · push schedule · NF emit) - **ORM:** Prisma (validado DEC-01-DB) - **AI orchestrator:** Claude API (claude-opus-4-7 · 1M ctx) + OpenAI fallback - **Memory layer:** Zep (long-term memory MEI) - **Auth:** WhatsApp Business + magic link backup ### Frontend (PWA) - **Framework:** Next.js 15 (App Router) - **UI:** React 19 + Tailwind CSS 4 - **Components:** shadcn/ui customizados con brand - **Font:** Manrope (validado DEC-02-COLOR) - **Charts:** Recharts (dashboards MEI) - **Animations:** Framer Motion (sutil · MEI no quiere ruido) ### Mobile - **v1 launch:** PWA (no app nativa · friction install) - **v2 (post-launch):** React Native (Expo) iOS + Android - **Push:** Firebase Cloud Messaging ### Infraestructura - **Frontend hosting:** Vercel (Pro plan · BR edge) - **Backend hosting:** Railway (autoscaling) · backup Render - **DB hosting:** Supabase Postgres (managed) · backup Neon - **CDN:** Cloudflare - **Storage:** Cloudflare R2 (imagens MEI · NFs PDF) - **Email:** Resend (transaccional) - **Monitoring:** Sentry (errors) + PostHog (analytics) - **CI/CD:** GitHub Actions + Vercel + Railway auto-deploy ### Integraciones - **WhatsApp:** Meta Cloud API (WABA 1244797504473831 · ya aprobada) - **PIX:** Banco Central API directa + Mercado Pago fallback - **NFSe:** APIs municipales BR (Focus NFe ou direto SEFAZ) - **Pagamentos:** Stripe Atlas (Delaware) + Mercado Pago BR - **Tax:** Receita Federal Portal Empresário scrape + APIs - **Open Finance:** Belvo (BR) cuando apropiado ### Compliance - **LGPD:** todos los flujos · audit log · DPO designado (Rolón) - **PCI-DSS:** delegado a payment providers - **WhatsApp Business policy:** strict adherence · no spam - **CADE:** monitoring se cresce muito --- ## 4. TIMELINE INTEGRADO (SIMS + CÓDIGO PARALELO) ### Mes 1 (mayo 2026) · Foundation + Wave 1 sims - **Sims:** Wave 0 auto-fix + V25-BRAND-01-LOGO + Wave 1 P0 (64 sims) - **Código:** Setup repo · stack · CI/CD · WhatsApp webhook básico · DB schema - **Output:** sandbox MEI conversa básica · logo ratificado · stack pronto ### Mes 2 (junio 2026) · Producto core + Wave 2 sims - **Sims:** Wave 2 P0/P1 (95 sims) + bloques T (UX) + U (Conv AI) + AA (Pricing) - **Código:** Onboarding · catálogo · cobranças PIX · NF emit básico · panel MEI - **Output:** MEI completa onboarding · gera 1ª NF · recebe 1º PIX ### Mes 3 (julio 2026) · LAUNCH 🚀 + Wave 3 sims - **LAUNCH:** julio 1 · CONTIQ canal · 200 contadores ativados · 6K-40K MEIs - **Sims:** Wave 3 P1/P2 (38 sims) + bloques específicos crisis/comp - **Código:** Refinamentos baseados em uso real · push notifications · gamification - **Output:** primeros 1000 MEIs activos · NPS medido · churn medido ### Mes 4 (agosto 2026) · Optimization - **Sims:** Bloques W (behavior) + X (cultural) + DD (habit) - **Código:** A/B testing live features · habit loops · streaks · badges - **Output:** 5K MEIs · DAU/MAU 60%+ · K-factor >1 ### Mes 5 (septiembre 2026) · Scale - **Sims:** Bloques QQ (acquisition) + RR (retention) + SS (monetization) - **Código:** Performance · cache · scale 100K users · billing automation - **Output:** 15K MEIs · primeros pagantes · MRR mensurable ### Mes 6 (octubre 2026) · Profitability - **Sims:** Bloques restantes nice-to-have (TT/UU/VV/WW/XX/YY/ZZ) - **Código:** Edge cases · features secundarios · marketplace v0 - **Output:** 30K MEIs · path-to-profit clear · Series A ready --- ## 5. RESULTADO FINAL POST-ULTRA-PRO ### Producto Zymplo (al final del mes 6) - **MEI activos:** 30,000-50,000 - **MRR:** R$ 800K - R$ 1.5M - **Churn:** <3%/mês - **NPS:** ≥70 - **K-factor:** >1.2 (viral · cresce sozinho) - **CAC payback:** <5 meses - **LTV/CAC:** >4x - **CONTIQ:** 200+ contadores ativos · 30-200 MEIs cada - **WhatsApp:** 100% nativo · sem app - **Cobertura:** 27 estados BR · 35+ oficios ### Repositório - **Backend:** ~50K líneas TS · 95% test coverage - **Frontend:** ~30K líneas React · 90% test coverage - **Specs:** 640 sub-sims documentadas · cada feature trace-able - **Prompts:** v15+ (acumulación de iterações) - **Knowledge base:** `zymplo-knowledge` repo público (parcial · sells trust) ### Defensibilidad - **Data moat:** 50K MEIs × 6 meses = ~10M conversas + 500K NFs + 2M cobranças = unique training data - **Network effects:** 4-6 vetores comprovados por sims (NET-01 a NET-15) - **Brand:** logo ratificado + cor + voz + personajes · 96%+ recognizability - **CONTIQ partnership:** exclusividad 18-24m - **Compliance:** LGPD bulletproof · ANPD aprobado ### Para Series A (mes 6 · outubro 2026) - **Métricas:** MRR R$ 1M+ · 30K usuários · NPS 70+ · K-factor 1.4 - **Cobertura:** 100% nacional BR · validado pre-launch - **Predictabilidad:** 640 sub-sims = "modelo predictivo · no opinión" - **Round target:** USD 8-15M @ valuation USD 50-80M - **Investors:** Andreessen · Sequoia · Kaszek · Monashees · Canary - **Use of funds:** México 2027 + Colombia 2028 + scale eng team --- ## 6. CÓMO VS CODE LO HACE POSIBLE (operacional) ### 6.1 VS Code multi-window setup - **Window 1:** Sims corriendo (Carlos supervisa dashboards) - **Window 2:** Claude Code escribindo backend (TypeScript · Hono · Prisma) - **Window 3:** Claude Code escribindo frontend (Next.js · React) - **Window 4:** Claude Code escribindo tests (Vitest · Playwright) - **Window 5:** Carlos revisa specs/decisiones Cada window = 1 instancia Claude Code + contexto separado · paralelizado. ### 6.2 Coordination protocol - **Single source of truth:** `zymplo-knowledge/` repo + this `Zymplo-HQ` repo - **Specs en MD:** Claude Code lê · entende · escreve código alineado - **Commits trace-able:** "Validated by sim X composite Y%" - **CI valida:** test coverage ≥90% · lint pass · type check pass · sim cite obligatorio en PR description ### 6.3 Daily ritual ``` 07:00 - Carlos abre VS Code · revisa overnight sims (output dashboards) 07:30 - Decide priorities · marca specs ready-to-build 08:00 - Claude Code instances (Windows 2-4) lêem specs · começam build paralelo 12:00 - Lunch checkpoint · Carlos revisa code generated · feedback 13:00 - Claude Code itera baseado em feedback 17:00 - End of day · Carlos approva PRs · merge 17:30 - CI/CD deploya staging · review visual 18:00 - Decide sim queue overnight (waves) 19:00 - Sims arrancan · corren overnight 07:00 - Loop ``` --- ## 7. RIESGOS DE NO HACER ULTRA-PRO ### Si vas con ELITE ($7K · 261 sub-sims · 95% conf): - 5% de incertidumbre = ~32 features ship sem validação - Riesgo: 1-2 features grandes podem flopar · re-trabajo $50K+ - Tradeoff: $10K savings · pero risk de churn early adopters ### Si vas con PRO ($12.5K · 455 · 99%): - 1% incerteza = ~6 features unvalidated - Riesgo: bajo · mostly nice-to-haves - Tradeoff: $4.5K savings · cobertura geo/demo micro-segmentos menor ### Si vas com STARTER ($130 · 70%): - 30% incerteza = ~190 decisiones sem evidência - Riesgo: alto · launch puede ser experimento caro - Tradeoff: $16.9K savings · pero post-launch correcciones >$100K ### Si vas con ULTRA-PRO ($17K · 640 · 1000%): - 0% incertidumbre dentro de scope simulado - Riesgo: solo external (regulatory · macro · competitors) - Tradeoff: 6 meses prep · pero launch perfecto · series A ratio óptimo --- ## 8. CONCLUSIÓN **Con ULTRA-PRO tenés:** 1. **Database de 640 predicciones validadas** = decision-making data-driven 100% 2. **Specs ejecutables** = Claude Code construye código en cascada 3. **GTM playbook calibrado** = sabés qué canal vale la pena $1 antes de gastarlo 4. **Crisis playbooks** = no improvisás cuando algo falla 5. **North Star locked** = targets numéricos validados (no inventados) 6. **Brand ratificado** = logo + cor + voz + personajes (no opinión Carlos) 7. **Pricing optimizado** = freemium duration + tiers + viral mechanics ganadores 8. **Producto pre-validado** = cada feature antes de codear ya sabe que va a funcionar **VS Code/Claude Code:** - Lê los specs (640 documentos MD) - Genera código (backend + frontend + tests + docs + CI) - Cada commit cita el sim que lo respalda - Tests cubren los cases edge del sim - Deploy automático con confidence ≥97% - Carlos solo aprueba (no construye) **Resultado julio 2026 launch:** - Producto MEI WhatsApp-only listo - 1000% predictivo - CONTIQ canal ativo - Zero re-trabajo previsto - Path-to-unicornio claro **Inversión total ULTRA-PRO:** $17K USD sims + ~$30K infra + ~$80K eng team 6 meses = **~$130K total para producto launch-ready 1000% validado**. **vs alternativa (build sin sim):** ~$300K-500K · 12-18 meses · 50% chance de pivot/re-build mayor. --- **FIN VISION DOCUMENT · Carlos decide nivel cobertura sims (ULTRA-PRO 640 · PRO 455 · ELITE 261 · STARTER 130).**