From 1dbdff780ac73ab7ad87dd9a9c905d6c814851ba Mon Sep 17 00:00:00 2001
From: johnthagen <johnthagen@gmail.com>
Date: Wed, 1 Jul 2026 07:49:20 -0400
Subject: [PATCH] Add AGENTS.md file

---
 AGENTS.md | 7 +++++++
 README.md | 5 +++++
 2 files changed, 12 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..7b12306
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,7 @@
+# Repository Guidelines
+
+## General Instructions
+
+- ALWAYS format the code via `uv run nox --session fmt` AFTER you're done with your task
+- ALWAYS check for lint errors via `uv run nox --session lint` and fix them
+- ALWAYS check for type errors via `uv run nox --session type_check` and fix them
diff --git a/README.md b/README.md
index 293a8b9..d559f37 100644
--- a/README.md
+++ b/README.md
@@ -417,6 +417,11 @@ To run the image in a container:
 docker run --rm --interactive --tty fact 5
 ```
 
+# AI Agents
+
+AI agentic coding tools are configured in [AGENTS.md](./AGENTS.md). For more details, see
+<https://agents.md/>.
+
 # Miscellaneous
 
 ## Shebang Line