From 977a76221dbf9e058d3cc7c7bd06d9a9c055a000 Mon Sep 17 00:00:00 2001
From: fullsend-code
 <278716306+fullsend-ai-coder[bot]@users.noreply.github.com>
Date: Wed, 9 Sep 2026 10:33:36 +0000
Subject: [PATCH] docs(#189): document PR title scope character restrictions

Add a bullet to the PR Conventions section of AGENTS.md
documenting that scopes must match [\w$\.\-* ]* -- the
character class enforced by the headerPattern regex in
pr-semantic.yaml. This prevents agents and contributors
from using # or other special characters in the scope
position, which causes PR Semantic CI failures requiring
human intervention to rename the title.

Closes #189

Assisted-by: claude-opus-4-6
---
 AGENTS.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/AGENTS.md b/AGENTS.md
index e8fe9d9..ca3e1a7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -33,5 +33,6 @@
 
 - PR titles must follow [Conventional Commits](https://www.conventionalcommits.org/) — enforced by CI (`pr-semantic.yaml`)
 - Allowed types: `feat`, `fix`, `chore`, `docs`, `style`, `refactor`, `perf`, `test`, `revert`
+- Scopes are optional. If used, they must match `[\w$.\-* ]*` — no `#`, `@`, or other special characters. Do not put issue references (e.g., `#187`) in the scope position; reference issues in the PR body with `Closes #N` instead.
 - Subjects must not start with an uppercase character
 - Agent-assisted commits should include an `Assisted-by: <model>` footer