spec-lite 1.5.2 → 1.7.0

package/skills/spec-test-exec/SKILL.md

@@ -0,0 +1,251 @@
+---
+name: spec-test-exec
+description: Sinh bundle test-executions cho MỘT feature — render Test Cases trong test-design.md thành các doc thực thi theo harness (func-manual/auto, e2e-manual/auto, nfr, dm). Đọc-xuống từ test-design (source of truth), inherit TC-F* nguyên văn, KHÔNG đẻ ID mới. Mỗi lần chạy = bundle đánh số mới, ephemeral per test cycle.
+---
+
+# spec-test-exec
+
+## Overview
+
+Sinh một **cycle bundle test-executions** cho một feature vào `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` — render các Test Case đã thiết kế ở `test-design.md` thành **doc thực thi** theo từng **harness** (manual GUI walk / automation / tool đặc thù / migration script). Plane 2 tầng: feature group (`{F-XXX}-{slug}/`) → cycle bundle (`{NNN}-{cycle-slug}/`); `{NNN}` reset per-feature (xem `conventions.md` §8.1).
+
+**Vị trí trong 3 layer** (xem `conventions.md` §8):
+
+```
+frd.md ──(/spec-test | /spec-test-design)──▶ test-design.md ──(/spec-test-exec)──▶ test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/
+         [DESIGN — TC là gì]                 [SOURCE OF TRUTH]  [EXECUTION — chạy bằng harness gì]
+```
+
+**Cốt lõi — đọc xuống, KHÔNG sáng tạo:**
+- test-design.md là **source of truth** của bộ Test Case. Skill này **chỉ đọc** test-design → route TC vào doc theo section nguồn + harness.
+- **Inherit `TC-F*` nguyên văn** — KHÔNG đẻ ID mới, KHÔNG renumber. (`{PREFIX}_E2E_*` nếu dùng chỉ là title `test.describe` trong code, không phải ID artifact.)
+- Mỗi lần chạy = **bundle đánh số mới** (snapshot độc lập từ test-design hiện tại). **KHÔNG** carry-over result, **KHÔNG** link chuỗi với bundle cũ.
+
+**KHÔNG versioned:** doc test-exec không mang `template_version`/`migrations` — derived, ngoài scope `/artifact-audit` + `/artifact-migrate` (xem `conventions.md` §7 + §8.1).
+
+## When to Use
+
+- Một feature đã có `test-design.md` và cần sinh doc thực thi để bắt đầu một **chu kỳ test** (regression release, sprint test, UAT...).
+- test-design.md vừa cập nhật (qua `/spec-test`) → cần một bundle thực thi mới phản ánh TC hiện tại.
+
+## When NOT to Use
+
+- Feature **chưa có** `test-design.md` → chạy `/spec-test` (qua integration) hoặc `/spec-test-design` (bootstrap) trước.
+- Muốn **thêm/đổi TC** → KHÔNG sửa ở đây (test-exec chỉ đọc). Sửa test-design qua `/spec-test`, rồi sinh lại bundle.
+- Chỉ muốn cập nhật **kết quả thực thi** (Test Result) → edit doc trong bundle trực tiếp (đó là việc của owner khi chạy test), không chạy lại skill.
+
+---
+
+## Process
+
+### Bước 1: Xác định feature
+
+`/spec-test-exec` thao tác trên **đúng một feature**.
+
+**Nếu có ARGUMENT:**
+- Parse: feature ID (`F-012`, `012`) hoặc slug (`F-012-bulk-import`, `bulk-import`).
+- Quét `.specs/main/feature/*/test-design.md`, tìm feature khớp.
+- Không khớp → báo lỗi:
+  > Không tìm thấy feature có test-design.md khớp với "{argument}". Kiểm tra `.specs/main/feature/`.
+
+**Nếu không có ARGUMENT:**
+
+Quét `.specs/main/feature/`. Liệt kê features **có `test-design.md`**, kèm các cycle bundle hiện có trong feature group:
+
+```
+Features có test-design.md:
+
+  [1] F-012 — bulk-import   test-design: approved   cycles: 001-regression, 002-release-2.0
+  [2] F-031 — checkout      test-design: draft       cycles: —
+
+Chọn số feature:
+```
+
+Không feature nào có test-design.md → dừng:
+> Chưa có feature nào có test-design.md. Chạy `/spec-test` hoặc `/spec-test-design` trước.
+
+---
+
+### Bước 2: Gate check + phát hiện section điều kiện
+
+Đọc `.specs/main/feature/{F-XXX}-{slug}/test-design.md`.
+
+**Check 1 — test-design.md tồn tại:** nếu không → dừng (đã xử lý ở Bước 1).
+
+**Check 2 — status (cảnh báo, KHÔNG block):**
+
+Nếu `status` **không phải** `approved`:
+> ⚠ `test-design.md` của **{F-XXX}** đang ở `status: {status}` (chưa approved — có thể còn placeholder TBD ở Test Data / Strategy / Out of Scope).
+>
+> Bundle sinh ra sẽ kế thừa các placeholder đó. Tiếp tục? (yes / no — default yes)
+
+`no` → dừng, gợi ý approve test-design trước.
+
+**Check 3 — phát hiện section required-emptyable rỗng (quyết định nfr/dm):**
+
+Đọc 2 section của test-design:
+- `## Non-Functional Test Cases` — có TC block (`### TC-F...`) không?
+- `## Data & Migration Test Cases` — có TC block không?
+
+Quy tắc (xem `conventions.md` §8.2):
+- Section có ≥1 TC → **sẽ sinh** doc tương ứng (`test-exec-nfr.md` / `test-exec-dm.md`).
+- Section rỗng (chỉ heading, không TC) → **BỎ QUA** doc đó.
+
+Báo lại cho user:
+```
+test-design F-012:
+  Functional TC: 8   Validation TC: 12   E2E TC: 3   NFR TC: 2   DM TC: 0
+→ Sẽ sinh: func-manual, func-auto, e2e-manual, e2e-auto, nfr   (BỎ dm — section rỗng)
+```
+
+---
+
+### Bước 3: Cấp feature group + cycle bundle
+
+**Feature group** `{F-XXX}-{slug}/` — mirror tên thư mục `main/feature/{F-XXX}-{slug}/`. Chưa tồn tại → tạo mới; đã có → dùng lại (gom cycle).
+
+**Cycle number `{NNN}`** — đánh số **per-feature** (reset trong mỗi feature group):
+- Quét max `{NNN}` của các cycle bundle **trong feature group đó**:
+  - `.specs/test-executions/{F-XXX}-{slug}/*/` (active)
+  - `.specs/archive/**/` thuộc cùng feature (cycle đã archive)
+- `{NNN}` mới = max + 1, zero-padded 3 chữ số. Feature group rỗng → `001`.
+
+**Cycle slug** — kebab-case mô tả **chu kỳ test** (vd `regression`, `release-2.0`, `smoke`). KHÔNG nhúng `{F-XXX}` (đã ở tầng feature group). Hỏi user (mặc định gợi ý theo ngữ cảnh):
+
+> Cycle mới: `F-012-bulk-import/003-regression`. Đổi cycle-slug? (Enter để giữ)
+
+**Cảnh báo clobber:** nếu tên cycle trùng một bundle đã có trong feature group → cảnh báo, KHÔNG ghi đè (đề nghị số mới hoặc archive cycle cũ trước).
+
+---
+
+### Bước 4: Route TC → bucket + completeness check
+
+**Đọc toàn bộ TC từ test-design**, gom theo section nguồn:
+
+| Section test-design | Bucket scope | TC fields đọc được |
+| --- | --- | --- |
+| `## Functional Test Cases` | func | Type, **Autoable**, Priority, Covers, Scenario, Preconditions, Steps, Expected, Test data |
+| `## Validation Test Cases` | func | TC ID, Covers VR, Field, Input, Expected, Polarity (**Autoable=YES** uniform) |
+| `## E2E Test Cases` | e2e | Type (journey/consistency/integrity), Priority, Covers FAC, Spans, Preconditions, Steps, Expected |
+| `## Non-Functional Test Cases` | nfr | Type, Priority, Covers NFR, Preconditions, Steps, Expected |
+| `## Data & Migration Test Cases` | dm | Type, Priority, Covers DM, Preconditions, Steps, Expected |
+
+**Route vào doc:**
+
+| Doc | Lấy TC nào |
+| --- | --- |
+| `test-exec-func-manual` | **TOÀN BỘ** Functional + Validation TC (bất kể Autoable) |
+| `test-exec-func-auto` | Functional + Validation TC có **`Autoable ∈ {YES, MAYBE}`** (Validation đều YES) |
+| `test-exec-e2e-manual` | **TOÀN BỘ** E2E TC |
+| `test-exec-e2e-auto` | **TOÀN BỘ** E2E TC (cùng tập với e2e-manual — hai harness thay thế) |
+| `test-exec-nfr` | Non-Functional TC *(bỏ doc nếu rỗng)* |
+| `test-exec-dm` | Data & Migration TC *(bỏ doc nếu rỗng)* |
+
+**Completeness check (BẮT BUỘC trước khi ghi):**
+- Tập `TC-F*` ở 4 **scope bucket** (func ∪ e2e ∪ nfr ∪ dm) phải **bằng** tập TC trong `test-design > Traceability Matrix`.
+- Mỗi `TC-F*` rơi **đúng 1 scope bucket** (func/e2e/nfr/dm) — không lọt, không trùng scope. *(Cùng 1 TC xuất hiện ở cả func-manual lẫn func-auto là ĐÚNG — đó là hai harness của cùng scope func, không tính trùng.)*
+- func-auto là **tập con** của func-manual (chỉ Autoable=YES/MAYBE) — phần `Autoable=NO` chỉ ở manual.
+- Lỗi (TC không route được / TC thừa không có trong Matrix / section nguồn không parse được) → **dừng, báo cụ thể**, KHÔNG ghi bundle nửa vời.
+
+---
+
+### Bước 5: Sinh doc từ template
+
+Với mỗi doc cần sinh, copy từ `templates/test-executions/test-exec-{...}-template.md` rồi điền:
+
+**Frontmatter (`conventions.md` §8.5):**
+- `id: test-exec-{kind}-{F-XXX}-{NNN}-{cycle-slug}` · `type: test-exec-{kind}` · `feature_id: {F-XXX}` · `status: draft`
+- `test_design_ref: main/feature/{F-XXX}-{slug}/test-design.md` (từ `.specs/` root — không phụ thuộc độ sâu bundle)
+- func/e2e: `alt_harness_{auto|manual}: ./test-exec-{...}.md` (relative, cùng bundle)
+- Markdown link tới test-design trong body: bundle sâu 2 tầng → `../../../main/feature/{F-XXX}-{slug}/test-design.md`.
+- **KHÔNG** `template_version`/`migrations`.
+
+**Inherit (đọc xuống — KHÔNG suy diễn lại):**
+- `TC-F*` ID, `Covers`, `Type`, `Priority`, `Preconditions`, `Steps`, `Expected` → copy **nguyên văn** từ test-design vào bảng Coverage + Test Cases của doc.
+- `Autoable` (func) → copy y nguyên; func-auto chỉ chứa YES/MAYBE.
+
+**Placeholder cho owner điền khi chạy** (KHÔNG tự bịa):
+- **Test Result / Status (CI)** → `—` (chưa chạy).
+- **Execution Locators / Test File / POM** → `_Pending — {owner}_`.
+- **Tool / Command / Layer** (nfr/auto) → gợi ý theo Type nếu suy được (vd NFR performance → `k6`), còn lại để placeholder.
+- Account/Role matrix, Env tiers, Seed, Fixtures → giữ skeleton template để owner điền theo môi trường.
+
+**Coverage tables:** điền từ Traceability Matrix (AC/VR/FAC/NFR/DM → TC IDs) — KHÔNG dựng matrix cạnh tranh; coverage master vẫn ở test-design.
+
+Hiển thị **tóm tắt bundle** (không dump toàn bộ) cho user xem trước khi ghi:
+```
+Cycle F-012-bulk-import/003-regression — sẽ ghi 5 doc:
+  func-manual : 20 TC (8 func + 12 val)        [toàn bộ]
+  func-auto   : 18 TC (Autoable YES/MAYBE)      [2 TC Autoable=NO chỉ ở manual]
+  e2e-manual  : 3 TC
+  e2e-auto    : 3 TC
+  nfr         : 2 TC
+  (dm: bỏ — rỗng)
+Completeness: 25/25 TC ở Traceability Matrix đều routed ✓
+```
+
+---
+
+### Bước 6: Ghi bundle + báo cáo
+
+**[6.1]** Tạo `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` (tạo feature group nếu chưa có), ghi từng doc (status `draft`).
+
+**[6.2]** KHÔNG cascade, KHÔNG đụng test-design (đọc-xuống one-way). KHÔNG ghi Change History vào test-design (test-exec không phải nguồn cascade).
+
+**[6.3] Báo cáo:**
+```
+✓ .specs/test-executions/F-012-bulk-import/003-regression/ (từ test-design.md)
+  ✓ test-exec-func-manual.md   — 20 TC
+  ✓ test-exec-func-auto.md     — 18 TC (Autoable YES/MAYBE)
+  ✓ test-exec-e2e-manual.md    — 3 TC
+  ✓ test-exec-e2e-auto.md      — 3 TC
+  ✓ test-exec-nfr.md           — 2 TC
+  (dm bỏ qua — test-design Data & Migration rỗng)
+
+Bước tiếp theo (team chọn harness theo kỹ năng — xem terms/003/004):
+  - func: chạy func-manual (QC) HOẶC func-auto (DEV/SE). Lưu ý auto-only LỌT exploratory + Autoable=NO.
+  - e2e:  chọn 1 trong e2e-manual (QC) / e2e-auto (SE) — thay thế hoàn toàn.
+  - nfr:  SDET/specialist chạy bằng tool tương ứng.
+  - Xóa doc harness không dùng (sinh hết để team chọn).
+  - Điền Test Result / Status khi chạy.
+```
+
+---
+
+## Common Rationalizations
+
+| Rationalization | Reality |
+| --- | --- |
+| "Thêm TC ngay trong bundle cho nhanh" | test-exec chỉ đọc xuống. TC mới phải vào test-design trước (qua `/spec-test`) rồi sinh lại — nếu không sẽ vỡ traceability + ID authority. |
+| "Đổi TC ID cho gọn lại" | ID `TC-F*` do test-design làm chủ, stable. Renumber ở đây phá liên kết với test code + Traceability Matrix. |
+| "Auto chạy pass hết là xong" | func-auto LỌT exploratory + `Autoable=NO` (visual). Manual-only mới đầy đủ scope func (terms/004). |
+| "Sinh thiếu vài doc cho nhanh" | Sinh hết (6 hoặc 4) để team chọn harness. Thiếu = ép harness sai với kỹ năng team. |
+| "Regenerate đè bundle cũ" | Mỗi cycle = bundle số mới. Đè bundle đã có Test Result = mất lịch sử thực thi. |
+
+## Red Flags
+
+- Có `TC-F*` ở test-design Traceability Matrix nhưng không xuất hiện ở doc nào → completeness fail (lọt).
+- Một `TC-F*` rơi vào >1 scope bucket (vd vừa func vừa e2e) → routing bug.
+- func-auto chứa TC `Autoable=NO` → sai filter.
+- Doc test-exec mang `template_version` → sai (test-exec không versioned).
+- Ghi đè bundle cũ đang có Test Result mà không cảnh báo.
+- Bịa Test Result / Locators / Tool thay vì để placeholder.
+- Sửa test-design trong lúc chạy skill (skill này read-only với test-design).
+
+## Verification
+
+Trước khi ghi bundle:
+
+- [ ] Đúng một feature; test-design.md tồn tại (cảnh báo nếu draft, không block).
+- [ ] nfr/dm: chỉ sinh khi section nguồn có TC; rỗng → bỏ doc.
+- [ ] Feature group `{F-XXX}-{slug}/` (mirror main/feature); `{NNN}` = max cycle **trong feature group đó** (active + archived) + 1 (reset per-feature); cycle-slug mô tả chu kỳ.
+- [ ] Route đúng: func ← Functional+Validation (manual=toàn bộ, auto=Autoable YES/MAYBE); e2e ← E2E (cả 2 harness cùng tập); nfr ← Non-Functional; dm ← Data & Migration.
+- [ ] **Completeness**: mọi `TC-F*` ở Traceability Matrix routed đúng 1 scope bucket — không lọt/trùng.
+- [ ] Inherit `TC-F*` + fields nguyên văn; KHÔNG ID mới, KHÔNG renumber.
+- [ ] Frontmatter: `id/type/feature_id/test_design_ref/alt_harness_*` đúng; KHÔNG `template_version`.
+- [ ] Test Result/Status/Locators = placeholder, không bịa.
+
+Sau khi ghi:
+
+- [ ] Bundle tại `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` với 6 (hoặc 4) doc, status `draft`.
+- [ ] KHÔNG đụng test-design (one-way đọc xuống, không cascade, không Change History).

