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