Add AGENTS.md to template and project

AGENTS.md

@@ -0,0 +1,8 @@
+# Environment/Tools
+
+* Python project with `uv`, use `uv add`/`uv run python` instead of bare `pip`/`python`
+* `poe setup`: One-time after-clone setup (dependencies, install pre-commit hooks).
+* `poe lint`: Pre-commit hooks (via `pre-commit`-compatible `prek`) including lint, format, type check (ruff, ty)
+* `poe test`: Run tests (accepts pytest arguments)
+* `poe lt`: Lint+test (no arguments)
+* `poe snapup`: Update test snapshots (syrupy, accepts pytest arguments)

template/AGENTS.md.jinja

@@ -0,0 +1,9 @@
+# Environment/Tools
+
+* Python project with `uv`, use `uv add`/`uv run python` instead of bare `pip`/`python`
+* `poe setup`: One-time after-clone setup (dependencies, install pre-commit hooks).
+* `poe lint`: Pre-commit hooks (via `pre-commit`-compatible `prek`) including lint, format, type check (ruff, ty)
+* `poe test`: Run tests (accepts pytest arguments)
+* `poe lt`: Lint+test (no arguments)
+* `poe snapup`: Update test snapshots (syrupy, accepts pytest arguments)
+{#- vim: set ft=markdown: #}

tests/__snapshots__/test_agents.ambr

@@ -0,0 +1,14 @@
+# serializer version: 1
+# name: test_agents
+  '''
+  # Environment/Tools
+
+  * Python project with `uv`, use `uv add`/`uv run python` instead of bare `pip`/`python`
+  * `poe setup`: One-time after-clone setup (dependencies, install pre-commit hooks).
+  * `poe lint`: Pre-commit hooks (via `pre-commit`-compatible `prek`) including lint, format, type check (ruff, ty)
+  * `poe test`: Run tests (accepts pytest arguments)
+  * `poe lt`: Lint+test (no arguments)
+  * `poe snapup`: Update test snapshots (syrupy, accepts pytest arguments)
+
+  '''
+# ---

tests/test_agents.py

@@ -0,0 +1,13 @@
+"""Snapshot tests for AGENTS.md template."""
+
+from collections.abc import Callable
+from pathlib import Path
+
+from syrupy.assertion import SnapshotAssertion
+
+
+def test_agents(
+    render_template: Callable[..., Path], snapshot: SnapshotAssertion
+) -> None:
+    rendered = render_template()
+    assert (rendered / "AGENTS.md").read_text() == snapshot