/ › expansion › 06-onboarding-peer-study
Stream 06 — Onboarding + Storytelling + Peer-Systems Study
Diseña la experiencia de bienvenida generativa para visitantes nuevos del portal y produce un estudio de pares que informa a todos los demás streams del vision-expansion. Dos productos paralelos con dependencias asimétricas: peer-systems study aterriza temprano para que streams 1–5 puedan tomar prestados patrones; el spec de onboarding lo sigue.
Por qué este stream existe
Futuros se está expandiendo de instrumento de influencia estrecha
(Tier 1 — heads of state, CELAC, IDB) a plataforma cívica de
inteligencia regional (Tiers 2–4 — investigadores, asignadores
de capital, periodistas, sociedad civil, ciudadanía curiosa). Hoy el
portal es un atlas estático: un visitante nuevo aterriza en /
y ve datos densos sin contexto sobre por qué le importa a él
específicamente. Onboarding no es marketing-funnel — es enrutamiento
editorial: leer pistas, proponer una entrada tailored, dejar que
el visitante la rechace en un click. Nunca bloquea acceso a sustancia.
Decisiones tomadas
| # | Decisión | Razón |
|---|---|---|
| D1 | Persona prototipo = investigador | Alta señal/tiempo; bajo riesgo reputacional si la welcome generativa falla |
| D2 | Default-public, sin gate | JS gate contradecía "blueprint vivo"; resuelto 2026-05-04 — _private/ queda gated, resto público |
| D3 | Generativo = pre-renderizado por variante | LLM-en-vivo es excepción; 95%+ template + variante cacheada por (rol × país × idioma) |
| D4 | Variant cap = 252 variantes max | 6 roles × 14 países × 3 idiomas; cada una pasa validator + red-team antes de promoción |
| D5 | Lenguas indígenas: tagging y enlace, nunca auto-traducción | Auto-traducir Guaraní sin revisión comunitaria es captura técnica con cara cultural |
| D6 | Tier 1 onboarding minimalista; Tier 2–4 onboarding rico | Heads of state ya saben qué es Futuros antes de aterrizar |
| D7 | Flipbook ≠ animación pesada | Paced reveal + full-bleed + minimal chrome. NO Lottie, NO scroll-jacking |
| D8 | Triple-señal con declaración explícita gana siempre | Inferencia por referrer/idioma/país es default; visitante sobreescribe en un click |
Las 6 personas
| Persona | Tiempo target | Anchor primario | CTA |
|---|---|---|---|
| Ministro / Cabinet | 4 min | Anchor 0 + Compacto | Briefing privada (mailto + Calendly) |
| Investigador | 5 min | Datasets + metodología + Anchor 0 caso | Descargar dataset · leer metodología |
| Periodista | 5 min | Cifras citables + quote-line + press kit | Press kit · contacto press SLA 24h |
| Asignador de capital | 6 min | Pipeline de pilotos + comparable txns + financial model | Solicitar financial model · DD call |
| ONG / sociedad civil | 4 min | Mecanismos de inclusión + riesgos identificados | Unirse a consulta · auditar metodología |
| Curioso (default) | 3 min ≥ 20 min | Story arc régimen AGI → LATAM oferta | Profundizar / role-shift |
Spec de bienvenida generativa
"Generativo" ≠ "LLM en vivo". 95%+ de outputs generativos son pre-renderizados por variante, cacheados, y servidos como HTML estático. Live LLM en frente del visitante es excepción gateada.
| Modo | Cuándo invoca el LLM | Ejemplo |
|---|---|---|
| Pre-rendered (default) | Build-time o background tick | Welcome card "minister × Paraguay × es" |
| Edge-rendered (excepción) | Request-time vía edge function, cache 24h | Combo no pre-cubierta |
| Live LLM (excepción rara, gateada) | Cada request | Pregunta libre — no en welcome |
Cada variante pasa por: build-cohort → validator gate → red-team gate
→ human approval → promotion. Costo full rebuild estimado: ~$300–510
LLM + ~$2K human review per quarter. Compatible con $5/d budget guardrail.
Política bilingüe / multilingüe
Tier 1 (es-LA, pt-BR, en) — 100% del portal público; traducción humana obligatoria; auto-translate vetado. Tier 2 (fr, ht, nl) — escalable cuando haya traductor comprometido. Tier 3 lenguas indígenas (Guaraní, Quechua, Aymara, Mapudungun, Náhuatl, Maya yucateco, K'iche', Warao) — tagging y enlace, nunca auto-traducidas. Cualquier contenido en lengua indígena requiere consulta comunitaria, traductor hablante nativo, revisor distinto, validator + red-team gate con auditor cultural, y auditoría comunitaria post-publicación con poder de retracción.
Peer-systems study — 14 fiches
Estudio temprano (entrega semana 1) para que streams 1–5 puedan tomar prestados patrones sin reinventar. Cada fiche con lo que hacen bien · lo que hacen mal · qué robar (por stream) · qué evitar · aplicable a streams.
| Sistema | Tipo | Robar para |
|---|---|---|
| Our World in Data | Atlas + indicadores | Atlas (S3), Newsroom (S7) |
| Atlas of Economic Complexity | Country/product zoom | Atlas (S3), Country pages (S4) |
| IMF Data + Climate | Gov-grade reliability | Truth-infra (cross), Atlas (S3) |
| Metaculus + Manifold | Forecast aggregation | AGI horizon (S8), Pulse (S4) |
| AI Index (Stanford HAI) | Annual narrative + dashboard | Annual report (cross), AGI horizon (S8) |
| Epoch AI | Compute / capability tracker | AGI horizon (S8), resource-flow (S3) |
| CSIS Reconnecting Asia | Geopolitical infra mapping | Atlas resource-flow (S3) |
| Brookings Foresight Africa | Region-narrative annual | Annual report (cross), voz (S1) |
| Bloomberg NEF | Multi-tracker UX | Pulse (S4), simulator (S5) |
| Pitchbook / Crunchbase | Capital-allocator UX | Capital-allocator surface (S4) |
| Statista | Multi-audience low-end | Anti-pattern reference |
| Replicate / HF Spaces | Interactive simulator UX | Simulator (S5) |
| Observable / Pudding | Generative storytelling | Onboarding (S6), flipbook UX |
| Worldometers / Trading Economics | Pulse-style indicator surfacing | Pulse (S4) |
Cinco patrones transversales
- El country-page es el átomo, no la home. OWID, Atlas of Economic Complexity, World Bank, Trading Economics, Worldometers, IMF Data — todos asumen que el visitante tiene un país en mente y diseñan el atlas alrededor del shell del país.
- Source line bajo cada figura, sin excepciones. OWID, IMF, FT, Bloomberg, AI Index — cada gráfico tiene
Fuente · Nota · Actualizadodebajo. - Forecast aggregation requiere fuentes múltiples por defecto. Metaculus, Epoch AI, AI Index, Manifold — ninguno publica forecast de fuente única.
- Scrollytelling carries the AGI conversation; static dashboards lose it. Pudding, Observable, Bloomberg Graphics largos.
- El simulador exitoso esconde sus parámetros detrás de presets. Replicate, HF Spaces, Pitchbook screener.
Tres patrones que no debemos copiar
- Statista's pay-wall + auto-translation — degrada la fuente.
- Pitchbook's "everything is gated" — para Futuros (postura "blueprint vivo"), el patrón es opuesto: datos públicos por defecto.
- Bloomberg NEF's editorial paywall + branding heavy — la cabecera Bloomberg domina cada chart; para Futuros la cabecera debe desaparecer.
Prototipo
HTML estático autocontenido demostrando el arco narrativo + lenguaje de
diseño + LLM-pre-rendered welcome card para una persona × país × idioma.
Cero JS. Reduce-motion respetado. Print stylesheet. Mobile responsive.
Palette + typo del DESIGN_DIRECTIVE.md (paper + ink, brick red
+ deep teal, Newsreader / Inter / JetBrains Mono).
→ Abrir prototipo: investigador × Paraguay × ES
Handoff a otros streams
| Stream | Qué pueden tomar prestado |
|---|---|
| Stream 1 (voz) | Brookings × Pudding × Rest of World — institucional con autoría visible y postura |
| Stream 2 (datos) | Schema IMF-style; Epoch + Metaculus ingest; API /api/<indicator>/<country>.json |
| Stream 3 (atlas) | Country-shell consistente + project-as-object + capas resource-flow. SVG estático, no Mapbox |
| Stream 4 (pulse + audiencias) | Pulse usa shell BNEF + Worldometers calendar; capital-allocator usa shell Pitchbook adapted |
| Stream 5 (simulator) | Pyodide-in-browser; presets primero, knobs después; URL shareable; cost transparency |
| Stream 7 (newsroom) | Topic-pages OWID-style + diff-layer pulse + multi-author Brookings-style |
| Stream 8 (AGI horizon) | Forecast aggregation multi-fuente (Cotra + Davidson + Metaculus + Epoch + Apollo + METR); distribuciones, no puntos |
Archivos en branch
state/expansion/06-onboarding-peer-study/00-charter.mdstate/expansion/06-onboarding-peer-study/01-onboarding-flow.mdstate/expansion/06-onboarding-peer-study/02-story-arcs.mdstate/expansion/06-onboarding-peer-study/03-generative-welcome-spec.mdstate/expansion/06-onboarding-peer-study/04-flipbook-ux.mdstate/expansion/06-onboarding-peer-study/05-bilingual-multilingual.mdstate/expansion/06-onboarding-peer-study/06-prototype/index.htmlstate/expansion/06-onboarding-peer-study/99-handoff.mdresearch/peer-systems/_index.md+ 14 fiches
Branch: expansion/06-onboarding-peer-study. Sin push a main, sin PR.