package/skills-overview.md

@@ -62,14 +62,14 @@ Nhận F-XXX từ argument (hoặc chọn từ prd Feature Index) + tùy chọn
 - **Create-only**: frd.md của feature mục tiêu **chưa tồn tại**. Đã tồn tại → **dừng, redirect `/spec-new`** (thay đổi feature đã spec phải đi qua integration để delta cascade + kéo theo `/spec-tech`/`/spec-test`).
 - Feature mới **đơn lẻ** chưa có trong Index → offer **register một row vào `prd.md > Features`** rồi author.
 
-**Sections template** (7): Overview · User Flows · Feature Acceptance Criteria · User Stories · Verification Rules · Scope · Dependencies
+**Sections template**: Overview · User Flows · Feature Acceptance Criteria (end-to-end) · Non-Functional Requirements · Data & Migration *(nếu có)* · User Stories · Verification Rules · Scope · Dependencies
 
 **Phạm vi hẹp — chủ yếu `frd.md`:**
 - Reference component frd phụ thuộc (Components Used → C-XXX có sẵn).
 - Component cần-nhưng-chưa-có → ghi *candidate* + Open Question cho `/spec-sad`/architect chốt boundary.
 - Có thể register **một** feature row vào prd (side-effect lên prd).
 - **Cascade vocabulary lên `domain.md`** (pha mô tả/WHAT): glossary term + **định nghĩa shared entity** (attributes), `Owner: TBD` để `/spec-sad` gán ở pha thiết kế (HOW). BA define entity, KHÔNG carve/gán Owner.
