<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom" xml:base="https://docs.spec-kitty.ai/migrations/2-1-main-cutover-checklist/">
  <id>https://docs.spec-kitty.ai/migrations/2-1-main-cutover-checklist/</id>
  <title>2.1 Main-Branch Cutover Checklist</title>
  <updated>2026-06-03T00:00:00.000Z</updated>
  <author><name>Spec Kitty</name></author>
  <link rel="alternate" type="text/html" href="https://docs.spec-kitty.ai/migrations/2-1-main-cutover-checklist/"/>
  <summary>Checklist for promoting the 2.x line to main, parking the old line as 1.x-maintenance, and shipping 2.1.0 as the first stable PyPI release on the new main.</summary>
  <content type="html">&lt;blockquote&gt;
&lt;p&gt;Migration note: This page documents a migration path or historical transition. It is not the current 3.2 happy path.&lt;/p&gt;
&lt;/blockquote&gt;
&lt;span id=&quot;21-main-branch-cutover-checklist&quot;&gt;&lt;/span&gt;
&lt;p&gt;Use this checklist to promote the &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; line to &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;, park the old line as &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt;, and ship &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt; as the first stable PyPI release on the promoted line.&lt;/p&gt;
&lt;h2 id=&quot;desired-end-state&quot;&gt;Desired End State&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; points at the former &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; history and is the stable &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; line.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; points at the former &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; history and is clearly deprecated.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt; publishes both GitHub release artifacts and the PyPI package.&lt;/li&gt;
&lt;li&gt;Install and docs messaging consistently describe &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; as maintenance-only.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;phase-0-freeze-and-confirm&quot;&gt;Phase 0: Freeze and Confirm&lt;/h2&gt;
&lt;ul class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Freeze non-release merges during the cutover window.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm the cutover is a branch rename/cutover, not a merge.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm the intended open-PR outcome:
&lt;ul&gt;
&lt;li&gt;PRs targeting &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; should land on the future &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;PRs targeting current &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; should either stay on &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; or be explicitly rebased.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm the release version is &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;phase-1-repo-and-distribution-prep&quot;&gt;Phase 1: Repo and Distribution Prep&lt;/h2&gt;
&lt;ul class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Merge the release-preparation changes for &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt;:
&lt;ul&gt;
&lt;li&gt;version bump&lt;/li&gt;
&lt;li&gt;changelog entry&lt;/li&gt;
&lt;li&gt;README/docs release-track update&lt;/li&gt;
&lt;li&gt;release workflow with PyPI publish&lt;/li&gt;
&lt;li&gt;release-readiness targeting &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; (and temporarily &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;)&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Configure PyPI Trusted Publishing for &lt;code dir=&quot;auto&quot;&gt;spec-kitty-cli&lt;/code&gt;:
&lt;ul&gt;
&lt;li&gt;owner/repo: &lt;code dir=&quot;auto&quot;&gt;Priivacy-ai/spec-kitty&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;workflow: &lt;code dir=&quot;auto&quot;&gt;.github/workflows/release.yml&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;environment: &lt;code dir=&quot;auto&quot;&gt;pypi&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify GitHub environment settings for &lt;code dir=&quot;auto&quot;&gt;pypi&lt;/code&gt; if environment protection rules are used.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm branch protections are defined for both current &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; before rename.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;phase-2-pre-cutover-verification&quot;&gt;Phase 2: Pre-Cutover Verification&lt;/h2&gt;
&lt;ul class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm latest &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; HEAD is the intended release candidate.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm &lt;code dir=&quot;auto&quot;&gt;CI Quality&lt;/code&gt; is green on that commit.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm &lt;code dir=&quot;auto&quot;&gt;Release Readiness Check&lt;/code&gt; passes for the &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt; PR.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm &lt;code dir=&quot;auto&quot;&gt;gh pr list&lt;/code&gt; shows the expected open PRs and bases.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm docs and metadata now describe:
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; as stable &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; as deprecated maintenance-only&lt;/li&gt;
&lt;li&gt;PyPI publication starting with &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;phase-3-branch-cutover-on-github&quot;&gt;Phase 3: Branch Cutover on GitHub&lt;/h2&gt;
&lt;p&gt;Do these steps in GitHub settings/UI during the freeze window.&lt;/p&gt;
&lt;ol class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Temporarily change the default branch from current &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Rename current &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Rename current &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; to &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Set &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; back as the default branch.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify branch protection rules carried over correctly after rename.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify open PR retargeting:
&lt;ul&gt;
&lt;li&gt;current &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; PRs should now target &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;current &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; PRs should now target &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;phase-4-post-cutover-repository-checks&quot;&gt;Phase 4: Post-Cutover Repository Checks&lt;/h2&gt;
&lt;ul class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify the repository homepage and default-branch badge point at the new &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify raw &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; asset URLs still resolve as expected.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify docs contribution/edit links point at &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify workflows trigger on the right branches after the rename.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify &lt;code dir=&quot;auto&quot;&gt;README.md&lt;/code&gt; on GitHub clearly marks &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; as deprecated.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Add a short deprecation note or pinned issue for &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; if desired.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;phase-5-release-210&quot;&gt;Phase 5: Release &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt;&lt;/h2&gt;
&lt;ol class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Check out the new &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; locally and pull latest.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Confirm &lt;code dir=&quot;auto&quot;&gt;pyproject.toml&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;CHANGELOG.md&lt;/code&gt; still show &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Tag the release:
&lt;div class=&quot;expressive-code&quot;&gt;&lt;figure class=&quot;frame is-terminal not-content&quot;&gt;&lt;figcaption class=&quot;header&quot;&gt;&lt;span class=&quot;title&quot;&gt;&lt;/span&gt;&lt;span class=&quot;sr-only&quot;&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre data-language=&quot;bash&quot;&gt;&lt;code&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;checkout&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;main&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;pull&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;origin&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;main&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;tag&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-a&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;v2.1.0&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;-m&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#984E4D&quot;&gt;Release v2.1.0&lt;/span&gt;&lt;span style=&quot;--0:#D9F5DD;--1:#111111&quot;&gt;&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;ec-line&quot;&gt;&lt;div class=&quot;code&quot;&gt;&lt;span style=&quot;--0:#82AAFF;--1:#3B61B0&quot;&gt;git&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;push&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;origin&lt;/span&gt;&lt;span style=&quot;--0:#D6DEEB;--1:#403F53&quot;&gt; &lt;/span&gt;&lt;span style=&quot;--0:#ECC48D;--1:#3B61B0&quot;&gt;v2.1.0&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/figure&gt;&lt;/div&gt;
&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Watch &lt;code dir=&quot;auto&quot;&gt;.github/workflows/release.yml&lt;/code&gt;.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify:
&lt;ul&gt;
&lt;li&gt;tests passed&lt;/li&gt;
&lt;li&gt;distributions built&lt;/li&gt;
&lt;li&gt;PyPI publish succeeded&lt;/li&gt;
&lt;li&gt;GitHub release was created with artifacts and notes&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;phase-6-release-verification&quot;&gt;Phase 6: Release Verification&lt;/h2&gt;
&lt;ul class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify GitHub release &lt;code dir=&quot;auto&quot;&gt;v2.1.0&lt;/code&gt; exists.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify PyPI shows &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt; as the latest version.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify &lt;code dir=&quot;auto&quot;&gt;pipx install spec-kitty-cli&lt;/code&gt; installs &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt;; optionally verify
&lt;code dir=&quot;auto&quot;&gt;python -m pip install spec-kitty-cli&lt;/code&gt; inside a virtual environment.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Smoke-test &lt;code dir=&quot;auto&quot;&gt;spec-kitty --version&lt;/code&gt; and &lt;code dir=&quot;auto&quot;&gt;spec-kitty init&lt;/code&gt; from the PyPI install.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Verify upgrade behavior on a representative existing project.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;phase-7-follow-through&quot;&gt;Phase 7: Follow-Through&lt;/h2&gt;
&lt;ul class=&quot;contains-task-list&quot;&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Announce &lt;code dir=&quot;auto&quot;&gt;2.1.0&lt;/code&gt; as the new stable line.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; State clearly that &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; is deprecated and maintenance-only.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Update any external docs or pinned install instructions that still mention the old split-track model.&lt;/li&gt;
&lt;li class=&quot;task-list-item&quot;&gt;&lt;input type=&quot;checkbox&quot; disabled&gt; Close or retarget any stale PRs/issues that still refer to the old branch setup.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;current-prs-to-check-during-cutover&quot;&gt;Current PRs to Check During Cutover&lt;/h2&gt;
&lt;p&gt;At the time this checklist was prepared:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;#305&lt;/code&gt; targets &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; and should end up on the new &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;#277&lt;/code&gt; targets &lt;code dir=&quot;auto&quot;&gt;2.x&lt;/code&gt; and should end up on the new &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;&lt;code dir=&quot;auto&quot;&gt;#265&lt;/code&gt; targets current &lt;code dir=&quot;auto&quot;&gt;main&lt;/code&gt; and should end up on &lt;code dir=&quot;auto&quot;&gt;1.x-maintenance&lt;/code&gt; unless intentionally rebased.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;rollback-plan&quot;&gt;Rollback Plan&lt;/h2&gt;
&lt;p&gt;If the branch rename causes unexpected automation or protection issues:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Pause tagging and PyPI publication.&lt;/li&gt;
&lt;li&gt;Fix branch protection and workflow targeting on GitHub first.&lt;/li&gt;
&lt;li&gt;Re-verify PR bases and default branch behavior.&lt;/li&gt;
&lt;li&gt;Only tag &lt;code dir=&quot;auto&quot;&gt;v2.1.0&lt;/code&gt; after the branch model is stable.&lt;/li&gt;
&lt;/ol&gt;</content>
</entry>
