# api-platform-builder

Субагент api-platform-builder для Claude Code собирает ресурсы API Platform в Symfony: сущность, операции, DTO, провайдер и процессор состояния, права и тесты. Создаёт эндпоинт.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 234 у репозитория
- Автор: dev-toolings
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/agents/api-platform-builder.md
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/api-platform-builder

## Что делает

Субагент проводит ресурс API Platform целиком: сущность Doctrine, атрибуты `#[ApiResource]`, явные операции `Get`, `GetCollection`, `Post`, `Put`, `Patch`, `Delete`, группы сериализации, DTO на вход и выход, провайдер и процессор состояния, проверки прав и тесты в `tests/Api/`. Первым делом он читает `composer.lock` и подстраивается под установленную версию, по умолчанию беря паттерны 5.0.

Внутри четыре скилла: `api-platform-resources`, `api-platform-dto-resources`, `api-platform-state-providers`, `api-platform-security`. Доступны чтение, поиск, правка файлов и `Bash`, лимит — 25 шагов. Конфигурацию он пишет PHP-атрибутами, YAML не трогает.

Версия решает многое. `StartSearchFilter`, `ChainFilter` и `Query` требуют 4.4+, `api-platform/test` — 5.0, а на Symfony 6.4 LTS объектного маппера нет, поэтому DTO получают провайдер и процессор, написанные руками. После сборки агент прогоняет `php bin/console debug:router | grep api` и `php bin/console api:openapi:export --yaml`.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/agents/api-platform-builder.md

## Когда брать
- собрать CRUD-ресурс API Platform от сущности до тестов
- перевести существующий ресурс на DTO с провайдером и процессором
- закрыть операции проверкой `is_granted` и voter'ами
- подогнать конфигурацию под установленную версию API Platform
- написать API-тесты на авторизацию и валидацию полей

## Примеры запросов агенту
- Создай ресурс API Platform для сущности `Order`: операции `Get`, `GetCollection` и `Post`, DTO на вход и выход, тесты в `tests/Api/`.
- Добавь в `Order` фильтр по статусу и закрой `Delete` проверкой `is_granted('ROLE_ADMIN')`.
- Посмотри, какая версия API Platform стоит в `composer.lock`, и перепиши ресурс `Product` под её паттерны.

## Похожие
- [symfony-specialist](https://affpapa.org/nevibecode/agents/symfony-specialist.md) — субагент · ★ 26718 у репозитория
- [recoup-platform-api-access](https://affpapa.org/nevibecode/skills/recoup-platform-api-access.md) — скилл · 5500 установок
- [wp-rest-api](https://affpapa.org/nevibecode/skills/wp-rest-api.md) — скилл · 6700 установок
- [wp-abilities-api](https://affpapa.org/nevibecode/skills/wp-abilities-api.md) — скилл · 4900 установок
- [laravel-api-tool-kit](https://affpapa.org/nevibecode/plugins/laravel-api-tool-kit.md) — плагин · ★ 530 у репозитория
- [Drupal Expert](https://affpapa.org/nevibecode/agents/drupal-expert.md) — субагент · ★ 41430 у репозитория

Из того же набора: [dev-toolings/superpowers-symfony](https://affpapa.org/nevibecode/by/dev-toolings/superpowers-symfony.md) — 51 карточка

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

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