diff --git a/CLAUDE.md b/CLAUDE.md
index 03ce682..7f4111a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -125,7 +125,10 @@ persistence) → GUI (Qt widgets that read the manager and connect to its signal
   checks `origin` shortly after launch and every 4 h, and a click runs
   `git pull --ff-only` then re-execs the app — pushing `master` is
   effectively releasing to the other machines (a new pip dependency still
-  needs a manual `pip install -e .` there).
+  needs a manual `pip install -e .` there). **Every round ends with commit
+  AND push** (trav's standing request, 2026-07-03: both machines ride the
+  bleeding edge, sync as often as possible) — so never leave master in a
+  half-working state between commits you push.
 - `scripts/` holds one-off maintenance tools (`audit_artwork.py`,
   `recover_artwork.py`, `clear_computed_ratings.py`) run manually against a data
   dir; most default to dry-run and need `--write` to mutate files.