spec-lite 1.2.1 → 1.3.0

package/skills-overview.md

@@ -65,13 +65,14 @@ Nếu `prd.md` chưa có → dừng, yêu cầu chạy `/spec-prd` trước.
 
 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`
+**Thứ tự bắt buộc:** `init` → `component` → `feature` → `tsd` *(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` |
 
 ### Phân chia trách nhiệm
 
@@ -143,6 +144,24 @@ Component Index và Feature Index **để placeholder** — sẽ được điề
 
 ---
 
+### `/spec-tsd [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.
+
+**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.
+
+**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).
+
+**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.
+
+**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ó.
+
+---
+
 ### Thứ tự thực hiện
 
 ```
@@ -155,6 +174,9 @@ 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)
+         │
+         ▼
 (fill in NEEDS_CLARIFY items khi có thêm context)
          │
          ▼
@@ -171,6 +193,7 @@ 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` |
 | `/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)* |
@@ -212,6 +235,30 @@ Context load: `spec.md` + `sad.md` + `domain.md` + `cdd.md` (cho mỗi component
 
 ---
 
+### `/spec-test [number]`
+
+Tạo `specs/integrations/{slug}/test.md` cho một integration. Chạy bởi **QC** sau khi `spec.md` đã được approve. **Song song / độc lập** với `/spec-tech` — cả hai chỉ phụ thuộc `spec.md`. Không có thứ tự bắt buộc giữa chúng.
+
+**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.
+
+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)*.
+
+**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)
+
+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.
+
+**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.
+
+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.
+
+---
+
 ### `/plan`
 
 Tạo `plan.md` và `todo.md` từ `spec.md` + `tech.md`. Là SDD wrapper quanh `planning-and-task-breakdown`.
@@ -288,21 +335,77 @@ Di chuyển integration đã hoàn thành hoặc không còn active từ `specs/
 
 ```
         /spec-new [requirement]
-   (human review + apply cascade proposals + approve)
-                │
-        /spec-tech
-   (human review + apply cascade proposals + approve)
+   (human review + auto-cascade → frd / crd / prd / domain / sad)
                 │
-        /plan
-   (human approve)
-                │
-        /build ←──────────────┐
-                │              │
-        /review-integration   │ (nếu Critical/Important)
-                │              │
-           [approve] ──────────┘ (nếu Suggestion only)
-                │
-        /archive  (khi integration Done, dọn dẹp khỏi integrations/)
+                ▼ (spec.md approved)
+        ┌───────────────────────┬───────────────────────┐
+        │ DEV branch            │ QC branch (song song) │
+        ▼                       ▼
+   /spec-tech              /spec-test
+   (review + cascade       (review + cascade
+    → cdd / fdd / sad)      → tsd)
+        │                       │
+        └───────────┬───────────┘
+                    │ (tech.md approved — /plan KHÔNG đợi test.md)
+                    ▼
+                  /plan
+            (human approve)
+                    │
+                  /build ←──────────────┐
+                    │                    │
+            /review-integration         │ (nếu Critical/Important)
+                    │                    │
+              [approve] ─────────────────┘ (nếu Suggestion only)
+                    │
+                  /archive
+```
+
+> **Lưu ý:** `/spec-tech` (DEV) và `/spec-test` (QC) chạy song song / độc lập — cả hai chỉ phụ thuộc `spec.md` approved. `/plan` chỉ chờ `tech.md` (test tasks tự QC manage trong test framework, không phải plan.md).
+
+---
+
+## Project-level review
+
+Khác với `/review-integration` (chạy sau `/build` cho một integration cụ thể), `/review-everything` review toàn bộ codebase đối chiếu với main artifacts.
+
+| Command | Reads | Writes |
+| --- | --- | --- |
+| `/review-everything` | `prd.md`, `domain.md`, `sad.md`, *(source code)* | `specs/integrations/{NNN}-{slug}/review-findings.md` *(qua /spec-new)* |
+
+### `/review-everything`
+
+Review codebase ở project level theo năm trục của `code-review-and-quality`. Spawn 5 subagent song song — cùng context (prd / domain / sad), khác axis (Correctness / Readability / Architecture / Security / Performance).
+
+**Output** — findings table phân loại theo severity scale của `code-review-and-quality`: Critical, Required, Optional/Consider, Nit, FYI.
+
+**Sau khi có findings**, hỏi user severity tier muốn xử lý:
+
+- Critical only
+- Critical + Required (must-fix)
+- Critical + Required + Optional
+- Tất cả (kèm Nit + FYI)
+- Bỏ qua — chỉ xem findings
+
+Nếu user chọn fix → gom selected findings thành raw requirement, invoke `/spec-new` với ARGUMENT đó. Integration được tạo và xử lý như integration thường (`/spec-tech` → `/plan` → `/build`).
+
+`review-findings.md` (full snapshot, gồm cả deferred) được ghi vào `specs/integrations/{NNN}-{slug}/` để traceability.
+
+**Khi dùng:**
+
+- Health-check định kỳ, audit trước release lớn
+- Cross-team review hoặc onboarding owner mới
+- Khi nghi ngờ drift / vi phạm guardrails tích luỹ qua nhiều integration
+
+```
+/review-everything
+        │
+   [findings table]
+        │
+   user chọn severity tier
+        │
+   (nếu fix) /spec-new ←─── raw requirement (gom từ findings)
+        │
+   /spec-tech → /plan → /build (integration bình thường)
 ```
 
 ---

