Guide VTEX IO Master Data v2 design with MasterDataClient and indexed fields.
npx skills add https://github.com/exilonX/ap2 --skill vtex-io-masterdata-exilonx
Please help me install this Agent Skill. Skill: vtex-io-masterdata Source: https://github.com/exilonX/ap2/tree/main/.agents/skills/vtex-io-masterdata Command: npx skills add https://github.com/exilonX/ap2 --skill vtex-io-masterdata-exilonx
It prevents teams from misusing VTEX Master Data v2 as a default storage layer by forcing a rigorous check of whether Master Data is the right system of record for the problem at hand.
where fields.Use the vtex-io-masterdata skill to review your VTEX IO Master Data design and validate that your entities, schemas, indexing, and access patterns are correct and safe for production.
High-intent search queries and answers about installing and using this skill.
VTEX Master Data v2 should only be used after evaluating whether data belongs in Catalog, OMS, a BFF with caching, or an external database. This prevents misusing Master Data as a default storage layer.
Perform CRUD operations in Master Data v2 strictly using the MasterDataClient or ctx.clients.masterdata. Direct REST API calls are prohibited to ensure correct and safe implementation.
VTEX IO JSON Schemas must respect a 60-schema limit, require indexed `where` fields for query performance, and need careful trigger management to maintain operational safety at scale.
Avoid placing synchronous Master Data calls in the VTEX checkout purchase path. This operational safety measure prevents critical performance bottlenecks during high-scale transactions.
Search indexing in Master Data v2 requires indexed `where` fields for query performance. Pagination and scroll behaviors must be respected to correctly handle large data retrieval.
Do not use Master Data as a single source of truth when data natively belongs to Catalog, OMS, or checkout surfaces. Governance rules mandate evaluating external databases or BFFs first.
vtexEvaluate Master Data v2 for persistence and implement JSON Schemas and CRUD in VTEX IO apps.
vtexdocsManage Master Data v2 entities and schemas with MasterDataClient in VTEX IO apps.
WilljeanneEvaluate Master Data v2 suitability for custom data storage in VTEX IO apps.
exilonXGuide VTEX IO app data storage and read patterns across stores and APIs.