diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..0e43882
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,22 @@
+# Agents
+
+This role configures Keepalived for high availability (VRRP).
+
+## Role Analysis
+
+- **Type**: Infrastructure service role (HA)
+- **OS Support**: Alpine 3.22, Debian 12
+- **Deployment Method**: Direct (not Docker-based)
+- **Scope**: Keepalived installation and VRRP configuration
+
+## Tasks
+
+1. **install** - Installs Keepalived
+2. **config** - Configures VRRP instances
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```