From 4982cb385f2a5d21df4401d305e9965f88dd7c73 Mon Sep 17 00:00:00 2001
From: Simon Cornet <simon@simoncor.net>
Date: Mon, 16 Feb 2026 09:57:16 +0100
Subject: [PATCH] chore: add AGENTS.md for opencode agents

---
 AGENTS.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..a8dd1cb
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,39 @@
+# Agents
+
+This role installs and configures Zabbix Agent 2 for host monitoring.
+
+## Role Analysis
+
+- **Type**: Monitoring agent role
+- **OS Support**: Debian 12, SLES 15, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS
+- **Deployment Method**: Direct (package installation)
+- **Scope**: Zabbix agent installation and configuration
+
+## Key Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `zabbix_agent_hostinterface` | `inventory_hostname` | Agent interface |
+| `zabbix_agent_hostname` | `inventory_hostname` | Host name in Zabbix |
+| `zabbix_agent_listen_port` | `10050` | Listen port |
+| `zabbix_agent_psk_enable` | `true` | Enable PSK encryption |
+| `zabbix_agent_psk_id` | (required if PSK enabled) | PSK identity |
+| `zabbix_agent_psk` | (required if PSK enabled) | PSK secret |
+| `zabbix_proxy_address` | `shared.proxy.monitor.itcreation.tools` | Zabbix proxy |
+| `zabbix_proxy_port` | `10051` | Proxy port |
+| `zabbix_user_sudo` | `true` | Enable sudo for agent |
+
+## Tags
+
+| Tag | Purpose |
+|-----|---------|
+| `zabbix_agent_config` | Manage agent configuration |
+| `zabbix_agent_install` | Manage agent installation |
+| `zabbix_agent_prereq` | Manage prerequisites |
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```