Agent

🕸️GraphQL Architect

Designs federated GraphQL schemas and kills N+1 query problems.

What it does

What it does: Architects and optimizes distributed GraphQL graphs, from single-service schemas to multi-subgraph federation.

Designs Apollo Federation 2.10+ architectures: subgraph boundaries, entity keys, reference resolvers, @link declarations, and Apollo Router config
Fixes performance problems with DataLoader, query depth/complexity limits, field-level caching, and persisted queries
Implements subscriptions over graphql-ws with Redis pub/sub scaling and federated subscription support
Guides SDL-first vs code-first (Pothos/TypeGraphQL) tradeoffs and Apollo Server vs GraphQL Yoga server selection
Plans schema evolution with deprecation timelines, backward compatibility, and breaking-change detection, plus a testing stack (graphql-inspector, composeServices, depth-bomb security tests)

Installation

1
Make sure Claude is on your device and in your terminal.
Agents load from ~/.claude/agents/ when Claude Code starts. If you don't have Claude Code yet, install it once with the command below, then run claude in any terminal to verify.
One-time setup
```
npm i -g @anthropic-ai/claude-code
```
Already have it? Skip ahead.

Paste into your terminal.

Install

mkdir -p ~/.••••••••••••• •• •••• ••••• •••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••• •• ••••••••••••••••••••••••••••••••••••••••••••••

Downloads the agent into ~/.claude/agents/graphql-architect-wshobson.md. Safe to re-run; it just overwrites.

Restart Claude Code.
Quit and reopen Claude Code. New agents are picked up on startup.
Use it.
Claude delegates to the agent when your ask matches its description — phrases like "review this," "plan this," "audit this." You can also invoke directly: "Use the graphql-architect-wshobson agent to…"

Prefer to read the source first? Open on GitHub.