From f5f8cda9f62ea91a4b7eca36f242edca113d0bc5 Mon Sep 17 00:00:00 2001
From: Christian Colglazier <christian@cacolglazier.com>
Date: Wed, 18 Feb 2026 13:11:25 -0500
Subject: [PATCH] docs(agents): create commit message style guide

---
 AGENTS.md         | 1 +
 agents/COMMITS.md | 8 ++++++++
 2 files changed, 9 insertions(+)
 create mode 100644 agents/COMMITS.md

diff --git a/AGENTS.md b/AGENTS.md
index b1cbc17..723d287 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -96,6 +96,7 @@ python3 -m py_compile ./home/bin/homeassistant.py
 - Redirect stderr appropriately: `2>/dev/null` or `2>&1`
 
 ### Configuration Files
+- Before generating a commit, always consult `agents/COMMITS.md` for the required style.
 
 #### chezmoi Templates
 - Dotfiles use chezmoi's templating system
diff --git a/agents/COMMITS.md b/agents/COMMITS.md
new file mode 100644
index 0000000..d337f2c
--- /dev/null
+++ b/agents/COMMITS.md
@@ -0,0 +1,8 @@
+Commits
+## Commit Message Format
+Follow conventional commits style (all lowercase).
+- `feat(scope): description` - New feature
+- `fix(scope): description` - Bug fix
+- `refactor(scope): description` - Code refactoring
+- `docs(scope): description` - Documentation changes
+- Example: `feat(zsh): update dotfiles` or `fix(scripts): use correct pass entry`