doctrine-architect — субагент для Claude Code
Субагент doctrine-architect разбирает сущности Symfony и историю миграций, а на выходе даёт схему связей и план миграции — до того, как вы напишете код.
MIT ★ 234 обновлён 2026-10-05
.claude/agents/doctrine-architect.mdЧто делает 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 или по @-упоминанию
Вручную: положить файлы
.codex/agents/doctrine-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/doctrine-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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