spec-lite 1.5.2 → 1.7.0

package/README.md

@@ -45,7 +45,7 @@ BA author `.specs/main/feature/{F-XXX}-*/frd.md` trực tiếp qua interview, **
 
 Phạm vi hẹp: **chủ yếu frd.md** (+ tối đa một feature row vào prd nếu register). Reference component frd phụ thuộc (Components Used); component cần-nhưng-chưa-có ghi như *candidate* để `/spec-sad`/architect chốt boundary. **KHÔNG** tạo `crd.md`/`cdd.md` — component artifacts sinh ở integration time qua `/spec-new` cascade. Change History operation = `manual`. Nếu bỏ qua bước này, `/spec-new` vẫn tự tạo frd làm fallback.
 
-Sections: Overview · User Flows · Feature Acceptance Criteria · User Stories · Verification Rules · Scope · Dependencies
+Sections: Overview · User Flows · Feature Acceptance Criteria (end-to-end) · Non-Functional Requirements · Data & Migration *(nếu có)* · User Stories · Verification Rules · Scope · Dependencies
 
 ---
 
@@ -63,7 +63,7 @@ Scan codebase để extract main artifacts, sau đó vào Integration Pipeline.
 /spec-brownfield-feature
          │
          ▼
-/spec-tsd [F-XXX]   (tùy chọn — bootstrap tsd.md cho từng feature)
+/spec-test-design [F-XXX]   (tùy chọn — bootstrap test-design.md cho từng feature)
          │
          ▼
 (fill in NEEDS_CLARIFY khi có thêm context)
@@ -81,8 +81,8 @@ Scan module dirs, tạo `crd.md` + `cdd.md` cho từng component, điền Compon
 #### `/spec-brownfield-feature [path]`
 Scan routes/use cases/tests, tạo `frd.md` + `fdd.md` cho từng feature, điền Feature Index vào `prd.md`. Yêu cầu `component` đã chạy (fdd.md cần C-XXX IDs từ Component Index).
 
-#### `/spec-tsd [F-XXX]`
-Bootstrap `feature/{F-XXX}/tsd.md` (Test Spec Document) trực tiếp từ `frd.md` — mechanical derive Test Scenarios + Test Cases (mỗi Flow → TS, mỗi US/AC → Functional TC, mỗi VR → ≥1 positive + 1+ negative, mỗi FAC → Feature AC TC). Không interview, không cần integration. Dùng sau `/spec-brownfield-feature` để có test coverage tracking từ ngày 1, hoặc khi tsd drift khỏi frd cần regenerate fresh.
+#### `/spec-test-design [F-XXX]`
+Bootstrap `feature/{F-XXX}/test-design.md` (Test Design Document) trực tiếp từ `frd.md` — mechanical derive Test Scenarios + Test Cases (mỗi Flow → TS, mỗi US/AC → Functional TC, mỗi VR → ≥1 positive + 1+ negative, mỗi FAC → E2E TC, mỗi NFR → Non-functional TC, mỗi DM → Data & Migration TC). Không interview, không cần integration. Dùng sau `/spec-brownfield-feature` để có test coverage tracking từ ngày 1, hoặc khi test-design drift khỏi frd cần regenerate fresh.
 
 > **NEEDS_CLARIFY:** Các mục chưa rõ khi scan được đánh dấu `[NEEDS_CLARIFY]` — không block workflow, fill in dần khi có thêm context.
 
@@ -99,7 +99,7 @@ Mỗi requirement mới đều đi qua pipeline này.
           ├─────────────────┐
           ▼                 ▼
    /spec-tech         /spec-test   (song song — cả hai chỉ phụ thuộc spec.md)
-   (DEV approve)      (QC approve, cascade lên feature/*/tsd.md)
+   (DEV approve)      (QC approve, cascade lên feature/*/test-design.md)
           │                 │
           └────────┬────────┘
                   ▼
@@ -126,7 +126,10 @@ Tạo `.specs/integrations/{slug}/tech.md` sau khi `spec.md` được approve. C
 - Không có argument → hiển thị danh sách tất cả integrations
 
 #### `/spec-test [number]`
-Tạo `.specs/integrations/{slug}/test.md` sau khi `spec.md` được approve. Chạy bởi **QC**, **song song / độc lập** với `/spec-tech` — cả hai chỉ phụ thuộc `spec.md`. Mechanical derive Test Scenarios + Test Cases từ frd.md (Flow → TS, US/AC → Functional TC, VR → positive + negative, FAC → Feature AC TC), priority deterministic. Cascade lên `feature/{F-XXX}/tsd.md` qua Changes blocks. Gate: integration phải có `features:` non-empty (component-thuần không áp dụng).
+Tạo `.specs/integrations/{slug}/test.md` sau khi `spec.md` được approve. Chạy bởi **QC**, **song song / độc lập** với `/spec-tech` — cả hai chỉ phụ thuộc `spec.md`. Mechanical derive Test Scenarios + Test Cases từ frd.md (Flow → TS, US/AC → Functional TC, VR → positive + negative, FAC → E2E TC, NFR → Non-functional TC, DM → Data & Migration TC), priority deterministic. Cascade lên `feature/{F-XXX}/test-design.md` qua Changes blocks. Gate: integration phải có `features:` non-empty (component-thuần không áp dụng).
+
+#### `/spec-test-exec [F-XXX]`
+Sinh **bundle test-executions** (bản thực thi) cho một feature từ `test-design.md`. Layer EXECUTION — `test-design.md` là **source of truth**, skill đọc-xuống một chiều (không cascade, không sửa test-design), inherit `TC-F*` nguyên văn. Output: cycle bundle `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` (plane 2 tầng, ephemeral per chu kỳ test). Sinh tới 6 doc theo scope×harness — `func-manual`/`func-auto`, `e2e-manual`/`e2e-auto`, `nfr`, `dm` (nfr/dm bỏ nếu rỗng); team chọn harness theo kỹ năng. KHÔNG versioned. Feature-level, chạy sau khi có test-design (không thuộc per-integration pipeline).
 
 #### `/plan`
 Tạo `plan.md` và `todo.md` từ `spec.md` + `tech.md`.
