diff --git a/docs/DEVELOPPEMENT.md b/docs/DEVELOPPEMENT.md
index f94ea80..4e50956 100644
--- a/docs/DEVELOPPEMENT.md
+++ b/docs/DEVELOPPEMENT.md
@@ -2076,6 +2076,14 @@ adb shell run-as com.hormonetrack rm -f databases/hormonetrack.db-wal \
     databases/hormonetrack.db-shm   # WAL périmé sinon ! (checkpoint implicite fait par le seed)
 ```
 
+⚠️ **Piège WAL constaté à la v1.9.8** : après un `force-stop` (= SIGKILL, PAS de
+checkpoint), le schéma entier peut vivre SEULEMENT dans le `-wal` — extraire la
+seule `hormonetrack.db` donne un fichier de 4 Ko SANS tables (`no such table:
+treatments` au seed). Solution : extraire `hormonetrack.db` **ET**
+`hormonetrack.db-wal` CÔTE À CÔTE sous leurs noms d'origine (ex. `/tmp/hrtseed/`)
+— sqlite rejoue le WAL à l'ouverture et le fusionne à la fermeture (le `-wal`
+disparaît après le seed) ; on pousse alors la seule `.db` résultat.
+
 Règles du seed (le script les impose) : colonnes = noms de propriétés Kotlin
 (Room n'applique pas de snake_case), enums stockés en String — on insère
 SEULEMENT des lignes, on ne touche NI au schéma NI à `room_master_table`