diff --git a/.forgejo/workflows/ci.yml b/.forgejo/workflows/ci.yml
index 4fec19d..805cdda 100644
--- a/.forgejo/workflows/ci.yml
+++ b/.forgejo/workflows/ci.yml
@@ -1,9 +1,12 @@
 # CI runs first; build only proceeds if all checks pass.
 #
-# Push to dev:  typecheck + lint + test → build :dev + :<sha>
-# Push to main: typecheck + lint + test only (no build — wait for release tag)
-# Tag v*:       typecheck + lint + test → build :latest + :<sha> + :<version>
-# Pull request: typecheck + lint + test only (no build)
+# Push to dev:       typecheck + lint + test → build :dev + :<sha>
+# Tag v* (release):  typecheck + lint + test → build :latest + :<sha> + :<version>
+# Pull request:      typecheck + lint + test only (no build)
+#
+# To cut a release:
+#   Create a release via the Forgejo UI on main with a v* tag name.
+#   The tag push triggers this workflow; build job pushes :latest + :<version>.
 #
 # Required secrets (repo → Settings → Secrets → Actions):
 #   REGISTRY_USER   — your Forgejo username
@@ -12,7 +15,7 @@ name: CI & Build
 
 on:
   push:
-    branches: [main, dev]
+    branches: [dev]
     tags: ["v*"]
     paths:
       - "src/**"