graphql-architect · qdhenry — Claude Code subagent: setup and use
The graphql-architect subagent designs and improves GraphQL APIs, covering schemas, resolvers, federation, and subscriptions. Use it for new APIs, performance audits, or refactoring.
no license ★ 1,357 updated 2026-03-01
.claude/agents/graphql-architect.mdWhat graphql-architect 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.
What it helps with
- 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 for the agent
- 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.
How to install graphql-architect
Manually: put the files in place
.claude/agents/graphql-architect.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/graphql-architect.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/graphql-architect.mdCursor also reads .claude/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 Claude Code?
Create the agent file at .claude/agents/graphql-architect.md.
What does graphql-architect do?
It designs GraphQL schemas, implements and tunes resolvers, and supports federation, subscriptions, security checks, and structured error handling.
Which GraphQL patterns does the subagent cover?
It covers Apollo Federation, DataLoader batching, WebSocket subscriptions, query complexity analysis, and field-level authorization.
Similar subagents
All subagents for Backend and APIs →graphql-architect by other authors comes first.