From a81134abb4861788a661ce51a8b6f55b67d4215d Mon Sep 17 00:00:00 2001
From: rlippmann <70883373+rlippmann@users.noreply.github.com>
Date: Fri, 6 Mar 2026 01:33:55 -0500
Subject: [PATCH] Create AGENTS.md with AI guidelines

Added guidelines for AI agents in the repository.
---
 AGENTS.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..996e578
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,31 @@
+# AGENTS.md
+
+Guidelines for AI agents working in this repository.
+
+## Branch rules
+- Never commit directly to `main`.
+- Always work on a feature branch.
+- If the current branch is `main`, stop and ask the user to create a branch.
+
+## Development workflow
+Before committing:
+1. Run `pre-commit run --all-files`
+2. Run `pytest`
+
+Do not bypass pre-commit hooks.
+
+## Scope of changes
+- Only modify files necessary for the requested task.
+- Do not refactor unrelated code.
+- Do not change project structure unless explicitly asked.
+- Make the minimal change required to solve the requested task.
+- If the task expands beyond the original request, stop and ask the user for guidance.
+
+## Dependencies
+If tests fail due to missing dependencies, install them rather than skipping tests.
+
+## CI
+Do not modify GitHub CI workflows unless explicitly asked.
+
+## Documentation
+If implementation behavior changes, update the specification documents to match.