Skip to main content
subagent CX Codex

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

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/graphql-architect.md
Open on GitHub

What 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.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

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 VoltAgent 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. CX Codex ★ 6,505repo 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 graphql-expert martinholovsky graphql-expert is a Claude Code skill for designing GraphQL schemas, building resolvers, and working with federation. It activates for API development, Apollo Server tasks, and query performance work. CX Codex +1 220installs graphql Mindrally graphql is a Claude Code skill for GraphQL schema design and query tuning. It comes into play while building APIs or wiring GraphQL clients into an app. CX Codex +1 726installs 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 graphql-performance-optimizer davila7 graphql-performance-optimizer is a Claude Code subagent that diagnoses slow GraphQL APIs and changes resolvers or caching. It activates for N+1 queries, pagination bottlenecks, and federation latency. CX Codex 599installs graphql-implementation secondsky graphql-implementation — a skill for Claude Code, Codex, Cursor, and other agents that designs GraphQL schemas, writes resolvers, sets up DataLoader, and wires error handling. CX Codex +1 400installs

From the same set112

The whole set →
ai-engineer ai-engineer designs RAG pipelines, configures vector databases, and writes agent workflows for LLM applications. Built for developers adding AI features. CX Codex ★ 1,357repo stars project-health-check project-health-check is a Claude Code command that reviews Git activity, dependencies, security findings, and Linear task metrics in a project health report. It helps identify risks to investigate. CX Codex +1 ★ 1,357repo stars setup-agent-tail setup-agent-tail is a Claude Code skill that deploys agent-tail in a project, detects its framework, installs the CLI and plugins, and routes server and browser logs to files for an agent. CX Codex +1 ★ 1,357repo stars todo-branch todo-branch executes backlog items on your active Git branch through guided phases, step-by-step approvals, and a single final commit. CX Codex +1 ★ 1,357repo stars bidirectional-sync bidirectional-sync — a slash command that pairs GitHub issues with Linear tasks and copies edits both ways, settling the ones that landed on both sides. CX Codex +1 ★ 1,357repo stars dx-optimizer dx-optimizer configures developer environments, project automation scripts, and Git hooks to eliminate workflow friction and speed up onboarding. CX Codex ★ 1,357repo stars clean-branches clean-branches — a command that systematically removes merged and inactive branches from Git. Keeps your repository clean by deleting obsolete branches and syncing local state with the remote. CX Codex +1 ★ 1,357repo stars performance-engineer performance-engineer is a Claude Code subagent for finding performance bottlenecks and planning optimization work. It joins tasks involving scalability, profiling, or load testing. CX Codex ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open