From 2a4d3bf095781570943db7144059715f87e17bc6 Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Fri, 16 Jan 2026 23:47:58 +0100
Subject: [PATCH 1/3] =?UTF-8?q?=F0=9F=94=A7=20add=20commit/pr=20format=20t?=
 =?UTF-8?q?o=20AGENTS.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 2851b1d5..7e2f2ce3 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -197,6 +197,43 @@ def test_example(app, status, warning, get_sphinx_app_output):
     assert warnings == ""
 ```
 
+## Testing Philosophy
+
+1. **Always add tests** for new features and bug fixes
+2. **Unit tests should be atomic** – fast and focused
+3. **Document test purpose** – explain *why* the test exists
+4. **Use parameterized tests** (rstest/pytest) for multiple scenarios
+5. **Use snapshot tests** (insta/syrupy) for complex outputs
+
+## Commit Message Format
+
+Use this format:
+
+```
+<EMOJI> <KEYWORD>: Summarize in 72 chars or less (#<PR>)
+
+Optional detailed explanation.
+```
+
+Keywords:
+
+- `✨ NEW:` – New feature
+- `🐛 FIX:` – Bug fix
+- `👌 IMPROVE:` – Improvement (no breaking changes)
+- `‼️ BREAKING:` – Breaking change
+- `📚 DOCS:` – Documentation
+- `🔧 MAINTAIN:` – Maintenance changes only (typos, etc.)
+- `🧪 TEST:` – Tests or CI changes only
+- `♻️ REFACTOR:` – Refactoring
+
+If the commit only makes changes to a single package,
+consider including the name in the title.
+
+## PR title and description format
+
+Use the same as for the commit message format,
+but for the title you can omit the `KEYWORD` and only use `EMOJI`
+
 ## Pull Request Requirements
 
 When submitting changes:

From dc513dd63ad3df7bb2ec59bf1984009ef342afed Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Fri, 16 Jan 2026 23:49:30 +0100
Subject: [PATCH 2/3] Update AGENTS.md

---
 AGENTS.md | 7 -------
 1 file changed, 7 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 7e2f2ce3..f74f3d2b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -197,13 +197,6 @@ def test_example(app, status, warning, get_sphinx_app_output):
     assert warnings == ""
 ```
 
-## Testing Philosophy
-
-1. **Always add tests** for new features and bug fixes
-2. **Unit tests should be atomic** – fast and focused
-3. **Document test purpose** – explain *why* the test exists
-4. **Use parameterized tests** (rstest/pytest) for multiple scenarios
-5. **Use snapshot tests** (insta/syrupy) for complex outputs
 
 ## Commit Message Format
 

From 98d31a74aefed618b872461b91adf1f1b073b5d6 Mon Sep 17 00:00:00 2001
From: Chris Sewell <chrisj_sewell@hotmail.com>
Date: Fri, 16 Jan 2026 23:50:06 +0100
Subject: [PATCH 3/3] Update AGENTS.md

---
 AGENTS.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/AGENTS.md b/AGENTS.md
index f74f3d2b..c7681c5d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -197,7 +197,6 @@ def test_example(app, status, warning, get_sphinx_app_output):
     assert warnings == ""
 ```
 
-
 ## Commit Message Format
 
 Use this format: