diff --git a/README.md b/README.md
index fe28e71..149565a 100644
--- a/README.md
+++ b/README.md
@@ -8,4 +8,31 @@ layer: wiki
 ---
 # claude-plugins
 
-Marketplace de plugins Claude Code da Descomplicar
\ No newline at end of file
+Marketplace de plugins Claude Code da Descomplicar
+
+## Versões — bumpar sempre nos DOIS sítios
+
+A versão de cada plugin vive em dois ficheiros e **não há automação a sincronizá-los**:
+
+| Ficheiro | Papel | Quem o lê |
+|---|---|---|
+| `<plugin>/.claude-plugin/plugin.json` | **fonte de verdade** | `/plugin update` — é esta que decide se há versão nova |
+| `.claude-plugin/marketplace.json` | agregado derivado | `/plugin marketplace update` — catálogo |
+
+Bumpar só o agregado **não tem efeito nenhum**: o catálogo mostra a versão nova, o
+`/plugin update` responde `already at the latest version` e o cache continua na antiga.
+Aconteceu a 30-07-2026 com marketing/gestao/project-manager/wordpress.
+
+Verificar coerência antes de commitar:
+
+```bash
+for p in */; do p=${p%/}; f="$p/.claude-plugin/plugin.json"; [ -f "$f" ] || continue
+  a=$(jq -r .version "$f")
+  b=$(jq -r ".plugins[]|select(.name==\"$p\").version" .claude-plugin/marketplace.json)
+  [ "$a" = "$b" ] || echo "DIVERGE $p: plugin.json=$a marketplace.json=$b"
+done
+```
+
+Depois de publicar: `/plugin marketplace update descomplicar-plugins` (catálogo) **e**
+`/plugin update <nome>@descomplicar-plugins` (reinstala no cache). O primeiro sozinho
+não actualiza o que corre.
\ No newline at end of file
diff --git a/gestao/.claude-plugin/plugin.json b/gestao/.claude-plugin/plugin.json
index 0010987..4408cee 100644
--- a/gestao/.claude-plugin/plugin.json
+++ b/gestao/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "gestao",
   "description": "Project management, time tracking, daily checkups, worklogs, reflections, knowledge management, archiving and compliance auditing. Backed by NotebookLM notebooks.",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "author": {
     "name": "Descomplicar - Crescimento Digital",
     "url": "https://descomplicar.pt"
diff --git a/marketing/.claude-plugin/plugin.json b/marketing/.claude-plugin/plugin.json
index 4f17dfa..a792e3f 100644
--- a/marketing/.claude-plugin/plugin.json
+++ b/marketing/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "marketing",
   "description": "Digital marketing strategy, SEO, content marketing, social media, ads, copywriting, video and YouTube. Backed by NotebookLM notebooks.",
-  "version": "1.0.0",
+  "version": "2.0.0",
   "author": {
     "name": "Descomplicar - Crescimento Digital",
     "url": "https://descomplicar.pt"
diff --git a/project-manager/.claude-plugin/plugin.json b/project-manager/.claude-plugin/plugin.json
index ec91010..49ff752 100644
--- a/project-manager/.claude-plugin/plugin.json
+++ b/project-manager/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "project-manager",
   "description": "Spec-driven project management with flexible sprints, scope validation, and NotebookLM-powered discovery. Prevents wasted work by forcing alignment before coding. 7 skills, 2 agents, 1 hook.",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "author": {
     "name": "Descomplicar - Crescimento Digital",
     "url": "https://descomplicar.pt"
diff --git a/wordpress/.claude-plugin/plugin.json b/wordpress/.claude-plugin/plugin.json
index 2ec219d..e9485e6 100644
--- a/wordpress/.claude-plugin/plugin.json
+++ b/wordpress/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "wordpress",
   "description": "WordPress development, maintenance and optimization - plugins, themes, WooCommerce, Elementor, Crocoblock. Backed by NotebookLM notebooks.",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "author": {
     "name": "Descomplicar - Crescimento Digital",
     "url": "https://descomplicar.pt"