Add AGENTS.md (#136)

Author: pavelzw

template/.claude/CLAUDE.md

@@ -0,0 +1 @@
+../AGENTS.md

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.

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"]
 )