1 files changed, 6 insertions, 0 deletions
diff --git a/CLAUDE.md b/CLAUDE.md
index 552f7d9..4fbfdcb 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -160,16 +160,22 @@ the Slackware target, so their project-version flag is `-V` only.
 To cut a release (bump `X.Y.Z`):
 
 ```bash
+# 1. add a dated section for X.Y.Z at the top of ChangeLog.md (Keep a Changelog
+#    format: Added / Changed / Fixed / Removed), summarizing the commits since
+#    the last tag (git log vPREV..HEAD).
 sed -i 's/^PROJECT_VERSION="[^"]*"/PROJECT_VERSION="X.Y.Z"/' \
     test-build install.sh image-builder/*.sh
 git commit -aS -m "release X.Y.Z"
 git tag -s vX.Y.Z -m "vX.Y.Z"
 git push origin master --tags          # both remotes (danix_git + forge)
+# --note-file feeds the ChangeLog section as the release body.
 tea release create --repo danix/sbo-dockerbuild --tag vX.Y.Z --title vX.Y.Z
 ```
 
 The `sed` anchors on `^PROJECT_VERSION="..."`, which never matches the SBo
 package `VERSION=`/`OPT_VERSION=` vars, so it only touches the project const.
+`ChangeLog.md` is the human-facing history; update it in the same release
+commit as the version bump.
 
 ## Deployment