@@ -171,15 +174,18 @@ Migrate **main artifact** lỗi thời lên structure mới (mọi main type). T
 | `/spec-brownfield-init` | `.specs/main/prd.md`, `.specs/main/domain.md`, `.specs/main/sad.md` |
 | `/spec-brownfield-component` | `.specs/main/component/{C-XXX}-*/crd.md + cdd.md` |
 | `/spec-brownfield-feature` | `.specs/main/feature/{F-XXX}-*/frd.md + fdd.md` |
-| `/spec-tsd` | `.specs/main/feature/{F-XXX}-*/tsd.md` |
+| `/spec-test-design` | `.specs/main/feature/{F-XXX}-*/test-design.md` |
 | `/artifact-audit` | *(báo cáo out-dated; + stamp `template_version` cho main artifact legacy conform)* |
 | `/artifact-migrate` | *(modify in-place main artifact lỗi thời lên structure mới + set `template_version`)* |
 | `/spec-new` | `.specs/integrations/{slug}/spec.md` |
 | `/spec-tech` | `.specs/integrations/{slug}/tech.md` |
-| `/spec-test` | `.specs/integrations/{slug}/test.md`, cascade: `feature/{F-XXX}/tsd.md` |
+| `/spec-test` | `.specs/integrations/{slug}/test.md`, cascade: `feature/{F-XXX}/test-design.md` |
+| `/spec-test-exec` | `.specs/test-executions/{F-XXX}-*/{NNN}-*/test-exec-*.md` (derived từ test-design) |
 | `/plan` | `.specs/integrations/{slug}/plan.md`, `todo.md` |
 | `/build` | *(implements tasks từ `plan.md`/`todo.md`)* |
 | `/review-integration` | *(findings report — không tạo file)* |
 | `/review-everything` | `.specs/integrations/{NNN}-{slug}/review-findings.md` *(qua /spec-new)* |
 
 Feature artifacts (`frd.md`) ở greenfield có thể author trước bằng `/spec-frd`, hoặc mọc dần qua **cascade proposals** từ integrations (`/spec-new` fallback). Component artifacts (`crd.md`/`cdd.md`) ở greenfield chỉ mọc qua cascade — không có skill author trực tiếp (`/spec-frd` chỉ reference component, không tạo crd/cdd).
