diff --git a/CLAUDE.md b/CLAUDE.md
index f4e7851..466c058 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -32,12 +32,14 @@ major-version tag and an immutable semver tag.
 2. Determine the next version by bumping the patch or minor from the
    latest semver tag (e.g. `v1.0.3` → `v1.0.4` for a fix, `v1.1.0`
    for a non-breaking feature).
-3. Tag and push. Both the immutable semver tag and the moving major
-   tag get pushed in the same command:
+3. Tag and push. This repo has `tag.gpgsign=true` globally, so tags
+   must be annotated with a message (`-m`) and a GPG key must be
+   available. Both the immutable semver tag and the moving major tag
+   get pushed in the same release:
 
    ```sh
-   git tag v1.0.4
-   git tag -f v1
+   git tag -m "v1.0.4" v1.0.4
+   git tag -f -m "v1 - track latest v1.x.y" v1
    git push origin main
    git push origin v1.0.4
    git push origin v1 --force
@@ -53,8 +55,8 @@ major-version tag and an immutable semver tag.
 2. Cut a new major tag (`v2.0.0`) and a new major-line tag (`v2`):
 
    ```sh
-   git tag v2.0.0
-   git tag v2
+   git tag -m "v2.0.0" v2.0.0
+   git tag -m "v2 - track latest v2.x.y" v2
    git push origin main v2.0.0 v2
    ```