Critical Gotchas

Read this file before every phase. It contains only the invariants that repeatedly cause agent failures.

CODEGEN-001

Never write raw GraphQL strings, schemas, or queries.

Constructive workflow:

1. Provision tables via TypeScript blueprints (BlueprintDefinition from node-type-registry) using @constructive-io/sdk (Phase 2.3).
2. Generate .graphql schema files and typed SDK code from the live endpoint via @constructive-io/graphql-codegen.
3. Use generated hooks and ORM only.

Do not hand-write .graphql files, inline SDL, or raw query strings.

CODEGEN-002

Never modify generated SDK/ORM code. Files under src/generated/ are outputs of @constructive-io/graphql-codegen and will be overwritten on the next codegen run.