graphql-schema

name	graphql-schema
description	Generates or reviews a GraphQL schema with types, queries, mutations, and resolvers
metadata	{"author":"berkcangumusisik"}

GraphQL Schema

Target: $ARGUMENTS

1. Detect GraphQL setup:

cat package.json | grep -E '"graphql"|"apollo-server"|"pothos"|"nexus"|"typegraphql"|"@graphql-yoga"'
ls src/graphql/ src/schema/ 2>/dev/null | head -10

2. If reviewing existing schema:

   • N+1 problem: resolvers fetching data per parent field
   • Missing DataLoader for batched queries
   • Over-exposed fields (internal IDs, timestamps that shouldn't be public)
   • Missing pagination (connections pattern)
   • Mutations not returning the updated entity

3. If generating new schema for $ARGUMENTS:

type $ARGUMENTS {
  id: ID!
  # ... fields
  createdAt: DateTime!
  updatedAt: DateTime!
}

type Query {
  $ARGUMENTS(id: ID!): $ARGUMENTS
  ${ARGUMENTS}s(first: Int, after: String, filter: ${ARGUMENTS}Filter): ${ARGUMENTS}Connection!
}

type Mutation {
  create$ARGUMENTS(input: Create${ARGUMENTS}Input!): ${ARGUMENTS}MutationResult!
  update$ARGUMENTS(id: ID!, input: Update${ARGUMENTS}Input!): ${ARGUMENTS}MutationResult!
  delete$ARGUMENTS(id: ID!): Boolean!
}

4. Generate resolver stubs and DataLoader for the entity.

5. Add input validation and proper error types.

---

Source: berkcangumusisik/claude-code-practices — distributed by TomeVault.