Skip to main content
subagent CX Codex

graphql-architect · voltagent/awesome-codex-subagents — Codex subagent: schema review and GraphQL architecture

graphql-architect — a subagent that audits GraphQL schemas for architectural flaws, performance risks, and security gaps. Guides schema evolution, resolver design, and federation without breaking clients.

MIT ★ 6,505 updated 2026-10-05

Install into Codex · Manually: put the files in place All methods and platforms ↓
.codex/agents/graphql-architect.toml
Open on GitHub

What graphql-architect does

graphql-architect treats GraphQL as a contract layer across clients, resolvers, and distributed services. It maps schema surface to resolver boundaries, identifies risks in federation and execution patterns, and prioritizes high-leverage improvements with rollout guidance.

The subagent operates in three phases: mapping schema structure (queries, mutations, subscriptions) to resolver and data boundaries, scanning for architecture risks in schema design and federation, and recommending targeted changes with compatibility and migration paths.

It focuses on nullability strategy, deprecation planning, N+1 patterns, query complexity limits, field-level authorization, and denial-of-service vectors via expensive queries. Returns a prioritized list of issues, design recommendations, client impact, and rollout guidance.

What it helps with

  • audit GraphQL schema for architecture and federation risks
  • detect performance bottlenecks in resolvers and query patterns
  • surface security gaps in introspection and field-level authorization
  • plan schema evolution while maintaining backward compatibility
  • optimize nullability, pagination, and query complexity controls

Example prompts for the agent

  • Review our GraphQL schema for federation resolver issues and N+1 risks.
  • What schema changes reduce query complexity and make DoS harder?
  • How do we change User.email from nullable to required without breaking clients?

How to install graphql-architect

Manually: put the files in place

.codex/agents/graphql-architect.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about graphql-architect

How do I install graphql-architect in Codex?

Add the config file to .codex/agents/graphql-architect.toml. The subagent will appear in your Codex agents list and become available for tasks involving GraphQL architecture.

What does graphql-architect do?

It analyzes GraphQL schemas, resolvers, and federation for architectural flaws, performance gaps, and security risks. It recommends improvements with compatibility guidance and migration paths for clients.

Is the Codex version different from Claude Code or Cursor?

graphql-architect is available across Codex, Claude Code, and Cursor with the same logic. Installation differs: Claude Code and Cursor use .md files, while Codex uses .toml.

Source text

graphql-architect.toml · MIT
# graphql-architect

Use when a task needs GraphQL schema evolution, resolver architecture, federation design, or distributed graph performance/security review.

Treat GraphQL as a contract and execution architecture across clients, resolvers, and distributed services.

Working mode:
1. Map schema surface (queries, mutations, subscriptions) to resolver/data boundaries.
2. Identify architectural risks in schema design, federation, and execution behavior.
3. Recommend smallest high-leverage improvements with compatibility and rollout guidance.

Focus on:
- schema evolution and backward compatibility
- nullability, input modeling, and deprecation strategy
- resolver ownership and data boundary clarity
- N+1 risk, batching strategy, and query planning implications
- query complexity/depth control and abuse-resistance posture
- pagination and filtering consistency across graph surface
- federation/subgraph boundaries, entity keys, and composition stability
- subscription/event-stream reliability and authorization boundaries

Performance checks:
- identify resolver hot paths likely to regress latency
- flag over-fetch/under-fetch pressures by schema shape
- call out where persisted queries, caching, or complexity controls are missing

Security checks:
- flag field-level auth ambiguities
- identify introspection/exposure risks relevant to deployment context
- surface denial-of-service vectors via expensive query patterns

Quality checks:
- provide one client-breaking change list (if any)
- provide migration path for schema-level changes
- separate immediate defects from medium-term architecture debt

Return:
- schema/resolver/federation issues found
- recommended design changes (prioritized)
- client, performance, and security implications
- migration/rollout guidance

Do not implement resolver code changes unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Similar subagents

All subagents for Backend and APIs →

graphql-architect by other authors comes first.

graphql-architect VoltAgent Community graphql-architect designs GraphQL schemas for microservices, federation, and distributed graphs. Use it when an API needs structured evolution or query analysis. CX Codex 1,038installs graphql-architect qdhenry The graphql-architect subagent designs and improves GraphQL APIs, covering schemas, resolvers, federation, and subscriptions. Use it for new APIs, performance audits, or refactoring. CX Codex ★ 1,357repo stars api-scaffolding-graphql-architect Seth Hobson api-scaffolding-graphql-architect is a Claude Code subagent for GraphQL architecture and API performance work. It engages on schema design, federation, and optimization tasks. CX Codex ★ 42,780repo stars public-graphql-api-design Samuel Berthe public-graphql-api-design designs safe public GraphQL APIs for third-party developers, covering schema conventions, Relay pagination, complexity ceilings, and federation boundaries. CX Codex +1 10,100installs mcp-graphql-enhanced letoribo mcp-graphql-enhanced is an MCP server for Claude Code that selectively inspects GraphQL schemas and prevents context overflow. It supports targeted graph queries and endpoint federation. CX Codex +1 ★ 7repo stars graphql-expert-best-practices wispbit graphql-expert-best-practices is a Claude Code skill with rules for GraphQL schemas, resolvers, mutations and pagination. The agent uses them while writing or reviewing schemas. CX Codex +1 144installs apollo-federation apollographql Guides an agent through Apollo Federation subgraph schemas: directives, entities with @key, composition errors. Handy when a supergraph spans several GraphQL services. CX Codex +1 2,100installs graphql-development Mindrally graphql-development — a skill that gives the agent GraphQL guidelines: schema design, type-safe clients, React and Next.js integration. Useful when it writes resolvers and queries. CX Codex +1 701installs

From the same set176

The whole set →
ui-fixer The ui-fixer subagent applies small patches to reproduced UI bugs. Use it when the fix should stay close to the owning component and avoid unrelated refactoring. CX Codex ★ 6,505repo stars ui-designer ui-designer — a subagent that designs interfaces and interactions before coding. Delivers concrete recommendations on layout, component states, and accessibility—in a form ready to implement. CX Codex ★ 6,505repo stars mobile-developer The mobile-developer subagent for Codex implements and debugs mobile features amid device constraints, lifecycle transitions, and degraded network conditions. CX Codex ★ 6,505repo stars microservices-architect microservices-architect maps service boundaries, contracts, and failure paths. Use it to review a distributed design or plan a change to service ownership. CX Codex ★ 6,505repo stars fullstack-developer fullstack-developer handles bounded cross-layer features from user actions down to backend effects and UI updates. Useful when a single worker needs to own the full integration path. CX Codex ★ 6,505repo stars frontend-developer frontend-developer — a scoped subagent for frontend changes and UI bug fixes, with checks for state integrity, accessibility, and nearby regressions. CX Codex ★ 6,505repo stars electron-pro electron-pro — a subagent for Electron development: helps map responsibility across main, preload, and renderer processes, design IPC bridges, verify security boundaries, and validate packaging assumptions. CX Codex ★ 6,505repo stars design-bridge design-bridge converts DESIGN.md documents into precise, structured UI instructions for implementation agents. CX Codex ★ 6,505repo stars

Project sponsors

Companies that keep this analytics open