spec-lite 1.5.2 → 1.6.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,7 @@ 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).
 
 #### `/plan`
 Tạo `plan.md` và `todo.md` từ `spec.md` + `tech.md`.
@@ -171,12 +171,12 @@ 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` |
 | `/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)* |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-lite",
-  "version": "1.5.2",
+  "version": "1.6.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/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):

package/skills/spec-test/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: spec-test
-description: Tạo test.md cho một integration bằng cách mechanical derive Test Scenarios + Test Cases từ Flows/US/AC/VR/FAC trong frd.md. Auto-cascade lên feature/{F-XXX}/tsd.md. Role QC, song song với /spec-tech (DEV) — cả hai chỉ phụ thuộc spec.md approved.
+description: Tạo test.md cho một integration bằng cách mechanical derive Test Scenarios + Test Cases từ Flows/US/AC/VR/FAC trong frd.md. Auto-cascade lên feature/{F-XXX}/test-design.md. Role QC, song song với /spec-tech (DEV) — cả hai chỉ phụ thuộc spec.md approved.
 ---
 
 # spec-test
@@ -9,15 +9,15 @@ description: Tạo test.md cho một integration bằng cách mechanical derive
 
 Tạo `test.md` cho một integration trong `.specs/integrations/{slug}/`.
 
-`test.md` là verification design ở integration level — định nghĩa **how to verify** rằng integration đáp ứng `spec.md`. Nội dung gồm Test Strategy (per integration) + Changes blocks cascade lên feature `tsd.md` (Test Spec Document).
+`test.md` là verification design ở integration level — định nghĩa **how to verify** rằng integration đáp ứng `spec.md`. Nội dung gồm Test Strategy (per integration) + Changes blocks cascade lên feature `test-design.md` (Test Design Document).
 
 **Hai artifact tách bạch:**
 - `.specs/integrations/{slug}/test.md` — integration-level, ephemeral, PR record bất biến sau approve (single-word naming như `spec.md` / `tech.md` / `plan.md`).
-- `.specs/main/feature/{F-XXX}-{slug}/tsd.md` — feature-level, persistent canonical artifact (3-letter naming như `frd.md` / `fdd.md`). TC content cuối cùng nằm ở đây.
+- `.specs/main/feature/{F-XXX}-{slug}/test-design.md` — feature-level, persistent canonical artifact (cùng nhóm main feature như `frd.md` / `fdd.md`). TC content cuối cùng nằm ở đây.
 
 **Role:** QC. Song song với `/spec-tech` (DEV role). Cả hai chỉ phụ thuộc `spec.md` approved — không có thứ tự bắt buộc giữa chúng.
 
-**Cốt lõi:** agent **mechanical derive** TC từ frd.md (mỗi Flow → TS, mỗi US/AC → Functional TC, mỗi VR → Validation TC positive+negative, mỗi FAC → Feature AC TC). Agent KHÔNG sáng tạo TC ngoài frd — phần đó là QC thêm tay khi review.
+**Cốt lõi:** agent **mechanical derive** TC từ frd.md (mỗi Flow → TS, mỗi US/AC → Functional TC, mỗi VR → Validation TC positive+negative, mỗi FAC → E2E TC, mỗi NFR → Non-functional TC, mỗi DM → Data & Migration TC). Agent KHÔNG sáng tạo TC ngoài frd — phần đó là QC thêm tay khi review.
 
 ## When to Use
 
@@ -27,7 +27,7 @@ Tạo `test.md` cho một integration trong `.specs/integrations/{slug}/`.
 ## When NOT to Use
 
 - `spec.md` chưa có hoặc chưa approve → chạy `/spec-new` trước
-- Integration có `features: []` (không touch feature nào) → `test.md` không áp dụng vì component-level `tsd.md` không tồn tại trong kit này (xem `templates/main/feature/tsd-template.md` — component contract verify gián tiếp qua feature TC + unit test trong code). Verification cho integration thuần component → đặt trong tech.md hoặc phase Verification của plan.md.
+- Integration có `features: []` (không touch feature nào) → `test.md` không áp dụng vì component-level `test-design.md` không tồn tại trong kit này (xem `templates/main/feature/test-design-template.md` — component contract verify gián tiếp qua feature TC + unit test trong code). Verification cho integration thuần component → đặt trong tech.md hoặc phase Verification của plan.md.
 - Chỉ muốn cập nhật `test.md` đã có → edit file trực tiếp
 
 ---
