From 5fe58798739775fe1b2c25cf091d60d2c06f95bf Mon Sep 17 00:00:00 2001
From: eddy <eddy@macmini.local>
Date: Sun, 2 Aug 2026 18:30:22 +0200
Subject: [PATCH] docs: document version.txt as single source of truth for
 firmware versions

---
 AGENTS.md | 7 +++++++
 1 file changed, 7 insertions(+)

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
 
 ```