diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..30d9970
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# Agents
+
+This role configures [SemaphoreUI](https://semaphoreui.com/) - an open-source Ansible UI and alternative to AWX/Tower.
+
+## Role Analysis
+
+- **Type**: Application server role (automation UI)
+- **OS Support**: Debian 12
+- **Deployment Method**: Docker
+- **Dependencies**: Docker must be installed
+
+## Tasks
+
+1. **install semaphore** - Deploys SemaphoreUI via Docker
+2. **cleanup docker** - Cleans up Docker resources
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```