diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 9555840..16ff8d2 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -260,7 +260,7 @@ jobs:
                    },
                    {
                      name: "Plugin do Claude Code",
-                     value: "```\nclaude plugin marketplace update parity\nclaude plugin update parity\n```\nReinicie o Claude Code para aplicar."
+                     value: "```\nclaude plugin marketplace update parity\nclaude plugin update parity@parity\n```\nReinicie o Claude Code para aplicar."
                    }
                  ]
                }]
diff --git a/README.md b/README.md
index 8a3d8c7..bb387c7 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,17 @@ claude plugin marketplace add decocms/parity
 claude plugin install parity@parity
 ```
 
+To update later:
+
+```bash
+claude plugin marketplace update parity   # refresh the marketplace clone
+claude plugin update parity@parity        # then update the plugin
+```
+
+Note the asymmetry: the *marketplace* is `parity`, the *plugin* is
+`parity@parity`. `claude plugin update parity` fails with "Plugin not found".
+Restart Claude Code afterwards to load the new version.
+
 Confirm it installed:
 
 ```bash