Service Runtime & Execution Model

When this skill applies

Use this skill when the main decision is how a VTEX IO backend app runs inside the node builder: how the Service entrypoint is structured, how runtime configuration is declared, and how routes, events, or GraphQL handlers are registered into the service.

• Creating a new backend app under node/
• Structuring node/index.ts as the service entrypoint
• Defining typed Context, State, and params contracts for handlers
• Configuring service.json for timeout, memory, workers, and replicas
• Troubleshooting runtime issues caused by service registration or execution model mismatches
• Registering GraphQL handlers at the runtime level, while keeping schema and resolver design in a separate skill

Do not use this skill for:

• deciding the app contract in manifest.json
• designing custom clients or integration transport layers
• detailed HTTP route handler behavior
• event-specific business workflows
• GraphQL schema or resolver modeling beyond runtime registration