diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..8e89c1cd
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,2 @@
+- after making any code changes, run `uv ruff check` to make sure linting passes
+- use `uv` to run any other necessary tasks such as `pytest`