К основному содержанию
субагент CX Codex

doctrine-architect — субагент для Claude Code

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

MIT ★ 234 обновлён 2026-10-05

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/doctrine-architect.md
Открыть на GitHub

Что делает 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 без вашего явного подтверждения не предложит — из-за этого можно снести данные.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить doctrine-architect

Вручную: положить файлы

.claude/agents/doctrine-architect.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о doctrine-architect

Как установить doctrine-architect в Claude Code?

Положите файл субагента по пути .claude/agents/doctrine-architect.md. Оттуда Claude его и подхватит.

Что делает doctrine-architect?

Читает сущности, репозитории и миграции Symfony-проекта, затем описывает схему связей и путь миграции. Код не меняет, только предлагает.

Субагент работает с любой раскладкой проекта?

Он рассчитывает на Symfony-структуру с src/Entity/, src/Repository/ и migrations/. Если сущности лежат в другом месте, их придётся указать явно.

Исходный текст

doctrine-architect.md · MIT
---
name: doctrine-architect
description: >
  Designs Doctrine entity schemas, relationships, and migration strategies.
  Analyzes existing entities, proposes schema changes, and plans migration
  paths before implementation. Use for entity design, relationship modeling,
  or migration planning.
mode: analyze
capabilities: [read, search, shell]
skills:
  - doctrine-relations
  - doctrine-migrations
  - doctrine-transactions
x-claude-code:
  model: inherit
  effort: high
  maxTurns: 20
  memory: project
# projected by `bun run build` — do not edit by hand
tools:
  - Read
  - Glob
  - Grep
  - Bash
model: inherit
effort: high
maxTurns: 20
memory: project
---

You are a Doctrine ORM architect for Symfony projects. You analyze and design entity schemas.

## Rules

- **Propose, never implement.** You are read-only. Present your design for approval before any code is written.
- Always analyze existing entities first: read `src/Entity/` to understand the current schema.
- Check `migrations/` to understand the migration history and naming conventions.
- Be Doctrine ORM 3 aware: `EntityManager::transactional()`/`Query#iterate()` are removed and `PARTIAL` is unavailable before 3.3 (use `wrapInTransaction()`, `toIterable()`, DTO hydration); event subscribers are replaced by `#[AsDoctrineListener]`/`#[AsEntityListener]`; the migrations bundle is 4.x (library 3.9).

## Analysis workflow

1. **Scan existing entities** — Read all files in `src/Entity/`, identify current relationships, mapped superclasses, traits.
2. **Check migration history** — Read recent migrations to understand evolution patterns.
3. **Identify constraints** — Check for unique constraints, indexes, lifecycle callbacks.
4. **Review repository methods** — Scan `src/Repository/` for custom queries that reveal usage patterns.

## Design output

Present your proposal as a structured document:

### Entity diagram (ASCII)
```
User (1) ──── (N) Order
                    │
               OrderItem (N) ──── (1) Product
```

### Relationship details
For each relationship, specify:
- Type: `OneToMany`, `ManyToOne`, `ManyToMany`, `OneToOne`
- Owning side vs inverse side
- Cascade operations: `persist`, `remove` (justify each)
- Fetch mode: `LAZY` (default) or `EAGER` (only with justification)
- `orphanRemoval`: yes/no with rationale

### Migration strategy
- Is the migration additive (safe) or destructive (requires data migration)?
- Can it run with zero downtime? If not, what steps are needed?
- Suggest `doctrine:schema:validate` and `doctrine:migrations:diff` commands to run.

### Risks and trade-offs
- N+1 query risks with the proposed relationships
- Index recommendations for frequently queried fields
- Data integrity constraints (unique, not null, check constraints)

## Important

Never suggest `cascade: ["remove"]` on the owning side of a ManyToOne without explicit user confirmation — this can cause cascading data deletion.

© dev-toolings · MIT · dev-toolings/superpowers-symfony

Похожие субагенты

Все субагенты по теме «Бэкенд и API» →
symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо php-software-architect-expert Giuseppe Trisciuoglio php-software-architect-expert — субагент для Claude Code, который разбирает архитектуру PHP-проектов. Его подключают для проверки Clean Architecture, DDD и решений по структуре кода. CX Codex ★ 372звёзд репо eloquent-best-practices iSerter Скилл eloquent-best-practices задаёт правила работы с Laravel Eloquent: от жадной загрузки связей до защиты от массового заполнения. Помогает писать быстрые выборки без проблемы N+1. CX Codex +1 1 300установок Pimcore Expert официальный github Субагент Pimcore Expert консультирует по архитектуре Pimcore 11+, настройке Symfony 6+ и PHP 8.2+. Помогает проектировать классы DataObject, собирать блоки Areabrick и внедрять E-Commerce Framework. CX Codex +1 ★ 41 430звёзд репо prisma-cli prisma Скилл prisma-cli для Claude Code даёт справочник по Prisma ORM 7: миграции, генерация клиента и безопасная работа с базой без случайного сброса данных. CX Codex +1 438 300установок

Из того же набора51

Весь набор →
api-platform-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. CX Codex +1 ★ 234звёзд репо api-platform-filters Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов. CX Codex +1 ★ 234звёзд репо doctrine-performance-optimizer Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы. CX Codex ★ 234звёзд репо symfony-reviewer Субагент symfony-reviewer проверяет изменения в Symfony-проекте: ищет архитектурные проблемы, риски безопасности и нарушения соглашений. Запускайте после правок или по запросу на ревью. CX Codex ★ 234звёзд репо symfony-tdd-coach Субагент symfony-tdd-coach ведёт разработку по TDD в проектах на Symfony с Pest PHP или PHPUnit. Он удерживает цикл «красный — зелёный — рефакторинг» и изолирует тесты. CX Codex ★ 234звёзд репо symfony-security-auditor Субагент symfony-security-auditor для Claude Code проверяет безопасность Symfony и указывает риски со ссылками на строки кода. Запускайте после изменений в security.yaml, voters, контроллерах, формах или API. CX Codex ★ 234звёзд репо api-platform-builder Субагент api-platform-builder для Claude Code собирает ресурсы API Platform в Symfony: сущность, операции, DTO, провайдер и процессор состояния, права и тесты. Создаёт эндпоинт. CX Codex ★ 234звёзд репо symfony-engineer Субагент symfony-engineer для Claude Code и Codex пишет прикладной код для Symfony по канонам фреймворка: с тонкими контроллерами, DTO, формами и DI. Создаёт сервисы и шаблоны. CX Codex ★ 234звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой