diff --git a/AGENTS.md b/AGENTS.md
index 272363d..f488092 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -35,6 +35,13 @@ M5Stack Atom S3 Lite (ESP32-S3), 2 relais, 2 touch sensors (HS-S43A), BLE, Andro
 - Bestanden: `MainActivity.kt`, `SettingsActivity.kt`, `EspFlasher.kt`, `UsbSerialTransport.kt`, `PrefsHelper.kt`, `UsbUtils.kt`
 - Assets: `firmware/bootloader.bin`, `partitions.bin`, `boot_app0.bin`, `firmware.bin`
 
+## Versiebeheer
+
+- **Single source of truth:** `version.txt` (regels `server=N` en `client=N`)
+- `src/version.h` wordt **automatisch gegenereerd** uit `version.txt` door PlatformIO pre-build script
+- Nooit `version.h` handmatig bewerken — altijd `version.txt` aanpassen en `pio run` laten regenereren
+- Firmwareversie ophogen: bump het nummer in `version.txt`, commit, rebuild firmware, kopieer `.bin` naar Android assets
+
 ## ADB — telefoon
 
 ```