К основному содержанию
субагент CX Codex

graphql-architect · voltagent/awesome-codex-subagents — субагент для Codex: проверка схем и архитектуры GraphQL

Субагент graphql-architect анализирует GraphQL-схемы на ошибки архитектуры, риски производительности и безопасности. Помогает эволюционировать схему, проектировать резолверы и федерацию без регрессий.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/graphql-architect.toml
Открыть на GitHub

Что делает graphql-architect

graphql-architect рассматривает GraphQL как контракт между клиентами, резолверами и сервисами. Он проверяет, насколько хорошо схема отражает границы данных и сервисов, ловит несовместимости при эволюции, выявляет горячие точки производительности.

Субагент работает в три шага: сначала строит карту поверхности схемы (запросы, мутации, подписки) и резолверов, затем ищет риски в дизайне и федерации, потом предлагает наименьшие, но высокоэффективные улучшения с указанием совместимости и плана развёртывания.

Заостряет внимание на nullability, стратегии deprecation, проблемах N+1, сложности запросов, field-level авторизации и vectors DDoS через дорогие паттерны запросов. Возвращает список проблем, приоритезированные изменения, влияние на клиентов и пути миграции.

Какие задачи решает

  • проверить GraphQL-схему на ошибки архитектуры и federation
  • выявить риски производительности в резолверах и запрос-паттернах
  • обнаружить бреши безопасности в introspection и авторизации
  • спланировать эволюцию схемы без breaking changes
  • оптимизировать nullability, pagination и query complexity

Примеры запросов агенту

  • Проверь нашу GraphQL-схему на проблемы federated resolvers и N+1.
  • Что нужно изменить в schema design, чтобы снизить complexity и усложнить DDoS?
  • Как развернуть изменение типа User.email с nullable на non-nullable без breaking changes?

Как установить graphql-architect

Вручную: положить файлы

.codex/agents/graphql-architect.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о graphql-architect

Как установить graphql-architect в Codex?

Добавь конфиг в .codex/agents/graphql-architect.toml. Субагент появится в списке агентов Codex и будет доступен как вариант для выполнения задач по GraphQL-архитектуре.

Что делает graphql-architect?

Анализирует GraphQL-схемы, резолверы и федерацию на проблемы архитектуры, производительности и безопасности. Предлагает изменения с учётом совместимости и плана миграции для клиентов.

Отличается ли этот субагент для Codex от версий для других платформ?

graphql-architect доступен для Codex, Claude Code и Cursor. Логика одинаковая, но способ установки разный: для Claude Code и Cursor используются файлы .md, для Codex — .toml.

Исходный текст

graphql-architect.toml · MIT
# graphql-architect

Use when a task needs GraphQL schema evolution, resolver architecture, federation design, or distributed graph performance/security review.

Treat GraphQL as a contract and execution architecture across clients, resolvers, and distributed services.

Working mode:
1. Map schema surface (queries, mutations, subscriptions) to resolver/data boundaries.
2. Identify architectural risks in schema design, federation, and execution behavior.
3. Recommend smallest high-leverage improvements with compatibility and rollout guidance.

Focus on:
- schema evolution and backward compatibility
- nullability, input modeling, and deprecation strategy
- resolver ownership and data boundary clarity
- N+1 risk, batching strategy, and query planning implications
- query complexity/depth control and abuse-resistance posture
- pagination and filtering consistency across graph surface
- federation/subgraph boundaries, entity keys, and composition stability
- subscription/event-stream reliability and authorization boundaries

Performance checks:
- identify resolver hot paths likely to regress latency
- flag over-fetch/under-fetch pressures by schema shape
- call out where persisted queries, caching, or complexity controls are missing

Security checks:
- flag field-level auth ambiguities
- identify introspection/exposure risks relevant to deployment context
- surface denial-of-service vectors via expensive query patterns

Quality checks:
- provide one client-breaking change list (if any)
- provide migration path for schema-level changes
- separate immediate defects from medium-term architecture debt