+
+Ngoài `main/` và `integrations/`, còn plane thứ ba **`.specs/test-executions/`** (execution layer): bundle thực thi *derived* từ `test-design.md` qua `/spec-test-exec`, đánh số per-feature 2 tầng (`{F-XXX}-{slug}/{NNN}-{cycle-slug}/`), ephemeral per chu kỳ test, không versioned. Xem `conventions.md` §8.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-lite",
-  "version": "1.5.2",
+  "version": "1.7.0",
   "description": "Spec-driven development kit for Claude Code",
   "type": "module",
   "bin": {

package/skills/ado-create/SKILL.md

@@ -216,7 +216,7 @@ Sau khi tất cả tickets đã được tạo, cập nhật `spec.md`:
 ### Feature: Đăng ký / Đăng nhập (F-001)
 **ADO:** [#12345 — [SDLC-TEST] Đăng ký / Đăng nhập](https://dev.azure.com/...)
 
-**Feature-level Acceptance Criteria:**
+**Feature Acceptance Criteria:**
 ```
 
 **Với User Story ticket thành công:** Thêm dòng `**ADO:**` ngay sau heading user story:

package/skills/archive/SKILL.md

@@ -1,116 +1,125 @@
 ---
 name: archive
-description: Archive một integration từ .specs/integrations sang .specs/archive. Dùng khi một integration đã hoàn thành hoặc không còn active và cần được lưu trữ ra khỏi thư mục làm việc chính.
+description: Archive một integration hoặc một test-execution (cycle bundle / feature group) sang .specs/archive/ — namespaced theo loại (.specs/archive/integrations/ và .specs/archive/test-executions/). Dùng khi integration đã hoàn thành hoặc một chu kỳ test đã xong và cần dọn ra khỏi thư mục làm việc chính.
 ---
 
 # archive
 
 ## Overview
 
-Di chuyển một integration từ `.specs/integrations/` sang `.specs/archive/` để dọn dẹp thư mục làm việc chính trong khi vẫn giữ nguyên toàn bộ nội dung integration đó.
+Di chuyển một artifact bundle ra khỏi thư mục làm việc sang `.specs/archive/`, giữ nguyên nội dung. Hỗ trợ **hai plane**:
+
+- **Integration**: `.specs/integrations/{id}-{slug}/` → `.specs/archive/integrations/{id}-{slug}/`
+- **Test execution**: `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` → `.specs/archive/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/`
+  - Đơn vị archive = **cycle bundle** (một chu kỳ test xong) hoặc **cả feature group** (`{F-XXX}-{slug}/`) khi feature retire.
+
+`.specs/archive/` được **namespace theo loại** (`integrations/` + `test-executions/`) để không trộn lẫn hai plane. Cấu trúc nguồn được giữ nguyên dưới subfolder loại (test-exec giữ 2 tầng feature-group → cycle-bundle).
 
 ## When to Use
 
-- Integration đã hoàn thành (Done) và không cần active nữa
-- Integration bị cancel hoặc deferred vô thời hạn
-- Muốn dọn dẹp `.specs/integrations/` khỏi các integration cũ
+- Integration đã hoàn thành (Done) / cancel / deferred vô thời hạn.
+- Một **chu kỳ test** (cycle bundle test-exec) đã chạy xong, muốn lưu kết quả ra khỏi working set.
+- Feature retire → archive cả feature group test-executions của nó.
+- Dọn dẹp `.specs/integrations/` hoặc `.specs/test-executions/` khỏi bundle cũ.
 
 ## When NOT to Use
 
-- Integration đang In Progress → chưa nên archive
-- Muốn xóa hoàn toàn → đừng archive, thao tác thủ công sau khi confirm với team
+- Integration đang In Progress → chưa nên archive.
+- Cycle test đang chạy dở (Test Result chưa xong) → chưa archive.
+- Muốn xóa hoàn toàn → đừng archive, thao tác thủ công sau khi confirm với team.
 
 ---
 
 ## Process
 
-### Bước 1: Kiểm tra thư mục archive
+### Bước 1: Chuẩn bị thư mục archive
 
-Kiểm tra `.specs/archive/` đã tồn tại chưa.
+`.specs/archive/` chứa subfolder theo loại. **Tạo lazy** — chỉ tạo subfolder loại nào khi thực sự archive item thuộc loại đó:
 
-**Nếu chưa tồn tại** → tạo thư mục `.specs/archive/`.
-
-**Nếu đã tồn tại** → tiếp tục.
+- Archive integration → đảm bảo `.specs/archive/integrations/` tồn tại (tạo nếu chưa).
+- Archive test-execution → đảm bảo `.specs/archive/test-executions/` tồn tại (tạo nếu chưa).
 
 ---
 
-### Bước 2: Liệt kê integrations
-
-Quét `.specs/integrations/` để tìm tất cả các integration (mỗi integration là một thư mục con).
+### Bước 2: Liệt kê archivable từ cả hai plane
 
-**Nếu không có integration nào:**
+Quét `.specs/integrations/` và `.specs/test-executions/`. Hiển thị danh sách **chia section theo plane, đánh số liên tục**:
 
 ```
-Không có integration nào trong .specs/integrations/.
-```
-
-Dừng lại.
-
-**Nếu có integrations**, hiển thị danh sách dạng numbered list, kèm trạng thái nếu đọc được từ `spec.md` (frontmatter `status` hoặc heading):
-
-```
-Integrations trong .specs/integrations/:
+Archivable:
 
+Integrations (.specs/integrations/):
   [1]  001-user-authentication      (approved)
-  [2]  002-payment-integration      (draft)
-  [3]  003-notification-service     (done)
-  [4]  004-admin-panel              (in-progress)
+  [2]  003-notification-service     (done)
+
+Test executions (.specs/test-executions/):
+  [3]  F-012-bulk-import / 001-regression
+  [4]  F-012-bulk-import / 002-release-2.0
+  [5]  F-012-bulk-import            (cả feature group — gồm 001, 002)
+  [6]  F-031-checkout / 001-smoke
 
-Chọn số thứ tự integration để archive (hoặc nhập nhiều số cách nhau bởi dấu cách, ví dụ: 1 3):
+Chọn số để archive (nhiều số cách nhau bởi dấu cách, ví dụ: 1 3):
 ```
 
-Với mỗi integration, cố gắng đọc `spec.md` để lấy status. Nếu không đọc được thì bỏ qua phần status.
+- **Integration**: mỗi `{id}-{slug}/` là 1 dòng. Cố đọc `spec.md` frontmatter `status` để hiển thị (bỏ qua nếu không đọc được).
+- **Test execution**: mỗi **cycle bundle** `{F-XXX}-{slug}/{NNN}-{cycle-slug}/` là 1 dòng (qualified tên feature group). **Thêm 1 dòng cho cả feature group** `{F-XXX}-{slug}/` để archive trọn gói.
+- Cả hai plane rỗng → `Không có gì để archive trong .specs/integrations/ và .specs/test-executions/.` → dừng.
 
 ---
 
 ### Bước 3: Xác nhận
 
-Sau khi user chọn, hiển thị xác nhận trước khi di chuyển:
+Hiển thị source → **namespaced dest** trước khi di chuyển:
 
 ```
-Sẽ archive các integration sau:
+Sẽ archive:
 
-  .specs/integrations/001-user-authentication/  →  .specs/archive/001-user-authentication/
-  .specs/integrations/003-notification-service/ →  .specs/archive/003-notification-service/
+  .specs/integrations/001-user-authentication/
+    →  .specs/archive/integrations/001-user-authentication/
+
+  .specs/test-executions/F-012-bulk-import/001-regression/
+    →  .specs/archive/test-executions/F-012-bulk-import/001-regression/
 
 Xác nhận? (yes/no)
 ```
 
-Nếu user không confirm → hủy, không làm gì.
+- Nếu user chọn **cả feature group** lẫn một cycle con của nó → cảnh báo trùng, chỉ giữ feature group (archive group bao trọn cycle).
+- Không confirm → hủy, không làm gì.
 
 ---
 
 ### Bước 4: Di chuyển
 
-Với mỗi integration đã được confirm:
+Với mỗi item đã confirm, di chuyển **giữ nguyên cấu trúc nguồn** dưới subfolder loại:
+
+- Integration: `.specs/integrations/{id}-{slug}/` → `.specs/archive/integrations/{id}-{slug}/`
+- Cycle bundle: `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` → `.specs/archive/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` (tạo feature group dưới archive nếu chưa có).
+- Feature group: `.specs/test-executions/{F-XXX}-{slug}/` → `.specs/archive/test-executions/{F-XXX}-{slug}/`.
 
-- Di chuyển toàn bộ thư mục `.specs/integrations/{slug}/` sang `.specs/archive/{slug}/`
-- Giữ nguyên toàn bộ cấu trúc thư mục và file bên trong
+Sau khi di chuyển cycle bundle, nếu feature group nguồn **rỗng** (không còn cycle nào) → xóa thư mục feature group rỗng ở `.specs/test-executions/` cho gọn.
 
-Nếu `.specs/archive/{slug}/` đã tồn tại (trùng tên) → cảnh báo:
+**No-overwrite guard:** nếu dest đã tồn tại → cảnh báo và **bỏ qua** item đó (không ghi đè frozen record):
 
 ```
-⚠ .specs/archive/001-user-authentication/ đã tồn tại. Bỏ qua integration này để tránh ghi đè.
+⚠ .specs/archive/test-executions/F-012-bulk-import/001-regression/ đã tồn tại. Bỏ qua để tránh ghi đè.
 ```
 
-Và bỏ qua integration đó, tiếp tục với các integration còn lại.
+Tiếp tục với các item còn lại.
 
 ---
 
 ### Bước 5: Kết quả
 
-Thông báo kết quả:
-
 ```
 ✓ Đã archive:
-  .specs/archive/001-user-authentication/
-  .specs/archive/003-notification-service/
+  .specs/archive/integrations/001-user-authentication/
+  .specs/archive/test-executions/F-012-bulk-import/001-regression/
 
-{nếu có lỗi}
+{nếu có}
 ⚠ Bỏ qua (đã tồn tại):
-  .specs/archive/005-foo/
+  .specs/archive/test-executions/F-031-checkout/001-smoke/
 
-.specs/integrations/ hiện còn {N} integration(s).
+Còn lại: {N} integration(s), {M} test-execution cycle(s).
 ```
 
 ---
@@ -119,7 +128,9 @@ Thông báo kết quả:
 
 Trước khi di chuyển:
 
-- [ ] `.specs/archive/` đã tồn tại (tạo nếu chưa có)
-- [ ] User đã chọn ít nhất 1 integration
-- [ ] User đã confirm trước khi di chuyển
-- [ ] Không ghi đè nếu slug đã tồn tại trong `.specs/archive/`
+- [ ] Subfolder loại tương ứng (`.specs/archive/integrations/` hoặc `.specs/archive/test-executions/`) đã tồn tại (tạo lazy nếu chưa).
+- [ ] User đã chọn ít nhất 1 item.
+- [ ] User đã confirm; trùng feature-group ⨯ cycle-con đã dedupe.
+- [ ] Cấu trúc nguồn giữ nguyên dưới subfolder loại (test-exec giữ 2 tầng).
+- [ ] Không ghi đè nếu dest đã tồn tại.
+- [ ] Feature group nguồn rỗng sau khi archive cycle → dọn thư mục rỗng.

package/skills/artifact-audit/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: artifact-audit
-description: Audit MAIN artifacts trong .specs/main/ xem có lỗi thời so với template không (chỉ main artifacts — prd/domain/sad/frd/fdd/tsd/crd/cdd; integration artifacts ngoài scope). So `template_version` của artifact với `template_version` hiện tại đọc thẳng từ template (.claude/templates/). Versioned khớp → up-to-date, lệch → out-dated (in vX → vY). Artifact thiếu version (sinh trước versioning) → đối chiếu structure với template: khớp thì stamp version, lệch thì flag out-dated. KHÔNG tự migrate — chỉ stamp khi chắc chắn khớp + báo cáo. Nhận tùy chọn 1 hay nhiều main type làm scope (vd `frd`, `frd,crd`); không có arg → audit mọi main type.
+description: Audit MAIN artifacts trong .specs/main/ xem có lỗi thời so với template không (chỉ main artifacts — prd/domain/sad/frd/fdd/test-design/crd/cdd; integration artifacts ngoài scope). So `template_version` của artifact với `template_version` hiện tại đọc thẳng từ template (.claude/templates/). Versioned khớp → up-to-date, lệch → out-dated (in vX → vY). Artifact thiếu version (sinh trước versioning) → đối chiếu structure với template: khớp thì stamp version, lệch thì flag out-dated. KHÔNG tự migrate — chỉ stamp khi chắc chắn khớp + báo cáo. Nhận tùy chọn 1 hay nhiều main type làm scope (vd `frd`, `frd,crd`); không có arg → audit mọi main type.
 ---
 
 # artifact-audit
@@ -9,7 +9,7 @@ description: Audit MAIN artifacts trong .specs/main/ xem có lỗi thời so v
 
 Trả lời một câu hỏi: **main artifact nào trong `.specs/main/` đã lỗi thời so với template mới nhất?**
 
-> **Scope = chỉ main artifacts** (`prd`, `domain`, `sad`, `frd`, `fdd`, `tsd`, `crd`, `cdd` — đều nằm dưới `.specs/main/`). Integration artifacts (`spec`, `tech`, `test`, `plan`, `todo`, `techdebt` dưới `.specs/integrations/`) **không** thuộc scope của skill này — chúng là ephemeral và immutable sau khi `done`, không audit/migrate theo version.
+> **Scope = chỉ main artifacts** (`prd`, `domain`, `sad`, `frd`, `fdd`, `test-design`, `crd`, `cdd` — đều nằm dưới `.specs/main/`). Integration artifacts (`spec`, `tech`, `test`, `plan`, `todo`, `techdebt` dưới `.specs/integrations/`) **không** thuộc scope của skill này — chúng là ephemeral và immutable sau khi `done`, không audit/migrate theo version.
 
 Cơ chế (xem `conventions.md` §7 Template Versioning):
 - **Nguồn sự thật** = `template_version` trong frontmatter template đang cài (`.claude/templates/...`). Đọc thẳng lúc chạy — không manifest, không cache.
@@ -43,7 +43,7 @@ Type của main artifact resolve theo **filename**. Mỗi type map tới đúng
 | `sad.md` | sad | `main/sad-template.md` |
 | `frd.md` | frd | `main/feature/frd-template.md` |
 | `fdd.md` | fdd | `main/feature/fdd-template.md` |
-| `tsd.md` | tsd | `main/feature/tsd-template.md` |
+| `test-design.md` | test-design | `main/feature/test-design-template.md` |
 | `crd.md` | crd | `main/component/crd-template.md` |
 | `cdd.md` | cdd | `main/component/cdd-template.md` |
 

package/skills/artifact-migrate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: artifact-migrate
-description: Migrate MAIN artifact trong .specs/main/ lên structure template mới nhất (chỉ main artifacts — prd/domain/sad/frd/fdd/tsd/crd/cdd; integration artifacts ngoài scope). Tự chạy /artifact-audit (classify-only, scoped) để phát hiện out-dated, rồi áp delta từ block `migrations` của template — add section thiếu, remove section deprecated, update format section (vd ASCII→Mermaid) — set template_version = current. Tương tác: confirm add/remove/update, hỏi carry-over khi rename, section nội dung mới thì interview hoặc NEEDS_CLARIFY (không bịa). Single-artifact, KHÔNG cascade. Nhận tùy chọn 1 main artifact (path); không có arg → quét mọi main artifact, migrate từng cái có confirm + skip.
+description: Migrate MAIN artifact trong .specs/main/ lên structure template mới nhất (chỉ main artifacts — prd/domain/sad/frd/fdd/test-design/crd/cdd; integration artifacts ngoài scope). Tự chạy /artifact-audit (classify-only, scoped) để phát hiện out-dated, rồi áp delta từ block `migrations` của template — add section thiếu, remove section deprecated, update format section (vd ASCII→Mermaid) — set template_version = current. Tương tác: confirm add/remove/update, hỏi carry-over khi rename, section nội dung mới thì interview hoặc NEEDS_CLARIFY (không bịa). Single-artifact, KHÔNG cascade. Nhận tùy chọn 1 main artifact (path); không có arg → quét mọi main artifact, migrate từng cái có confirm + skip.
 ---
 
 # artifact-migrate
@@ -9,7 +9,7 @@ description: Migrate MAIN artifact trong .specs/main/ lên structure template m
 
 Đưa một main artifact (hoặc toàn bộ main artifacts) **lỗi thời** lên đúng structure của template mới nhất, rồi cập nhật `template_version`. Đây là vế **fix** đối xứng với `/artifact-audit` (vế **detect**).
 
-> **Scope = chỉ main artifacts** (`prd`, `domain`, `sad`, `frd`, `fdd`, `tsd`, `crd`, `cdd` — đều dưới `.specs/main/`). Integration artifacts (`spec`, `tech`, `test`, `plan`, `todo`, `techdebt`) **không** thuộc scope — ephemeral + immutable sau `done`, không migrate theo version.
+> **Scope = chỉ main artifacts** (`prd`, `domain`, `sad`, `frd`, `fdd`, `test-design`, `crd`, `cdd` — đều dưới `.specs/main/`). Integration artifacts (`spec`, `tech`, `test`, `plan`, `todo`, `techdebt`) **không** thuộc scope — ephemeral + immutable sau `done`, không migrate theo version.
 
 Cơ chế (xem `conventions.md` §7 Template Versioning):
 - **Required section hiện tại** = body `##` headings của template (deterministic theo level; `###` = instance).
@@ -34,7 +34,7 @@ Cơ chế (xem `conventions.md` §7 Template Versioning):
 
 Resolve type của main artifact theo **filename** (giống `/artifact-audit`). Mỗi type map tới đúng một template tại `.claude/templates/...`:
 
-`prd.md`→`main/prd-template.md` · `domain.md`→`main/domain-template.md` · `sad.md`→`main/sad-template.md` · `frd.md`→`main/feature/frd-template.md` · `fdd.md`→`main/feature/fdd-template.md` · `tsd.md`→`main/feature/tsd-template.md` · `crd.md`→`main/component/crd-template.md` · `cdd.md`→`main/component/cdd-template.md`
+`prd.md`→`main/prd-template.md` · `domain.md`→`main/domain-template.md` · `sad.md`→`main/sad-template.md` · `frd.md`→`main/feature/frd-template.md` · `fdd.md`→`main/feature/fdd-template.md` · `test-design.md`→`main/feature/test-design-template.md` · `crd.md`→`main/component/crd-template.md` · `cdd.md`→`main/component/cdd-template.md`
 
 **Chỉ main artifacts.** Integration artifacts (`spec`/`tech`/`test`/`plan`/`todo`/`techdebt`) ngoài scope → bỏ qua. File không khớp map → cũng bỏ qua.
 

package/skills/spec-brownfield-feature/SKILL.md

@@ -289,7 +289,7 @@ Brownfield init hoàn tất! Main artifacts:
   └── feature/         ({N} features, mỗi cái có frd.md + fdd.md)
 
 Bước tiếp theo (tùy chọn):
-  /spec-tsd [F-XXX]  → bootstrap tsd.md (Test Spec Document) cho từng feature
+  /spec-test-design [F-XXX]  → bootstrap test-design.md (Test Design Document) cho từng feature
                        — derive 1:1 từ frd.md, có test coverage tracking từ ngày 1.
 
 Để bắt đầu implement, dùng /spec-new để tạo integration đầu tiên.

package/skills/spec-frd/SKILL.md

@@ -9,7 +9,7 @@ description: Author MỚI frd.md (Feature Requirements Document) trực tiếp
 
 Author `.specs/main/feature/{F-XXX}-{feature-slug}/frd.md` trực tiếp qua interview — **spec-first ở feature level**, do **BA** chạy trước khi bất kỳ integration nào bắt đầu.
 
-`frd.md` là **what to build** của một feature: Overview, User Flows, Feature AC, User Stories, Verification Rules, Scope, Dependencies. Đây là baseline ổn định, **author một lần** — mọi thay đổi sau đó đi qua `/spec-new` (delta cascade).
+`frd.md` là **what to build** của một feature: Overview, User Flows, Feature AC (end-to-end), Non-Functional Requirements, Data & Migration, User Stories, Verification Rules, Scope, Dependencies. Đây là baseline ổn định, **author một lần** — mọi thay đổi sau đó đi qua `/spec-new` (delta cascade).
 
 Skill này là cặp greenfield đối xứng với `/spec-brownfield-feature` (vốn reverse-engineer frd từ code). Khác biệt: `/spec-frd` author *forward* từ interview, không scan code.
 
@@ -23,7 +23,7 @@ Skill này là cặp greenfield đối xứng với `/spec-brownfield-feature` (
 - ✅ Nếu feature mục tiêu là feature mới chưa có trong Index → **register một row vào `prd.md > Features`** (side-effect hợp lệ lên prd).
 - ✅ **Cascade vocabulary lên `domain.md`** (Bước 4b — pha *mô tả hệ thống*/WHAT): glossary term + **định nghĩa entity đầy đủ** (attributes). `Owner` của entity để `TBD` cho `/spec-sad` điền ở pha *thiết kế hệ thống* (HOW). BA duyệt trước khi ghi. Đây là điểm khác với phiên bản trước (`/spec-frd` từng không đụng domain) — vocabulary sinh ra ở feature-authoring time nên seed luôn, thay vì để domain rỗng tới integration đầu tiên.
 - ❌ KHÔNG tạo/sửa `crd.md`/`cdd.md` — component artifacts ra đời ở integration time qua `/spec-new` cascade.
-- ❌ KHÔNG tạo `fdd.md` (inter-component design) hay `tsd.md` (test) — để skill/role khác lo.
+- ❌ KHÔNG tạo `fdd.md` (inter-component design) hay `test-design.md` (test) — để skill/role khác lo.
 - ❌ KHÔNG carve component / quyết `Owner` của shared entity (để `/spec-sad`/`/spec-new`); KHÔNG đổi status feature đã có; KHÔNG đụng sad.
 
 ## When to Use
@@ -180,9 +180,14 @@ Hỏi tuần tự, từng phần — không hỏi tất cả cùng lúc. Nếu B
 **Phần 3 — User Stories:**
 > Liệt kê các stories ở cấp feature: "{Persona} muốn {hành động} để {mục tiêu}". Mỗi story có priority (Must/Should/Could) và acceptance criteria (Given/When/Then).
 
-**Phần 4 — Feature Acceptance Criteria:**
-> Có criteria nào áp cho *toàn* feature mà story lẻ không cover? (e2e liên story, cross-story consistency, NFR như performance/accessibility, data & migration)
-> Mỗi cái Given/When/Then, **Then phải đo được**.
+**Phần 4 — Feature Acceptance Criteria (end-to-end):**
+> Có criteria **end-to-end** nào áp cho *toàn* feature mà story lẻ không cover? 3 shape: journey (tuần tự liên story) + consistency (đa màn) + integrity (bất biến liên story, không tuần tự — vd cascade delete, đối soát khớp). Mỗi cái Given/When/Then, **Then phải đo được**. (NFR và data/migration hỏi riêng ở Phần 4b / 4c.)
+
+**Phần 4b — Non-Functional Requirements:**
+> Feature có yêu cầu non-functional riêng không? (performance, accessibility, security, browser, i18n). Mỗi cái **tham chiếu `NFR-*` của PRD nếu có** (refine bar chung) hoặc đặc thù-feature. G/W/T, Then đo được. Không có → để section trống (required-emptyable, giữ heading).
+
+**Phần 4c — Data & Migration:**
+> Feature có đụng migration / backfill data cũ không? Nếu có: G/W/T, Then đo được (đếm bản ghi / so khớp). Không có → giữ heading, để section trống (required-emptyable).
 
 **Phần 5 — Verification Rules:**
 > Với mỗi input field trong các stories, mình sẽ suggest 2-4 phương án validation để BA chọn (xem "Verification Rules — quy ước sinh" bên dưới). BA là người quyết định.
@@ -246,7 +251,7 @@ BA quyết **định nghĩa entity** (WHAT); `Owner` để `/spec-sad` cascade b
 
 Dùng `.claude/templates/main/feature/frd-template.md` làm skeleton, điền nội dung từ interview.
 
-**ID assignment** (luôn là create — frd mới): US `US-F{NNN}-001+`, Story AC `AC-F{NNN}-001+`, Feature AC `FAC-F{NNN}-001+` (counter độc lập với Story AC), VR `VR-F{NNN}-001+`. `NNN` = số của F-XXX. Flow đánh số từ 1.
+**ID assignment** (luôn là create — frd mới): US `US-F{NNN}-001+`, Story AC `AC-F{NNN}-001+`, Feature AC `FAC-F{NNN}-001+` (counter độc lập với Story AC), NFR `NFR-F{NNN}-001+` (counter độc lập), DM `DM-F{NNN}-001+` (counter độc lập, chỉ khi có Data & Migration), VR `VR-F{NNN}-001+`. `NNN` = số của F-XXX. Flow đánh số từ 1.
 
 **Frontmatter** frd mới: theo template, `status: draft`, `owner: BA`, `feature_id: F-XXX`, `template_version` copy từ `frd-template.md` (xem `conventions.md` §7 — chỉ set lúc CREATE; thay đổi sau qua `/spec-new` không đụng version).
 
@@ -331,7 +336,7 @@ Append **một** Change History entry vào `domain.md`, operation = `manual` (au
 
 (Nếu domain.md đang là skeleton create lần đầu thì entry vẫn `manual`/`update` — file đã được `/spec-prd` scaffold với operation `create` từ trước.) Atomic với 7a: domain cascade fail → rollback cả frd. `Owner` của entity do `/spec-sad`/`/spec-new` cascade bổ sung sau (HOW phase) qua `[MODIFY Owner]`.
 
-**7c. KHÔNG đụng gì khác.** Không đổi status của các feature *đã có* (frd tồn tại ≠ integration bắt đầu; marker "→ frd.md tồn tại" derive từ file existence). Không thêm component vào Index (chỉ candidate). Không carve component / không tự quyết `Owner` của shared entity. Không tạo crd/cdd/fdd/tsd. Không đụng sad.
+**7c. KHÔNG đụng gì khác.** Không đổi status của các feature *đã có* (frd tồn tại ≠ integration bắt đầu; marker "→ frd.md tồn tại" derive từ file existence). Không thêm component vào Index (chỉ candidate). Không carve component / không tự quyết `Owner` của shared entity. Không tạo crd/cdd/fdd/test-design. Không đụng sad.
 
 **7d. Thông báo kết quả:**
 
@@ -349,7 +354,7 @@ Append **một** Change History entry vào `domain.md`, operation = `manual` (au
   - VR-F{NNN}-{seq} — {field}
 
 Bước tiếp theo:
-  - /spec-tsd F-XXX  → QC bootstrap test spec từ frd này
+  - /spec-test-design F-XXX  → QC bootstrap test design từ frd này
   - /spec-new F-XXX  → DEV bắt đầu integration (frd sẽ được consume, crd/cdd sinh qua cascade)
   {nếu có candidate hoặc entity Owner TBD} - /spec-sad → architect chốt boundary component + gán Owner cho shared entity
 ```
@@ -388,12 +393,14 @@ Bước tiếp theo:
 - [ ] frd.md có đủ 7 core sections (luôn create mới); `Open Questions` chứa câu hỏi clarify + component candidate còn mở, hoặc đã xóa nếu rỗng
 - [ ] Frontmatter có `template_version` copy từ `frd-template.md`
 - [ ] Mỗi User Story có persona + priority + ít nhất 1 AC Given/When/Then
-- [ ] Feature AC dùng ID `FAC-F{NNN}-{seq}` (counter độc lập với `AC-F{NNN}`), Then đo được
+- [ ] Feature AC chỉ end-to-end (journey + consistency + integrity), ID `FAC-F{NNN}-{seq}` (counter độc lập với `AC-F{NNN}`), Then đo được; authz/access-control functional → AC/VR, không phải NFR
+- [ ] Non-Functional Requirements: heading luôn có (required-emptyable); nếu có item → ID `NFR-F{NNN}-{seq}`, tham chiếu `NFR-*` PRD nếu có thể, Then đo được
+- [ ] Data & Migration (required-emptyable): ID `DM-F{NNN}-{seq}`, Then đo được; không đụng migration → giữ heading, để trống
 - [ ] Verification Rules đã confirm với BA (không tự assert); không chứa regex/code/error message; semantic type
 - [ ] ID bắt đầu từ 001 (create mới)
 - [ ] Components Used reference C-XXX có sẵn; component mới ghi candidate + surface cho /spec-sad
 - [ ] Nếu register feature mới: prd Features có row [NEW] + Change History entry; status feature đã có KHÔNG đổi
 - [ ] Domain cascade (nếu có vocabulary mới, đã BA confirm): Glossary term ghi đủ định nghĩa; Shared Entity ghi đủ definition + attributes với `Owner: TBD` (KHÔNG tự gán C-XXX); domain.md có Change History entry operation = `manual`
-- [ ] KHÔNG tạo crd/cdd/fdd/tsd; KHÔNG carve component / gán Owner entity; KHÔNG đụng sad
+- [ ] KHÔNG tạo crd/cdd/fdd/test-design; KHÔNG carve component / gán Owner entity; KHÔNG đụng sad
 - [ ] Change History entry (frd) operation = `manual` (luôn `create`)
 - [ ] User đã confirm trước khi ghi file

package/skills/spec-new/SKILL.md

@@ -91,11 +91,13 @@ Sections hiện có:
 
   [1] Overview
   [2] User Flows
-  [3] Feature-level Acceptance Criteria
-  [4] User Stories
-  [5] Verification Rules
-  [6] Scope (In Scope / Out of Scope)
-  [7] Dependencies (Feature Dependencies + Components Used)
+  [3] Feature Acceptance Criteria (end-to-end)
+  [4] Non-Functional Requirements
+  [5] Data & Migration (required-emptyable)
+  [6] User Stories
+  [7] Verification Rules
+  [8] Scope (In Scope / Out of Scope)
+  [9] Dependencies (Feature Dependencies + Components Used)
   [A] All — viết lại toàn bộ từ đầu
   [S] Lên spec từ frd.md hiện tại — frd.md đã đầy đủ, không cần chỉnh
 
@@ -241,7 +243,7 @@ Template gốc là single source of truth cho format. KHÔNG duplicate skeleton
 
 Liệt kê **tất cả** features liên quan đến integration và đánh giá từng cái. Không được bỏ qua feature nào — kể cả feature `Done` vẫn phải đánh giá xem spec mới có làm thay đổi scope không.
 
-- Operation=create khi frd.md chưa tồn tại → nội dung đầy đủ tất cả 7 sections: Overview, User Flows, Feature-level AC, User Stories, Verification Rules, Scope, Dependencies.
+- Operation=create khi frd.md chưa tồn tại → nội dung đầy đủ các section: Overview, User Flows, Feature Acceptance Criteria (end-to-end), Non-Functional Requirements (required-emptyable), Data & Migration (required-emptyable), User Stories, Verification Rules, Scope, Dependencies.
 - Operation=update khi frd.md đã tồn tại → hỏi user chọn section cần update:
 
 ```
@@ -250,11 +252,13 @@ Sections hiện có:
 
   [1] Overview
   [2] User Flows
-  [3] Feature-level Acceptance Criteria
-  [4] User Stories
-  [5] Verification Rules
-  [6] Scope (In Scope / Out of Scope)
-  [7] Dependencies (Feature Dependencies + Components Used)
+  [3] Feature Acceptance Criteria (end-to-end)
+  [4] Non-Functional Requirements
+  [5] Data & Migration (required-emptyable)
+  [6] User Stories
+  [7] Verification Rules
+  [8] Scope (In Scope / Out of Scope)
+  [9] Dependencies (Feature Dependencies + Components Used)
   [A] All — viết lại toàn bộ từ đầu
 
 Chọn section cần cập nhật (có thể chọn nhiều, ví dụ: 2 3):