diff --git a/template/.claude/CLAUDE.md b/template/.claude/CLAUDE.md
new file mode 120000
index 0000000..be77ac8
--- /dev/null
+++ b/template/.claude/CLAUDE.md
@@ -0,0 +1 @@
+../AGENTS.md
\ No newline at end of file
diff --git a/template/AGENTS.md b/template/AGENTS.md
new file mode 100644
index 0000000..5b31c3c
--- /dev/null
+++ b/template/AGENTS.md
@@ -0,0 +1,5 @@
+Lockfiles must be consistent with package metadata. After any change to `pixi.toml`, run `pixi lock`.
+
+Everything runs in a pixi environment. Any command (like `pytest`) must be prefixed with `pixi run` (e.g. `pixi run pytest`).
+
+Code formatting must align with our standards. Run `pixi run lint` before `git commit`s to ensure this.
diff --git a/tests/test_template.py b/tests/test_template.py
index cb7f378..2406617 100644
--- a/tests/test_template.py
+++ b/tests/test_template.py
@@ -46,6 +46,13 @@ def test_add_autobump_workflow(generate_project, add_autobump_workflow):
     ).exists() == add_autobump_workflow
 
 
+def test_agents_md(generated_project):
+    assert (generated_project / "AGENTS.md").exists()
+    claude_md = generated_project / ".claude" / "CLAUDE.md"
+    assert claude_md.is_symlink()
+    assert claude_md.resolve() == (generated_project / "AGENTS.md").resolve()
+
+
 @pytest.mark.parametrize(
     "minimal_python_version", ["py310", "py311", "py312", "py313", "py314"]
 )