diff --git a/CLAUDE.md b/CLAUDE.md
index 14cfded..3e1a819 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -59,6 +59,13 @@ class MyCog(commands.Cog):
 - **Image**: `manticorum67/major-domo-discordapp` (no dash between discord and app)
 - **Health**: Process liveness only (no HTTP endpoint)
 - **CI/CD**: Gitea Actions on PR to `main` — builds Docker image, auto-generates CalVer version (`YYYY.MM.BUILD`) on merge
+
+### Release Workflow
+1. Create feature/fix branches off `next-release` (e.g., `fix/scorebug-bugs`)
+2. When done, merge the branch into `next-release` — this is the staging branch where changes accumulate
+3. When ready to release, open a PR from `next-release` → `main`
+4. CI builds Docker image on PR; CalVer tag is created on merge
+5. Deploy the new image to production (see `/deploy` skill)
 - **Other services on same host**: `sba_db_api`, `sba_postgres`, `sba_redis`, `sba-website-sba-web-1`, `pd_api`
 
 ### Logs