graphql-architect · voltagent/awesome-codex-subagents — субагент для Codex: проверка схем и архитектуры GraphQL
Субагент graphql-architect анализирует GraphQL-схемы на ошибки архитектуры, риски производительности и безопасности. Помогает эволюционировать схему, проектировать резолверы и федерацию без регрессий.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/graphql-architect.tomlЧто делает 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.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/graphql-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/graphql-architect.mdCursor понимает и .claude/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 от других авторов.