package/templates/integrations/test-template.md

@@ -0,0 +1,166 @@
+---
+id: "{id}"
+slug: "{slug}"
+title: "{title}"
+features: []
+status: draft
+created: {YYYY-MM-DD}
+referenced_by:
+  - conventions.md > 4. Integration Artifacts > 4.7 test.md > Cấu trúc
+  - skills/spec-test/SKILL.md > Process > Bước 4: Write — sinh draft
+---
+
+## 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. -->
+
+## 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ù.
+- Risk areas (vd: data migration cần backfill verify, integration đụng auth flow → security regression).
+-->
+
+### Approach
+
+- {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.
+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).
+- 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
+  - `[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.
+
+**ID assignment:** agent đọc tsd.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)
+- 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.
+-->
+
+### 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)*
+
+**Operation:** create | update
+**Format reference:** [tsd-template.md](../../templates/main/feature/tsd-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=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:
+
+#### Test Scenarios
+
+##### TS-F001-003 [NEW]: Refund flow — happy + edge
+
+- **Flow ref:** `frd.md > Flow 3: Refund`
+- **Preconditions:** order đã thanh toán xong, refund window còn hạn
+- **Postconditions:** số tiền hoàn về phương thức thanh toán gốc
+- **Paths:**
+  - Happy: order paid → refund click → confirm → refunded
+  - Edge: order paid → refund click → past window → blocked
+- **Test cases:** `TC-F001-022`, `TC-F001-023`
+
+#### Functional Test Cases
+
+##### TC-F001-022 [NEW]: Refund order trong window
+
+| Field | Value |
+| --- | --- |
+| **Type** | Functional — positive |
+| **Priority** | P0 |
+| **Covers** | `US-F001-005`, `AC-F001-012` |
+| **Scenario** | `TS-F001-003` |
+| **Preconditions** | order paid 1h trước |
+
+**Steps:**
+
+1. Login customer
+2. Vào order detail
+3. Click "Refund"
+4. Confirm refund
+
+**Expected:**
+
+- Refund record được tạo với status `processing`
+- Email notification gửi tới customer
+
+##### TC-F001-008 [MODIFY expected]
+- Expected: 2-3 phút → 30s (sau khi tech.md tối ưu queue)
+
+##### TC-F001-015 [REMOVE]
+- Lý do: superseded by TC-F001-022 (cover same AC, scope hẹp hơn)
+
+#### Validation Test Cases
+
+| TC ID | Covers VR | Field | Input | Expected | Polarity | Op |
+| --- | --- | --- | --- | --- | --- | --- |
+| `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
+
+##### TC-F001-040 [NEW]: E2E checkout + refund
+
+| Field | Value |
+| --- | --- |
+| **Type** | Feature AC — e2e |
+| **Priority** | P0 |
+| **Covers** | `FAC-F001-004` |
+| **Spans** | `US-F001-001`, `US-F001-005` |
+
+**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.
+
+| FRD Item | Type | Covered by | Status | Op |
+| --- | --- | --- | --- | --- |
+| `US-F001-005` | US | `TC-F001-022` | ✅ | NEW |
+| `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 |
+| Flow 3 | Flow | `TS-F001-003` | ✅ | NEW |
+-->
+
+## Out of Scope
+
+<!-- Những gì KHÔNG được test trong integration này và lý do (vd: thuộc layer khác như infra audit, NFR đã verify ở integration trước, ...) -->
+
+## Open Questions
+
+<!-- Các điểm còn mơ hồ cần clarify trước khi proceed. Xóa section nếu không có. -->
+
+## Cascade Summary
+
+<!-- Bảng tóm tắt để reviewer scan nhanh trước khi approve. Liệt kê **tất cả** feature trong `features:` — feature no-delta ghi operation `no-op`. -->
+
+| 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 |

package/templates/main/feature/frd-template.md

@@ -27,6 +27,8 @@ Mọi thay đổi structure ở file này tự động propagate qua Changes blo
 {Mô tả các luồng thao tác của user để hoàn thành mục tiêu của feature này.}
 {Mỗi flow là một Mermaid flowchart riêng, bao gồm happy case và tất cả edge cases quan trọng.}
 
+Flow numbering **stable** — không renumber khi xóa flow. Nếu xóa Flow 1, Flow 2 giữ nguyên số (không tái sử dụng số 1).
+
 ### Flow 1: {Tên luồng chính}
 
 ```mermaid
