API Design GraphQL

Scope Boundaries

• Use when GraphQL schema boundaries, resolver contracts, and query safety must be defined.
• Use proactively when GraphQL SDL/resolver diffs appear in specs, manifests, or source.
• Use when clients need flexible field selection but query safety and authz boundaries are not yet explicit.
• Do not use for REST-first endpoint design; use api-design-rest.
• Do not use for storage internals; use db-*.

Goal

Deliver GraphQL contracts that are safe to evolve and efficient at runtime.