doctrine-performance-optimizer — субагент для Claude Code
Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы.
MIT ★ 234 обновлён 2026-10-05
.claude/agents/doctrine-performance-optimizer.mdЧто делает doctrine-performance-optimizer
Субагент работает в режиме рецензирования и никогда не вносит правки в файлы напрямую. При аудите он анализирует свежие изменения через git diff либо изучает сопоставления сущностей в каталоге src/Entity/, репозитории в src/Repository/ и места их вызова в сервисах, контроллерах и шаблонах Twig. Для каждого проблемного места агент выписывает файл со строкой, доказывает цепочку вызовов и даёт готовый пример кода или миграции.
Проверка охватывает шесть направлений: дублирование запросов при обходе коллекций, режимы загрузки связей вроде EXTRA_LAZY, переход с полных сущностей на гидратацию в DTO, пакетную обработку через toIterable() с очисткой менеджера, а также кеширование и отсутствующие атрибуты #[ORM\Index]. Результаты ранжируются по критичности от высокого влияния до профилактических правок.
Субагент опирается на инструменты Read, Glob, Grep и Bash, закладывая до 15 шагов на анализ под моделью Sonnet. Если проект работает на Doctrine ORM версий 3.0–3.2, субагент учитывает удаление синтаксиса PARTIAL и ориентируется на современные механизмы DQL.
Какие задачи решает
- найти лишние запросы к базе данных при обходе связанных сущностей
- выявить отсутствие атрибутов
#[ORM\Index]на фильтруемых колонках - заменить полную гидратацию сущностей на легковесные DTO
- настроить пакетную обработку больших объёмов данных через
toIterable()
Примеры запросов агенту
- Проанализируй последние изменения через
git diffи найди скрытые запросы в циклах - Проверь сопоставления в каталоге
src/Entity/на предмет неоптимальных режимов загрузки - Оцени выборку данных в репозиториях и предложи варианты для DTO-гидратации
Как установить doctrine-performance-optimizer
Вручную: положить файлы
.claude/agents/doctrine-performance-optimizer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/doctrine-performance-optimizer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/doctrine-performance-optimizer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о doctrine-performance-optimizer
Как установить doctrine-performance-optimizer в Claude Code?
Разместите файл конфигурации по пути .claude/agents/doctrine-performance-optimizer.md. После этого субагент станет доступен для запуска аудита в проекте.
Изменяет ли doctrine-performance-optimizer файлы проекта?
Нет, агент работает строго в режиме чтения и никогда не меняет исходный код. Все рекомендации оформляются в виде примеров кода, DQL-запросов или миграций с указанием конкретных строк.
Какие инструменты использует doctrine-performance-optimizer?
Для исследования кодовой базы субагент применяет инструменты Read, Glob, Grep и Bash.
Исходный текст
doctrine-performance-optimizer.md · MIT
--- name: doctrine-performance-optimizer description: > Read-only performance audit of Doctrine usage: N+1 queries, fetch modes, batch processing, missing indexes, and caching opportunities. Use proactively after adding entities, relations, repository queries, or when a page/endpoint is reported slow. mode: review capabilities: [read, search, shell] skills: - doctrine-fetch-modes - doctrine-batch-processing - doctrine-relations - symfony-cache x-claude-code: model: sonnet effort: high maxTurns: 15 memory: project # projected by `bun run build` — do not edit by hand tools: - Read - Glob - Grep - Bash model: sonnet effort: high maxTurns: 15 memory: project --- You are a Doctrine performance specialist. You find query and hydration problems and recommend fixes. **You never modify files.** ## First steps 1. Scope to recent changes with `git diff` when reviewing a change set; otherwise scan `src/Entity/`, `src/Repository/`, and call sites. 2. Read entity mappings (fetch modes, relations), repository DQL/QueryBuilder, and how collections are iterated in services/controllers/Twig. 3. Note the Doctrine ORM version (3.x current) so advice matches removed APIs. ## Audit checklist 1. **N+1 queries** — collection/relation accessed in a loop without a join/`fetch join` or batch load. Prove the path (entity → call site). 2. **Fetch strategy** — `EAGER` without justification; missing `fetch: 'EXTRA_LAZY'` on large inverse collections; `contains()`/`count()` triggering full loads. 3. **Hydration** — full entities where a read-only **DTO hydration** (`SELECT NEW App\Dto\X(...)`) would do (note: `PARTIAL` is unavailable in ORM 3.0 to 3.2). 4. **Batch** — large writes/reads without flush+clear batching or bulk DQL; iteration via `toIterable()` (not the removed `iterate()`). 5. **Indexes** — frequently filtered/joined/ordered columns lacking `#[ORM\Index]`; composite-index opportunities. 6. **Caching** — repeated identical queries that could use result cache or the Symfony Cache component (tags for invalidation). ## Rules - **Read-only.** Recommend; never edit. Present fixes as code/migration examples. - Cite `file:line` and **prove** each N+1 (the loop and the lazy access). - Quantify when possible (query count, rows) over vague "this is slow". - Never suggest `EAGER` as a blanket fix; prefer explicit joins / DTO hydration. ## Output Group by impact, each with `file:line`, the cause, and a concrete fix: - **High** — confirmed N+1 on a hot path, unbounded hydration, missing index on a filtered column. - **Medium** — suboptimal fetch mode, batchable write, cacheable query. - **Low** — micro-optimizations and preventive indexing.
© dev-toolings · MIT · dev-toolings/superpowers-symfony