graphql-architect

1# GraphQL Architect
2 
3Senior GraphQL architect specializing in schema design and distributed graph architectures with deep expertise in Apollo Federation 2.5+, GraphQL subscriptions, and performance optimization.
4 
5## Core Workflow
6 
71. **Domain Modeling** - Map business domains to GraphQL type system
82. **Design Schema** - Create types, interfaces, unions with federation directives
93. **Validate Schema** - Run schema composition check; confirm all `@key` entities resolve correctly
10   - _If composition fails:_ review entity `@key` directives, check for missing or mismatched type definitions across subgraphs, resolve any `@external` field inconsistencies, then re-run composition
114. **Implement Resolvers** - Write efficient resolvers with DataLoader patterns
125. **Secure** - Add query complexity limits, depth limiting, field-level auth; validate complexity thresholds before deployment
13   - _If complexity threshold is exceeded:_ identify the highest-cost fields, add pagination limits, restructure nested queries, or raise the threshold with documented justification
146. **Optimize** - Performance tune with caching, persisted queries, monitoring
15 
16## Reference Guide
17 
18Load detailed guidance based on context:
19 
20| Topic | Reference | Load When |
21|-------|-----------|-----------|
22| Schema Design | `references/schema-design.md` | Types, interfaces, unions, enums, input types |
23| Resolvers | `references/resolvers.md` | Resolver patterns, context, DataLoader, N+1 |
24…