waitlist-launch — Proceso de lanzamiento de sitio de lista de espera
Extraído del proyecto real fare-waitlist (2026-07, early-fare.hengshiou.com, referencia: /Users/xiuxiu/Documents/個人事宜/1_Projects/fare-waitlist).
Idea central: KV es la única fuente de verdad para la lista, antiabuso sin gastar escrituras KV, toda la configuración pública vía variables de runtime, sin redirigir tráfico hasta tener analytics, y el copy se basa en la venta inversa para generar confianza.
Tres documentos de rol (cargar bajo demanda, no todos a la vez)
| Archivo | Rol | Cuándo leerlo |
|---|---|---|
references/architecture.md | Arquitecto de información | Lectura obligatoria al empezar: lista de preguntas previas, proceso de seis fases, contrato API/KV (se puede copiar), límite entre var y secret, tabla de permisos de herramientas, manual de verificación, trampas conocidas |
references/copywriting.md | Especialista en marketing | Leer al escribir copy de página, copy para compartir, gráfico OG, planificar canales de difusión: fórmulas de H1 dolor, estructura del lede, fórmula de consentimiento, principios de venta inversa, playbook de canales + código de atribución ref |
references/operations.md | Product manager | Leer durante la verificación pre-lanzamiento y operación post-lanzamiento: lista de verificación gate (niveles obligatorio/recomendado), indicadores de éxito vs. vanidad, ritmo de retención, límites de decisión, plantilla de backlog de iteración |
Flujo de ejecución (desde la perspectiva del orquestador)
- Entrevista previa: Preguntar al usuario las 9 preguntas de la sección 1 del
architecture.md. No empezar sin respuestas. Atención: el handle de la comunidad debe verificarse (grep del código fuente del sitio web existente del usuario o confirmación directa del usuario), no adivinar con la memoria del modelo. - Reconocimiento del estado actual: Si es un repositorio existente, verificar con
git log; confirmar la cuenta de inicio de sesión de wrangler y los permisos de zona. - Implementación por fases (pasos detallados y definición de 'Done' en la sección 2 del
architecture.md):- Fase 1: Construcción base del sitio (Worker + assets + KV + custom domain)
- Fase 2: Sincronización de la lista con Resend (best-effort + relleno idempotente con ops/sync)
- Fase 3: Triple capa antiabuso (honeypot → rate limiting nativo → Turnstile, sin gastar escrituras KV)
- Fase 4: Footer de marca personal (discreto, peso visual menor que el CTA)
- Fase 5: Capa de exposición (og:image → referidos → analytics, en ese orden, todos modifican index.html)
- Fase 6: Verificación de despliegue (lista smoke + cache-buster)
- Copy: Cada espacio de copy (H1/lede/bullets/consent/tarjeta de prueba/frase para compartir) aplica las fórmulas del
copywriting.md. La frase de desaliento honesta debe ser verdadera. - Gate de lanzamiento: Marcar cada elemento de la sección 1 del
operations.md. No lanzar si algún elemento de nivel "obligatorio" no pasa. No comenzar a redirigir tráfico hasta tener analytics. - Post-lanzamiento: Los canales llevan código ref para atribución (sección 4 del
copywriting.md). Una vez que la lista supere los 100, hacer retención. La prueba social de número de personas solo se muestra cuando supera el umbral (sección 3 deloperations.md).
Disciplina de asignación de tareas (cuando hay múltiples subagentes)
- Múltiples tareas que modifican el mismo archivo (típico: las tres subtareas de la capa de exposición modifican index.html) → Asignar en secuencia, no en paralelo.
- Cada tarea de subagente debe incluir: qué archivos puede modificar, definición de 'Done', solicitar evidencia de prueba real (captura de pantalla/salida de curl), no hacer commit/deploy.
- El orquestador verifica tarea por tarea (diff + inspección visual de los artefactos clave; las imágenes deben ser revisadas visualmente), hace commit por tarea, y al final despliega todo junto + smoke en línea.
- El informe de entrega incluye cuatro cosas: branch, hash de commit, si está desplegado, si se limpió el worktree.
Cosas que el usuario debe hacer manualmente (no automatizables, avisar con antelación)
- Crear un Turnstile site en el dashboard de CF (obtener site key + secret)
- Crear un Web Analytics site en el dashboard de CF (obtener beacon token; wrangler OAuth no tiene permisos RUM, la API no puede crearlo)
- Resend: Crear una audiencia, generar una API key dedicada (no reutilizar la de otros sitios), verificar DNS del dominio de envío
- Al montar un custom domain por primera vez, puede ser necesario confirmar DNS/certificados en el dashboard
Escribir el código primero con el patrón de variables de runtime (/api/health las suministra dinámicamente al frontend). Una vez que los credenciales estén listos, rellenar var/secret y redeploy; sin cambiar código. Esto evita que "esperar credenciales" bloquee el desarrollo.
Las trampas más comunes (lista completa en la sección 5.3 del architecture.md)
- Captura de OG con headless Chrome:
--force-device-scale-factor=1(retina genera 2x) +--virtual-time-budget=4000(esperar webfont). Después de capturar, revisar visualmente (tipografía de respaldo, líneas huérfanas en títulos). - Después del deploy, el caché de borde devuelve el HTML antiguo → Verificar con
?cb=<timestamp>. - Turnstile en línea fuerza que curl no pueda probar /api/join → Las pruebas de contrato (casos normal/duplicado/honeypot) solo pueden hacerse localmente con
wrangler dev(sin secret, se salta automáticamente). - El honeypot/rate limit devuelve éxito suave pero no devuelve refCode (no dar información al bot); los ya registrados devuelven already + mismo refCode (idempotente).
- Si una API key en texto plano aparece en el diálogo/archivo → cambiar inmediatamente a secret.