pest/CLAUDE.md

CLAUDE.md

Do not edit this file. Agents must never add, remove, or reword anything here. If a change seems needed, say so and let a human do it.

Ask before testing

When asked to review code or build a feature, do not run the test suite and do not write new tests. Make the change, report it, then ask the user whether tests should be added — describing the tests you have in mind — and wait for the user to confirm.

Two reasons this matters here: the suite takes minutes, and tests/.snapshots/success.txt plus the tally in tests/Visual/Parallel.php encode the whole suite's result, so a single added test breaks both.

Once the user confirms:

composer test:unit         # fast, excludes the visual group
composer test:integration  # visual and snapshot tests
composer test              # everything CI runs, in CI's order
composer update:snapshots  # only when a test was added or removed