# api-scaffolding-graphql-architect

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

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 41823
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/api-scaffolding/agents/graphql-architect.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/api-scaffolding-graphql-architect

## Что делает

Субагент разбирает требования и связи данных, затем предлагает масштабируемую GraphQL-схему, резолверы и план развития API. Он работает с Apollo Federation v2, композиционными схемами, SDL, интерфейсами, union-типами и Relay-паттернами. Подходит для миграции с REST, интеграции микросервисов и построения gateway.

В задачах производительности он применяет DataLoader против N+1, анализ сложности и глубины запросов, persisted queries, кэширование на уровне поля или запроса, Redis и CDN. Для защиты API рассматривает JWT, RBAC, авторизацию на уровне полей, лимиты запросов, проверку входных данных и защиту introspection. Поддерживает подписки через WebSocket или Server-Sent Events, тестирование схемы, поиск breaking changes и мониторинг резолверов. Apollo Server, Prisma, GraphQL Code Generator и другие инструменты выбираются под задачу.

Субагент доступен в Claude Code, Codex и Cursor. Для Claude Code нужен репозиторий `wshobson/agents`; установка добавляет плагин и файл `.claude/agents/graphql-architect.md`. Без настройки схемы и источников данных он сможет спроектировать решение, но не создаст фактическую интеграцию сам по себе.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install api-scaffolding@claude-code-workflows
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/graphql-architect.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/graphql-architect.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/graphql-architect.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/api-scaffolding/agents/graphql-architect.md

## Когда брать
- спроектировать федеративную GraphQL-архитектуру для микросервисов
- устранить N+1-запросы через DataLoader и кэширование
- настроить авторизацию на уровне полей и лимиты сложности
- перенести REST API на GraphQL с сохранением совместимости
- проверить схему на breaking changes и подготовить её развитие

## Примеры запросов агенту
- Спроектируй федеративную GraphQL-архитектуру для нескольких команд и опиши границы subgraph.
- Проанализируй эту схему, найди причины N+1-запросов и предложи DataLoader и кэширование.
- Подготовь стратегию перехода с REST на GraphQL с сохранением совместимости клиентов.

## Похожие
- [fullstack-developer](https://affpapa.org/nevibecode/agents/fullstack-developer.md) — субагент · 18117 установок
- [python-pro](https://affpapa.org/nevibecode/agents/voltagent-community-python-pro.md) — субагент · 11689 установок
- [typescript-pro](https://affpapa.org/nevibecode/agents/voltagent-community-typescript-pro.md) — субагент · 9602 установки
- [code-explorer](https://affpapa.org/nevibecode/agents/code-explorer.md) — субагент · 1172 установки

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 508 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md