update

Author: Litarnus

AGENTS.md

@@ -4,18 +4,8 @@
 
 - `sentry/sentry-symfony` is a Composer library and Symfony bundle, not an
   application.
-- The bundle wires the Sentry PHP SDK into Symfony and optional integrations
-  such as request handling, console, Messenger, Twig, Cache, DBAL, HTTP
-  client, metrics, and Monolog/logging.
-- The main entry points are:
-  - `src/SentryBundle.php`: registers compiler passes.
-  - `src/DependencyInjection/Configuration.php`: defines the config tree.
-  - `src/DependencyInjection/SentryExtension.php`: turns config into container
-    definitions and parameters.
-  - `src/Resources/config/services.yaml`: defines base services and listener
-    tags.
-  - `src/aliases.php`: selects version-specific classes by runtime feature
-    detection.
+- Use this file for repo-specific constraints that are easy to miss, and
+  explore the codebase for current implementation details.
 
 ## Compatibility Rules
 
@@ -42,23 +32,13 @@
 - Keep `declare(strict_types=1);` in PHP files.
 - Do not introduce PHP syntax or runtime assumptions that require newer than
   PHP `7.2` in shipped code unless the package minimum is being raised.
-- Follow the existing formatting rules from `.php-cs-fixer.dist.php`: Symfony
-  style, short arrays, ordered imports, yoda conditions, and 4-space
-  indentation.
+- Follow the existing formatting rules from `.php-cs-fixer.dist.php`.
 - Services are private by default. Prefer existing FQCN service IDs and aliases
   instead of introducing new public services.
 - If a service or class has no intended public API surface but is public only
   for tests, wiring, or framework integration reasons, mark it `@internal` so
   users do not rely on it as a stable extension point and future refactors do
   not become accidental BC breaks.
-- Config changes usually require synchronized updates in all of these places:
-  - `src/DependencyInjection/Configuration.php`
-  - `src/DependencyInjection/SentryExtension.php`
-  - `src/Resources/config/services.yaml`
-  - `src/Resources/config/schema/sentry-1.0.xsd`
-  - `tests/DependencyInjection/Fixtures/{yml,php,xml}`
-  - `tests/DependencyInjection/ConfigurationTest.php`
-  - `tests/DependencyInjection/SentryExtensionTest.php`
 - XML fixtures are still relevant for older Symfony versions even though XML
   config support is skipped on Symfony 8+ in tests.
 - End-to-end behavior lives in `tests/End2End/App`. Prefer end-to-end coverage
@@ -81,23 +61,19 @@
 - For config changes, update the YAML, PHP, and XML DI fixtures together.
 - For optional-package behavior, mirror the existing pattern of conditional
   skips instead of forcing packages to exist in every environment.
-- Local verification commands:
-  - `composer install`
-  - `composer cs-check`
-  - `composer phpstan`
-  - `composer psalm`
-  - `composer tests`
-  - `composer check`
-- `composer phpstan` runs PHPStan with `512M` because the default local PHP
-  memory limit can be too low for this repo.
-- `php-cs-fixer` is the formatting tool in this repo. If formatting fails, run
-  `composer cs-fix` and then rerun `composer check`.
+- After editing files, run the relevant formatting, lint, and test commands for
+  the code you changed.
 - Before committing, run `composer check`.
 
 ## Docs And Release Notes
 
-- Update `README.md` when public installation, configuration, or usage changes.
-- Update `CHANGELOG.md` for user-facing changes.
+- `README.md` and `CHANGELOG.md` are updated manually during releases, so do
+  not modify them as part of normal development changes.
+- If a change may require updates in the separate documentation repo, ask the
+  user whether to review their locally checked out docs. The user must provide
+  the local path. If they opt in, update that repo's `master` branch when safe,
+  use git worktrees to inspect the relevant docs, and suggest any needed
+  changes to avoid stale documentation.
 - Add or update an `UPGRADE-*.md` file when a change is breaking or alters the
   upgrade path.
 - `CONTRIBUTING.md` states that new code should include tests and notes that
@@ -109,7 +85,4 @@
 - `.github/workflows/tests.yaml` runs a PHP/Symfony matrix and also includes
   jobs that remove optional packages before running tests.
 - `.github/workflows/static-analysis.yaml` runs PHP-CS-Fixer, PHPStan, and
-  Psalm on a recent PHP version. Check the workflow file for the exact version
-  currently used in CI.
-- A single local green run is necessary but not sufficient. Avoid changes that
-  only work when optional packages are present.
+  Psalm on a single recent PHP version rather than across the full test matrix.