AgentFlow v2.4.0 — Plan de Lanzamiento a Producción

Pre-Launch Checklist

💻

Calidad de Código

7/7

✓Tests pasan (unit 847, e2e 94)
✓Build sin warnings (2m 14s)
✓ESLint + TypeScript strict OK
✓PR revisada y aprobada ×2
✓Sin TODO pendientes críticos
✓Sin console.log en producción
✓Error handling cubre WS failures

🔒

Seguridad

6/7

✓Sin secrets en VCS (git-secrets OK)
✓npm audit: 0 critical, 0 high
✓Validación entrada WS endpoints
✓Auth con JWT + permisos workspace
⚠CSP header: ampliar nonce para YJS
✓Rate limiting en WS handshake
✓CORS restringido a agentflow.io

⚡

Rendimiento

7/7

✓LCP 1.8s · INP 82ms · CLS 0.02
✓Sin N+1 en queries workspace
✓Avatares optimizados + lazy load
✓Bundle +18KB gzip (dentro de budget)
✓Índice en workspace_members.user_id
✓Cache Redis para permisos (60s TTL)
✓CDN Vercel configurado

Accesibilidad

6/6

✓Navegación teclado en workspace modal
✓ARIA live region para cambios CRDT
✓Contraste 5.1:1 (WCAG AA)
✓Focus trap en diálogo de invitación
✓Errores de formulario con aria-describedby
✓axe-core: 0 errores, 0 warnings

🏗️

Infraestructura

5/5

✓Vars prod configuradas en Vercel
✓Migración additive lista para aplicar
✓SSL auto Vercel + dominio verificado
✓Sentry DSN configurado
✓Health check /api/health responde 200

📄

Documentación

4/5

✓README con requisitos WebSocket
✓API docs workspace endpoints
✓ADR-047: elección YJS vs Automerge
✓CHANGELOG.md actualizado
○Docs usuario (pendiente marketing)

Feature Flag Lifecycle — shared_workspaces_enabled

✓

Deploy con flag OFF

✓

Equipo interno (14 usuarios)

5%

Canary — 60 usuarios Enterprise

25%

Rollout parcial Plan Pro

50%

Mitad de usuarios

100%

Full GA + limpieza flag

Propietario: Marta García · Expiración del flag: 30 jun 2026 · Ventana de monitorización por etapa: 24–48 horas

Rollout Gradual y Umbrales de Decisión

Secuencia de Rollout

✓

Deploy a Staging

Suite completa + smoke test manual de flujos críticos

DONE

✓

Deploy a Producción (flag OFF)

Verificar health check · sin nuevos errores en Sentry

DONE

✓

Equipo interno (14 usuarios)

Uso real en producción · ventana 24h · 0 incidencias

DONE

4

Canary 5% — Enterprise

~60 usuarios · monitorizar error rate, P95, métricas negocio · 24–48h

EN CURSO

5

Rollout progresivo 25% → 50% → 100%

Misma monitorización en cada etapa · posibilidad de revertir porcentaje

PENDIENTE

6

Full rollout + limpieza flag

1 semana monitorización · eliminar flag + código muerto antes 30 jun

PENDIENTE

Umbrales de Decisión por Métricas

Métrica	Avanzar	Mantener	Revertir
Tasa de errores	≤ +10% baseline	+10% a +100%	> 2× baseline
P95 latencia	≤ +20% baseline	+20% a +50%	> +50% baseline
JS errors (cliente)	Sin nuevos tipos	< 0.1% sesiones	> 0.1% sesiones
Conversión a workspace	Neutral o positiva	Caída < 5%	Caída > 5%

Revertir INMEDIATAMENTE si:

• Error rate > 2× baseline o P95 latencia > +50%
• Spike de reportes de usuario en Intercom
• Problema de integridad de datos (YJS conflict resolution)
• Vulnerabilidad de seguridad descubierta en workspace sharing

Monitorización Post-Deploy & Plan de Rollback

📊 Métricas en Tiempo Real (Canary 5%)

Error rate actual

0.12%

Baseline: 0.11% · +0.01pp ✓

P95 Latencia API

187ms

Baseline: 178ms · +5% ✓

Activos en workspace

24

Sesiones WS activas · sin drops

LCP

1.9s

Baseline: 1.8s · +5% ✓

JS Errors / sesión

0.003%

Sin nuevos tipos de error ✓

DB Pool usage

34%

Max pool: 20 conns · OK ✓

✓ Todas las métricas dentro del umbral VERDE — listo para avanzar a 25%

🔄 Plan de Rollback Documentado

1

Deshabilitar feature flag en LaunchDarkly
shared_workspaces_enabled → OFF para 100% usuarios

< 30s
2

Verificar rollback: health check + Sentry (sin nuevos errores)
Test flujo crítico manualmente

2–3 min
3

Comunicar al equipo en Slack #deployments
Incluir causa, usuarios afectados, próximos pasos

inmediato
4

BD: Migración es additive — no requiere rollback.
Tabla workspaces permanece inactiva hasta próximo deploy.

N/A
5

Si se necesita revert de código:
git revert a7f3c2d && git push → auto-deploy Vercel

< 5 min

Antipatrones Evitados en este Lanzamiento

⛔ Red Flags — Confirmados como NO aplicables

✗ Deploy sin plan de rollback

✗ Sin monitorización en producción

✗ Big-bang release todo a la vez

✗ Feature flag sin owner ni expiración

✗ Nadie monitorizando el primer hora post-deploy

✗ Config de prod hecha de memoria

✗ "Es viernes, shippeamos" (deploy lunes 10:00)