From 5d436f48b29a7170454d65720932cc2c46af3dc4 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Mon, 16 Feb 2026 05:13:49 +0100
Subject: [PATCH] docs: add mac beta release runbook note

---
 AGENTS.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 1b5fab7c280..bfe6fb759b7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -218,6 +218,12 @@
 
 ## Changelog Release Notes
 
+- When cutting a mac release with beta GitHub prerelease:
+  - Tag `vYYYY.M.D-beta.N` from the release commit (example: `v2026.2.15-beta.1`).
+  - Create prerelease with title `openclaw YYYY.M.D-beta.N`.
+  - Use release notes from `CHANGELOG.md` version section (`Changes` + `Fixes`, no title duplicate).
+  - Attach at least `OpenClaw-YYYY.M.D.zip` and `OpenClaw-YYYY.M.D.dSYM.zip`; include `.dmg` if available.
+
 - Keep top version entries in `CHANGELOG.md` sorted by impact:
   - `### Changes` first.
   - `### Fixes` deduped and ranked with user-facing fixes first.