From 1c19654faab1585c9cfb5bdc331a2b21c8355ada Mon Sep 17 00:00:00 2001
From: Zhengshou Lai <lai.zhengshou@outlook.com>
Date: Tue, 9 Jun 2026 14:50:25 +0800
Subject: [PATCH] docs(README): add Update section warning about reinstall
 after git pull

Clarify that `git pull` / `git submodule update` only update the source
tree; `make install` or `mytoolkit update` must be rerun for changes to
take effect in the installed CLI.
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index e28730b..b58b534 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,15 @@ mytoolkit --version
 mytoolkit templates register ~/workspace/templates   # one-time, points at template root
 ```
 
+## Update
+
+`git pull` or `git submodule update` only updates the source tree. The installed Python package is **not** refreshed automatically. After pulling new code, rerun:
+
+```bash
+make install            # or: mytoolkit update
+mytoolkit --version     # verify the new version is active
+```
+
 ## Top-level commands
 
 ```bash