# api-architect

Проектирует REST- и GraphQL-API и готовит код для связи сервисов. Вызывайте его, когда нужно выбрать стиль API или продумать устойчивость и защиту.

- субагент · `type=agent` · Claude Code · 881 установка
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/api-graphql/api-architect.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/agents/davila7-api-architect

## Что делает

Субагент помогает спроектировать GraphQL-схему и структуру резолверов, подготовить REST-клиент или сравнить REST, GraphQL и gRPC. Для GraphQL учитывает федерацию, пакетную загрузку данных и ограничения сложности запросов; для REST — слои сервиса и обработки отказов, повторы и идемпотентность. Он работает с инструментами чтения и редактирования файлов, а также Bash.

Перед генерацией кода он собирает исходные требования: для REST нужны базовый адрес API и хотя бы один метод, для GraphQL — подход к схеме и тип операций. Обязательно задать язык с фреймворком, тип API и способ аутентификации. Сначала нужно явно сказать «generate» — до этого субагент не начинает писать код.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --agent api-graphql/api-architect
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/api-graphql/api-architect.md

## Когда брать
- спроектировать GraphQL-схему с федерацией
- создать REST-клиент с повторами и защитой от сбоев
- сравнить REST, GraphQL и gRPC для нового сервиса
- задать аутентификацию и ограничение запросов к API

## Примеры запросов агенту
- Спроектируй GraphQL API для каталога товаров с поиском, категориями и остатками; сначала собери требования.
- Подготовь REST-клиент для платёжного сервиса на TypeScript с повторными запросами; дождись моих ответов и команды «generate».
- Сравни REST, GraphQL и gRPC для системы уведомлений в реальном времени и порекомендуй вариант.

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

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 495 карточек

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