diff --git a/README.md b/README.md
index 9ede0c3..e6f1ad3 100644
--- a/README.md
+++ b/README.md
@@ -8,10 +8,18 @@ Workspace firmware centré sur une seule cible: Freenove FNK0102H avec `ui_freen
 - `docs/FNK0102H_SOURCE_OF_TRUTH.md`: matrice board/config/pins/support.
 - `README_ESP32_ZACUS.md`: notes runtime et signatures série utiles.
 
+## Deux firmwares
+
+- `ui_freenove_allinone/` — firmware **Arduino/PlatformIO** historique (UI/audio/caméra/réseau), chemin release stabilisé.
+- `idf_zacus/` — firmware **master ESP-IDF 5.4** (migration en cours, branche `feat/idf-migration`) : voix NPC (esp-sr wakeword + bridge WS), **énigmes locales** P1 son / P3 QR (caméra OV3660 + micro), **écran LVGL** (vue scène, viewfinder, shell Workbench, intro cracktro), et une **surface REST de jeu** (`/game/step`, `/game/puzzle_state`, `/game/file`). Voir `idf_zacus/README.md`.
+- `box3_voice/` — firmware annexe **ESP32-S3-BOX-3** : pipeline voix + **générateur de stimulus** (`/stim/qr`, `/stim/melody`) pour exercer les énigmes du master. Voir `box3_voice/README.md`.
+
 ## Arborescence utile
 
 - `platformio.ini`: env PlatformIO canonique `freenove_esp32s3_full_with_ui`.
-- `ui_freenove_allinone/`: firmware UI/audio/caméra/réseau.
+- `ui_freenove_allinone/`: firmware Arduino UI/audio/caméra/réseau.
+- `idf_zacus/`: firmware master ESP-IDF (énigmes locales, écran LVGL, REST de jeu).
+- `box3_voice/`: firmware BOX-3 (voix + générateur de stimulus QR/mélodie).
 - `data/`: contenu LittleFS.
 - `lib/`: bibliothèques runtime.
 - `scripts/`: bootstrap et scripts repo.