From 20b3bb0da12ecf607ea5054735ba116cd5daf67e Mon Sep 17 00:00:00 2001
From: James <james@prestwi.ch>
Date: Mon, 30 Mar 2026 09:17:08 -0400
Subject: [PATCH] chore: update branch references for main/legacy rename
 (ENG-2105)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update CI triggers, CLAUDE.md, CONTRIBUTING.md, and README.md to
reflect the branch rename: develop → main, main → legacy.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .github/workflows/rust.yml | 2 +-
 CLAUDE.md                  | 4 ++--
 CONTRIBUTING.md            | 5 +++++
 README.md                  | 4 ++--
 4 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index b0a67bea..ba92f5fd 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -3,7 +3,7 @@ name: CI # Continuous Integration
 on:
   workflow_dispatch:
   push:
-    branches: [main]
+    branches: [main, legacy]
   pull_request:
 
 # simplest example of using the rust-base action
diff --git a/CLAUDE.md b/CLAUDE.md
index 53eade31..2951863a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,8 +2,8 @@
 
 ## Branches
 
-The `main` branch is in maintenance and bug-fix mode. The `develop` branch
-contains current work.
+The `main` branch contains current work. The `legacy` branch is under
+long-term maintenance and may receive active work.
 
 ## Commands
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b23d7613..7b3ed2e1 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -22,6 +22,11 @@ We maintain code quality and style standards, and require commit signing. This
 option allows us to make small changes to your PR to bring it in line with
 these standards. It helps us get your PR in faster, and with less work from you.
 
+### Branching
+
+PRs should target the `main` branch by default. The `legacy` branch is under
+long-term maintenance and accepts maintenance and backport PRs.
+
 ## Development Basics
 
 Before submitting a PR we recommend you run the following commands to ensure
diff --git a/README.md b/README.md
index fa5b6d90..0bd387f2 100644
--- a/README.md
+++ b/README.md
@@ -3,8 +3,8 @@
 [![CI](https://github.com/init4tech/node-components/actions/workflows/rust.yml/badge.svg)](https://github.com/init4tech/node-components/actions/workflows/rust.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-> **Note:** The `main` branch is in maintenance and bug-fix mode. The
-> `develop` branch contains current work.
+> **Note:** The `legacy` branch is under long-term maintenance and may receive
+> active work. The `main` branch contains current work.
 
 A collection of components for building the Signet node. These components
 implement core node functionality, but are potentially independently useful.