Save this content to: AGENTS.md

---
package: overtrue/laravel-versionable
source_path: AGENTS.md
repo: https://github.com/overtrue/laravel-versionable
---

# AGENTS.md

## Maintenance guidelines

- Prefer minimal, high-confidence changes.
- Do not change public APIs unless the issue explicitly requires it.
- Do not introduce new dependencies without a clear reason.
- Keep diffs small and reviewable.
- For PHP projects, check composer scripts first; prefer the smallest relevant PHPUnit/Pest/PHPStan command.
- For JavaScript/TypeScript projects, check package scripts first; prefer targeted tests/lint/typecheck.
- Never merge PRs, publish releases, close controversial issues, or modify security policy automatically.

## Review guidelines

- Flag regressions, missing tests, BC breaks, security risks, and unclear behavior.
- Do not block on subjective style unless it violates existing project conventions.
- Treat documentation typos as low priority unless they change meaning.
- When suggesting changes, be specific and include the reason.

Package: **overtrue/laravel-versionable**

## Purpose
Make Eloquent models versionable.

## Compatibility Targets
- Laravel: **^13**
- PHP: **^8.3**

## Local Development
```bash
composer install
composer test
composer check-style
```

## Release Rule
- Tag / release only when GitHub Actions on `master` is green.