diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..e46341f
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,38 @@
+# 更新紀錄 CHANGELOG
+
+> 每次改了什麼，都記在這。版號對應 `template/.claude/VERSION`。
+> 想更新到最新版？看 [README → 一鍵更新](README.md#-已安裝舊版一鍵更新)。
+
+版號規則（語意化版本，簡化版）：
+- **大版號**（1.x → 2.x）：破壞性變動，舊專案更新後可能要手動調整。
+- **中版號**（1.0 → 1.1）：加了新功能，向下相容，更新即用。
+- **小版號**（1.1.0 → 1.1.1）：修 bug、改文件，無新功能。
+
+---
+
+## 1.1.0 — 一鍵更新
+
+**新增**
+- `scripts/update.sh`：已安裝舊版的人，一行指令更新到最新版。
+  只覆蓋模板/邏輯檔（hooks、commands、TEMPLATE-*），**完全不碰**使用者資料
+  （`wiki/status.md`、`mistakes.md`、`decisions-summary.md`、`.wikiignore`、`settings.json`、`CLAUDE.md`）。
+  會先比對版本、列出新功能、依已裝模組自動偵測該更新什麼，跑完自我更新。
+- `template/.claude/VERSION`：版本基準檔，讓「檢查新版」有依據。
+- `CHANGELOG.md`（本檔）。
+
+**第一次更新的雞生蛋問題**：舊版本機還沒有 `update.sh`，所以第一次靠 README 那行
+`curl` 從遠端抓更新器來跑；跑完它把自己裝進 `scripts/update.sh`，之後直接跑本機的即可。
+
+---
+
+## 1.0.0 — 模組化安裝（基準版）
+
+此版本之前無 VERSION 檔，以下為依 git 歷史回溯的功能基準。
+
+- `scripts/install.sh` 模組化安裝：`--wiki` / `--sdd` / `--all`，無參數則互動詢問。
+- **LLM Wiki**：CC 記憶系統（INDEX / status / mistakes / decisions-summary）
+  + 接關 hook（session-start-recall）+ 對應 slash commands。
+- **wiki 機敏防護三層**：`.wikiignore`（檔案層）＋行內標記（局部）＋
+  `wiki-secret-scan.sh`（機械兜底攔截）。
+- **SDD 強制**：動 code 前必須有 `design.md`，由 `sdd-guard.sh` hook 把關，附 TEMPLATE 範本。
+- docs 分類結構（1-vision ~ 6-user）與 ADR 範本。
diff --git a/README.md b/README.md
index d2a5761..52acbcf 100644
--- a/README.md
+++ b/README.md
@@ -65,6 +65,33 @@ CC 會掃描現有文件、建立 wiki、整理 docs 結構。
 
 ---
 
+## 🔄 已安裝舊版？一鍵更新
+
+聽到出新功能了，想升級到最新版，跑這一行就好：
+
+```bash
+cd your-project
+curl -sSL https://raw.githubusercontent.com/uncle6me-web/system-dev-template/main/scripts/update.sh | bash
+```
+
+它會先比對你的版本和最新版，告訴你**多了哪些新功能**，然後：
+
+| 動作 | 對象 |
+|------|------|
+| 🆕 **補上**新功能（舊版沒有的 hook / command / 範本） | 模板檔 |
+| ⬆️ **更新**模板邏輯（hooks、commands、TEMPLATE-* 換成新版） | 模板檔 |
+| 🔒 **完全不碰**你的內容與設定 | `wiki/status.md`、`mistakes.md`、`decisions-summary.md`、`.wikiignore`、`settings.json`、`CLAUDE.md` |
+
+> **為什麼第一次要用 curl？** 舊版本機還沒有 `update.sh`，所以第一次得從遠端抓它下來跑。
+> 跑完它會把自己也裝進 `scripts/update.sh`，**之後更新直接跑** `bash scripts/update.sh` 就好，不用再 curl。
+
+更新只會動「已安裝的模組」（裝了 wiki 就更新 wiki，裝了 SDD 就更新 SDD），偵測自動完成。
+若 `settings.json` 缺了新版才有的 hook，它不會幫你改設定，但會在結尾**列出來提醒你手動補**（不擅自動你的設定）。
+
+📜 想知道每次改了什麼、現在是哪一版？看 **[更新紀錄 CHANGELOG](CHANGELOG.md)**。
+
+---
+
 ## 目錄說明
 
 ```
@@ -82,7 +109,8 @@ system-dev-template/
 │   └── llm-wiki/       ← 複製到 Legacy-Workspace/.claude/skills/
 │
 ├── scripts/
-│   └── install.sh      ← 已有專案接入腳本
+│   ├── install.sh      ← 已有專案接入腳本
+│   └── update.sh       ← 舊版一鍵更新（只換模板，不碰你的資料）
 │
 └── docs/               ← 這個 repo 自己的說明
     ├── why.md          ← 設計理念
diff --git a/scripts/update.sh b/scripts/update.sh
new file mode 100755
index 0000000..f7cb6ac
--- /dev/null
+++ b/scripts/update.sh
@@ -0,0 +1,174 @@
+#!/bin/bash
+# system-dev-template updater
+# 已安裝舊版的人，一鍵更新到新版。
+#
+# 核心安全原則：只覆蓋「模板/邏輯檔」，絕不碰「使用者資料檔」。
+#   ✅ 可覆蓋：hooks/*.sh、commands/*.md、TEMPLATE-*、wiki/INDEX.md
+#              ——這些由模板維護，使用者不會手改，新版直接換掉。
+#   🔒 絕不碰：wiki/status.md、mistakes.md、decisions-summary.md、.wikiignore、
+#              settings.json、CLAUDE.md
+#              ——這些是使用者自己填的內容，覆蓋＝清空他的記憶與設定。
+#
+# 「第一次更新」的雞生蛋問題：
+#   舊版本機沒有 update.sh。所以第一次靠 README 那行 curl 從遠端抓這支腳本來跑。
+#   跑完它會把自己也更新進 scripts/update.sh，之後就能直接跑本機的 `bash scripts/update.sh`。
+
+set -euo pipefail
+
+REPO_RAW="https://raw.githubusercontent.com/uncle6me-web/system-dev-template/main"
+TEMPLATE_URL="$REPO_RAW/template"
+
+UPDATED=()
+KEPT=()
+NEW=()
+
+# ── 版本比對：先看本機 vs 遠端，給使用者「值不值得更新」的判斷 ──
+LOCAL_VER="(未知)"
+[ -f ".claude/VERSION" ] && LOCAL_VER="$(tr -d '[:space:]' < .claude/VERSION)"
+REMOTE_VER="$(curl -sSL "$TEMPLATE_URL/.claude/VERSION" 2>/dev/null | tr -d '[:space:]' || echo '')"
+
+echo ""
+echo "🔄 system-dev-template updater"
+echo "================================="
+echo "   本機版本：${LOCAL_VER:-未知}"
+echo "   最新版本：${REMOTE_VER:-取不到（檢查網路）}"
+echo ""
+
+if [ -z "$REMOTE_VER" ]; then
+  echo "❌ 取不到遠端版本，可能是網路問題。請稍後再試。"
+  exit 1
+fi
+
+if [ "$LOCAL_VER" = "$REMOTE_VER" ]; then
+  echo "✅ 已是最新版（$LOCAL_VER），不需更新。"
+  echo "   （仍會同步模板邏輯檔，確保 hooks/commands 與最新一致。）"
+  echo ""
+fi
+
+# ── 工具函式 ───────────────────────────────────────
+# 覆蓋更新：模板/邏輯檔，無條件抓最新版蓋掉。
+update_file() {
+  local dest="$1" src="$2"
+  mkdir -p "$(dirname "$dest")"
+  if [ -f "$dest" ]; then
+    if curl -sSL "$src" -o "$dest.tmp" 2>/dev/null && [ -s "$dest.tmp" ]; then
+      if cmp -s "$dest" "$dest.tmp"; then
+        rm -f "$dest.tmp"          # 內容相同，不算更新
+      else
+        mv "$dest.tmp" "$dest"
+        UPDATED+=("$dest")
+      fi
+    else
+      rm -f "$dest.tmp"
+      echo "   ⚠️  抓取失敗，保留原檔：$dest"
+    fi
+  else
+    if curl -sSL "$src" -o "$dest" 2>/dev/null && [ -s "$dest" ]; then
+      NEW+=("$dest")               # 新功能：舊版沒有的檔
+    else
+      rm -f "$dest"
+      echo "   ⚠️  抓取失敗：$dest"
+    fi
+  fi
+}
+
+# 保留：使用者資料檔，只記錄「有保留」，永遠不動。
+keep_file() {
+  [ -f "$1" ] && KEPT+=("$1") || true
+}
+
+# ── 偵測已安裝哪些模組（依現有檔案判斷，更新只動已裝的）──
+HAS_WIKI=false
+HAS_SDD=false
+[ -d ".claude/wiki" ] && HAS_WIKI=true
+if [ -f ".claude/hooks/sdd-guard.sh" ] || [ -d "docs/3-specs/TEMPLATE-sdd" ]; then HAS_SDD=true; fi
+
+echo "📦 偵測到已安裝模組："
+$HAS_WIKI && echo "   • LLM Wiki"
+$HAS_SDD  && echo "   • SDD"
+{ $HAS_WIKI || $HAS_SDD; } || echo "   （未偵測到任何模組——這裡可能還沒安裝，請改跑 install.sh）"
+echo ""
+
+# ── 模板/邏輯檔：覆蓋更新 ──────────────────────────
+# 共用 hook
+update_file ".claude/hooks/pre-write-guard.sh" "$TEMPLATE_URL/.claude/hooks/pre-write-guard.sh"
+update_file ".claude/VERSION"                  "$TEMPLATE_URL/.claude/VERSION"
+
+if $HAS_WIKI; then
+  # wiki 的「邏輯檔」：導航與 hooks，可覆蓋
+  update_file ".claude/wiki/INDEX.md"                    "$TEMPLATE_URL/.claude/wiki/INDEX.md"
+  update_file ".claude/hooks/session-start-recall.sh"   "$TEMPLATE_URL/.claude/hooks/session-start-recall.sh"
+  update_file ".claude/hooks/wiki-secret-scan.sh"       "$TEMPLATE_URL/.claude/hooks/wiki-secret-scan.sh"
+  update_file ".claude/commands/wiki-init.md"           "$TEMPLATE_URL/.claude/commands/wiki-init.md"
+  update_file ".claude/commands/wiki-capture.md"        "$TEMPLATE_URL/.claude/commands/wiki-capture.md"
+  update_file ".claude/commands/wiki-update.md"         "$TEMPLATE_URL/.claude/commands/wiki-update.md"
+  update_file ".claude/commands/wiki-recall.md"         "$TEMPLATE_URL/.claude/commands/wiki-recall.md"
+
+  # wiki 的「使用者資料」：絕不碰
+  keep_file ".claude/wiki/status.md"
+  keep_file ".claude/wiki/mistakes.md"
+  keep_file ".claude/wiki/decisions-summary.md"
+  keep_file ".claude/wiki/.wikiignore"
+fi
+
+if $HAS_SDD; then
+  # SDD 範本與 hook：可覆蓋
+  update_file "docs/3-specs/TEMPLATE-sdd/design.md"               "$TEMPLATE_URL/docs/3-specs/TEMPLATE-sdd/design.md"
+  update_file "docs/3-specs/TEMPLATE-sdd/tasks.md"                "$TEMPLATE_URL/docs/3-specs/TEMPLATE-sdd/tasks.md"
+  update_file "docs/2-architecture/decisions/TEMPLATE-adr.md"     "$TEMPLATE_URL/docs/2-architecture/decisions/TEMPLATE-adr.md"
+  update_file ".claude/commands/sdd-check.md"                     "$TEMPLATE_URL/.claude/commands/sdd-check.md"
+  update_file ".claude/hooks/sdd-guard.sh"                        "$TEMPLATE_URL/.claude/hooks/sdd-guard.sh"
+fi
+
+# ── 自我更新：把最新的 update.sh 也抓下來（含 install.sh）──
+# 這兩支在 main/scripts/ 下，不在 template/。
+update_file "scripts/update.sh"  "$REPO_RAW/scripts/update.sh"
+update_file "scripts/install.sh" "$REPO_RAW/scripts/install.sh"
+
+chmod +x .claude/hooks/*.sh scripts/*.sh 2>/dev/null || true
+
+# ── 使用者資料檔：絕不碰，但提醒「設定可能有新欄位要手動補」──
+keep_file ".claude/settings.json"
+keep_file "CLAUDE.md"
+
+# ── 結果輸出 ───────────────────────────────────────
+echo ""
+echo "─────────────────────────────────"
+if [ ${#NEW[@]} -gt 0 ]; then
+  echo ""
+  echo "🆕 新功能（舊版沒有，已加入）："
+  for f in "${NEW[@]}"; do echo "   + $f"; done
+fi
+if [ ${#UPDATED[@]} -gt 0 ]; then
+  echo ""
+  echo "⬆️  已更新（覆蓋成新版）："
+  for f in "${UPDATED[@]}"; do echo "   ~ $f"; done
+fi
+if [ ${#NEW[@]} -eq 0 ] && [ ${#UPDATED[@]} -eq 0 ]; then
+  echo ""
+  echo "✨ 模板邏輯檔已全部最新，無需變動。"
+fi
+if [ ${#KEPT[@]} -gt 0 ]; then
+  echo ""
+  echo "🔒 完整保留（你的內容/設定，從未碰過）："
+  for f in "${KEPT[@]}"; do echo "   = $f"; done
+fi
+
+# ── settings.json 提醒：新模組 hook 可能要手動補 ──
+if [ -f ".claude/settings.json" ]; then
+  MISSING=()
+  $HAS_WIKI && ! grep -q "session-start-recall.sh" .claude/settings.json && MISSING+=("SessionStart: session-start-recall.sh")
+  $HAS_WIKI && ! grep -q "wiki-secret-scan.sh"     .claude/settings.json && MISSING+=("PreToolUse(Write|Edit): wiki-secret-scan.sh")
+  $HAS_SDD  && ! grep -q "sdd-guard.sh"            .claude/settings.json && MISSING+=("PreToolUse(Write|Edit): sdd-guard.sh")
+  if [ ${#MISSING[@]} -gt 0 ]; then
+    echo ""
+    echo "📌 settings.json 是你的設定（沒動），但偵測到缺以下 hook，請手動補上："
+    for h in "${MISSING[@]}"; do echo "   • $h"; done
+  fi
+fi
+
+echo ""
+echo "🚀 更新完成：${LOCAL_VER} → ${REMOTE_VER}"
+echo "   下次更新直接跑：bash scripts/update.sh"
+echo "   改了什麼看：CHANGELOG.md"
+echo ""
diff --git a/template/.claude/VERSION b/template/.claude/VERSION
new file mode 100644
index 0000000..9084fa2
--- /dev/null
+++ b/template/.claude/VERSION
@@ -0,0 +1 @@
+1.1.0