# doctrine-architect

Субагент doctrine-architect разбирает сущности Symfony и историю миграций, а на выходе даёт схему связей и план миграции — до того, как вы напишете код.

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

## Что делает

Субагент для Symfony-проектов на Doctrine ORM: читает `src/Entity/`, `src/Repository/` и `migrations/`, а потом выдаёт проект схемы. Работает в режиме анализа, из инструментов у него Read, Glob, Grep и Bash, поэтому правки в коде остаются за вами.

На выходе — структурированный документ. ASCII-схема связей, по каждой связи тип (`OneToMany`, `ManyToOne`, `ManyToMany`, `OneToOne`), владеющая сторона, каскады с обоснованием, режим загрузки, `orphanRemoval`. Дальше стратегия миграции: аддитивная она или разрушительная, переживёт ли деплой без простоя, какие команды прогнать: `doctrine:schema:validate` и `doctrine:migrations:diff`. В конце риски: N+1, индексы под частые запросы, ограничения целостности.

Заточен под Doctrine ORM 3: советует `wrapInTransaction()`, `toIterable()` и DTO-гидратацию вместо удалённых `EntityManager::transactional()` и `Query#iterate()`, а подписчики событий переводит на атрибуты `#[AsDoctrineListener]` и `#[AsEntityListener]`. `cascade: ["remove"]` на владеющей стороне `ManyToOne` без вашего явного подтверждения не предложит — из-за этого можно снести данные.

## Установка

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- Спроектировать связи между сущностями до написания кода
- Разобрать текущую схему в `src/Entity/` перед рефакторингом
- Понять, чем обернётся миграция для уже накопленных данных
- Найти риск N+1 в предложенной связи и закрыть его индексом
- Перевести подписчики событий на атрибуты Doctrine ORM 3

## Примеры запросов агенту
- Через субагента doctrine-architect разбери связи в `src/Entity/Order.php` и предложи схему для позиций заказа
- Позови doctrine-architect: спланируй миграцию под новое поле `status` в `Product` и скажи, разрушительная она или нет
- Пусть doctrine-architect проверит эту связь на N+1 и подскажет индексы

## Похожие
- [symfony-specialist](https://affpapa.org/nevibecode/agents/symfony-specialist.md) — субагент · ★ 26718 у репозитория
- [php-symfony](https://affpapa.org/nevibecode/rules/php-symfony.md) — правило · ★ 41430 у репозитория
- [php-software-architect-expert](https://affpapa.org/nevibecode/agents/php-software-architect-expert.md) — субагент · ★ 372 у репозитория
- [eloquent-best-practices](https://affpapa.org/nevibecode/skills/eloquent-best-practices.md) — скилл · 1300 установок
- [Pimcore Expert](https://affpapa.org/nevibecode/agents/pimcore-expert.md) — субагент · ★ 41430 у репозитория
- [prisma-cli](https://affpapa.org/nevibecode/skills/prisma-cli.md) — скилл · 438300 установок

Из того же набора: [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
