Save this content to: AGENTS.md

# 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-filesystem-qiniu**

## Purpose
Qiniu filesystem driver for Laravel (Flysystem adapter).

## Compatibility Targets
- Laravel: **^9|^10|^11|^12|^13**
- PHP: **Laravel 13 requires PHP 8.3+**

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

## Notes
- Tests are run via PHPUnit + Orchestra Testbench.
- If you see PHP deprecation notices from vendor packages during tests, treat them as upstream noise unless they fail CI.