From 902063fd0ac3f95b409063a921f0f928953fa33c Mon Sep 17 00:00:00 2001
From: sck_0 <samujackson1337@gmail.com>
Date: Sun, 25 Jan 2026 18:01:02 +0100
Subject: [PATCH] docs: add release management procedure to MAINTENANCE.md

---
 MAINTENANCE.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/MAINTENANCE.md b/MAINTENANCE.md
index 3d67446c..6a921bef 100644
--- a/MAINTENANCE.md
+++ b/MAINTENANCE.md
@@ -52,3 +52,31 @@ Running the scripts is **MANDATORY** after any change to `skills/`.
 ## 5. Agent Artifacts (Internal)
 
 - [ ] **Walkthrough**: Update `walkthrough.md` in the brain/artifact directory to reflect the session's achievements.
+
+## 6. Release Management
+
+When creating a new version release:
+
+- [ ] **Tag**: Create an annotated git tag.
+
+  ```bash
+  git tag -a vX.Y.Z -m "Release X.Y.Z: Title"
+  ```
+
+- [ ] **Push Tag**:
+
+  ```bash
+  git push origin vX.Y.Z
+  ```
+
+- [ ] **Set Default Repo**: Ensure the `gh` CLI knows the upstream repo (crucial if you have multiple remotes).
+
+  ```bash
+  gh repo set-default sickn33/antigravity-awesome-skills
+  ```
+
+- [ ] **Create GitHub Release**: This creates the visible release on GitHub.
+
+  ```bash
+  gh release create vX.Y.Z --title "Release X.Y.Z: Title" --generate-notes
+  ```