diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..d67ac5be5
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,11 @@
+# Directives for agents working on the cpal repository
+
+ - Read CONTRIBUTING.md before you make any change.
+ - Install the git hook(s) located in .githooks.
+ - Always plan before making non-trivial changes.
+ - Always run `cargo fmt --all` and `cargo check --workspace`
+   after making changes.
+ - Before considering non-trivial changes done, aways have
+   reviews performed by fresh subagents. Check for code
+   quality issues, overengineering / code duplication, and
+   verbosity / violation of contributing guidelines
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..43c994c2d
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md