From 196616c6ba55d48ac274e201785740162e93b3b6 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 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 AGENTS.md

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..6ab0926
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,48 @@
+# Agents
+
+This role manages core OS components and defaults tailored for Siempie infrastructure. This is the foundational role for all Debian/Ubuntu systems.
+
+## Role Analysis
+
+- **Type**: Base system configuration role
+- **OS Support**: Debian 12, Debian 13, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, Alpine 3.23
+- **Deployment Method**: Direct (not Docker-based)
+- **Scope**: Comprehensive system configuration
+
+## Key Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `apt_automatic_reboot_time` | `03:45` | Automated reboot time |
+| `apt_automatic_reboot` | `true` | Enable automated reboots |
+| `apt_enable_universe` | `true` | Enable Ubuntu universe repo |
+| `firewall_enable` | `true` | Enable firewall |
+| `ntp_server` | `time.cloudflare.com` | NTP server |
+| `timezone` | `Europe/Amsterdam` | System timezone |
+| `swap` | `false` | Enable swap |
+
+## Available Tags
+
+- `apt` - APT package management
+- `apt-update` - APT update
+- `apt-cleanup` - APT cleanup
+- `cron` - Cron jobs
+- `environment-file` - Environment configuration
+- `hostname` - Hostname management
+- `firewall` - UFW firewall
+- `journald` - Systemd journal config
+- `locale` - Locale settings
+- `ntp` - NTP/Chrony configuration
+- `sshd` - SSH daemon config
+- `swap` - Swap configuration
+- `sysctl` - Kernel parameters
+- `systemctl` - Systemd units
+- `timezone` - Timezone settings
+- `usermanagement` - User management
+
+## Testing
+
+```bash
+ansible-lint
+molecule test
+```