From f0275f3c0bd18cd95646588943743b9961e0aec0 Mon Sep 17 00:00:00 2001 From: Craig Martin Date: Tue, 17 Nov 2026 13:38:21 -0500 Subject: [PATCH 1/2] Say the mirror merges its pull requests once checks pass Co-Authored-By: Claude Opus 5.5 --- .claude/commands/write_release_descriptions.md | 2 +- AGENTS.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.claude/commands/write_release_descriptions.md b/.claude/commands/write_release_descriptions.md index b4a567c7ac7..cd240cfb009 100644 --- a/.claude/commands/write_release_descriptions.md +++ b/.claude/commands/write_release_descriptions.md @@ -6,7 +6,7 @@ description: Write CLI release description and generate RELEASE_NOTES given a ch You need to create release documentation for Shopify CLI based on the changeset PR at: $ARGUMENTS -For `main`, the version bump is made upstream, in Shopify's internal monorepo, with `pnpm changeset-manifests`, and the mirror carries it here: it opens or refreshes a pull request automatically after each upstream merge. Never merge "Version Packages - main" here: the mirror would refuse every later publish. `stable/*` patch lines keep their own "Version Packages - stable/X.Y" pull requests here. +For `main`, the version bump is made upstream, in Shopify's internal monorepo, with `pnpm changeset-manifests`, and the mirror carries it here: it opens or refreshes a pull request automatically after each upstream merge and merges it once `main`'s required checks pass. Never merge "Version Packages - main" here: the mirror would refuse every later publish. `stable/*` patch lines keep their own "Version Packages - stable/X.Y" pull requests here. ## Step 1: Generate Release Markdown diff --git a/AGENTS.md b/AGENTS.md index 94f2271c6ab..d6fd9867f29 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -57,7 +57,7 @@ If the change is not ready to be public, do not add a changeset. ## Releases -- `main`'s version bump is made upstream, in Shopify's internal monorepo, with `pnpm changeset-manifests`. The mirror carries it here: it opens or refreshes a pull request automatically after each upstream merge, and `release.yml` publishes as before. +- `main`'s version bump is made upstream, in Shopify's internal monorepo, with `pnpm changeset-manifests`. The mirror carries it here: it opens or refreshes a pull request automatically after each upstream merge and merges it once `main`'s required checks pass, and `release.yml` publishes as before. - Never merge "Version Packages - main" here. It would put commits on `main` that the mirror didn't make, and the mirror would refuse every later publish. - `stable/*` patch lines keep their own "Version Packages - stable/X.Y" pull requests here, as before. - Each `X.Y.0` release gets a `stable/X.Y` branch for its patch releases. Only Dev Experience members can create one: after the release job, a Dev Experience member creates it from the release tag with `git push origin refs/tags/X.Y.0:refs/heads/stable/X.Y`. From 7a1c42e17c4f92f800288d318e0dfd772247d283 Mon Sep 17 00:00:00 2001 From: Craig Martin Date: Tue, 17 Nov 2026 18:40:11 -0500 Subject: [PATCH 2/2] Say Dev Experience merges stable pull requests with the bypass Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index d6fd9867f29..96c47838e55 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -59,9 +59,9 @@ If the change is not ready to be public, do not add a changeset. - `main`'s version bump is made upstream, in Shopify's internal monorepo, with `pnpm changeset-manifests`. The mirror carries it here: it opens or refreshes a pull request automatically after each upstream merge and merges it once `main`'s required checks pass, and `release.yml` publishes as before. - Never merge "Version Packages - main" here. It would put commits on `main` that the mirror didn't make, and the mirror would refuse every later publish. -- `stable/*` patch lines keep their own "Version Packages - stable/X.Y" pull requests here, as before. +- `stable/*` patch lines keep their own "Version Packages - stable/X.Y" pull requests here. GitHub Actions can't open them, so a Dev Experience member opens each one from `changeset-release/stable/X.Y`. - Each `X.Y.0` release gets a `stable/X.Y` branch for its patch releases. Only Dev Experience members can create one: after the release job, a Dev Experience member creates it from the release tag with `git push origin refs/tags/X.Y.0:refs/heads/stable/X.Y`. -- Changes to `stable/*` branches, such as patch-release cherry-picks, need a pull request with code-owner review. Do not push to them directly. +- Changes to `stable/*` branches, such as patch-release backports and their "Version Packages" pull requests, go through a pull request that a Dev Experience member merges with the branch rules' bypass (`gh pr merge --merge --admin`), with no review. Do not push to them directly. ## Further reading