# api-designer

Субагент api-designer проектирует контракты REST и GraphQL, схемы ответов, пагинацию и правила версионирования до написания кода.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 489 у репозитория
- Автор: josstei
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/api-designer.md
- Обновлён: 2026-10-26
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/josstei-api-designer

## Что делает

Субагент специализируется на contract-first разработке. Он формирует каталог эндпоинтов с HTTP-методами, строит типизированные схемы запросов и ответов в JSON Schema или TypeScript, а также описывает единую структуру ошибок с кодами состояния вроде 400, 401, 403, 404, 409 и 422.

В решениях агент опирается на строгие правила: ресурсно-ориентированные пути во множественном числе, вложенные маршруты для связей с жестким владением, выбор между курсорной и офсетной пагинацией и версионирование через URL-префиксы. Он также готовит фрагменты спецификаций OpenAPI для ключевых маршрутов.

Субагент работает строго в режиме чтения: он создаёт проектные контракты, но не пишет логику обработчиков маршрутов в коде проекта.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/josstei/maestro-orchestrate/tree/HEAD/antigravity/src/agents/api-designer.md

## Когда брать
- спроектировать спецификацию OpenAPI и схемы эндпоинтов
- выбрать стратегию пагинации и сортировки для списков
- описать структуру машиночитаемых ошибок и статус-кодов
- спланировать версионирование API без нарушения обратной совместимости

## Примеры запросов агенту
- Спроектируй REST API для сервиса аутентификации пользователей с кодами ошибок
- Добавь единый контракт курсорной пагинации для всех эндпоинтов со списками
- Опиши схему ресурсов и эндпоинты для управления заказами в формате OpenAPI

## Похожие
- [doc-api](https://affpapa.org/nevibecode/commands/doc-api.md) — команда · 733 установки
- [api-reference-documentation](https://affpapa.org/nevibecode/skills/api-reference-documentation.md) — скилл · 501 установка
- [api-architect](https://affpapa.org/nevibecode/skills/api-architect.md) — скилл · 235 установок
- [api-documentation-generator](https://affpapa.org/nevibecode/skills/api-documentation-generator.md) — скилл · 235 установок
- [api-integration-specialist](https://affpapa.org/nevibecode/agents/api-integration-specialist.md) — субагент · ★ 1013 у репозитория
- [api-contract-design](https://affpapa.org/nevibecode/skills/api-contract-design.md) — скилл · ★ 587 у репозитория

## Другие версии с тем же именем
- [api-designer · voltagent](https://affpapa.org/nevibecode/agents/api-designer.md) — 756 установок
- [api-designer · voltagent](https://affpapa.org/nevibecode/agents/voltagent-api-designer.md) — ★ 6505 у репозитория

Из того же набора: [josstei/maestro-orchestrate](https://affpapa.org/nevibecode/by/josstei/maestro-orchestrate.md) — 40 карточек

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

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