@@ -90,8 +90,8 @@ Nếu `status` **không phải** `approved`:
 
 > ⛔ Integration **{slug}** không touch feature nào (`features: []`).
 >
-> `/spec-test` cascade lên `feature/{F-XXX}/tsd.md` — không áp dụng cho integration thuần component.
-> Component contract được verify gián tiếp qua feature TC + unit test trong code (xem `templates/main/feature/tsd-template.md`).
+> `/spec-test` cascade lên `feature/{F-XXX}/test-design.md` — không áp dụng cho integration thuần component.
+> Component contract được verify gián tiếp qua feature TC + unit test trong code (xem `templates/main/feature/test-design-template.md`).
 >
 > Đặt verification cho integration này trong:
 > - `tech.md > Implementation Notes` — verification approach
@@ -109,7 +109,7 @@ Load các file sau:
 
 - `.specs/integrations/{slug}/spec.md` — đọc toàn bộ + frontmatter (`features`)
 - `.specs/main/feature/{F-XXX}-{slug}/frd.md` — cho mỗi feature trong frontmatter `features` (source của TC — bắt buộc tồn tại vì cascade từ spec.md đã apply)
-- `.specs/main/feature/{F-XXX}-{slug}/tsd.md` — cho mỗi feature trong frontmatter `features` (nếu tồn tại — cần để diff và assign next ID)
+- `.specs/main/feature/{F-XXX}-{slug}/test-design.md` — cho mỗi feature trong frontmatter `features` (nếu tồn tại — cần để diff và assign next ID)
 - `.specs/integrations/{slug}/tech.md` — đọc nếu tồn tại (optional, dùng để hint environment / data set / NFR perf threshold)
 
 Tóm tắt context:
@@ -119,8 +119,8 @@ TÔI HIỂU:
 - Integration: {title}
 - Features touched: {từ frontmatter — F-XXX, ...}
 - Mỗi feature có trong frd.md:
-  - F-XXX: {N} Flows, {M} US ({K} AC), {P} VR, {Q} FAC
-- tsd.md hiện tại:
+  - F-XXX: {N} Flows, {M} US ({K} AC), {P} VR, {Q} FAC, {R} NFR, {S} DM
+- test-design.md hiện tại:
   - F-XXX: tồn tại — max(TS)=NNN, max(TC)=MMM   (cho operation=update)
   - F-YYY: chưa tồn tại                          (cho operation=create)
 - tech.md: {tồn tại / chưa — nếu có thì có hint gì cho env/data/perf}
