diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..c0f5b22e
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,6 @@
+## Rules for this Repository
+
+1. **Always lint after changes**: Run `ruff check . --fix` to maintain code quality.
+2. **Test your changes**: Use `uv run pytest` to verify everything works.
+3. **Add tests for new features**: Write tests for any new functionality you add.
+4. **Use uv for running commands**: Always prefix commands with `uv run` when running examples or scripts.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..43c994c2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md