From 9739944cd0ee7e96608c0d34fefa1430a009f3f4 Mon Sep 17 00:00:00 2001
From: Sal <59910950+ss-o@users.noreply.github.com>
Date: Mon, 19 Oct 2026 04:16:59 +0100
Subject: [PATCH] docs(agents): align the branch-name rule with commit-lint

Closes #239. The rule listed only feature, bug and hotfix issue branches, while the commit-lint caller enforces the organization pattern, which also accepts an optional slug and <type>/<slug>; the text now links the pull-request runbook.
---
 AGENTS.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 849bf0a..78f2924 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -28,8 +28,9 @@ and sync utilities.
 
 - This repository uses trunk-based development on `main` per organization ADR 0019. Create short-lived branches from `main` and target pull requests to
   `main`.
-- Use the organization branch names `feature-<id>`, `bug-<id>`, or
-  `hotfix-<id>`.
+- Use the organization branch names that `commit-lint.yml` enforces:
+  `feature-<issue>`, `bug-<issue>` or `hotfix-<issue>` with an optional
+  `-<slug>`, or `<type>/<slug>` ([pull-request runbook](https://github.com/z-shell/.github/blob/main/runbooks/pull-requests.md#1-before-the-branch)).
 - Keep `main` deployable; deployment remains a separately verified workflow
   result after merge.