@@ -139,11 +139,11 @@ Nếu frd.md của feature nào không tồn tại → báo lỗi và dừng (l
 
 Với mỗi feature trong `features:`:
 
-- Đọc `feature/{F-XXX}/tsd.md` hiện tại (nếu có) để lấy `max(TS-F{NNN}-seq)` và `max(TC-F{NNN}-seq)`
+- Đọc `feature/{F-XXX}/test-design.md` hiện tại (nếu có) để lấy `max(TS-F{NNN}-seq)` và `max(TC-F{NNN}-seq)`
 - ID mới = `max(seq) + 1`, format 3 chữ số
-- TC dùng **chung sequence** cho Functional / Validation / Feature AC — không reset theo loại
+- TC dùng **chung sequence** cho Functional / Validation / E2E / Non-functional / Data & Migration — không reset theo loại, không đẻ prefix riêng
 - ID **stable** — không tái sử dụng khi [REMOVE], không renumber khi [MODIFY]
-- Operation=create (tsd.md chưa tồn tại) → bắt đầu từ `001`
+- Operation=create (test-design.md chưa tồn tại) → bắt đầu từ `001`
 
 #### 3.2 Derivation rules
 
@@ -176,14 +176,13 @@ Với mỗi feature trong `features:`:
 - Covers: `VR-{F_ID}-{seq}`
 - Priority: P1 mặc định (xem 3.3)
 
-**D. Feature AC Test Cases** — mỗi FAC → 1 Feature AC TC.
+**D. E2E Test Cases** — mỗi `FAC-*` (end-to-end) → 1 TC. Type: `E2E — journey` (tuần tự liên story) / `E2E — consistency` (đa màn) / `E2E — integrity` (bất biến liên story, không tuần tự) — đọc FAC để phân loại. Covers `FAC-{F_ID}-{seq}`. Spans: list US IDs (nếu journey/integrity). Preconditions/Steps/Expected dịch 1:1 từ G/W/T.
 
-- TC ID mới = `TC-F{NNN}-{next_seq}`
-- Type: derive từ nhóm FAC (`e2e` / `consistency` / `NFR` / `data & migration`) — đọc context FAC để phân loại
-- Priority: theo bảng ở 3.3
-- Covers: `FAC-{F_ID}-{seq}`
-- Spans: list US IDs mà FAC liên quan (nếu FAC e2e)
-- Preconditions/Steps/Expected: dịch 1:1 từ Given/When/Then của FAC
+**D2. Non-Functional Test Cases** — mỗi `NFR-*` → 1 TC. Type: `performance` / `a11y` / `security` / ... (theo NFR). Covers `NFR-{F_ID}-{seq}`. Dịch 1:1 từ G/W/T.
+
+**D3. Data & Migration Test Cases** (required-emptyable) — mỗi `DM-*` → 1 TC. Type: `data migration`. Covers `DM-{F_ID}-{seq}`. Dịch 1:1 từ G/W/T. Frd không có DM entry → giữ heading, để section trống.
+
+> Mọi TC ở D / D2 / D3 dùng **chung sequence `TC-F{NNN}-{next_seq}`** — KHÔNG đẻ prefix riêng. Priority theo bảng ở 3.3.
 
 **E. Traceability Matrix** — row per frd item:
 
@@ -191,7 +190,9 @@ Với mỗi feature trong `features:`:
 - 1 row per US → cover by TC (Functional)
 - 1 row per Story AC → cover by TC (Functional)
 - 1 row per VR → cover by TC (Validation, list tất cả positive + negative)
-- 1 row per FAC → cover by TC (Feature AC)
+- 1 row per FAC → cover by TC (E2E)
+- 1 row per NFR → cover by TC (Non-functional)
+- 1 row per DM → cover by TC (Data & Migration)
 - Mọi item phải có cover ✅ (vì derive 1:1). Nếu agent không thể derive một item nào → đánh dấu ❌ + ghi lý do ở Gaps section, KHÔNG silent skip.
 
 #### 3.3 Priority defaults
@@ -208,19 +209,20 @@ Mọi TC đều có priority deterministic. QC override khi review (Bước 4).
 
 **TC cover VR** — inherit max priority của các US trong `Refs` column của VR. Nếu Refs trống → P1 default.
 
-**TC cover FAC** — theo nhóm FAC:
+**TC cover FAC / NFR / DM** — theo loại + section nguồn:
 
-| FAC group | TC Priority |
+| Loại | TC Priority |
 | --- | --- |
-| End-to-end liên story | P0 |
-| Cross-story consistency | P1 |
-| NFR — security / data integrity | P0 |
+| FAC — end-to-end (journey) | P0 |
+| FAC — integrity | P0 |
+| FAC — consistency | P1 |
+| NFR — security | P0 |
 | NFR — performance / a11y / i18n / browser | P1 |
 | Data & migration | P0 |
 
-#### 3.4 Diff vs current tsd.md
+#### 3.4 Diff vs current test-design.md
 
-Với feature có tsd.md hiện tại (operation=update):
+Với feature có test-design.md hiện tại (operation=update):
 
 - Item đã có TC cover → KHÔNG sinh TC mới, giữ nguyên TC cũ
 - Item trong frd nhưng chưa có TC cover → sinh TC mới với marker `[NEW]`
@@ -229,7 +231,7 @@ Với feature có tsd.md hiện tại (operation=update):
 
 Agent compute diff tự động — KHÔNG hỏi user "field nào đã đổi"; đọc 2 file rồi đối chiếu.
 
-**No-delta case:** nếu diff giữa frd hiện tại và tsd.md hiện tại = empty cho 1 feature (frd không thêm/đổi item nào mà tsd chưa cover) → **bỏ Changes block của feature đó hoàn toàn**, ghi `no-op` trong Cascade Summary để minh bạch.
+**No-delta case:** nếu diff giữa frd hiện tại và test-design.md hiện tại = empty cho 1 feature (frd không thêm/đổi item nào mà test-design chưa cover) → **bỏ Changes block của feature đó hoàn toàn**, ghi `no-op` trong Cascade Summary để minh bạch.
 
 #### 3.5 Placeholders cần QC fill
 
@@ -237,8 +239,7 @@ Agent **không suy đoán** các field sau, dùng placeholder rõ ràng để QC
 
 | Field | Placeholder | Vì sao agent không tự fill |
 | --- | --- | --- |
-| Environments table | Row mặc định: `dev / staging / prod-like` với `data set: TBD`, `mục đích: TBD` | Phụ thuộc setup CI/CD và availability — QC owns |
-| Test Data table | Row `{TBD — fixture}` cho mỗi seed/boundary dataset agent thấy cần | QC chọn fixture source thực tế |
+| Test Data Requirements | Row `{TBD — shape}` cho mỗi seed/boundary dataset agent thấy cần | QC xác định yêu cầu data (shape); nguồn/refresh thuộc execution |
 | Out of Scope | Để trống với note `<!-- QC fill -->` | Quyết định business của QC |
 | Test Strategy > Approach | Bullet generic theo template gốc | Strategy đặc thù integration QC fill |
 
@@ -249,8 +250,8 @@ Agent **không suy đoán** các field sau, dùng placeholder rõ ràng để QC
 Tổng hợp và viết draft `test.md` theo `templates/integrations/test-template.md`:
 
 - **Context** — tóm tắt từ Bước 2
-- **Test Strategy** — placeholder + Environments table với placeholder rows
-- **Changes** — 1 block per feature *có delta*, mỗi block có operation + content theo template gốc `templates/main/feature/tsd-template.md`. Feature no-delta → bỏ block.
+- **Test Strategy** — Approach delta đặc thù integration (KHÔNG có Environments table — env assignment thuộc execution)
+- **Changes** — 1 block per feature *có delta*, mỗi block có operation + content theo template gốc `templates/main/feature/test-design-template.md`. Feature no-delta → bỏ block.
 - **Out of Scope** — empty với note QC fill
 - **Open Questions** — list các item mà agent không thể derive deterministic (vd: FAC có wording vague, VR không rõ nhánh fail nào)
 - **Cascade Summary** — table liệt kê **tất cả** feature trong `features:` (kể cả no-delta — ghi `no-op`)
@@ -263,14 +264,14 @@ Hiển thị **toàn bộ draft** cho QC xem — **chưa ghi file, chưa cascade
 
 > Draft trên đã đúng chưa? QC điểm cần check:
 >
-> 1. **Mechanical derivation** — mỗi Flow / US / AC / VR / FAC trong frd đã có TC cover chưa? (xem Traceability Matrix)
+> 1. **Mechanical derivation** — mỗi Flow / US / AC / VR / FAC / NFR / DM trong frd đã có TC cover chưa? (xem Traceability Matrix)
 > 2. **Priority defaults** — có TC nào cần override khỏi default không?
-> 3. **Placeholders** — fill Environments / Test Data / Out of Scope / Strategy Approach.
+> 3. **Placeholders** — fill Test Data Requirements / Out of Scope / Strategy Approach.
 > 4. **Extra edge cases** — ngoài AC/VR có scenario nào QC muốn thêm? (vd: exploratory, security boundary, race condition không có trong AC)
 > 5. **Changes markers** — `[NEW]/[MODIFY]/[REMOVE]` có đúng không?
 > 6. **No-delta features** — Cascade Summary có ghi `no-op` đúng cho feature không có delta không?
 >
-> **Sau khi confirm, agent sẽ auto-apply tất cả Changes blocks lên feature tsd.md(s).**
+> **Sau khi confirm, agent sẽ auto-apply tất cả Changes blocks lên feature test-design.md(s).**
 
 Nếu QC yêu cầu chỉnh sửa:
 - Override priority → update draft
@@ -286,25 +287,25 @@ Chỉ tiến hành Bước 6 sau khi QC confirm.
 
 **[6.1] Ghi `.specs/integrations/{slug}/test.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` mirror từ `spec.md`. (test.md là integration artifact — **không** mang `template_version`; versioning chỉ áp dụng cho main artifacts, xem `conventions.md` §7.)
 
-**[6.2] Auto-apply mỗi Changes block** vào `feature/{F-XXX}/tsd.md` tương ứng. Thứ tự apply: theo thứ tự xuất hiện trong frontmatter `features` (deterministic, không có forward reference giữa các feature tsd.md). Bỏ qua feature có operation `no-op` trong Cascade Summary.
+**[6.2] Auto-apply mỗi Changes block** vào `feature/{F-XXX}/test-design.md` tương ứng. Thứ tự apply: theo thứ tự xuất hiện trong frontmatter `features` (deterministic, không có forward reference giữa các feature test-design.md). Bỏ qua feature có operation `no-op` trong Cascade Summary.
 
 Cho từng block:
 
 - **Operation=create:**
-  - Tạo file `.specs/main/feature/{F-XXX}-{slug}/tsd.md`
-  - Nội dung = nội dung của Changes block (theo format `templates/main/feature/tsd-template.md`)
-  - Frontmatter của tsd.md mới: status `draft` + `template_version` copy từ `tsd-template.md` (separate lifecycle với integration test.md). Chỉ stamp ở operation=create; **operation=update KHÔNG đụng** version của tsd.md hiện có.
+  - Tạo file `.specs/main/feature/{F-XXX}-{slug}/test-design.md`
+  - Nội dung = nội dung của Changes block (theo format `templates/main/feature/test-design-template.md`)
+  - Frontmatter của test-design.md mới: status `draft` + `template_version` copy từ `test-design-template.md` (separate lifecycle với integration test.md). Chỉ stamp ở operation=create; **operation=update KHÔNG đụng** version của test-design.md hiện có.
 
 - **Operation=update:**
-  - Đọc tsd.md hiện tại
+  - Đọc test-design.md hiện tại
   - Với mỗi TS/TC trong Changes block:
     - `[NEW]` → append/insert vào section tương ứng (giữ thứ tự numeric của ID)
     - `[MODIFY {field}]` → tìm TS/TC bằng ID, update field đã chỉ định, giữ nguyên field khác
-    - `[REMOVE]` → xóa TS/TC khỏi tsd.md (ID retire, không tái sử dụng)
+    - `[REMOVE]` → xóa TS/TC khỏi test-design.md (ID retire, không tái sử dụng)
   - Cập nhật Traceability Matrix: thêm row cho item mới, update row của item bị MODIFY, KHÔNG xóa row của REMOVE (đánh dấu retire)
-  - Ghi lại tsd.md
+  - Ghi lại test-design.md
 
-**[6.2.5] Append Change History entry** vào mỗi tsd.md bị touched (theo `conventions.md` §5.5). Đây là phần atomic của auto-apply — nếu fail thì rollback luôn.
+**[6.2.5] Append Change History entry** vào mỗi test-design.md bị touched (theo `conventions.md` §5.5). Đây là phần atomic của auto-apply — nếu fail thì rollback luôn.
 
 Format entry:
 
@@ -315,16 +316,16 @@ Format entry:
   - [marker] {TS/TC ID} — {mô tả ngắn 1 dòng}
 ```
 
-- Operation = `create` (tsd.md mới) | `update` (tsd.md đã tồn tại).
+- Operation = `create` (test-design.md mới) | `update` (test-design.md đã tồn tại).
 - Integration link trỏ tới `test.md` (không phải `spec.md`) — đây là cascade từ test.
-- Section name = tên section trong template tsd (`Test Scenarios`, `Functional Test Cases`, `Validation Test Cases`, `Feature AC Test Cases`, `Traceability Matrix`...).
+- Section name = tên section trong template test-design (`Test Scenarios`, `Functional Test Cases`, `Validation Test Cases`, `E2E Test Cases`, `Non-Functional Test Cases`, `Data & Migration Test Cases`, `Traceability Matrix`...).
 - Mọi TS/TC có marker trong Changes block phải xuất hiện ở entry, group theo section.
 - Với operation=create từ template trống (no Changes block content) → entry body có thể là `- **All sections**: initial scaffold`.
 
 **[6.3] Atomic rollback:** Nếu apply block nào fail (vd `[MODIFY TC-F001-005]` nhưng ID không tồn tại):
 1. Rollback các block đã apply trước đó về state ban đầu
 2. **Không** ghi integration test.md
-3. Báo lỗi cụ thể cho QC fix draft hoặc feature tsd.md hiện tại
+3. Báo lỗi cụ thể cho QC fix draft hoặc feature test-design.md hiện tại
 
 **[6.4] Thông báo kết quả:**
 
@@ -332,12 +333,12 @@ Format entry:
 ✓ .specs/integrations/{slug}/test.md đã được tạo (status: approved)
 
 Auto-cascade applied:
-  ✓ feature/F-XXX-{slug}/tsd.md — {created | updated: +N TS, +M TC, modify K TC, remove L TC}
-  ✓ feature/F-YYY-{slug}/tsd.md — no-op (frd không đổi)
+  ✓ feature/F-XXX-{slug}/test-design.md — {created | updated: +N TS, +M TC, modify K TC, remove L TC}
+  ✓ feature/F-YYY-{slug}/test-design.md — no-op (frd không đổi)
 
 Bước tiếp theo:
-  - QC: review feature tsd.md đã cascade, fill remaining TBD nếu có
-  - DEV: có thể run /plan nếu chưa có plan.md (plan.md hiện chưa consume tsd.md — test tasks tự QC manage trong test framework)
+  - QC: review feature test-design.md đã cascade, fill remaining TBD nếu có
+  - DEV: có thể run /plan nếu chưa có plan.md (plan.md hiện chưa consume test-design.md — test tasks tự QC manage trong test framework)
 ```
 
 ---
@@ -348,7 +349,7 @@ Bước tiếp theo:
 | --- | --- |
 | "TC có thể nghĩ ra khi chạy test" | Không document = không có traceability. AC pass/fail không kiểm tra được nếu không có TC mapping. |
 | "VR positive đủ rồi, negative skip" | Negative case là nơi bug ẩn. Mỗi nhánh fail của VR phải có TC riêng. |
-| "Priority để default hết P1 cho nhanh" | Priority decorative thì cũng phải đúng — derive deterministic từ US Priority/FAC group. P1 hàng loạt = QC chưa nhìn frd. |
+| "Priority để default hết P1 cho nhanh" | Priority decorative thì cũng phải đúng — derive deterministic từ US Priority/loại requirement (FAC/NFR/DM). P1 hàng loạt = QC chưa nhìn frd. |
 | "Out of Scope để trống cũng được" | Mọi integration đều có thứ không test. Trống = scope creep hoặc gap không kiểm soát. |
 
 ## Red Flags
@@ -357,8 +358,8 @@ Bước tiếp theo:
 - TC có Covers trống → không trace được lên frd
 - VR có ít hơn 2 TC (1 positive + 1+ negative) → coverage thiếu
 - Priority hàng loạt giống nhau cho mọi TC → QC chưa override default
-- Test Data toàn `TBD` sau khi QC review → chưa thật sự confirm
-- Changes block có marker `[NEW]` cho TC trùng ID với TC đã có trong tsd.md hiện tại → diff bug
+- Test Data Requirements toàn `TBD` sau khi QC review → chưa thật sự confirm
+- Changes block có marker `[NEW]` cho TC trùng ID với TC đã có trong test-design.md hiện tại → diff bug
 - Cascade Summary thiếu row cho feature trong `features:` (kể cả no-op) → không minh bạch
 
 ## Verification
@@ -368,17 +369,17 @@ Trước khi QC confirm (Bước 5), kiểm tra:
 - [ ] Mỗi Flow trong frd có 1 TS tương ứng
 - [ ] Mỗi US AC có TC Functional cover
 - [ ] Mỗi VR có ≥1 positive + ≥1 negative TC
-- [ ] Mỗi FAC có TC Feature AC cover
+- [ ] Mỗi FAC có TC E2E cover; mỗi NFR có TC Non-functional; mỗi DM có TC Data & Migration
 - [ ] Traceability Matrix đầy đủ (không ❌ mà không giải thích)
 - [ ] Priority deterministic theo bảng 3.3 (default), QC override visible
 - [ ] ID assignment từ max(seq)+1, không tái sử dụng, không renumber
-- [ ] Markers `[NEW]/[MODIFY {field}]/[REMOVE]` khớp diff vs current tsd.md
+- [ ] Markers `[NEW]/[MODIFY {field}]/[REMOVE]` khớp diff vs current test-design.md
 - [ ] Feature no-delta được ghi `no-op` trong Cascade Summary, KHÔNG có Changes block
 
 Sau khi QC confirm (Bước 6):
 
 - [ ] Auto-apply theo thứ tự features trong frontmatter
-- [ ] Mỗi tsd.md bị touched có entry mới trong `## Change History` (conventions §5.5)
+- [ ] Mỗi test-design.md bị touched có entry mới trong `## Change History` (conventions §5.5)
 - [ ] Fail-safe: nếu apply fail thì không ghi integration test.md (rollback luôn Change History entries)
-- [ ] Mỗi feature tsd.md mới có status `draft` (separate lifecycle)
-- [ ] Main artifact tsd.md create có `template_version` copy từ template; tsd.md update giữ nguyên version cũ. test.md (integration) KHÔNG mang `template_version`
+- [ ] Mỗi feature test-design.md mới có status `draft` (separate lifecycle)
+- [ ] Main artifact test-design.md create có `template_version` copy từ template; test-design.md update giữ nguyên version cũ. test.md (integration) KHÔNG mang `template_version`