diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..48e7dc7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# Agents
+
+This role configures [Jellyfin](https://jellyfin.org/) media server - a free, open-source media streaming solution.
+
+## Role Analysis
+
+- **Type**: Application server role (media)
+- **OS Support**: Debian 13
+- **Deployment Method**: Docker
+- **Dependencies**: Docker must be installed
+
+## Tasks
+
+1. **install jellyfin** - Deploys Jellyfin via Docker
+2. **cleanup docker** - Cleans up Docker resources
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```