diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..1441ab4
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# Agents
+
+This role configures [Pulse](https://github.com/rcourtman/Pulse/) - a Radarrarr companion for managing media library operations.
+
+## Role Analysis
+
+- **Type**: Application server role (media management)
+- **OS Support**: Debian 13
+- **Deployment Method**: Docker
+- **Dependencies**: Docker must be installed
+
+## Tasks
+
+1. **install pulse** - Deploys Pulse via Docker
+2. **cleanup docker** - Cleans up Docker resources
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```