# graphql-architect

The graphql-architect subagent designs and improves GraphQL APIs, covering schemas, resolvers, federation, and subscriptions. Use it for new APIs, performance audits, or refactoring.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/data-ai/graphql-architect.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-graphql-architect

## What it does

graphql-architect helps shape a GraphQL schema with clear types, interfaces, unions, and enums, then works on the resolver layer. It targets N+1 issues with DataLoader patterns and can examine caching, query-cost checks, rate limits, and field-level authorization.

The subagent also covers Apollo Federation, subgraph architecture, and WebSocket subscriptions. Its listed tools include file reading and editing, project search, Bash, web research, plus `context7` and `sequential-thinking`. In Claude Code, place the agent at `.claude/agents/graphql-architect.md`.

Its workflow expects tests, type checks, linting, and security scans before a change is finished. Projects without those checks need setup before this workflow can be followed as intended.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/graphql-architect.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.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/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/graphql-architect.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/data-ai/graphql-architect.md

## When to use it
- design a GraphQL schema for a new API
- remove resolver N+1 issues with DataLoader
- split an API into federated subgraphs
- add WebSocket-based subscriptions
- audit query cost and field authorization

## Example prompts
- Design a GraphQL schema for this API, including types, relations, and pagination.
- Inspect the resolvers for N+1 issues, propose DataLoader usage, and edit the project.
- Review the current GraphQL architecture and plan an Apollo Federation setup.

## Similar
- [api-scaffolding-graphql-architect](https://affpapa.org/en/nevibecode/agents/api-scaffolding-graphql-architect.md) — subagent · ★ 42780 repo stars
- [graphql-expert](https://affpapa.org/en/nevibecode/skills/graphql-expert.md) — skill · 220 installs
- [graphql](https://affpapa.org/en/nevibecode/skills/mindrally-graphql.md) — skill · 726 installs
- [graphql-expert-best-practices](https://affpapa.org/en/nevibecode/skills/graphql-expert-best-practices.md) — skill · 144 installs
- [graphql-performance-optimizer](https://affpapa.org/en/nevibecode/agents/graphql-performance-optimizer.md) — subagent · 599 installs
- [graphql-implementation](https://affpapa.org/en/nevibecode/skills/graphql-implementation.md) — skill · 400 installs

## Other versions with the same name
- [graphql-architect · voltagent](https://affpapa.org/en/nevibecode/agents/graphql-architect.md) — 1038 installs
- [graphql-architect · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-graphql-architect.md) — ★ 6505 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
