vtex-io-service-runtime

SKILL.md

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