From b8c02e4389832b03624b4619d4939b5f90adb11c Mon Sep 17 00:00:00 2001
From: Mason Daugherty <mason@langchain.dev>
Date: Fri, 29 May 2026 16:12:32 -0400
Subject: [PATCH] chore(infra): note branch conventions in `AGENTS.md` (#37776)

---
 AGENTS.md | 16 ++++++++++++++++
 CLAUDE.md | 16 ++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 8b8a51a152c..09d0564f28a 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -97,6 +97,22 @@ feat(langchain): `ls_agent_type` tag on `create_agent` calls
 fix(openai): infer Azure chat profiles from model name
 ```
 
+#### Branch naming
+
+Branches should be prefixed `<github-username>/<scope>/<short-description>`:
+
+- `<github-username>` — the author's GitHub login (e.g. `mdrxy`).
+- `<scope>` — the same scope used in the Conventional Commit title (`core`, `langchain`, partner name, `infra`, `docs`, etc.).
+- `<short-description>` — kebab-case, brief, no trailing slash.
+
+Examples:
+
+```txt
+mdrxy/anthropic/normalize-tool-call-ids
+mdrxy/core/vector-store-type-hints
+mdrxy/infra/agents-md-branch
+```
+
 #### PR descriptions
 
 The description *is* the summary — do not add a `# Summary` header.
diff --git a/CLAUDE.md b/CLAUDE.md
index 8b8a51a152c..09d0564f28a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -97,6 +97,22 @@ feat(langchain): `ls_agent_type` tag on `create_agent` calls
 fix(openai): infer Azure chat profiles from model name
 ```
 
+#### Branch naming
+
+Branches should be prefixed `<github-username>/<scope>/<short-description>`:
+
+- `<github-username>` — the author's GitHub login (e.g. `mdrxy`).
+- `<scope>` — the same scope used in the Conventional Commit title (`core`, `langchain`, partner name, `infra`, `docs`, etc.).
+- `<short-description>` — kebab-case, brief, no trailing slash.
+
+Examples:
+
+```txt
+mdrxy/anthropic/normalize-tool-call-ids
+mdrxy/core/vector-store-type-hints
+mdrxy/infra/agents-md-branch
+```
+
 #### PR descriptions
 
 The description *is* the summary — do not add a `# Summary` header.