-- **KHÔNG** tạo `crd.md`/`cdd.md` (sinh ở integration time qua `/spec-new` cascade), không tạo `fdd.md`/`tsd.md`, không đổi status feature đã có, không đụng sad.
+- **KHÔNG** tạo `crd.md`/`cdd.md` (sinh ở integration time qua `/spec-new` cascade), không tạo `fdd.md`/`test-design.md`, không đổi status feature đã có, không đụng sad.
 - Change History operation = `manual` (cả frd lẫn domain). Verification Rules dùng quy ước option-suggester của `/spec-new` (BA owns).
 
 Bỏ qua bước này cũng được — `/spec-new` sẽ tự tạo frd làm fallback khi integration đầu tiên chạm tới feature.
@@ -94,14 +94,14 @@ Bỏ qua bước này cũng được — `/spec-new` sẽ tự tạo frd làm fa
 
 Dùng khi onboarding một project đã có code vào SDD. Mục tiêu: extract main artifacts từ codebase hiện có, sau đó chuyển vào **Integration Pipeline** để implement.
 
-**Thứ tự bắt buộc:** `init` → `component` → `feature` → `tsd` *(tùy chọn — bootstrap test coverage tracking)*
+**Thứ tự bắt buộc:** `init` → `component` → `feature` → `test-design` *(tùy chọn — bootstrap test coverage tracking)*
 
 | Command | Scan | Reads | Writes |
 | --- | --- | --- | --- |
 | `/spec-brownfield-init [path]` | tech stack, README, auth, infra | attachments | `prd.md` *(no indexes)*, `domain.md` *(glossary only)*, `sad.md` |
 | `/spec-brownfield-component [path]` | module dirs, service/controller/entity files | `prd.md`, `domain.md` | `component/{C-XXX}-*/crd.md + cdd.md`; update `prd.md` Component Index; cascade Shared Entities → `domain.md` |
 | `/spec-brownfield-feature [path]` | use cases, routes, test files | `prd.md`, `domain.md`, `component/*/crd.md` | `feature/{F-XXX}-*/frd.md + fdd.md`; update `prd.md` Feature Index |
