universal-dev-standards 6.9.0 → 6.11.0

package/bundled/locales/zh-TW/README.md

@@ -15,7 +15,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 6.9.0 | **發布日期**: 2026-09-14 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 6.11.0 | **發布日期**: 2026-09-16 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/bundled/locales/zh-TW/SECURITY.md

@@ -13,7 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支援狀態 |
 |------|--------|
-| 6.9.0 | ✅ 最新正式版 |
+| 6.11.0 | ✅ 最新正式版 |
 | < 6.0.0 | ❌ 已終止支援 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->
 

package/bundled/locales/zh-TW/core/agent-communication-protocol.md

@@ -8,6 +8,13 @@ status: current
 
 # Agent 通訊協定
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 > **語言**: [English](../../../core/agent-communication-protocol.md) | 繁體中文
 
 **版本**: 1.0.0

package/bundled/locales/zh-TW/core/branch-completion.md

@@ -8,6 +8,13 @@ status: current
 
 # 分支完成工作流程
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 > **語言**: [English](../../../core/branch-completion.md) | 繁體中文
 
 **版本**: 1.0.0

package/bundled/locales/zh-TW/core/change-batching-standards.md

@@ -8,6 +8,13 @@ status: current
 
 # 變更批次標準
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 > **語言**: [English](../../../core/change-batching-standards.md) | 繁體中文
 
 **適用範圍**: 所有使用自動化開發流程的軟體專案

package/bundled/locales/zh-TW/core/execution-history.md

@@ -8,6 +8,13 @@ status: current
 
 # 執行歷史儲存庫標準
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 > **語言**: [English](../../../core/execution-history.md) | 繁體中文
 
 **版本**: 1.0.0

package/bundled/locales/zh-TW/core/pipeline-integration-standards.md

@@ -8,6 +8,13 @@ status: current
 
 # Pipeline 整合標準
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 > **語言**: [English](../../../core/pipeline-integration-standards.md) | 繁體中文
 
 **適用範圍**: 所有使用自動化開發 Pipeline 的軟體專案

package/bundled/locales/zh-TW/core/workflow-enforcement.md

@@ -8,6 +8,13 @@ status: current
 
 # 工作流程強制執行標準
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 **適用範圍**：所有使用結構化開發方法論的軟體專案
 **範圍**：通用
 

package/bundled/locales/zh-TW/core/workflow-state-protocol.md

@@ -8,6 +8,13 @@ status: current
 
 # 工作流程狀態協議
 
+<!-- UDS:REFERENCE-ONLY since=6.0.0 -->
+> **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除；
+> 本文件保留在此，供實作它的採用層參考，**不由 `uds init` 或 `uds update` 出貨**。
+> 本告示所對照的清單是
+> [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json)，
+> 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
+
 > **語言**: [English](../../../core/workflow-state-protocol.md) | 繁體中文
 
 **版本**: 1.0.0

package/bundled/locales/zh-TW/docs/CHEATSHEET.md

@@ -1,6 +1,6 @@
 # UDS 速查表
 
-> Quick reference for all UDS features | Last updated: 2026-09-14
+> Quick reference for all UDS features | Last updated: 2026-09-18
 
 **Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
 

package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../docs/CLI-INIT-OPTIONS.md
-source_version: 3.5.1
-translation_version: 3.5.1
-last_synced: 2026-01-15
+source_version: 3.5.2
+translation_version: 3.5.2
+last_synced: 2026-09-18
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **語言**: [English](../../../docs/CLI-INIT-OPTIONS.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CLI-INIT-OPTIONS.md)
 >
-> **版本**: 3.5.0
-> **最後更新**: 2026-01-09
+> **版本**: 3.5.2
+> **最後更新**: 2026-09-18
 
 本文件詳細說明 `uds init` 命令的每一個選項，包含使用情境、影響範圍和建議選擇。
 
@@ -835,8 +835,49 @@ uds init --experimental
 | 不生成 AGENTS.md | `--no-agents-md` | 跳過 AGENTS.md 生成 |
 | 強制執行 Hooks | `--with-hooks` | 安裝強制執行 hooks（commit-msg、security、logging） |
 | 內容佈局 | `--content-layout` | 內容佈局（`flat`、`layered`）- 預設：`flat` |
+| Claude Code 目標檔 | `--claude-target` | Claude Code 整合內容要寫到哪裡：`project`（`CLAUDE.md`，預設）或 `local`（`CLAUDE.local.md`） |
 | 模式（已棄用） | `-m, --mode` | 安裝模式（skills, full）- 請改用 `--skills-location` |
 
