NutriSync — Feature Flag Architecture Dashboard

🚩

Arquitecto de Feature Flags · Skill CULTIVA IA

Audita, planifica y gestiona el ciclo completo de feature flags — clasificación, despliegue, rampa de activación y retirada. Evita la deuda técnica de flags huérfanos mediante 3 herramientas Python (stdlib) + guías de proveedor, ciclo de vida y estrategias de rollout.

python scripts/rollout_planner.py --population 85000 --strategy ring --duration-days 21

Resumen del inventario

Total flags

En producción + nuevo

Deuda crítica

>120 días sin retirar

Sin kill switch

Requieren documentar

Flags sanos

Permission/Operacional OK

Nuevo rollout

21d

ai_meal_planner · Ring

Auditoría de flags — flag_debt_scanner.py

Flag	Tipo	Antigüedad	Referencias	Deuda	Owner	Estado	Acción recomendada
legacy_payment_flow	Release	210 días	2 refs	CRÍTICO	Sin owner	Probablemente muerto	Retirar inmediatamente
new_dashboard_v2	Release	124 días	3 refs	CRÍTICO	@carlos.dev	Stale (>90d)	Revisar y retirar
team_chat_experiment	Experiment	67 días	4 refs	AVISO	@product-growth	A/B en curso	Fijar fecha límite
export_csv_beta	Release	45 días	8 refs	OK	@ana.backend	Activo en rampa	Continuar rollout
dark_mode_toggle	Permission	Permanente	15 refs	SANO	@frontend	Permission (eterno)	Ignorar en scanner
sso_enterprise	Permission	Permanente	6 refs	SANO	@platform	Plan Enterprise	Ignorar en scanner
ai_meal_planner	Release	Nuevo	0 refs (pendiente)	NUEVO	@ai-team	Rollout planificado	Ejecutar plan ring

Plan de rollout — rollout_planner.py

ai_meal_planner

Estrategia: Ring · Población: 85.000 MAU · Duración: 21 días

Ring strategy

15 Jun 2026

Fase 1 — Canary 850 usuarios (1%)

abort si: error_rate > baseline+1pp OR p99_latency > baseline×1.2

20 Jun 2026

Fase 2 — Early adopters 4.250 usuarios (5%)

abort si: coste inferencia/req > €0.004 OR alucinaciones reportadas >0

25 Jun 2026

Fase 3 — Quarter roll 21.250 usuarios (25%)

abort si: NPS < 6 en encuesta post-feature OR latencia AI >4s

30 Jun 2026

Fase 4 — Half world 42.500 usuarios (50%)

abort si: churn semanal aumenta >0.5pp vs. grupo control

5 Jul 2026

Fase 5 — Full rollout 85.000 usuarios (100%)

post-100%: mantener 7 días · retirar flag si estable · archivar doc entry

Auditoría kill switch — kill_switch_audit.py

🚨

legacy_payment_flow

Sin entrada en docs/feature-flags.md. Sin owner. Sin trigger documentado.

FAIL

🚨

new_dashboard_v2

Entrada presente pero falta dashboard de monitoreo y kill-switch trigger.

FAIL

⚠️

team_chat_experiment

Owner y tipo documentados. Falta: fecha límite del experimento y winner criteria.

WARN

✅

export_csv_beta

Owner, tipo, kill-switch y dashboard documentados. Rollout en progreso.

PASS

✅

dark_mode_toggle

Flag Permission permanente. Excluido del scanner de deuda. Kill switch no aplica.

PASS

✅

sso_enterprise

Flag Permission de plan Enterprise. Documentado en runbook. Ciclo de vida controlado.

PASS

🔵

ai_meal_planner

Nuevo. Kill switch diseñado: dashboard Datadog + alerta automática a 0% si error_rate >2%. Pendiente de merge.

PENDIENTE

Resumen: 2 FAIL · 1 WARN · 1 PENDIENTE · 3 PASS
Requisito para merge: 0 FAIL en kill_switch_audit.py

Distribución de deuda técnica

críticos

2 críticos (>90 días, Release)

1 advertencia (A/B sin fecha)

3 sanos (Permission/OK)

1 nuevo (pendiente rollout)

Anti-patrones detectados

🪦

Flag huérfano sin owner

El ingeniero original abandonó el equipo. Nadie sabe si está activo al 100% o muerto.

legacy_payment_flow

⏰

Release flag con 124 días sin retirar

Si el feature está al 100%, el flag ya no tiene utilidad y genera deuda en 3 lugares del código.

new_dashboard_v2

🧪

A/B test sin fecha de cierre

Sin winner criteria definida, el experimento puede correr indefinidamente. Fijar deadline en 14 días.

team_chat_experiment

Comparativa de proveedores — para NutriSync

GrowthBook

OSS · Self-host o Cloud · A/B nativo

9.2/10

✓ A/B testing con estadísticas Bayesianas

✓ SDK TypeScript/React nativo

✓ Self-host disponible (data residency EU)

✓ OSS — lock-in bajo

— Sin audit log SOC2 (no necesario aquí)

Precio: Free hasta 1k conexiones/día · Pro desde $150/mes para 12.000 admins

Statsig

Experimentación avanzada · Free tier generoso

7.8/10

✓ Free tier hasta 5M eventos/mes

✓ Análisis de métricas integrado

✗ Sin self-host (SaaS only)

✗ Lock-in moderado

Precio: Free · Pro desde $200/mes

Unleash

OSS · Self-hosted · Dev-friendly

7.0/10

✓ Open source, sin lock-in

✓ Self-hosted en AWS ECS (stack actual)

✗ A/B testing menos maduro

✗ UI más técnica

Precio: OSS gratis · Enterprise desde $500/mes

Plan de limpieza — Workflow 2: Quarterly cleanup

#	Flag	Prioridad	Acción	Responsable	Deadline	Criterio de done
1	legacy_payment_flow	P0 · Crítico	Confirmar si activo al 100%. Si sí: eliminar código + config. Si no: deploy directo.	@eng-lead (reasignar)	19 Jun 2026	0 refs en codebase · entrada archivada
2	new_dashboard_v2	P0 · Crítico	Confirmar % actual con @carlos.dev. Rampar a 100% o retirar. Documentar kill switch antes.	@carlos.dev	23 Jun 2026	kill_switch_audit PASS · 0 refs o 100% estable 7d
3	team_chat_experiment	P1 · Aviso	Fijar deadline de conclusión: 26 Jun 2026. Definir winner criteria en Notion antes del 16 Jun.	@product-growth	26 Jun 2026	Winner declarado + código del perdedor eliminado
4	ai_meal_planner	P2 · Nuevo	Ejecutar plan ring 21d. Verificar kill switch en staging. Archivar entrada 12 Jul si 100% estable 7d.	@ai-team	12 Jul 2026	100% por 7d · sin incidentes · flag retirado

Criterios de exito verificables

FAIL en kill_switch_audit

En merge de cualquier flag nuevo. Gate de CI obligatorio.

kill_switch_audit.py --format json | jq '.fail | length == 0'

≤5

Flags stale en >90 días

Objetivo para el próximo quarterly cleanup (Sept 2026).

flag_debt_scanner.py --max-age-days 90 | wc -l <= 5

<60d

Mean time to retire (Release)

Desde que un Release flag llega al 100% hasta que se retira del código.

git log --diff-filter=D -S "flag_name" | parse_age