@@ -46,19 +48,32 @@ flowchart TD
     A(["Điểm bắt đầu"]) --> B["..."]
 ```
 
-## Feature-level Acceptance Criteria
+## Feature Acceptance Criteria
 
-Criteria áp dụng cho toàn bộ feature — không gắn với story cụ thể (ví dụ: performance, security, accessibility).
-AC ID format: `AC-F{NNN}-{seq}` — đánh số tăng dần toàn feature (không reset giữa sections).
+Criteria áp dụng cho **toàn bộ feature** — phần Story AC không cover được. Mọi Feature AC phải test được pass/fail.
 
-- `AC-{F_ID}-001`
-  - **Given** {precondition}
+Thường gồm 4 nhóm:
+- **End-to-end liên story** — full happy path đi qua nhiều story.
+- **Cross-story consistency** — UI/behavior đồng nhất giữa các màn trong feature.
+- **Non-functional** — performance, accessibility, browser support, i18n, security.
+- **Data & migration** — backfill, schema migration, không mất data cũ.
+
+> Out of scope: release readiness (runbook/rollout/legal sign-off) và success metric/KPI post-release — đặt ở artifact khác (`tech.md`, `sad.md`, hoặc PMO checklist).
+
+Feature AC ID format: `FAC-F{NNN}-{seq}` — counter **độc lập** với Story AC (`AC-F{NNN}-{seq}`). ID **stable** — không tái sử dụng seq khi xóa, không renumber.
+
+Format: **Given/When/Then bắt buộc** — kể cả NFR / consistency. **Then phải đo được**: ngưỡng cụ thể HOẶC danh sách item so sánh.
+
+- `FAC-{F_ID}-001`
+  - **Given** {precondition đo được}
   - **When** {action}
-  - **Then** {expected outcome}
+  - **Then** {outcome có threshold hoặc danh sách cụ thể, không vague}
 
 ## User Stories
 
-US ID format: `US-F{NNN}-{seq}` — đánh số tăng dần toàn feature.
+US ID format: `US-F{NNN}-{seq}` — đánh số tăng dần toàn feature. ID **stable** — không tái sử dụng seq khi xóa, không renumber.
+
+Story AC ID format: `AC-F{NNN}-{seq}` — đánh số tăng dần toàn feature (không reset giữa các story). ID **stable** — không tái sử dụng seq khi xóa, không renumber.
 
 ### US-{F_ID}-001: {Story title}
 

package/templates/main/feature/tsd-template.md

@@ -0,0 +1,220 @@
+---
+id: tsd-{feature}
+type: tsd
+status: draft
+owner: "{QC}"
+feature_id: "{Feature ID — match frd.md}"
+frd_ref: "feature/{F-XXX}-{slug}/frd.md"
+referenced_by:
+  - conventions.md > 3. Main Artifacts > 3.3 Feature level > tsd.md > Cấu trúc
+---
+
+<!--
+Canonical format cho feature/{F-XXX}-{slug}/tsd.md.
+Sinh từ frd.md — mỗi AC / VR / Flow phải có ít nhất 1 test case cover.
+Traceability Matrix ở cuối là source of truth để kiểm tra coverage trước khi đóng feature.
+
+TSD chỉ tồn tại ở FEATURE level — không tách tsd riêng cho component.
+Component là internal building block; contract của component được verify gián tiếp qua TC ở đây
+và qua unit test trong code (không phải spec artifact).
+-->
+
+# Test Spec: {Feature Name}
+
+## Overview
+
+{Phạm vi tsd này — feature gì, các luồng / AC / VR chính cần verify, trong 2-3 câu.}
+
+## Test Strategy
+
+### Approach
+
+- **Functional**: verify từng US / Story AC theo happy + edge.
+- **Validation**: derive 1:1 từ Verification Rules.
+- **Flow-based (E2E)**: chạy theo Mermaid flows trong frd.
+- **Feature AC**: cover các Feature AC — e2e liên story, cross-story consistency, NFR, data & migration.
+
+### Environments
+
+| Env | Mục đích | Data set | Ghi chú |
+| --- | --- | --- | --- |
+| {dev / staging / prod-like} | {functional / E2E / load} | {seed / anonymized prod} | ... |
+
+## Test Scenarios
+
+Mỗi scenario gắn với 1 flow trong `frd.md > User Flows`. Scenario mô tả end-to-end path; test case chi tiết liệt kê ở section bên dưới.
+
+TS ID format: `TS-F{NNN}-{seq}` — đánh số tăng dần toàn feature. ID **stable** — đã assign rồi giữ nguyên kể cả khi xóa (không tái sử dụng seq, không renumber).
+
+### TS-{F_ID}-001: {Tên — match Flow 1 trong frd}
+
+- **Flow ref:** `frd.md > Flow 1: {tên}`
+- **Preconditions:** {state trước khi chạy}
+- **Postconditions:** {state sau khi pass}
+- **Paths:**
+  - Happy: A → B → C(happy) → D → F
+  - Edge: A → B → C(edge) → E → G
+- **Test cases:** `TC-{F_ID}-001`, `TC-{F_ID}-002`, ...
+
+---
+
+### TS-{F_ID}-002: {Tên — match Flow 2 nếu có}
+
+...
+
+## Functional Test Cases
+
+Cover User Stories và Acceptance Criteria trong frd.
+
+TC ID format: `TC-F{NNN}-{seq}` — đánh số tăng dần toàn feature. ID **stable** (không tái sử dụng seq khi xóa, không renumber). Nếu xóa TC → ID đó retire, seq mới tiếp tục tăng từ max.
+
+### TC-{F_ID}-001: {Title ngắn — verb-first}
+
+| Field | Value |
+| --- | --- |
+| **Type** | Functional — positive / negative |
+| **Priority** | P0 / P1 / P2 |
+| **Covers** | `US-{F_ID}-001`, `AC-{F_ID}-001` |
+| **Scenario** | `TS-{F_ID}-001` |
+| **Preconditions** | ... |
+
+**Steps:**
+
+1. {action}
+2. {action}
+3. {action}
+
+**Expected:**
+
+- {observable outcome 1}
+- {observable outcome 2}
+
+**Test data:** {ref Test Data section hoặc inline literal}
+
+---
+
+### TC-{F_ID}-002: ...
+
+## Validation Test Cases
+
+Derive 1:1 từ Verification Rules trong frd. Mỗi `VR-F{NNN}-{seq}` cần ít nhất:
+- 1 positive (rule pass)
+- 1+ negative — mỗi nhánh fail là 1 case riêng (vd VR "email format" → 1 case cho missing `@`, 1 case cho missing domain, ...)
+
+Form bảng để dễ scan; case phức tạp có thể tách ra block riêng như Functional TC.
+
+| TC ID | Covers VR | Field | Input | Expected | Polarity |
+| --- | --- | --- | --- | --- | --- |
+| `TC-{F_ID}-010` | `VR-{F_ID}-001` | `email` | `"user@example.com"` | accept | positive |
+| `TC-{F_ID}-011` | `VR-{F_ID}-001` | `email` | `""` | reject — required | negative |
+| `TC-{F_ID}-012` | `VR-{F_ID}-001` | `email` | `"abc"` | reject — invalid format | negative |
+
+## Feature AC Test Cases
+
+Cover Feature Acceptance Criteria (`FAC-*`) trong frd. Feature AC trong frd đã ở format G/W/T → TC ở đây dịch 1:1: Given → Preconditions, When → Steps, Then → Expected.
+
+### TC-{F_ID}-040: {Title — e2e liên story}
+
+| Field | Value |
+| --- | --- |
+| **Type** | Feature AC — e2e |
+| **Priority** | P0 / P1 / P2 |
+| **Covers** | `FAC-{F_ID}-001` |
+| **Spans** | `US-{F_ID}-001`, `US-{F_ID}-002`, `US-{F_ID}-003` |
+| **Preconditions** | account mới chưa onboard |
+
+**Steps:**
+
+1. Đăng ký account mới
+2. Verify email qua link
+3. Hoàn thành onboarding form
+4. Thực hiện first transaction
+
+**Expected:**
+
+- Toàn bộ flow chạy trong 1 session, không cần support intervene
+- State persist đúng giữa các step (refresh không mất tiến độ)
+
+---
+
+### TC-{F_ID}-041: {Title — consistency}
+
+| Field | Value |
+| --- | --- |
+| **Type** | Feature AC — consistency |
+| **Priority** | P1 |
+| **Covers** | `FAC-{F_ID}-002` |
+| **Preconditions** | feature đã deploy lên test env, 3 màn Register / Profile / Admin Create accessible |
+
+**Steps:**
+
+1. Trigger empty `email` validation ở Register
+2. Trigger empty `email` validation ở Profile
+3. Trigger empty `email` validation ở Admin Create
+4. Trigger invalid format `"abc"` ở cả 3 màn
+
+**Expected:**
+
+- 3 message ở step 1-3 identical (cùng text, cùng style)
+- 3 message ở step 4 identical
+
+---
+
+### TC-{F_ID}-050: {Title — NFR perf}
+
+| Field | Value |
+| --- | --- |
+| **Type** | Feature AC — performance |
+| **Priority** | P0 |
+| **Covers** | `FAC-{F_ID}-003` |
+| **Preconditions** | env perf-test, dataset baseline đã load |
+
+**Steps:**
+
+1. Chạy load test (k6 / JMeter) profile 100 RPS sustained 5 phút lên `/login`
+2. Đọc p95 latency từ summary report
+
+**Expected:**
+
+- p95 ≤ 500ms
+- Error rate ≤ 0.1%
+
+## Test Data
+
+| Data set | Mục đích | Nguồn | Refresh |
+| --- | --- | --- | --- |
+| `seed_users` | functional positive | fixture / factory | mỗi run |
+| `boundary_inputs` | validation edges | inline trong TC | n/a |
+
+## Traceability Matrix
+
+**Source of truth** để verify coverage trước khi đóng feature. Mỗi item từ frd phải xuất hiện. Gap → đánh ❌ và mô tả rõ ở phần "Gaps" bên dưới.
+
+| FRD Item | Type | Covered by | Status |
+| --- | --- | --- | --- |
+| Flow 1 | Flow | `TS-{F_ID}-001` | ✅ |
+| `US-{F_ID}-001` | US | `TC-{F_ID}-001`, `TC-{F_ID}-002` | ✅ |
+| `AC-{F_ID}-001` | Story AC | `TC-{F_ID}-001` | ✅ |
+| `VR-{F_ID}-001` | VR | `TC-{F_ID}-010`, `TC-{F_ID}-011`, `TC-{F_ID}-012` | ✅ |
+| `FAC-{F_ID}-001` | Feature AC | `TC-{F_ID}-040` | ✅ |
+| `FAC-{F_ID}-002` | Feature AC | `TC-{F_ID}-041` | ✅ |
+| `FAC-{F_ID}-003` | Feature AC | `TC-{F_ID}-050` | ✅ |
+| `AC-{F_ID}-00X` | Story AC | — | ❌ chưa có TC |
+
+### Gaps
+
+{Liệt kê item ❌ kèm lý do tạm hoãn / blocker — empty nếu coverage đầy đủ.}
+
+## Out of Scope
+
+- {những gì tsd này KHÔNG cover — lý do (vd: thuộc layer khác như infra/security audit, đã verify ở môi trường khác, ...)}
+
+## Dependencies
+
+### FRD reference
+
+- `frd.md` của feature này — mọi ID (`US-`, `AC-`, `VR-`, Flow) phải match.
+
+### Components Used (input only)
+
+Tham chiếu `frd.md > Components Used` để hiểu contract của các component được feature này dùng. Behavior của component được verify **gián tiếp** qua các TC ở đây — không tách tsd riêng cho component.

package/templates/main/feature/test-plan-template.md

@@ -1,60 +0,0 @@
----
-id: "003-assign-todo"
-slug: "assign-todo"
-title: "Assign Todo — Test Plan"
-features: ["F-004"]
-status: draft
-created: 2026-04-21
----
-
-## Test Strategy
-
-Approach tổng quan: test pyramid distribution, environment setup, fixtures.
-
-## AC Coverage Matrix
-
-| AC ID | Primary Level | Test Case ID(s) | Status |
-|-------|--------------|-----------------|--------|
-| AC-F004-001 | Component | TC-001 | draft |
-| AC-F004-002 | Component | TC-002 | draft |
-| ... |
-
-## Verification Rules Coverage
-
-Mỗi rule trong `frd.md > Verification Rules` của feature phải có **≥ 1 positive test case** (input hợp lệ pass) và **≥ 1 negative test case** (input vi phạm rule bị reject). Nếu rule áp dụng ở nhiều layer (client + gateway, xem `fdd.md > Verification Implementation`) → cover từng layer.
-
-| Rule ID | Layer (từ FDD) | Test Case ID(s) | Status |
-|---------|----------------|-----------------|--------|
-| VR-F004-001 | service | TC-010 (pos), TC-011 (neg) | draft |
-| VR-F004-002 | gateway | TC-012 (neg) | draft |
-| ... |
-
-## Test Cases
-
-### TC-001: Non-owner không thấy assign control
-**Verifies:** AC-F004-001 (primary)
-**Level:** Component test (TodoModal)
-**Setup:**
-- Render TodoModal với prop `isOwner: false`
-**Steps:**
-1. Mở modal
-2. Query assign control
-**Expected:**
-- Assign control không có trong DOM
-**Negative variants:** —
-
-### TC-006: Happy path assign
-**Verifies:** AC-F004-006, AC-F004-007 (primary), AC-F004-008 (supporting)
-**Level:** E2E (Playwright)
-**Setup:**
-- Seed: userA, userB
-- userA login, tạo todo
-**Steps:**
-1. userA mở task detail
-2. Click assign, chọn userB
-3. Confirm
-**Expected:**
-- Modal hiển thị owner = userB
-- Refresh dashboard → card hiển thị userB
-**Verification queries:**
-- DB: `SELECT * FROM todo_history WHERE todo_id=? AND event_type='ASSIGNED'` → 1 row, payload đúng