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