-| `/spec-tsd [F-XXX]` | — *(không scan code, derive 100% từ frd)* | `feature/{F-XXX}-*/frd.md`, `fdd.md` *(optional)* | `feature/{F-XXX}-*/tsd.md` |
+| `/spec-test-design [F-XXX]` | — *(không scan code, derive 100% từ frd)* | `feature/{F-XXX}-*/frd.md`, `fdd.md` *(optional)* | `feature/{F-XXX}-*/test-design.md` |
 
 ### Phân chia trách nhiệm
 
@@ -173,21 +173,21 @@ Component Index và Feature Index **để placeholder** — sẽ được điề
 
 ---
 
-### `/spec-tsd [F-XXX]`
+### `/spec-test-design [F-XXX]`
 
-**Mục tiêu:** Bootstrap `tsd.md` (Test Spec Document) cho một feature trực tiếp từ frd.md — mechanical derive Test Scenarios + Test Cases. KHÔNG cần integration.
+**Mục tiêu:** Bootstrap `test-design.md` (Test Design Document) cho một feature trực tiếp từ frd.md — mechanical derive Test Scenarios + Test Cases. KHÔNG cần integration.
 
 **Khi nào dùng:**
-- **Brownfield onboarding** — sau `/spec-brownfield-feature` đã sinh frd.md, chạy `/spec-tsd` cho từng feature để có test coverage tracking từ ngày 1.
-- **Greenfield deferred** — feature đã có frd.md từ lâu nhưng tsd.md chưa được tạo.
-- **Ad-hoc rebuild** — tsd drift khỏi frd, regenerate fresh.
+- **Brownfield onboarding** — sau `/spec-brownfield-feature` đã sinh frd.md, chạy `/spec-test-design` cho từng feature để có test coverage tracking từ ngày 1.
+- **Greenfield deferred** — feature đã có frd.md từ lâu nhưng test-design.md chưa được tạo.
+- **Ad-hoc rebuild** — test-design drift khỏi frd, regenerate fresh.
 
 **Khi nào KHÔNG dùng:**
