Feature branches no longer commit docs/screenshots. Every pull that changed the menu rewrote the same composed sheets (overview.png, light-dark.png). So each merge left the other open pulls conflicted over pictures that were stale anyway. Now tools/screenshots.sh refreshes them in a docs: refresh screenshots commit of their own, as the first step of a release (docs/RELEASING.md).
The screenshots hook now runs before a push, not on every commit. It still takes every shot in a headless GNOME Shell, and fails if the shell or a shot fails, so it remains the shell-side integration check. It writes nothing into the tree. tools/screenshots.sh --out DIR writes every shot and sheet to a directory, for a PR's before/after images. Only the three images the README shows stay committed; the other 16 are removed.
This changes the workflow in AGENTS.md and DEVELOPING.md. DEVELOPING.md also no longer advises branching one pull from another.
🤖 Generated with Claude Code