git:20260917.3d83f4c to git:20261005.042befb

---

name: doctrine-relations

description: Define Doctrine entity relationships (OneToMany, ManyToMany, ManyToOne); configure cascade, orphan removal, multiple entity managers; prevent N+1 queries

capabilities: [read, search, edit, shell]

tags: [doctrine]

# projected by `bun run build` — do not edit by hand

allowed-tools:

- Read

- Glob

- Grep

- Write

- Edit

- Bash

---

# Doctrine Relations (Symfony)

## Use when

- Designing entity relations or schema evolution.

- Improving Doctrine correctness/performance.

## Default workflow

1. Model ownership/cardinality and transactional boundaries.

2. Apply mapping/schema changes with migration safety.

3. Tune fetch/query behavior for hot paths.

4. Verify lifecycle behavior with targeted tests.

## Guardrails

- Keep owning/inverse sides coherent.

- Avoid destructive migration jumps in one release.

- Eliminate accidental N+1 and over-fetching.

## Progressive disclosure

- Use this file for execution posture and risk controls.

- Open references when deep implementation details are needed.

## Output contract

- Entity/migration changes.

- Integrity and performance decisions.

- Validation outcomes and rollback notes.

## References

- `reference.md`