diff --git a/workloads/ecommerce/README.md b/workloads/ecommerce/README.md
new file mode 100644
index 0000000..cc74bc6
--- /dev/null
+++ b/workloads/ecommerce/README.md
@@ -0,0 +1,17 @@
+# Ari Shopping Front v1
+
+Frontend estático responsive para la primera etapa de la tienda online.
+
+## Incluye
+- Home profesional y responsive
+- Buscador y filtros por categoría
+- Catálogo demostrativo
+- Carrito lateral en el navegador
+- Integración inicial con Instagram
+- Base preparada para consumir APIs de microservicios
+
+## Despliegue en el laboratorio
+Reemplaza `workloads/ecommerce/index.html` con el `index.html` incluido. El pipeline actual construirá la imagen, actualizará el manifiesto GitOps y validará el tag desplegado.
+
+## Antes de producción
+Se deben incorporar logo oficial, fotos y precios reales, inventario, número de WhatsApp, políticas comerciales y servicios de catálogo, inventario, carrito, pedidos, pagos y clientes.