-- Có integration cascade từ spec.md → frd → muốn cập nhật tsd theo changeset → dùng `/spec-test` (preserve ID stable).
+- Có integration cascade từ spec.md → frd → muốn cập nhật test-design theo changeset → dùng `/spec-test` (preserve ID stable).
 
-**Derivation:** mechanical 1:1 từ frd — mỗi Flow → TS, mỗi US/AC → Functional TC, mỗi VR → ≥1 positive + 1+ negative Validation TC, mỗi FAC → Feature AC TC. Priority deterministic theo US Priority + FAC group. KHÔNG interview.
+**Derivation:** mechanical 1:1 từ frd — mỗi Flow → TS, mỗi US/AC → Functional TC, mỗi VR → ≥1 positive + 1+ negative Validation TC, mỗi FAC → E2E TC, mỗi NFR → Non-functional TC, mỗi DM → Data & Migration TC. Priority deterministic theo US Priority + loại requirement. KHÔNG interview.
 
-**Cảnh báo overwrite:** nếu tsd.md đã tồn tại, skill hỏi confirm rõ ràng — regenerate sẽ reassign IDs từ 001 và làm vỡ test code references nếu có.
+**Cảnh báo overwrite:** nếu test-design.md đã tồn tại, skill hỏi confirm rõ ràng — regenerate sẽ reassign IDs từ 001 và làm vỡ test code references nếu có.
 
 ---
 
@@ -203,7 +203,7 @@ Component Index và Feature Index **để placeholder** — sẽ được điề
 /spec-brownfield-feature [path]
          │
          ▼
-/spec-tsd [F-XXX]   (tùy chọn — chạy cho mỗi feature để bootstrap tsd.md)
+/spec-test-design [F-XXX]   (tùy chọn — chạy cho mỗi feature để bootstrap test-design.md)
          │
          ▼
 (fill in NEEDS_CLARIFY items khi có thêm context)
@@ -225,7 +225,7 @@ Nhóm skill dọn dẹp / migrate artifacts hiện có sau khi template được
 
 ### `/artifact-audit [type]`
 
-Phát hiện **main artifact** lỗi thời so với template (xem `conventions.md` §7 Template Versioning). So `template_version` của artifact với `template_version` đọc thẳng từ template tại `.claude/templates/main/` — không manifest, không cache. **Chỉ main artifacts** (`prd`/`domain`/`sad`/`frd`/`fdd`/`tsd`/`crd`/`cdd`); integration artifacts ngoài scope.
+Phát hiện **main artifact** lỗi thời so với template (xem `conventions.md` §7 Template Versioning). So `template_version` của artifact với `template_version` đọc thẳng từ template tại `.claude/templates/main/` — không manifest, không cache. **Chỉ main artifacts** (`prd`/`domain`/`sad`/`frd`/`fdd`/`test-design`/`crd`/`cdd`); integration artifacts ngoài scope.
 
 **Scope:** argument là 1 main type (`/artifact-audit frd`) hoặc list (`frd,crd`); không có arg → audit mọi main type. Type resolve theo **filename**.
 
@@ -260,11 +260,12 @@ Sau khi main artifacts đã sẵn sàng (từ greenfield hoặc brownfield), m
 | --- | --- | --- |
 | `/spec-new [requirement]` | `prd.md`, `domain.md`, frd(s), crd(s) | `.specs/integrations/{slug}/spec.md` |
 | `/spec-tech [number]` | `sad.md`, `domain.md`, cdd(s), fdd(s), `spec.md` | `.specs/integrations/{slug}/tech.md` |
-| `/spec-test [number]` | `spec.md`, frd(s), tsd(s), `tech.md` *(optional)* | `.specs/integrations/{slug}/test.md`, `feature/{F-XXX}/tsd.md` |
+| `/spec-test [number]` | `spec.md`, frd(s), test-design(s), `tech.md` *(optional)* | `.specs/integrations/{slug}/test.md`, `feature/{F-XXX}/test-design.md` |
+| `/spec-test-exec [F-XXX]` *(feature-level, sau khi có test-design)* | `feature/{F-XXX}/test-design.md` | `.specs/test-executions/{F-XXX}-*/{NNN}-*/test-exec-*.md` |
 | `/plan` | `spec.md`, `tech.md`, `domain.md` | `plan.md`, `todo.md` |
 | `/build` | `plan.md`, `todo.md` | *(source code)* |
 | `/review-integration` | `spec.md`, `tech.md`, `plan.md`, `todo.md`, *(source code)* | *(findings report)* |
-| `/archive` | `.specs/integrations/` | `.specs/archive/` |
+| `/archive` | `.specs/integrations/`, `.specs/test-executions/` | `.specs/archive/{integrations,test-executions}/` |
 
 ### `/spec-new [requirement]`
 
@@ -308,21 +309,34 @@ Tạo `.specs/integrations/{slug}/test.md` cho một integration. Chạy bởi *
 
 **Luôn hiển thị danh sách tất cả integrations** trong `.specs/integrations/`, đánh dấu `✓` những cái đã có `test.md`. Nếu có argument → chọn luôn không cần hiển thị.
 
