Patrón unificado de direcciones + geocoding para checkout, clientes, remisiones y planilla. Cubre tabla `addresses`, endpoints `store/addresses`, snapshot `dispatch_notes.customer_address`, componente `app-address-map-picker` (MapLibre), `GeocodingService` frontend, proxy Nominatim backend, validación sintáctica + warning no-bloqueante, cascade `resolveStopCoordinates` y customer-modal crear-mode. Trigger: cuando editar/agregar dirección de cliente, remisión o stop; cuando el mapa del despacho rechaza una dirección; cuando integrar dirección + mapa opcional + geocoding.
High-level AI Engine integration guide for Vendix: choosing the right AI subsystem, creating AI-powered features, and consuming AI Applications. Trigger: When creating AI-powered features, integrating AI Engine into domains, configuring AI providers/apps, or styling AI interaction elements.
AI async queue system using BullMQ: generation jobs, embedding jobs, queue registration, processors, retries, and job status. Trigger: When working with AI async processing, BullMQ queues, AI job processors, or embedding/generation background jobs.
Suite restaurante para Vendix: modelado plato/insumo, recetas/BOM, producción de sub-recetas en lote, fire-to-kitchen con descuento y COGS, mesas con cuenta abierta y split financiero, KDS en tiempo real vía SSE, menú con carta/secciones/ combos/ventanas horarias/ingeniería BCG, e integración POS con gating por industria. Trigger: When working on restaurant suite, recipes, BOM, prepared products, ingredient flags, kitchen fire, KDS, kitchen tickets, table sessions, open tabs, bill split, menu engineering, menu availability windows, or any store whose `industries` includes `restaurant`.
Flujo QR-de-mesa para comensales escaneando desde el storefront (`{shop-hostname}/?mesa=<public_token>`): tokens, modos de escaneo, re-asociación a sesión activa, cuenta compartida, SSE del comensal y reactivación automática desde mesa en limpieza. Complementa `vendix-restaurant-ops` (lado POS/admin) cubriendo el lado storefront/comensal que la otra skill no gobierna. Trigger: When editing QR de mesa comensal, public_token, table_session desde storefront, `ecommerce/tables/*` endpoints, table-banner UI, or `qr_scan_behavior` in restaurant settings.
Cómo nacen bien los reportes descargables de Vendix: exportación XLSX profesional con ExcelJS (nunca CSV), fechas en la timezone de la tienda (fallback SIEMPRE America/Bogota), dataset completo, agregación única (pantalla == archivo), y flujo de export unificado backend→frontend. OBLIGATORIA al crear, editar, fixear o mejorar cualquier reporte. Trigger: Creating, editing, fixing or improving any downloadable/report/export feature in apps/backend/src/domains/store/analytics or apps/frontend .../store/reports.
Establishes development best practices using the Vendix skills system. Trigger: ALWAYS when the user requests code changes, feature work, fixes, refactors, or development execution.
Defines the Vendix planning protocol before development. Trigger: When creating implementation plans, analyzing non-trivial changes, decomposing work, or preparing multi-agent development.