The workspace AGENTS.md states the changelog rule unconditionally:
Changelog Policy: Never edit debian/changelog files directly. Always use ./run bumpversion which uses the dch tool for proper RFC 2822 date formatting.
The dch half is true for halos-desktop-branding, halos-halpi-desktop-branding, halos-halpi2-desktop and cockpit-dockermanager-debian. It is false for halos-core-containers, halos-cockpit-config, halos-metapackages and halos-marine-containers, whose ./run bumpversion runs bare bump2version against a config whose only target is VERSION — no dch, no changelog edit. Those repos generate the shipped changelog in CI instead.
The Version Bumps section already anticipates this ("Per-repo changelog schemes differ (committed vs CI-generated debian/changelog); see each repo's AGENTS.md"), but an agent reading top-down hits the unconditional rule first and has to unlearn it on arrival.
Direction
Keep "never hand-edit" as the global rule — it holds everywhere — and qualify the remedy: ./run bumpversion in repos whose script runs dch, otherwise the repo's own AGENTS.md. halos-org/halos-core-containers#216 adds the per-repo section for one of them.
Found while fixing halos-org/halos-core-containers#213, where the same stale claim had been copied into a pre-commit hook's error message.
The workspace
AGENTS.mdstates the changelog rule unconditionally:The
dchhalf is true forhalos-desktop-branding,halos-halpi-desktop-branding,halos-halpi2-desktopandcockpit-dockermanager-debian. It is false forhalos-core-containers,halos-cockpit-config,halos-metapackagesandhalos-marine-containers, whose./run bumpversionruns barebump2versionagainst a config whose only target isVERSION— nodch, no changelog edit. Those repos generate the shipped changelog in CI instead.The Version Bumps section already anticipates this ("Per-repo changelog schemes differ (committed vs CI-generated
debian/changelog); see each repo's AGENTS.md"), but an agent reading top-down hits the unconditional rule first and has to unlearn it on arrival.Direction
Keep "never hand-edit" as the global rule — it holds everywhere — and qualify the remedy:
./run bumpversionin repos whose script runsdch, otherwise the repo's own AGENTS.md. halos-org/halos-core-containers#216 adds the per-repo section for one of them.Found while fixing halos-org/halos-core-containers#213, where the same stale claim had been copied into a pre-commit hook's error message.