universal-dev-standards 5.16.0 → 5.17.0

package/bundled/core/spec-driven-development.md

@@ -1,7 +1,7 @@
 # Spec-Driven Development (SDD) Standards
 
-**Version**: 2.2.0
-**Last Updated**: 2026-03-30
+**Version**: 2.3.0
+**Last Updated**: 2026-06-08
 **Applicability**: All projects adopting Spec-Driven Development
 **Scope**: universal
 **Industry Standards**: None (Emerging 2025+ methodology)
@@ -27,7 +27,7 @@ SDD operates at different maturity levels: Spec-first (discard after completion)
 |--------|-------------|
 | **Core Workflow** | Discuss → Proposal → Review → Implementation → Verification → Archive |
 | **Key Principle** | Spec First, Code Second |
-| **AC Format** | Given/When/Then (GWT) — enables structured BDD derivation |
+| **AC Format** | Given/When/Then (GWT, default — enables BDD derivation) **or** EARS notation (optional, XSPEC-263) |
 | **Test Generation** | Forward Derivation (/derive-bdd, /derive-tdd, /derive-all) |
 | **Maturity Levels** | Spec-first, Spec-anchored, Spec-as-source |
 | **Tools** | OpenSpec, Spec Kit, Manual (file-based) |
@@ -36,6 +36,24 @@ SDD operates at different maturity levels: Spec-first (discard after completion)
 | **AC YAML Sidecar** | Recommended .ac.yaml for machine-readable AC (when >3 ACs) |
 | **AI Agent Behavior** | Optional section defining agent roles, rules, quality checks, constraints |
 
+## Acceptance Criteria Formats | AC 格式
+
+UDS supports two AC notations. **GWT is the default and preferred** (Forward Derivation / BDD scenario generation depends on it). **EARS** (Easy Approach to Requirements Syntax, IBM Rational) is an optional supplement that expresses event/state/ubiquitous/unwanted requirements more precisely.
+
+| EARS type | Template | Use for |
+|-----------|----------|---------|
+| Ubiquitous | `THE SYSTEM SHALL <response>` | always-active requirement (no trigger) |
+| Event-driven | `WHEN <trigger> THE SYSTEM SHALL <response>` | triggered by an event |
+| State-driven | `WHILE <state> THE SYSTEM SHALL <response>` | active during a state |
+| Unwanted | `IF <condition>, THEN THE SYSTEM SHALL <response>` | error / exception handling |
+| Optional | `WHERE <feature included> THE SYSTEM SHALL <response>` | optional feature |
+
+Provide **GWT or EARS** per AC (`.ac.yaml`: `given/when/then` **or** `ears`). Prefer GWT for BDD-derivable behaviour; reach for EARS when GWT feels forced. Do not require both; do not remove GWT.
+
+## What's New in v2.3.0
+
+- **EARS notation** as an optional AC format (XSPEC-263): 5 EARS templates + `.ac.yaml` `ears` field. GWT remains default & preferred; `given/when/then` relaxed from `required` (backward compatible).
+
 ## What's New in v2.2.0
 
 - **AC YAML Sidecar**: Machine-readable acceptance criteria via `.ac.yaml` files (schema: `specs/schemas/acceptance-criteria.schema.yaml`)

package/bundled/locales/zh-CN/CHANGELOG.md

@@ -1,7 +1,7 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.16.0
-translation_version: 5.16.0
+source_version: 5.17.0
+translation_version: 5.17.0
 last_synced: 2026-06-08
 status: current
 ---
@@ -17,6 +17,16 @@ status: current
 
 ## [Unreleased]
 
