Save this content to: AGENTS.md

---
package: chamber-orchestra/doctrine-sort-bundle
source_path: AGENTS.md
repo: https://github.com/chamber-orchestra/doctrine-sort-bundle
---

# Repository Guidelines

## Project Structure & Module Organization
- `src/` contains the Symfony bundle code, organized by namespace (e.g., `Sort/`, `Mapping/`, `DependencyInjection/`, `EventSubscriber/`).
- `src/Resources/` holds bundle resources such as service config and translations.
- `tests/` is reserved for PHPUnit tests (currently empty).
- `bin/phpunit` and `vendor/` are Composer-managed tooling and dependencies.

## Build, Test, and Development Commands
- `composer install` installs PHP dependencies for local development.
- `composer test` runs the PHPUnit suite via the Composer script.
- `vendor/bin/phpunit` runs PHPUnit directly using `phpunit.xml.dist`.

## Coding Style & Naming Conventions
- PHP namespace root is `ChamberOrchestra\SortBundle` (PSR-4 via `composer.json`).
- Class files follow `StudlyCaps` with one class per file under `src/`.
- No formatter or linter is configured in this repo; keep changes consistent with existing code style and PHP 8.4 syntax.

## Testing Guidelines
- Tests should live in `tests/` and follow PHPUnit conventions (e.g., `SomethingTest.php`).
- Configure test services and kernel settings via `phpunit.xml.dist` as needed.
- Keep unit tests focused on sorter behavior and ORM helpers; add integration tests for bundle wiring.

## Commit & Pull Request Guidelines
- There is no commit history yet, so no established message convention.
- Use clear, imperative commit subjects (e.g., "Add range diff helper") and include scope when helpful.
- PRs should describe the change, list test coverage, and call out any behavior changes.

## Configuration Notes
- PHP 8.4 is required (see `composer.json`).
- Bundle services are defined in `src/Resources/config/services.php`.