-**Gate check:** spec.md phải `approved` + `features:` non-empty. Integration có `features: []` (thuần component) → dừng vì component-level `tsd` không tồn tại trong kit này.
+**Gate check:** spec.md phải `approved` + `features:` non-empty. Integration có `features: []` (thuần component) → dừng vì component-level `test-design` không tồn tại trong kit này.
 
-Context load: `spec.md` + `frd.md` (cho mỗi feature — source của TC) + `tsd.md` (cho mỗi feature nếu tồn tại, để diff và assign next ID) + `tech.md` *(optional, hint env / data set / NFR threshold)*.
+Context load: `spec.md` + `frd.md` (cho mỗi feature — source của TC) + `test-design.md` (cho mỗi feature nếu tồn tại, để diff và assign next ID) + `tech.md` *(optional, hint env / data set / NFR threshold)*.
 
 **KHÔNG interview** — agent **mechanical derive** TC từ frd.md:
 - mỗi Flow → 1 Test Scenario (`TS-F{NNN}-{seq}`)
 - mỗi US AC → 1 Functional TC
 - mỗi VR → 1 positive + 1+ negative Validation TC
-- mỗi FAC → 1 Feature AC TC (theo nhóm e2e / consistency / NFR / data & migration)
+- mỗi FAC → 1 E2E TC (Type e2e / consistency)
+- mỗi NFR → 1 Non-functional TC; mỗi DM → 1 Data & Migration TC
 
-Priority deterministic: US Priority Must/Should/Could → P0/P1/P2 (TC cover US/AC); VR → inherit max priority của Refs; FAC e2e/security/data → P0, consistency/perf/a11y → P1.
+Priority deterministic: US Priority Must/Should/Could → P0/P1/P2 (TC cover US/AC); VR → inherit max priority của Refs; FAC e2e + NFR security + DM → P0, FAC consistency + NFR perf/a11y → P1.
 
-**Cascade Proposals** đề xuất delta cho mỗi `feature/{F-XXX}/tsd.md` qua Changes blocks với markers `[NEW]/[MODIFY {field}]/[REMOVE]`. Feature no-delta → **bỏ block hoàn toàn**, ghi `no-op` trong Cascade Summary.
+**Cascade Proposals** đề xuất delta cho mỗi `feature/{F-XXX}/test-design.md` qua Changes blocks với markers `[NEW]/[MODIFY {field}]/[REMOVE]`. Feature no-delta → **bỏ block hoàn toàn**, ghi `no-op` trong Cascade Summary.
 
-QC review: override priority defaults, fill placeholders (env / data / OOS / strategy), add extra edge cases ngoài AC/VR nếu thấy cần. Sau confirm → auto-cascade ghi tsd.md.
+QC review: override priority defaults, fill placeholders (env / data / OOS / strategy), add extra edge cases ngoài AC/VR nếu thấy cần. Sau confirm → auto-cascade ghi test-design.md.
+
+---
+
+### `/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). Feature-level, chạy *sau* khi feature đã có test-design (không thuộc per-integration pipeline).
+
+**Cách chạy:** `/spec-test-exec` (list feature có test-design) hoặc `/spec-test-exec F-012`.
+
+**Output:** cycle bundle `.specs/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/` (plane 2 tầng — feature group → cycle bundle, `{NNN}` reset per-feature, ephemeral per chu kỳ test). Mỗi lần chạy = cycle mới.
+
+Route TC theo **section nguồn + Autoable**, sinh **tới 6 doc** (4 nếu feature không NFR/DM): `func-manual` (toàn bộ Functional+Validation), `func-auto` (Autoable=YES/MAYBE), `e2e-manual` + `e2e-auto` (toàn bộ E2E), `nfr`, `dm` *(nfr/dm bỏ nếu section rỗng)*. **Sinh hết để team chọn harness** theo kỹ năng (e2e: manual⇄auto thay thế hoàn toàn; func: auto-only lọt exploratory/visual). **Inherit `TC-F*` nguyên văn** (không đẻ ID) + completeness check mọi TC ở Traceability Matrix rơi đúng 1 scope bucket. KHÔNG versioned. Chi tiết: `conventions.md` §8, `terms/003`+`004`.
 
 ---
 
@@ -384,17 +398,17 @@ Review implementation sau `/build` theo năm trục: correctness, readability, a
 
 ### `/archive`
 
-Di chuyển integration đã hoàn thành hoặc không còn active từ `.specs/integrations/` sang `.specs/archive/` để dọn dẹp thư mục làm việc chính.
+Di chuyển artifact đã hoàn thành / không còn active sang `.specs/archive/` — hỗ trợ **cả 2 plane** và **namespace theo loại**.
 
-**Bước 1 — Kiểm tra thư mục:** Tự động tạo `.specs/archive/` nếu chưa tồn tại.
+**Bước 1 — Chuẩn bị:** Tạo lazy subfolder theo loại — `.specs/archive/integrations/` và/hoặc `.specs/archive/test-executions/`.
 
-**Bước 2 — Liệt kê:** Quét `.specs/integrations/`, hiển thị numbered list kèm status (đọc từ `spec.md` nếu có). Nếu không có integration nào → thông báo và dừng.
+**Bước 2 — Liệt kê:** Quét `.specs/integrations/` (mỗi `{id}-{slug}/`) và `.specs/test-executions/` (mỗi cycle bundle `{F-XXX}-{slug}/{NNN}-{cycle-slug}/`, + tùy chọn cả feature group). Hiển thị 2 section đánh số liên tục. Cả hai rỗng → dừng.
 