Return:
- schema/resolver/federation issues found
- recommended design changes (prioritized)
- client, performance, and security implications
- migration/rollout guidance

Do not implement resolver code changes unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →

Сначала — graphql-architect от других авторов.

graphql-architect VoltAgent Community Субагент graphql-architect для Claude Code проектирует GraphQL-схемы для микросервисов, федерации и распределённых графов. Разбирает проблемы с запросами и развитие API. CX Codex 1 038установок graphql-architect qdhenry Субагент graphql-architect проектирует и улучшает GraphQL API: схему, резолверы, федерацию и подписки. Подходит для нового API, аудита производительности и рефакторинга. CX Codex ★ 1 357звёзд репо api-scaffolding-graphql-architect Seth Hobson Субагент api-scaffolding-graphql-architect для Claude Code проектирует GraphQL-архитектуру и оптимизирует API. Подключается к задачам по федерации, схемам и производительности. CX Codex ★ 42 780звёзд репо public-graphql-api-design Samuel Berthe Скилл public-graphql-api-design помогает спроектировать публичный GraphQL API для сторонних разработчиков. Он задаёт правила схемы, пагинацию через Relay, лимиты сложности и границы доверия в федерации. CX Codex +1 10 100установок mcp-graphql-enhanced letoribo mcp-graphql-enhanced — MCP-сервер для Claude Code, который выборочно исследует GraphQL-схемы и защищает контекст модели от переполнения. Поддерживает точечный опрос графов и объединение API. CX Codex +1 ★ 7звёзд репо graphql-expert-best-practices wispbit Скилл graphql-expert-best-practices для Claude Code задаёт правила для схем, резолверов, мутаций и пагинации GraphQL. Агент обращается к ним при написании и ревью схем. CX Codex +1 144установок apollo-federation apollographql Помогает писать схемы подграфов Apollo Federation: директивы, сущности с @key, ошибки композиции. Полезен, когда суперграф собирается из нескольких GraphQL-сервисов. CX Codex +1 2 100установок graphql-development Mindrally Скилл graphql-development для Claude Code задаёт агенту правила для GraphQL: схема, типизированные клиенты, интеграция с React и Next.js. Направляет написание резолверов и запросов. CX Codex +1 701установок

Из того же набора176

Весь набор →
ui-fixer Субагент ui-fixer вносит минимальные исправления в уже воспроизведённые UI-дефекты. Подходит для точечных патчей без редизайна и лишних рефакторингов. CX Codex ★ 6 505звёзд репо ui-designer Субагент ui-designer, который проектирует интерфейсы и взаимодействия до кода. Даёт конкретные рекомендации по раскладке, состояниям компонентов и доступности — в форме, готовой к реализации. CX Codex ★ 6 505звёзд репо mobile-developer Субагент mobile-developer помогает внедрять и отлаживать мобильные экраны с учётом жизненного цикла приложения, нестабильной сети и ограничений устройств. CX Codex ★ 6 505звёзд репо microservices-architect Субагент microservices-architect разбирает границы сервисов, контракты и сценарии отказа. Подключайте его, когда проектируете разделение сервисов или проверяете распределённый поток. CX Codex ★ 6 505звёзд репо fullstack-developer Субагент fullstack-developer ведёт сквозную задачу через фронтенд и бэкенд, от действия пользователя в интерфейсе до сохранения данных. Помогает, когда всю цепочку должен закрыть один исполнитель. CX Codex ★ 6 505звёзд репо frontend-developer Субагент frontend-developer ведёт точечные изменения интерфейса и исправляет UI-баги с проверкой состояний, доступности и соседних регрессий. CX Codex ★ 6 505звёзд репо electron-pro Субагент electron-pro для работы с Electron-приложениями: помогает разбираться в границах между main, preload и renderer, настраивать IPC-мосты, проверять безопасность и готовить приложение к упаковке. CX Codex ★ 6 505звёзд репо design-bridge Субагент design-bridge разбирает файл DESIGN.md и превращает дизайн-систему бренда в готовые спецификации для фронтенд-агентов. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой