vtex-io-app-contract

SKILL.md

App Contract & Builder Boundaries

When this skill applies

Use this skill when the main decision is about what a VTEX IO app is, what capabilities it declares, and which integration boundaries it publishes through manifest.json.

Creating a new VTEX IO app and defining its initial contract

Adding or removing builders to match app capabilities

Choosing between dependencies and peerDependencies

Deciding whether a capability belongs in the current app or should move to another app

Troubleshooting link or publish failures caused by manifest-level contract issues

Do not use this skill for:

service runtime behavior such as service.json, memory, workers, or route exposure

HTTP handler implementation, middleware composition, or event processing

GraphQL schema, resolver, or data-fetching implementation

storefront, admin, or render-runtime frontend behavior

policy modeling and security boundary enforcement