diff --git a/records/plugin-dev/KB-PLUGIN-013-mindplace-plugin-publication-runbook.md b/records/plugin-dev/KB-PLUGIN-013-mindplace-plugin-publication-runbook.md
index 3b0456e..59cc928 100644
--- a/records/plugin-dev/KB-PLUGIN-013-mindplace-plugin-publication-runbook.md
+++ b/records/plugin-dev/KB-PLUGIN-013-mindplace-plugin-publication-runbook.md
@@ -399,6 +399,15 @@ Mensagem padrão para o cliente:
 4. **Não** atualiza `plugins.json` — o Mindplace pega automaticamente a release mais recente
 5. Clientes verão o botão **Atualizar** no Mindplace dentro de 1 hora (cache TTL)
 
+> **Gotcha (verificado no butterfly, GLPI 11.0.8, 2026-07-03):** ao mudar a
+> `version` do setup.php, o `CheckPluginsStates` do boot **desativa o plugin
+> na hora** ("version changed... has to be launched") — status vira
+> "Para atualizar", o setup.php deixa de ser carregado e os hooks somem
+> (funções do plugin ficam indefinidas). No ambiente de dev, rodar
+> `bin/console glpi:plugin:install <key> -u glpi && bin/console glpi:plugin:activate <key>`
+> logo após o bump. Sintoma enganoso: parece que o kill switch/licença
+> derrubou o plugin, mas é só o fluxo de update pendente.
+
 ### Revogar licença de um cliente
 
 1. No GLPI de produção: **Ativos → Licenças de Software** → encontrar o serial