From 10719b189287d6a3d4301e04c166810c73a6a0a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20S=C3=A4nger?=
 <20968534+dsnger@users.noreply.github.com>
Date: Sat, 18 Jul 2026 23:35:13 +0200
Subject: [PATCH] docs(readme): document the plugin update path and its
 qualified-name workaround

---
 README.md | 12 ++++++++++++
 todos.md  |  6 ++++++
 2 files changed, 18 insertions(+)

diff --git a/README.md b/README.md
index 70f4a71..0eb395d 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,18 @@ claude plugin marketplace add dsnger/dev-workflow-kit
 claude plugin install dev-workflow@dev-workflow-kit
 ```
 
+To update later:
+
+```sh
+claude plugin marketplace update dev-workflow-kit
+claude plugin update dev-workflow@dev-workflow-kit   # qualified form is a workaround: the bare
+                                                     # name is documented but errors "Plugin
+                                                     # 'dev-workflow' not found" (CLI 2.1.x)
+```
+
+Updates arrive only when the plugin version is bumped, and a running session keeps the
+old version until you restart it or run `/reload-plugins`.
+
 **2. Prerequisites:**
 
 - **superpowers** — not vendored. The workflow's middle *is* its skills; without it,
diff --git a/todos.md b/todos.md
index 392d45e..ef46b9e 100644
--- a/todos.md
+++ b/todos.md
@@ -55,6 +55,12 @@ driven by recurrence rather than by enthusiasm.
       `GIT_OBJECT_DIRECTORY` with the real store as an alternate would avoid the churn.
 
 ## Next
+- [ ] **Upstream-report candidate: `claude plugin update <bare-name>`.** The CLI docs
+      document the bare plugin name as a valid argument for `install`/`uninstall`/`update`
+      alike, but `claude plugin update dev-workflow` errors "Plugin 'dev-workflow' not
+      found" on CLI 2.1.x while `dev-workflow@dev-workflow-kit` works. README documents
+      the qualified form as a workaround; file via `/feedback` so the behaviour and the
+      docs stop disagreeing.
 
 ## Someday