What problem does it solve?
This Skill prevents brittle, inconsistent storefront behavior by guiding you to correctly design VTEX IO session transform apps that derive, propagate, and expose session-derived state safely and deterministically.
Core Features & Use Cases
- Namespace ownership & source-of-truth rules: Ensures your session app owns only its output fields and never duplicates VTEX-owned facts (e.g., cost center, organization, postal/country).
- Correct input/output modeling: Uses
public.* strictly as an input surface for propagation, while treating private namespaces as the computed read model for frontend consumption.
- Transform DAG & propagation correctness: Helps you declare dependencies so transforms run in the right order and changes re-trigger downstream outputs, including caching strategies to keep transforms fast.
- Debugging session collisions and staleness: Addresses common failure modes like stale fields, namespace collisions, and incorrect frontend reads or writes.
Quick Start
Use the vtex-io-session-apps skill to design a VTEX session transform that reads storefront-permissions inputs and outputs only your app’s derived private namespace fields, while updating public.* inputs only when you need native transforms to recompute.
