# GRAPHQL Builder > Conception et implémentation de schémas et résolveurs GraphQL. Se déclenche avec "GraphQL", "schema", "query", "mutation", "subscription", "resolver", "Apollo", "Hot Chocolate". Use when this capability is needed. - Skill: `tomevault-io/graphql-builder-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/graphql-builder-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/graphql-builder-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Integrations & APIs - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/graphql-builder-2 --- # GraphQL Builder ## Workflow 1. **Design du schéma** : Définir les types scalaires, objets, interfaces et unions ; concevoir les queries (lecture), mutations (écriture) et subscriptions (temps réel) ; créer les input types pour les mutations afin de garantir la validation côté serveur. 2. **Résolution efficace** : Implémenter le pattern DataLoader pour éliminer le problème N+1 (batching des requêtes DB par identifiants) ; mettre en cache les résultats des DataLoaders dans le scope de la requête ; éviter les résolveurs qui font des appels en cascade. 3. **Pagination** : Adopter le pattern Relay Connections (`edges`, `node`, `cursor`, `pageInfo`) pour une pagination cursor-based standardisée ; fournir aussi `totalCount` quand c'est nécessaire ; documenter les limites maximales. 4. **Authentification et autorisation** : Protéger le schéma via directives custom (`@auth`, `@hasRole`), middleware de contexte (injection du user dans le contexte GraphQL), ou field-level resolvers avec vérification de permissions ; ne jamais exposer des champs sensibles sans contrôle. 5. **Error handling** : Distinguer les erreurs techniques (exceptions non gérées) des erreurs métier ; utiliser les union types pour les erreurs métier (`union CreateUserResult = User | EmailAlreadyExists | ValidationError`) ; enrichir via `extensions` pour les codes d'erreur custom. 6. **Subscriptions et real-time** : Implémenter les subscriptions via WebSocket (protocole `graphql-ws`) ou server-sent events ; utiliser un bus de messages (Redis Pub/Sub, in-memory EventEmitter) pour la diffusion multi-instance ; gérer proprement la déconnexion. 7. **Schema stitching ou federation** : Pour les microservices, préférer Apollo Federation (sous-graphes avec `@key`, `@extends`, `@external`) plutôt que le stitching manuel ; définir clairement les boundaries de chaque sous-graphe. 8. **Performance** : Analyser la complexité des queries (depth limiting, complexity scoring) pour prévenir les attaques par requêtes profondes ; implémenter les persisted queries (hash côté client) pour réduire la bande passante et améliorer la sécurité en production. ## Règles - Fournis des exemples de schéma SDL et de code résolveur concrets dans le framework de l'utilisateur (Apollo Server, Hot Chocolate, Strawberry, etc.) - Adapte les patterns au langage cible (TypeScript/Node.js, C#/.NET, Python, etc.) - Toujours mentionner les trade-offs (ex. federation = complexité opérationnelle, mais scalabilité d'équipe) - Commence par la solution simple avant la complexe (schéma monolithique avant federation) - Souligne quand REST serait plus adapté que GraphQL (cas d'usage simples ou fichiers/uploads) --- > Source: [khalilbenaz/claude-skills-collection](https://github.com/khalilbenaz/claude-skills-collection) — distributed by [TomeVault](https://tomevault.io).