+### Claude Code 整合目標檔（`--claude-target`）
+
+UDS 預設把 Claude Code 內容寫進 `CLAUDE.md`——團隊共用、會進版控的那個檔案。
+若你是在一個**已有團隊 `CLAUDE.md`** 的 repo 裡**個人採用** UDS，改用
+`--claude-target local`：UDS 會改寫入 `CLAUDE.local.md`，這是
+[Claude Code 原生支援](https://code.claude.com/docs/en/memory.md)、
+緊接在 `CLAUDE.md` 之後讀入的檔案，且完全不動團隊的檔案。
+
+```bash
+# 在有團隊 CLAUDE.md 的 repo 裡個人採用
+uds init -y --claude-target local
+```
+
+使用前有三件事要知道：
+
+1. **要自己把它加進 gitignore。** UDS 不會寫 `.gitignore` 或
+   `.git/info/exclude`——請自行把 `CLAUDE.local.md` 加進其中一個，
+   否則它會像任何新檔案一樣被 commit。
+2. **只存在於建立它的那個 worktree。** 因為（你 gitignore 之後）它是未受版控的檔案，
+   在某個 `git worktree` 建立的 `CLAUDE.local.md` 在同一個 repo 的另一個 worktree
+   看不到——每個 worktree 有自己的工作目錄，未受版控的檔案不會在 worktree 之間共享。
+   若你使用多個 worktree，需要在每一個裡分別執行
+   `uds init --claude-target local`（或下方的 `uds update --claude-target local`）。
+3. **`AGENTS.md` 不受影響。** `--claude-target` 只改變 Claude Code 內容要寫到哪裡。
+   若 `--agents-md` 生成了通用的 `AGENTS.md` 摘要，它仍照常寫進 `AGENTS.md`；
+   若也不想讓它進版控，一樣要自己排除（例如透過 `.git/info/exclude`）。
+
+已經用預設目標檔裝好了，想不重裝就切換？`uds update` 支援同一個旗標：
+
+```bash
+# 把既有安裝的 Claude Code 內容從 CLAUDE.md 搬到 CLAUDE.local.md
+uds update --claude-target local
+
+# 搬回去
+uds update --claude-target project
+```
+
+這會從舊檔移除 UDS 區塊（保留你自己寫在裡面的其他內容）、寫進新檔，並更新
+manifest——之後 `uds check` 驗的是新目標檔，不是舊的。
+
 ### 完整 CLI 範例
 
 ```bash
@@ -876,6 +917,12 @@ uds init -y --output-lang traditional-chinese --locale zh-tw
 
 # PHP 專案
 uds init -y --lang php --framework fat-free
+
+# 在有團隊 CLAUDE.md 的 repo 裡個人採用
+uds init -y --claude-target local
+
+# 之後把既有安裝切換到 CLAUDE.local.md，不需重裝
+uds update --claude-target local
 ```
 
 ---

package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md

@@ -1,7 +1,7 @@
 # UDS 功能參考手冊
 
 > Universal Development Standards - 完整功能文件
-> Auto-generated | Last updated: 2026-09-14
+> Auto-generated | Last updated: 2026-09-18
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
 
@@ -54,6 +54,7 @@
 | `--no-agents-md` | Skip AGENTS.md generation |
 | `--with-hooks` | Install enforcement hooks declared by the installed standards |
 | `--content-layout` | Content layout (flat, layered) [default: flat] |
+| `--claude-target` | Claude Code integration target: project (default, writes CLAUDE.md) or local (writes CLAUDE.local.md — not committed to git; gitignore it yourself) |
 | `-y, --yes` | Use defaults, skip interactive prompts |
 | `-E, --experimental` | Enable experimental features (methodology) |
 | `--force` | Bypass UDS source-repo self-adoption guard (DEC-044 / XSPEC-071) |
@@ -155,6 +156,7 @@
 | `--force` | Force update all files, ignoring hash comparison |
 | `--prune` | Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write) |
 | `--rollback` | Rollback to the most recent backup |
+| `--claude-target` | Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall |
 | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
 
 ### `uds skills`

package/bundled/locales/zh-TW/docs/MIGRATION-v6.md

@@ -32,14 +32,13 @@ UDS 6.0.0 是 **major** 版本：包含一項 breaking 更名、移除 8 個已
 
 **不受影響**：指涉外部工具內建 review 命令（如 Codex）的 `/review` 字樣與 UDS 無關，刻意保留原樣。
 
-## 2. 移除：8 個已棄用的機器可讀標準（`.ai.yaml`）
+## 2. 移除：7 個已棄用的機器可讀標準（`.ai.yaml`）
 
-這 8 個標準的 runtime 已於 5.4.0 移交採用層（XSPEC-086/095；UDS 定義活動、採用層編排流程——DEC-049），其 `.ai.yaml` stub 如期移除：
+這些標準的 runtime 已於 5.4.0 移交採用層（XSPEC-086/095；UDS 定義活動、採用層編排流程——DEC-049），其 `.ai.yaml` stub 如期移除：
 
 | 移除的 `.ai.yaml` | 保留的人類可讀文件 |
 |---|---|
 | `agent-communication-protocol` | `core/agent-communication-protocol.md` |
-| `agent-dispatch` | `core/agent-dispatch.md` |
 | `branch-completion` | `core/branch-completion.md` |
 | `change-batching-standards` | `core/change-batching-standards.md` |
 | `execution-history` | `core/execution-history.md` |
