diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..81f75e6
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,23 @@
+# Agents
+
+This role configures [Pangolin](https://digpangolin.com/) - a Docker management UI for homelabs.
+
+## Role Analysis
+
+- **Type**: Application server role (Docker management UI)
+- **OS Support**: Debian 12
+- **Deployment Method**: Docker
+- **Dependencies**: Docker must be installed
+
+## Tasks
+
+1. **create network** - Creates Docker network
+2. **install pangolin** - Deploys Pangolin via Docker
+3. **cleanup docker** - Cleans up Docker resources
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```