-**Bước 3 — Xác nhận:** Hiển thị preview mapping `integrations/{slug}/ → archive/{slug}/` trước khi di chuyển. Chờ user confirm.
+**Bước 3 — Xác nhận:** Preview source → namespaced dest (`integrations/{slug}/ → archive/integrations/{slug}/`; cycle bundle → `archive/test-executions/{F-XXX}-{slug}/{NNN}-{cycle-slug}/`). Dedupe nếu chọn cả feature group lẫn cycle con.
 
-**Bước 4 — Di chuyển:** Move toàn bộ thư mục, giữ nguyên cấu trúc bên trong. Nếu slug đã tồn tại trong `.specs/archive/` → bỏ qua và cảnh báo để tránh ghi đè.
+**Bước 4 — Di chuyển:** Move giữ nguyên cấu trúc nguồn dưới subfolder loại (test-exec giữ 2 tầng). Dest đã tồn tại → bỏ qua + cảnh báo (no-overwrite). Feature group nguồn rỗng sau khi archive cycle → dọn thư mục rỗng.
 
-**Bước 5 — Kết quả:** Liệt kê integrations đã archive, integrations bị bỏ qua (nếu có), và số integration còn lại trong `.specs/integrations/`.
+**Bước 5 — Kết quả:** Liệt kê đã archive, bị bỏ qua (nếu có), và số còn lại mỗi plane.
 
 ---
 
