diff --git a/README.md b/README.md
index e3c68ac..a7caec3 100644
--- a/README.md
+++ b/README.md
@@ -38,6 +38,18 @@ runtime à installer) :
 > ⚠️ Un module temporaire **disparaît au redémarrage de Firefox** : il faut le
 > recharger via `about:debugging` à chaque session (comportement de dev attendu).
 
+> 🔴 **Après toute modification de `manifest.json` (permission ajoutée…) :
+> *Décharger* puis *Charger* le module. « Recharger » et F5 ne suffisent pas.**
+> Firefox relit les **scripts** de la page à chaque ouverture, mais le
+> **manifest** seulement **à l'installation** : on se retrouve sinon avec le code
+> le plus récent et les **permissions figées de l'ancien**.
+> Symptôme : `browser.<api> is undefined` alors que le manifest déclare bien la
+> permission. Piège de **dev uniquement** (en module signé, les permissions
+> déclarées sont accordées d'office) — mais il a déjà coûté deux passes de test.
+>
+> Pense aussi à **fermer les anciens onglets de la liste** avant de recharger :
+> une page orpheline rend les clics inertes.
+
 ### Vérifier l'extension
 
 ```sh