From 240f1cf6d6da014fa2ac03f409aa994c1a119557 Mon Sep 17 00:00:00 2001 From: Paul Kilmurray Date: Wed, 17 Jun 2026 21:04:18 +0200 Subject: [PATCH] docs: add stable/next branch-lane guidance for agents --- AGENTS.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index d0402ab..9d5d131 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,3 +16,11 @@ Respect documented author intent and check for companion PRs. repos. - When author intent is unclear, ask a question rather than request a change. + +## Branch lanes + +This repo has two permanent trunks: +- **`main`** — the **stable**, released line (1.9.x patches ship from here). +- **`next`** — the **in-development** major/minor (1.10, then 1.11, 2.0 …). + +Feature work usually targets `next`; patches to the shipped release target `main`. Never commit directly to either trunk — branch off the correct one in a worktree, and target the PR's base at the same lane. **If it isn't clear which lane a task belongs to, ask "main or next?" before branching, pulling (`git pull origin `), or opening a PR — don't default to `main`.**