From 364b3dbab1b2388cdac8dfb9d7614a84248ee1b5 Mon Sep 17 00:00:00 2001 From: Brian O'Kelley Date: Mon, 9 Nov 2026 18:20:49 +0000 Subject: [PATCH] docs(agents): describe pre mode and RC promotion for any line The playbook still said `main` is in 3.2 RC pre mode and that RC promotion cuts `3.2.0-rc.0`. Main is in 3.3 beta pre mode, and the promotion now derives `X.Y.0-rc.0` from package.json. Co-Authored-By: Claude Opus 5.5 --- .agents/playbook.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/.agents/playbook.md b/.agents/playbook.md index 5e353c7bbef..f539d23ee62 100644 --- a/.agents/playbook.md +++ b/.agents/playbook.md @@ -576,10 +576,12 @@ If unsure, default to no changeset and discuss whether the change belongs on #### Pre mode (prereleases) -During the beta phase, `.changeset/pre.json` put `main` in **beta pre mode**, -so each Version Packages cut produced `3.2.0-beta.N`. The current file uses -`"tag": "rc"` and produces `3.2.0-rc.N`; the stable cut (shipped as `3.2.1` -over the withdrawn `3.2.0`) requires the reviewed pre-mode exit below. The original beta entry procedure was: +During a line's beta phase, `.changeset/pre.json` puts `main` in **beta pre +mode**, so each Version Packages cut produces `X.Y.0-beta.N` (`main` is in 3.3 +beta pre mode now). After the RC promotion below it uses `"tag": "rc"` and +produces `X.Y.0-rc.N`; the stable cut requires the reviewed pre-mode exit below +(3.2 shipped as `3.2.1` over the withdrawn `3.2.0`). The original 3.2 beta +entry procedure was: ```bash npx changeset pre enter beta @@ -600,7 +602,8 @@ npm run promote:rc -- --prepare ``` This creates reviewed release state for the Version Packages workflow to cut -`3.2.0-rc.0`. The marker locks the exact pending root changeset pool by filename +`X.Y.0-rc.0` for the line in `package.json` (for 3.3, `3.3.0-beta.N` to +`3.3.0-rc.0`). The marker locks the exact pending root changeset pool by filename and digest; the trusted versioning job consumes that pool through Changesets, preserves its generated changelog, and performs the beta-to-RC phase change. An empty pool remains valid. Changesets otherwise carries the beta sequence number