+## [5.17.0] - 2026-06-08
+
+### 新增 — 可执行 SDD 一致性与 AC 格式扩充（XSPEC-262/263/264）
+
+- **`/sdd analyze` 跨 artifact 一致性（XSPEC-262，`scripts/sdd-analyze.ts`）**：acceptance-criteria-traceability + forward-derivation single-spine 的可执行面。7 类信号——孤儿测试／未覆盖／not_implemented／跨 spec AC 冲突／孤儿 .feature／AC 无 scenario／手册↔E2E drift（`T-NNN`，实现 XSPEC-260 R5）。`npm run sdd:analyze`；12 bats 测试。
+- **EARS 记法作为可选 AC 格式（XSPEC-263）**：spec-driven-development v2.3.0 加 5 种 EARS 模板；schema 加可选 `ears` 字段（given/when/then 由 required 放宽、向后兼容）。GWT 维持预设首选。
+- **结构化 Bugfix 规格模板（XSPEC-264）**：sdd-guide 决策树细分 trivial vs regression-prone，新增轻量 `<BUG-ID>.bugfix.md` 模板（current/expected/**unchanged** + root-cause + regression-test 当 AC）。
+
+> 注：Bugfix 模板的 sdd-guide locale（zh-TW/zh-CN）同步交 XSPEC-248 回路（既有 locale drift）。
+
 ## [5.16.0] - 2026-06-08
 
 ### 新增 — 测试推导链延伸至用户指南（XSPEC-260）

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

@@ -14,7 +14,7 @@ status: current
 
 > **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
 
-**版本**: 5.16.0 | **发布日期**: 2026-05-28 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.17.0 | **发布日期**: 2026-05-28 | **授权**: [双重授权](../../LICENSE) (CC BY 4.0 + MIT)
 
 语言无关、框架无关的软件项目文档标准。通过 AI 原生工作流，确保不同技术栈之间的一致性、质量和可维护性。
 

package/bundled/locales/zh-CN/core/spec-driven-development.md

@@ -8,8 +8,8 @@ status: current
 
 # 规格驱动开发 (SDD) 标准
 
-**版本**: 2.2.0
-**最后更新**: 2026-03-30
+**版本**: 2.3.0
+**最后更新**: 2026-06-08
 **适用范围**: 所有采用规格驱动开发的项目
 **范围**: universal
 
@@ -119,6 +119,20 @@ SDD **不是** "ATDD → BDD → TDD" 序列的一部分。相反，它通过正
 
 ---
 
+## AC 格式
+
+UDS 支持两种 AC 记法。**GWT 为预设与首选**（Forward Derivation／BDD 场景生成依赖它）。**EARS**（Easy Approach to Requirements Syntax，IBM Rational）为可选补充，对事件／状态／恒常／异常需求表达更精准（XSPEC-263）。
+
+| EARS 型 | 模板 | 用于 |
+|---------|------|------|
+| 恒常 Ubiquitous | `THE SYSTEM SHALL <response>` | 恒常需求（无触发）|
+| 事件驱动 Event-driven | `WHEN <trigger> THE SYSTEM SHALL <response>` | 事件触发 |
+| 状态驱动 State-driven | `WHILE <state> THE SYSTEM SHALL <response>` | 状态持续期间 |
+| 异常 Unwanted | `IF <condition>, THEN THE SYSTEM SHALL <response>` | 错误／异常处理 |
+| 选配 Optional | `WHERE <feature included> THE SYSTEM SHALL <response>` | 选配功能 |
+
+每个 AC 提供 **GWT 或 EARS** 之一（`.ac.yaml` 的 `given/when/then` 或 `ears`）。BDD 可推导行为优先 GWT；GWT 表达牵强时改用 EARS。不强制两者并存、不移除 GWT。
+
 ## 常见陷阱
 
 采用 SDD 时避免这些常见陷阱：

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

@@ -1,7 +1,7 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.16.0
-translation_version: 5.16.0
+source_version: 5.17.0
+translation_version: 5.17.0
 last_synced: 2026-06-08
 status: current
 ---
@@ -17,6 +17,16 @@ status: current
 
 ## [Unreleased]
 
+## [5.17.0] - 2026-06-08
+
+### 新增 — 可執行 SDD 一致性與 AC 格式擴充（XSPEC-262/263/264）
+
+- **`/sdd analyze` 跨 artifact 一致性（XSPEC-262，`scripts/sdd-analyze.ts`）**：acceptance-criteria-traceability + forward-derivation single-spine 的可執行面。7 類信號——孤兒測試／未覆蓋／not_implemented／跨 spec AC 衝突／孤兒 .feature／AC 無 scenario／手冊↔E2E drift（`T-NNN`，實現 XSPEC-260 R5）。`npm run sdd:analyze`；12 bats 測試。
+- **EARS 記法作為可選 AC 格式（XSPEC-263）**：spec-driven-development v2.3.0 加 5 種 EARS 模板；schema 加可選 `ears` 欄位（given/when/then 由 required 放寬、向後相容）。GWT 維持預設首選。
+- **結構化 Bugfix 規格模板（XSPEC-264）**：sdd-guide 決策樹細分 trivial vs regression-prone，新增輕量 `<BUG-ID>.bugfix.md` 模板（current/expected/**unchanged** + root-cause + regression-test 當 AC）。
+
+> 註：Bugfix 模板的 sdd-guide locale（zh-TW/zh-CN）同步交 XSPEC-248 迴路（既有 locale drift）。
+
 ## [5.16.0] - 2026-06-08
 
 ### 新增 — 測試推導鏈延伸至使用者指南（XSPEC-260）

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

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

package/bundled/locales/zh-TW/core/spec-driven-development.md

@@ -10,8 +10,8 @@ status: current
 
 > **語言**: [English](../../../core/spec-driven-development.md) | 繁體中文
 
-**版本**: 2.2.0
-**最後更新**: 2026-03-30
+**版本**: 2.3.0
+**最後更新**: 2026-06-08
 **適用性**: 所有採用規格驅動開發的專案
 **範圍**: 通用 (Universal)
 
@@ -38,6 +38,24 @@ SDD 的核心流程：**討論 → 規格提案 → 規格審查 → 實作 →
 | **參與者** | 架構師、開發者、AI 助手 |
 | **驗證方式** | 規格審查、正向推演 (Forward Derivation) |
 
+## AC 格式
+
+UDS 支援兩種 AC 記法。**GWT 為預設與首選**（Forward Derivation／BDD 場景生成依賴它）。**EARS**（Easy Approach to Requirements Syntax，IBM Rational）為可選補充，對事件／狀態／恆常／異常需求表達更精準。
+
+| EARS 型 | 模板 | 用於 |
+|---------|------|------|
+| 恆常 Ubiquitous | `THE SYSTEM SHALL <response>` | 恆常需求（無觸發）|
+| 事件驅動 Event-driven | `WHEN <trigger> THE SYSTEM SHALL <response>` | 事件觸發 |
+| 狀態驅動 State-driven | `WHILE <state> THE SYSTEM SHALL <response>` | 狀態持續期間 |
+| 異常 Unwanted | `IF <condition>, THEN THE SYSTEM SHALL <response>` | 錯誤／異常處理 |
+| 選配 Optional | `WHERE <feature included> THE SYSTEM SHALL <response>` | 選配功能 |
+
+每個 AC 提供 **GWT 或 EARS** 之一（`.ac.yaml` 的 `given/when/then` 或 `ears`）。BDD 可推導行為優先 GWT；GWT 表達牽強時改用 EARS。不強制兩者並存、不移除 GWT。
+
+## v2.3.0 新增內容
+
+- **EARS 記法** 作為可選 AC 格式（XSPEC-263）：5 種 EARS 模板 + `.ac.yaml` `ears` 欄位。GWT 維持預設與首選；`given/when/then` 由 required 放寬（向後相容）。
+
 ## v2.2.0 新增內容
 
 - **AC YAML Sidecar**：透過 `.ac.yaml` 檔案提供機器可讀的驗收標準（schema：`specs/schemas/acceptance-criteria.schema.yaml`）

package/bundled/skills/spec-driven-dev/SKILL.md

@@ -185,12 +185,39 @@ When modifying existing specs, use delta sections:
 | `## REMOVED Requirements` | Deprecated features | 移除功能 |
 | `## RENAMED Requirements` | Name changes | 重新命名 |
 
+## Cross-Artifact Analysis (`/sdd analyze`) | 跨 artifact 一致性檢查
+
+The **executable face** of the acceptance-criteria-traceability standard +
+forward-derivation single-spine principle (XSPEC-262). Validates that every test
+is a faithful projection of the AC spine across specs.
+本命令是 acceptance-criteria-traceability + forward-derivation single-spine 的**可執行面**，驗證每個測試是否忠實投影 AC 主幹。
+
+| Signal | Meaning | Gate |
+|--------|---------|------|
+| **orphan test** | `@AC AC-NNN` references an AC no spec defines / 引用不存在的 AC | 🔴 BLOCKING |
+| **uncovered** | an AC has no `@AC` reference / AC 無測試引用 | report only / 僅報告 |
+| **not_implemented** | AC marked so in its `.ac.yaml` / `.ac.yaml` 標記 | 🔴 BLOCKING before UAT |
+| **cross-spec conflict** | same AC id defined in >1 spec / 同 AC id 跨多 spec | 🔴 BLOCKING |
+| **orphan .feature** | Gherkin `@AC-N` tag referencing a non-existent AC / @AC-N 引用不存在 | 🔴 BLOCKING |
+| **AC w/o scenario** | AC has no `.feature` scenario (when BDD in use) / AC 無 BDD scenario | report only / 僅報告 |
+| **user-guide drift** | user-guide `T-N` with no matching journey/E2E test id / 手冊 T-N 無對應測試 | 🔴 BLOCKING |
+
+Coverage % uses the acceptance-criteria-traceability formula (not_implemented excluded). `--json` for CI.
+
+```
+npm run sdd:analyze -- --specs specs --tests tests [--userguide docs] [--json]
+```
+`--userguide <dir>` enables user-guide↔E2E drift detection (T-NNN, XSPEC-260/257). / 啟用手冊↔E2E drift 偵測。
+
+**vs `/ac-coverage`**: ac-coverage = per-spec detailed AC↔test matrix；`/sdd analyze` = cross-spec/batch consistency + orphan detection（互補、不取代）。
+
 ## Usage | 使用方式
 
 ```
 /sdd                     - Interactive spec creation wizard | 互動式規格建立精靈
 /sdd auth-flow           - Create spec for specific feature | 為特定功能建立規格
 /sdd review              - Review existing specs | 審查現有規格
+/sdd analyze             - Cross-artifact consistency check | 跨 artifact 一致性檢查
 /sdd --sync-check        - Check sync status | 檢查同步狀態
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universal-dev-standards",
-  "version": "5.16.0",
+  "version": "5.17.0",
   "description": "CLI tool for adopting Universal Development Standards",
   "keywords": [
     "documentation",

package/standards-registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "version": "5.16.0",
+  "version": "5.17.0",
   "lastUpdated": "2026-05-13",
   "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
   "formats": {
@@ -58,14 +58,14 @@
     "standards": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
-      "version": "5.16.0"
+      "version": "5.17.0"
     },
     "skills": {
       "name": "universal-dev-standards",
       "url": "https://github.com/AsiaOstrich/universal-dev-standards",
       "localPath": "skills",
       "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
-      "version": "5.16.0",
+      "version": "5.17.0",
       "note": "Skills are now included in the main repository under skills/"
     }
   },
@@ -2350,7 +2350,7 @@
       "id": "license-compliance",
       "name": "License Compliance Standards",
       "nameZh": "授權合規標準",
-      "version": "5.16.0",
+      "version": "5.17.0",
       "source": {
         "human": "core/license-compliance.md",
         "ai": "ai/standards/license-compliance.ai.yaml"