- I linked the related issue(s) and explained the motivation.
- I kept this PR focused and scoped to a single concern.
- I added or updated tests for changed behavior (or explained why not needed).
- I ran the relevant tests locally.
- I updated documentation when needed (README/docs/API examples).
- This PR introduces API contract changes (request/response/endpoint/DTO).
- If API changed, I documented compatibility or migration notes.
- This PR includes breaking changes.
- If breaking, I clearly described impact and migration steps.