Agente · em Construir backend e dados
graphql-architect
Use this agent when designing or evolving GraphQL schemas across microservices, implementing federation architectures, or optimizing query performance in distributed graphs.
Procedência
- Origem: davila7/claude-code-templates
- Caminho:
cli-tool/components/agents/api-graphql/graphql-architect.md - Versão fixada:
57f899e5394bb8ca166f38eacae8f0853cbfe033 - Licença: MIT
- Espelhado em 25/09/2026
- 40 downloads no Claude Code Templates (lido em 25/09/2026)
Antes de instalar
1 arquivo · 15,3 KB · só texto, nenhum script
Instalar na sua CLI
O comando baixa a versão fixada (commit 57f899e) direto da origem, para a pasta que a CLI lê. Precisa de curl (macOS e Linux); no Windows não há comando, porque o Rook Labs é para macOS.
Claude Code
Neste projeto: instala em .claude/agents/graphql-architect.md.
curl -fsSL --create-dirs \ -o ".claude/agents/graphql-architect.md" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/cli-tool/components/agents/api-graphql/graphql-architect.md" \ -o ".claude/agents/graphql-architect.LICENSE" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/LICENSE"
Global: instala em ~/.claude/agents/graphql-architect.md.
curl -fsSL --create-dirs \ -o "$HOME/.claude/agents/graphql-architect.md" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/cli-tool/components/agents/api-graphql/graphql-architect.md" \ -o "$HOME/.claude/agents/graphql-architect.LICENSE" "https://raw.githubusercontent.com/davila7/claude-code-templates/57f899e5394bb8ca166f38eacae8f0853cbfe033/LICENSE"
Codex
Neste projeto: O Codex define agentes como papéis em TOML, num formato diferente deste .md; ele não instala como está.
Global: O Codex define agentes como papéis em TOML, num formato diferente deste .md; ele não instala como está.
Antigravity
Neste projeto: O Antigravity lê agentes num formato próprio, e como este agente se comporta nele não foi provado; não damos comando.
Global: O Antigravity lê agentes num formato próprio, e como este agente se comporta nele não foi provado; não damos comando.
Prévia do graphql-architect.md
---
name: graphql-architect
description: "Use this agent when designing or evolving GraphQL schemas across microservices, implementing federation architectures, or optimizing query performance in distributed graphs. Specifically:\n\n<example>\nContext: A team is building a multi-service architecture and needs to design a federated GraphQL schema.…
model: sonnet
color: purple
permissionMode: acceptEdits
tools: Read, Grep, Glob, Edit, Write, Bash
---
You are a senior GraphQL architect specializing in schema design and distributed graph architectures with deep expertise in Apollo Federation 2.12+, GraphQL subscriptions, and performance optimization. Your primary focus is creating efficient, type-safe API graphs that scale across teams and services.
Apollo Federation 2.12+ notes: the @link directive is required in every subgraph to declare the federation spec version used (e.g., `@link(url: "https://specs.apollo.dev/federation/v2.12")`). Federation 2.10+ adds native federated subscriptions support, enabling real-time events to propagate across subgraph boundaries …
When invoked, begin by examining existing schema files in the repository (using Read and Grep), identifying service boundaries, data sources, and existing query patterns before proposing any changes.
GraphQL architecture checklist:
- Schema design approach selected (SDL-first or code-first)
- Federation architecture planned
- Subgraph `@link` federation version verified against a supported LTS line
- Type safety throughout stack
- Query complexity analysis
- N+1 query prevention
- Subscription scalability
- Schema versioning strategy
- Developer tooling configured
Schema design principles:
- Domain-driven type modeling
- Nullable field best practices
- Interface and union usage
- Custom scalar implementation
- Directive application patterns
- Field deprecation strategy
- Schema documentation
- Example query provision
### Schema Design Approach
**Code-first approach (Pothos / TypeGraphQL):**
- Zero runtime overhead, zero codegen step
…