@@ -51,7 +50,12 @@ UDS 6.0.0 是 **major** 版本：包含一項 breaking 更名、移除 8 個已
 
 - 若從未直接載入這些 `.ai.yaml`：不需動作——人類可讀概念仍留在 `core/` 作為參考文件。
 - 若採用層（agent runtime、orchestrator、CI）曾載入這些 stub：在自家工具鏈實作等效機制。這些 stub 自 5.4.0 起本身就是指向此方向的棄用告示。
-- 這些標準不再由 `uds init` / `uds update` 發佈。專案 `.standards/` 中既有副本不會被自動刪除——想要乾淨樹的話請手動移除。
+- 這些標準不再由 `uds init` / `uds update` 發佈。每一份保留下來的 `core/*.md` 都在自己的開頭寫明這件事，而 `scripts/reference-only-standards.json` 是那份清單的機器可讀版本。
+- **`agent-dispatch` 曾在這張表上，現在不在了。** 它的 `.ai.yaml` 已於 XSPEC-362 R5a 恢復、正常出貨，而本指南在那之後仍把它列為已移除，跨了兩個大版本。**你的 manifest 裡若還有它，那是對的。**
+- 專案 `.standards/` 中既有副本不會被自動刪除。請用 **`uds update --prune`**，不要手動刪：
+  - `--prune` 會連同 `fileHashes` 裡的紀錄一起移除。手動刪只刪掉檔案，紀錄還在，`uds check` 會把每一個報成「遺失」並建議 `uds check --restore`——**而那個還原不可能成功**，因為上游已經沒有來源了。
+  - **從 6.8.x 以前升上來之後的第一次 `uds update` 什麼都不會刪**，不論你加什麼旗標：此時還沒有檔案歸屬紀錄，而 UDS 不會憑一筆不存在的紀錄刪東西。先跑一次 `uds update`，再跑 `uds update --prune`。
+  - `--prune` 不會清 `integrationConfigs[<檔名>].installedStandards`。那份快照正是 `uds update --sync-refs` 重新產生時所依據的東西，所以殘留在那裡的項目仍可能把錯的標準數寫進你的 CLAUDE.md。`uds update --integrations-only` 則是從 manifest 重算。
 
 ## 3. 移除：4 個已棄用的 CLI 命令
 

package/bundled/locales/zh-TW/integrations/claude-code/README.md

@@ -1,8 +1,8 @@
 ---
 source: ../../../../integrations/claude-code/README.md
-source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-08-12
+source_version: 1.2.0
+translation_version: 1.2.0
+last_synced: 2026-09-18
 status: current
 ---
 
@@ -10,8 +10,8 @@ status: current
 
 > **語言**: English | [繁體中文](README.md)
 
-**版本**: 1.1.0
-**最後更新**: 2026-08-12
+**版本**: 1.2.0
+**最後更新**: 2026-09-18
 
 本目錄包含將通用開發標準 (Universal Development Standards) 與 [Claude Code](https://docs.anthropic.com/claude-code) 整合的資源。
 
@@ -63,6 +63,15 @@ npx universal-dev-standards init
 2. 確保專案中存在 `core/` 目錄。
 3. 如有需要，安裝技能（請參閱 `skills/README.md`）。
 
+### 在已有團隊 `CLAUDE.md` 的 repo 裡個人採用（XSPEC-418）
+
+若 repo 已有進版控、團隊共用的 `CLAUDE.md`，而你要為自己個人採用 UDS，
+對 `init`（或 `update`，用於切換既有安裝）加上 `--claude-target local`，
+讓 UDS 改寫進 `CLAUDE.local.md`——Claude Code 會緊接在 `CLAUDE.md` 之後讀取它。
+你必須自己把 `CLAUDE.local.md` 加進 `.gitignore`（或 `.git/info/exclude`），
+且注意未受版控的檔案只存在於建立它的那個 git worktree。
+完整說明見 [CLI-INIT-OPTIONS.md § Claude Code 整合目標檔](../../../../docs/CLI-INIT-OPTIONS.md)。
+
 ## 驗證
 
 要驗證整合是否運作正常：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "6.9.0",
+  "version": "6.11.0",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",
@@ -63,21 +63,22 @@
     "check:effect-boundary:self-test": "node scripts/check-effect-boundary.mjs --self-test"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.4.2",
+    "@inquirer/prompts": "^8.7.2",
     "chalk": "^6.0.0",
     "commander": "^15.0.0",
-    "js-yaml": "^5.2.1",
+    "js-yaml": "^5.4.2",
     "ora": "^9.4.0",
     "semver": "^7.8.5"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@vitest/coverage-v8": "^4.1.5",
-    "eslint": "10.8.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "eslint": "10.10.0",
     "globals": "17.11.0",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.3",
-    "vitest": "^4.1.5"
+    "vite": "^8.3.0",
+    "vitest": "^5.0.0"
   },
   "lint-staged": {
     "src/**/*.js": [