@@ -410,7 +424,7 @@ Di chuyển integration đã hoàn thành hoặc không còn active từ `.specs
         ▼                       ▼
    /spec-tech              /spec-test
    (review + cascade       (review + cascade
-    → cdd / fdd / sad)      → tsd)
+    → cdd / fdd / sad)      → test-design)
         │                       │
         └───────────┬───────────┘
                     │ (tech.md approved — /plan KHÔNG đợi test.md)

package/templates/integrations/test-template.md

@@ -12,15 +12,15 @@ referenced_by:
 
 ## Context
 
-<!-- Tóm tắt ngắn các thông tin quan trọng từ context đã load (spec.md, tech.md, frd.md, current tsd.md của các feature touched), để file self-contained. -->
+<!-- Tóm tắt ngắn các thông tin quan trọng từ context đã load (spec.md, tech.md, frd.md, current test-design.md của các feature touched), để file self-contained. -->
 
 ## Test Strategy
 
 <!--
 Strategy cho integration này — KHÔNG lặp lại Strategy chung của feature.
 Chỉ ghi delta hoặc nhấn mạnh phần đặc thù integration:
-- Loại test ưu tiên (functional / validation / FAC / cross-story consistency / NFR).
-- Environments / data set / fixture đặc thù.
+- Loại test ưu tiên (functional / validation / FAC e2e: journey / consistency / integrity / NFR / data & migration).
+- Yêu cầu data đặc thù integration (shape) — nguồn/refresh/env assignment thuộc execution layer, KHÔNG ở đây.
 - Risk areas (vd: data migration cần backfill verify, integration đụng auth flow → security regression).
 -->
 
@@ -28,46 +28,40 @@ Chỉ ghi delta hoặc nhấn mạnh phần đặc thù integration:
 
 - {bullet ngắn}
 
-### Environments
-
-| Env | Mục đích | Data set | Ghi chú |
-| --- | --- | --- | --- |
-| {dev / staging / prod-like} | {functional / E2E / load} | {seed / anonymized prod} | ... |
-
 ## Changes
 
 <!--
-test.md = changeset patch áp lên feature tsd.md(s). Mỗi block dưới đây tương ứng 1 feature bị touched.
+test.md = changeset patch áp lên feature test-design.md(s). Mỗi block dưới đây tương ứng 1 feature bị touched.
 Lặp block cho mỗi feature trong `features:` frontmatter mà có delta TC.
 
 **Khi nào BỎ block của 1 feature:**
-- Diff giữa frd hiện tại và tsd.md hiện tại của feature đó = empty (frd không thêm/đổi item nào mà tsd chưa cover).
+- Diff giữa frd hiện tại và test-design.md hiện tại của feature đó = empty (frd không thêm/đổi item nào mà test-design chưa cover).
 - Bỏ block hoàn toàn, ghi `no-op` cho feature đó trong Cascade Summary để minh bạch.
 
 **Operation:**
-- `create` — feature/{F-XXX}/tsd.md chưa tồn tại. Nội dung đầy đủ theo template gốc, mọi TS/TC implicit [NEW] (không cần marker).
-- `update` — feature/{F-XXX}/tsd.md đã tồn tại. Chỉ liệt kê TS/TC bị ảnh hưởng. Mỗi item có marker:
-  - `[NEW]` — TS/TC chưa có trong tsd hiện tại
+- `create` — feature/{F-XXX}/test-design.md chưa tồn tại. Nội dung đầy đủ theo template gốc, mọi TS/TC implicit [NEW] (không cần marker).
+- `update` — feature/{F-XXX}/test-design.md đã tồn tại. Chỉ liệt kê TS/TC bị ảnh hưởng. Mỗi item có marker:
+  - `[NEW]` — TS/TC chưa có trong test-design hiện tại
   - `[MODIFY {field}]` — TS/TC đã có, đang đổi field cụ thể (ví dụ `[MODIFY steps]`, `[MODIFY expected]`, `[MODIFY priority]`, `[MODIFY covers]`)
   - `[REMOVE]` — TS/TC đã có, sẽ bị xóa (ID retire — không tái sử dụng)
 
-**Format reference:** dùng đúng format của template gốc — KHÔNG duplicate skeleton ở đây. `templates/main/feature/tsd-template.md` là single source of truth cho format.
+**Format reference:** dùng đúng format của template gốc — KHÔNG duplicate skeleton ở đây. `templates/main/feature/test-design-template.md` là single source of truth cho format.
 
-**ID assignment:** agent đọc tsd.md hiện tại của feature để xác định next ID:
+**ID assignment:** agent đọc test-design.md hiện tại của feature để xác định next ID:
 - `TS-F{NNN}-{seq}` cho Test Scenarios
-- `TC-F{NNN}-{seq}` cho Test Cases (Functional, Validation, Feature AC dùng chung sequence — không reset theo loại)
+- `TC-F{NNN}-{seq}` cho Test Cases (Functional, Validation, E2E dùng chung sequence — không reset theo loại)
 - ID **stable** — không tái sử dụng khi [REMOVE], không renumber khi [MODIFY].
 
-**Auto-cascade:** sau khi human approve test.md, agent tự apply tất cả Changes blocks vào feature tsd.md. Integration test.md được giữ như PR record bất biến.
+**Auto-cascade:** sau khi human approve test.md, agent tự apply tất cả Changes blocks vào feature test-design.md. Integration test.md được giữ như PR record bất biến.
 -->
 
-### feature/{F-XXX}-{feature-slug}/tsd.md *(lặp block cho mỗi feature trong `features:` mà có delta TC; bỏ block nếu no-delta)*
+### feature/{F-XXX}-{feature-slug}/test-design.md *(lặp block cho mỗi feature trong `features:` mà có delta TC; bỏ block nếu no-delta)*
 
 **Operation:** create | update
-**Format reference:** [tsd-template.md](../../templates/main/feature/tsd-template.md)
+**Format reference:** [test-design-template.md](../../templates/main/feature/test-design-template.md)
 
 <!--
-operation=create → nội dung đầy đủ theo tsd-template.md (Overview, Test Strategy, Test Scenarios, Functional TCs, Validation TCs, Feature AC TCs, Test Data, Traceability Matrix, Out of Scope, Dependencies).
+operation=create → nội dung đầy đủ theo test-design-template.md (Overview, Test Strategy, Test Scenarios, Functional TCs, Validation TCs, E2E TCs, Non-Functional TCs, Data & Migration TCs, Test Data Requirements, Traceability Matrix, Out of Scope, Dependencies).
 operation=update → chỉ liệt kê TS/TC bị ảnh hưởng, mỗi item có marker, và **bắt buộc update Traceability Matrix** rows tương ứng.
 
 Ví dụ operation=update:
@@ -121,13 +115,13 @@ Ví dụ operation=update:
 | `TC-F001-030` | `VR-F001-008` | `refund_reason` | `"Customer changed mind"` | accept | positive | NEW |
 | `TC-F001-031` | `VR-F001-008` | `refund_reason` | `"abc"` | reject — min length | negative | NEW |
 
-#### Feature AC Test Cases
+#### E2E Test Cases
 
 ##### TC-F001-040 [NEW]: E2E checkout + refund
 
 | Field | Value |
 | --- | --- |
-| **Type** | Feature AC — e2e |
+| **Type** | E2E — journey |
 | **Priority** | P0 |
 | **Covers** | `FAC-F001-004` |
 | **Spans** | `US-F001-001`, `US-F001-005` |
@@ -135,6 +129,32 @@ Ví dụ operation=update:
 **Steps:** ...
 **Expected:** ...
 
+#### Non-Functional Test Cases
+
+##### TC-F001-045 [NEW]: Refund endpoint chịu tải
+
+| Field | Value |
+| --- | --- |
+| **Type** | Non-functional — performance |
+| **Priority** | P1 |
+| **Covers** | `NFR-F001-002` |
+
+**Steps:** ...
+**Expected:** ...
+
+#### Data & Migration Test Cases
+
+##### TC-F001-048 [NEW]: Backfill refund_reason cho order cũ
+
+| Field | Value |
+| --- | --- |
+| **Type** | Data migration |
+| **Priority** | P0 |
+| **Covers** | `DM-F001-001` |
+
+**Steps:** ...
+**Expected:** ...
+
 #### Traceability Matrix
 
 Bổ sung row cho mọi item mới + cập nhật row cho item bị [MODIFY]. KHÔNG xóa row của [REMOVE] — đánh dấu retire.
@@ -145,6 +165,8 @@ Bổ sung row cho mọi item mới + cập nhật row cho item bị [MODIFY]. KH
 | `AC-F001-012` | Story AC | `TC-F001-022` | ✅ | NEW |
 | `VR-F001-008` | VR | `TC-F001-030`, `TC-F001-031` | ✅ | NEW |
 | `FAC-F001-004` | Feature AC | `TC-F001-040` | ✅ | NEW |
+| `NFR-F001-002` | NFR | `TC-F001-045` | ✅ | NEW |
+| `DM-F001-001` | Data & Migration | `TC-F001-048` | ✅ | NEW |
 | Flow 3 | Flow | `TS-F001-003` | ✅ | NEW |
 -->
 
@@ -162,5 +184,5 @@ Bổ sung row cho mọi item mới + cập nhật row cho item bị [MODIFY]. KH
 
 | Artifact | Operation | Summary |
 | --- | --- | --- |
-| `feature/F-XXX-{slug}/tsd.md` | create / update | {ngắn: +N TS, +M TC, modify TC-F001-008, remove TC-F001-015} |
-| `feature/F-YYY-{slug}/tsd.md` | no-op | frd không đổi, tsd hiện tại đã cover full |
+| `feature/F-XXX-{slug}/test-design.md` | create / update | {ngắn: +N TS, +M TC, modify TC-F001-008, remove TC-F001-015} |
+| `feature/F-YYY-{slug}/test-design.md` | no-op | frd không đổi, test-design hiện tại đã cover full |