From a01c1a578d2db44dfe4d0054af47f8d927831fa8 Mon Sep 17 00:00:00 2001
From: Morgan Roderick <morgan@roderick.dk>
Date: Fri, 3 Apr 2026 21:42:06 +0200
Subject: [PATCH] docs: add AGENTS.md with pre-commit hook policy

---
 AGENTS.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..cb384b3
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,17 @@
+# Project Agent Configuration
+
+## Git Workflow
+
+**Pre-commit Hooks: NEVER Bypass**
+
+Pre-commit hooks perform essential validation including formatting, linting, and commit message checks. These hooks ensure code quality and consistency.
+
+- **Never** use `--no-verify` or `--no-gpg-sign` flags with git commands
+- **Never** skip hooks for any commit, including:
+  - Regular commits
+  - Hotfixes
+  - Emergency fixes
+  - WIP commits
+  - All other commits
+
+If a hook fails, fix the underlying issue rather than bypassing the hook.