@educa-corp/sdd-framework 0.9.1 → 0.9.2

package/core/skills/qc/qa-analyst/spec-breakdown.md

@@ -1,7 +1,9 @@
 ---
 version: 1.0
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
+updated: 2026-08-25
+ported_from: ui-automation-testing
+upstream_path: skills/qa-tc-analyst/spec-breakdown.md
+upstream_sha: 4a5fb9334fef1fdc3ac5e899e0463c643af80dad
 ---
 
 # Spec Breakdown — Bóc tách yêu cầu
@@ -27,7 +29,7 @@ Bóc tách spec/PRD/user story thô thành mô tả yêu cầu có cấu trúc c
    vào phân tích/BR/AC. Với file Confluence/HTML/MHTML: phát hiện qua thẻ `<s>`,
    `<strike>`, `<del>` hoặc style `text-decoration: line-through`.
 3. Xác định: feature name, actor/role, mục tiêu nghiệp vụ, phạm vi (in/out scope).
-4. Đánh dấu phần MƠ HỒ / THIẾU → ghi vào `DOC_GAPS.md` (gap GAP-xx).
+4. Đánh dấu phần MƠ HỒ / THIẾU → ghi vào `DOC_GAP.md` (gap GAP-xx).
 
 ---
 
@@ -37,7 +39,7 @@ Tách yêu cầu thành các khối:
 
 A. TỔNG QUAN: mục tiêu, actor, giá trị nghiệp vụ.
 B. CHỨC NĂNG: list từng chức năng (visible + ẩn + integration point).
-C. INPUT/OUTPUT: mỗi chức năng có input gì, output gì, ràng buộc field.
+C. INPUT/OUTPUT: mỗi chức năng có input gì, output gì, ràng buộc field. Với **mỗi field input** (kể cả tuỳ chọn): kiểm tra đủ `minlength`/`maxlength`, ký tự cho phép, trim, format. Field thiếu bất kỳ mục nào → ghi gap MISSING vào `DOC_GAP.md`.
 D. TRẠNG THÁI & LUỒNG: các state, điều kiện chuyển, happy path + alternate flow.
 E. PHỤ THUỘC: hệ thống/API/module liên quan.
 F. GIẢ ĐỊNH & CÂU HỎI MỞ: điều suy ra được vs điều cần dev/BA xác nhận.
@@ -48,14 +50,14 @@ F. GIẢ ĐỊNH & CÂU HỎI MỞ: điều suy ra được vs điều cần dev
 
 ⚠️ `/qc-analyze` chỉ ghi **ĐÚNG 2 FILE** cho mỗi UC, đặt trong thư mục QC **lộ ra ngoài**
 `{paths.qc_dir}/{UC-ID}/` (mặc định `docs/{UC-ID}/` — KHÔNG để trong `.agent/` ẩn):
-`REQUIREMENT_ANALYSIS.md` + `DOC_GAPS.md`. KHÔNG tách mỗi bước phân tích thành file riêng.
+`REQUIREMENT_ANALYSIS.md` + `DOC_GAP.md`. KHÔNG tách mỗi bước phân tích thành file riêng.
 
 Phần spec-breakdown là **mục đầu tiên** của `REQUIREMENT_ANALYSIS.md`:
 - Bảng chức năng + input/output/constraint
 - Sơ đồ/list luồng chính & phụ
 - Danh sách giả định và câu hỏi mở (đánh dấu rõ điều CHƯA chắc)
 
-Đồng thời ghi mọi khoảng trống phát hiện vào `{paths.qc_dir}/{UC-ID}/DOC_GAPS.md`
-(theo `{paths.qc_skills_dir}/qa-analyst/DOC_GAPS.template.md`), mỗi gap có ID `GAP-xx`.
+Đồng thời ghi mọi khoảng trống phát hiện vào `{paths.qc_dir}/{UC-ID}/DOC_GAP.md`
+(theo `{paths.qc_skills_dir}/qa-analyst/DOC_GAP.template.md`), mỗi gap có ID `GAP-xx`.
 
 Kết thúc bằng gợi ý: feature đã đủ rõ để chuyển sang `qa-planner` (phân tích rủi ro) chưa.

package/core/skills/qc/qa-analyst/spec-issue-reporter.md

@@ -0,0 +1,100 @@
+---
+version: 1.0
+updated: 2026-08-25
+ported_from: ui-automation-testing
+upstream_path: skills/qa-tc-analyst/spec-issue-reporter.md
+upstream_sha: 5b5c0c886e92b474e0a5a8157ba58a7c3ce4b3f8
+---
+
+# Spec Issue Reporter — gom mọi điểm mơ hồ thành báo cáo gửi PO/BA/Dev
+
+Gom mọi điểm mơ hồ / thiếu / mâu thuẫn phát hiện được trong lúc phân tích thành **một** báo cáo
+có cấu trúc, đủ thông tin để người nhận trả lời được ngay.
+
+> **`/qc-analyze` nạp file này** *(B9 — hợp nhất 2026-08-25)*. Nó là luật viết cho
+> `DOC_GAP.template.md` — template **duy nhất** của file gap. Bản 9 cột cũ đã bỏ.
+>
+> **Một chỗ cố ý khác upstream:** mức nặng nhất dùng `🔴 Blocker`, không phải `Critical` —
+> `/qc-run-test` đọc đúng từ đó để đặt *"scenario đang chờ PO"* vào sổ trace.
+
+## Đầu vào
+
+Mọi dấu `?`, chỗ thiếu mapping, chỗ mâu thuẫn mà các skill phân tích khác đã ghi nhận.
+
+## Đầu ra
+
+> ⛔ **BẮT BUỘC theo template — tự-validate trước khi lưu.** Đây là skill hay xuất **sai
+> template** nhất: tự chế cột, gộp `Trạng thái` với `Câu trả lời`, thiếu `Giao cho đội` /
+> `Người trả lời`, dùng Loại phi chuẩn (`SYNC` / `Drift` / `FEASIBILITY`), quên section
+> *Ưu tiên xử lý* + *Chú thích*.
+>
+> TRƯỚC khi lưu: mở `{paths.qc_skills_dir}/qa-analyst/DOC_GAP.template.md`, chạy hết
+> **"⚠️ Checklist bắt buộc trước khi lưu file"** ở cuối template, sửa cho khớp 100%.
+
+Một file gap gồm:
+
+1. **Section `Tài liệu đầu vào đã đọc để phân tích`** — BẮT BUỘC, đặt ngay sau metadata,
+   **trước** bảng gap. Bảng liệt kê **đầy đủ** mọi file đã đọc (spec chính + mọi ref-link +
+   transitive 1-hop): `# | Đường dẫn | Vai trò | Phiên bản`, kèm tổng số.
+   KHÔNG bỏ sót file nào đã mở — đây là **căn cứ độ phủ**: không có nó thì không ai phân biệt
+   được *"đã đọc và không thấy"* với *"chưa đọc"*.
+2. **Bảng gap 10 cột**, đúng thứ tự:
+   `ID | Loại | Vấn đề cần confirm | Câu hỏi / Lý do cần confirm & Gợi ý | Trích đoạn tài liệu (Evidence) | Giao cho đội | Mức độ | Người trả lời | Trạng thái | Câu trả lời`
+
+## Quy tắc
+
+- **Evidence bắt buộc** — dẫn **nguyên văn** in nghiêng + tham chiếu vị trí cụ thể
+  (`〔file §section〕`). Dùng ✕ khi mâu thuẫn giữa hai chỗ. Không phán đoán chủ quan.
+- **Cột 4 phải đủ bốn mục**, tách bằng `<br/>` thành từng dòng riêng trong cell:
+  ```
+  **Bối cảnh:** …<br/>**Vấn đề:** …<br/>**Tại sao quan trọng:** …<br/>**Gợi ý:** …
+  ```
+  Không viết bốn mục liên tiếp trên một dòng. Ngôn ngữ dễ hiểu cho PO/Design/Dev.
+  *"Tại sao quan trọng"* là thứ cho phép người nhận **xếp ưu tiên**; *"Gợi ý"* là thứ cho phép
+  họ **trả lời nhanh** thay vì nghĩ lại từ đầu.
+- **Tham chiếu BR/AC dùng ID GỐC trong PRD** (vd `FT-001-UC4-BR11`), **không** dùng ID nội bộ
+  do bước phân tích tự đánh số lại (vd `BR-UC4-12`). Hai hệ ID khác nhau; trộn vào là người
+  đọc không tra ngược được về PRD.
+- **Mức độ bắt buộc có emoji**: `🔴 Blocker` · `🟠 High` · `🟡 Medium` · `⚪ Low`.
+- **Pipe trong cell**: escape thành `\|` (vd `{a\|b\|c}`), nếu không sẽ vỡ bảng.
+- **Thêm hàng vào bảng đã có**: nối **ngay liền sau hàng cuối**, TUYỆT ĐỐI không chèn dòng
+  trắng giữa các hàng — dòng trắng làm Markdown tách thành hai bảng riêng và các gap mới
+  **không render** trong bảng chính. Thêm xong cập nhật luôn *Tổng số gap* ở header và bảng
+  *Ưu tiên xử lý*.
+- **KHÔNG thêm section "Change log"** và **KHÔNG thêm section "AI Assumptions"** — mọi giả định
+  AI tự suy là gap loại `ASSUMPTION` trong bảng, không tách thành section riêng.
+
+## Trạng thái hợp lệ
+
+`Open` · `Resolved` · `Out of Scope` · `Re-scoped → Covered`
+
+**Khi một trường hợp đã đánh dấu `Out of Scope` được yêu cầu viết test:**
+
+1. Kiểm PRD xem có ghi chú thay đổi phạm vi không — một change request có thể **dời trách
+   nhiệm kiểm tra** từ UC này sang UC khác.
+2. Có ghi chú rõ ràng → đổi trạng thái `Out of Scope` → `Re-scoped → Covered`, ghi test-case
+   mới vào cột *Câu trả lời*.
+3. Không tìm thấy ghi chú nhưng QC vẫn yêu cầu → **vẫn viết test** (QC chốt phạm vi), đồng
+   thời ghi chú lại để truy vết.
+
+## Xác định IN-SCOPE vs NGOÀI PHẠM VI — căn cứ SPEC, không dùng artifact tự sinh
+
+> ⚠️ **Nguồn quyết định phạm vi là SPEC, không phải tài liệu do chính pipeline QC sinh ra.**
+
+- Khi phán một hạng mục là in-scope hay ngoài phạm vi, phải trích **spec authority**: mục
+  *Scope/Phạm vi* của PRD, `@trace.platform` của file `.feature`, hoặc design-spec nêu rõ nền
+  tảng áp dụng.
+  **TUYỆT ĐỐI KHÔNG** lấy `TEST_PLAN.md` / `*.Test.md` dưới `{paths.qc_dir}` làm căn cứ — chúng
+  do chính pipeline này sinh ra, nên dùng chúng là **vòng lặp**: lấy *hệ quả* của phạm vi làm
+  *nguồn* của phạm vi.
+- **Bố cục file gap:** chỉ gap **in-scope** nằm trong bảng chính và tính vào *Ưu tiên xử lý*
+  (đây là gap sẽ chặn hoặc đẻ ra test). Gap **thật nhưng ngoài phạm vi** (thuộc feature khác)
+  và gap **lệch đồng bộ tài liệu** → gom vào section **"Ghi chú ngoài phạm vi"** riêng, không
+  trộn vào bảng chính, không tính ưu tiên. **Giữ audit trail, đừng xoá.**
+- Phân vân in hay out → mặc định **giữ in-scope + hỏi lại**. Loại nhầm ra ngoài phạm vi làm
+  **mất coverage trong im lặng** — nguy hiểm hơn hẳn việc thừa một gap ngoài lề.
+
+## Sau khi sinh file gap — BẮT BUỘC thẩm định
+
+Chạy `steps/gap-verify.md` trên tập gap vừa sinh trước khi bàn giao. Skill này **tìm** gap;
+nó không có cơ chế nào tự phát hiện gap mình vừa bịa ra. Xem `gap-verify` §"Nguyên tắc tối thượng".

package/core/skills/qc/qa-designer/e2e/journey.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — E2E Journey
@@ -18,7 +18,7 @@ Skill **tự chứa** để viết TC end-to-end: hành trình đầu→cuối x
 ---
 
 ## Format file TC (bắt buộc)
-- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAPS.md)`.
+- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAP.md)`.
 - **Test Data** dạng list (tài khoản/role, dữ liệu lớp/buổi…) · **Steps** `[Action]`/`[Verify]` xuyên các màn ·
   **Expected** 1 bullet = chuỗi verify point (tạo thành công, mã đúng, định tuyến đúng, đồng bộ đúng, hiển thị danh sách).
 - ID journey `E2E-<FEATURE>-NN` · cuối file: Trace matrix + bảng TC block · bỏ nội dung gạch ngang.

package/core/skills/qc/qa-designer/exploratory/charter.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Test Charter — Exploratory

package/core/skills/qc/qa-designer/exploratory/explore-to-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Explore-to-Functional Pipeline

package/core/skills/qc/qa-designer/functional/api.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Functional API (không qua UI)
@@ -22,7 +22,7 @@ Chỉ cần load file này.
 - 1 file/feature · mỗi TC **1 concept** · metadata **list** (không bảng/emoji): Title · Feature ·
   Priority(P0/P1/P2) · Status(Draft) · Author(AI) · Tags · Trace · 🚫 Block(nếu có).
 - **Trace:** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)`; không có BR → `⚠️ Chưa có Business Rule`.
-- **🚫 Block:** TC phụ thuộc gap vẫn viết đủ + `[GAP-xx](DOC_GAPS.md) — lý do`.
+- **🚫 Block:** TC phụ thuộc gap vẫn viết đủ + `[GAP-xx](DOC_GAP.md) — lý do`.
 - **Test Data:** dạng **list** (request cụ thể: method/path/headers/body). **Steps:** `[Action]`/`[Verify]`.
   **Expected:** 1 bullet nêu rõ **status code + field response cần chốt** (không ✅/❌).
 - Cuối file: **Trace matrix** (BR↔TC, ⚠️ TC thiếu BR) + **bảng TC bị block** · bỏ nội dung gạch ngang.

package/core/skills/qc/qa-designer/functional/gui-feature.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Functional GUI Feature (đa màn hình)
@@ -22,7 +22,7 @@ Skill **tự chứa** để viết TC functional cho feature có luồng span
 - 1 file/feature · mỗi TC **1 concept** · metadata **list** (không bảng/emoji): Title · Feature ·
   Priority(P0/P1/P2) · Status(Draft) · Author(AI) · Tags · Trace · 🚫 Block(nếu có).
 - **Trace:** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)`; không có BR → `⚠️ Chưa có Business Rule`.
-- **🚫 Block:** TC phụ thuộc gap vẫn viết đủ + `[GAP-xx](DOC_GAPS.md) — lý do`.
+- **🚫 Block:** TC phụ thuộc gap vẫn viết đủ + `[GAP-xx](DOC_GAP.md) — lý do`.
 - **Test Data:** dạng **list** (không bảng). **Steps:** `[Action]`/`[Verify]`, không `*Expected:*`/bước. **Expected:** 1 bullet cụ thể.
 - Cuối file: **Trace matrix** (BR↔TC, ⚠️ TC thiếu BR) + **bảng TC bị block** · không `#### Python Test Mapping` · bỏ nội dung gạch ngang.
 

package/core/skills/qc/qa-designer/functional/gui-screen.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Functional GUI Screen (1 màn hình)
@@ -22,7 +22,7 @@ Skill **tự chứa** để viết TC functional cho 1 màn hình đơn lẻ (we
 - 1 file/feature · mỗi TC **1 concept** · metadata **list** (mỗi trường 1 dòng, không bảng/emoji):
   Title · Feature · Priority(P0/P1/P2) · Status(Draft) · Author(AI) · Tags · Trace · 🚫 Block(nếu có).
 - **Trace:** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)`; TC không có BR → `⚠️ Chưa có Business Rule`.
-- **🚫 Block:** TC phụ thuộc gap **vẫn viết đủ** + `[GAP-xx](DOC_GAPS.md) — lý do`; chưa chạy tới khi gap Answered.
+- **🚫 Block:** TC phụ thuộc gap **vẫn viết đủ** + `[GAP-xx](DOC_GAP.md) — lý do`; chưa chạy tới khi gap Answered.
 - **Test Data:** dạng **list** (`- **Trường:** giá trị`), không bảng.
 - **Test Steps:** `**[Action]**` / `**[Verify]**`, KHÔNG `- *Expected:*` sau bước. **Expected:** 1 bullet cụ thể (không ✅/❌).
 - Phân nhóm GUI/Functional · cuối file: **Trace matrix** (BR↔TC, ⚠️ TC thiếu BR) + **bảng TC bị block** · KHÔNG `#### Python Test Mapping` · bỏ nội dung gạch ngang.

package/core/skills/qc/qa-designer/integration/api.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Integration API
@@ -20,7 +20,7 @@ verify luồng dữ liệu & contract giữa các thành phần. Chỉ cần loa
 ---
 
 ## Format file TC (bắt buộc)
-- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAPS.md)` (TC chặn vẫn viết đủ).
+- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAP.md)` (TC chặn vẫn viết đủ).
 - **Test Data** dạng list · **Steps** `[Action]`/`[Verify]` · **Expected** 1 bullet nêu rõ chặng verify (response/bản ghi/event).
 - Cuối file: Trace matrix + bảng TC block · bỏ nội dung gạch ngang.
 

package/core/skills/qc/qa-designer/integration/db.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Integration DB
@@ -18,7 +18,7 @@ insert/update/soft-delete đúng giá trị, side-effect, toàn vẹn. Chỉ c
 ---
 
 ## Format file TC (bắt buộc)
-- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAPS.md)`.
+- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAP.md)`.
 - **Test Data** dạng list (giá trị input) · **Steps** `[Action]`/`[Verify]` · **Expected** 1 bullet nêu rõ **bảng.cột = giá trị**.
 - Cuối file: Trace matrix + bảng TC block · bỏ nội dung gạch ngang.
 

package/core/skills/qc/qa-designer/integration/gui.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Integration GUI ↔ Backend
@@ -19,7 +19,7 @@ lỗi từ server, đồng bộ trạng thái hai chiều. Chỉ cần load file
 ---
 
 ## Format file TC (bắt buộc)
-- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAPS.md)`.
+- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAP.md)`.
 - **Test Data** dạng list · **Steps** `[Action]`/`[Verify]` · **Expected** 1 bullet (API liên quan + biểu hiện UI kỳ vọng).
 - Cuối file: Trace matrix + bảng TC block · bỏ nội dung gạch ngang.
 

package/core/skills/qc/qa-designer/integration/kafka.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Integration Kafka (Message/Event)
@@ -18,7 +18,7 @@ Skill **tự chứa** để viết TC tích hợp qua Kafka: producer phát even
 ---
 
 ## Format file TC (bắt buộc)
-- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAPS.md)`.
+- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAP.md)`.
 - **Test Data** dạng list (payload) · **Steps** `[Action]`/`[Verify]` · **Expected** 1 bullet nêu **topic + field payload / hành vi consumer**.
 - Cuối file: Trace matrix + bảng TC block · bỏ nội dung gạch ngang.
 

package/core/skills/qc/qa-designer/non-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Test Case — Non-Functional
@@ -18,7 +18,7 @@ Trọng tâm "hệ thống hoạt động TỐT thế nào". Chỉ cần load fi
 ---
 
 ## Format file TC (bắt buộc)
-- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAPS.md)`.
+- Metadata **list**: Title · Feature · Priority · Status(Draft) · Author(AI) · Tags · **Trace** `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)` (không có → `⚠️ Chưa có Business Rule`) · **🚫 Block** `[GAP-xx](DOC_GAP.md)`.
 - **Test Data** dạng list · **Steps** `[Action]`/`[Verify]` · **Expected** 1 bullet có **ngưỡng đo cụ thể** (không "nhanh/ổn định").
 - Cuối file: Trace matrix + bảng TC block · bỏ nội dung gạch ngang.
 

package/core/skills/qc/qa-planner/risk-model.md

@@ -0,0 +1,106 @@
+---
+version: 1.0
+updated: 2026-08-25
+ported_from: ui-automation-testing
+upstream_path: skills/qa-tc-analyst/risk-acceptance-analyzer.md
+upstream_sha: 5eca5091acd30e063d20b63f12b04e2d1c78ac83
+port_completeness: partial
+---
+
+# Risk Model — cách tính mức rủi ro và dùng nó để chia độ sâu test
+
+`test-plan.md` có **khung** bảng rủi ro (`§6`) nhưng không có **cách điền**. File này là cách điền.
+
+Nạp cùng `test-plan.md` khi lập plan. Đầu ra không phải file riêng — nó điền vào `§6 Rủi ro`
+và `§5 Tiêu chí Vào/Ra` của `TEST_PLAN.md`.
+
+## Cố ý chỉ port một phần
+
+Bản upstream (`risk-acceptance-analyzer`) có 5 phase. Ba phase bị **cố ý bỏ** vì trạm 1 đã làm rồi:
+
+| Phase upstream | Vì sao không port |
+|---|---|
+| Test Conditions | trùng vai với `qa-analyst/spec-breakdown` + `business-rules` (trạm 1) |
+| Ambiguity & Gap | trùng vai với `DOC_GAP` + `steps/gap-verify.md` (trạm 1) |
+| Acceptance Criteria | trùng vai với `qa-analyst/acceptance-criteria` (trạm 1) |
+
+Chỉ port **Phase 3 (Risk Register)** và **Phase 5 (Ưu tiên + Entry/Exit)** — hai phần trạm 2 sở hữu.
+
+*Ghi `port_completeness: partial` ở frontmatter — lần đồng bộ sau đừng hiểu phần thiếu là
+"ta cố ý xoá nội dung".*
+
+---
+
+## Bước 1 — Liệt kê rủi ro sản phẩm
+
+Bảy nguồn rủi ro. Quét từng cái, không bỏ nguồn nào chỉ vì "feature này chắc không có":
+
+| # | Nguồn | Dấu hiệu trong PRD/BR |
+|---|---|---|
+| 1 | **Logic phức tạp** | nhiều điều kiện AND/OR lồng nhau, bảng định tuyến, công thức tính |
+| 2 | **Tiền / thanh toán** | giao dịch, hoàn tiền, mã giảm giá, hạn mức |
+| 3 | **Dữ liệu nhạy cảm** | thông tin cá nhân, số điện thoại, thông tin định danh |
+| 4 | **Tích hợp nhiều phần** | gọi dịch vụ khác, hàng đợi sự kiện, đồng bộ dữ liệu |
+| 5 | **Code mới hoặc sửa nhiều** | feature xây mới, hoặc vùng vừa refactor |
+| 6 | **Lịch sử lỗi cao** | vùng đã từng có bug — tra `{paths.bug_reports_dir}` cho UC/feature này |
+| 7 | **Ảnh hưởng nhiều người dùng** | luồng chính mọi người đều đi qua, màn đăng nhập, trang chủ |
+
+> Nguồn 6 là nguồn duy nhất **tra được bằng dữ liệu thật** trong framework — sổ bug nằm ở
+> `{paths.bug_reports_dir}`. Đừng đoán "vùng này chắc ổn"; mở ra đếm.
+
+## Bước 2 — Chấm mức cho từng rủi ro
+
+Hai chiều, mỗi chiều ba mức:
+
+- **Khả năng xảy ra** — Cao / Trung bình / Thấp
+- **Mức thiệt hại nếu xảy ra** — Cao / Trung bình / Thấp
+
+Nhân lại ra **P0 → P3**:
+
+| Khả năng \ Thiệt hại | Cao | Trung bình | Thấp |
+|---|:---:|:---:|:---:|
+| **Cao** | **P0** | **P1** | P2 |
+| **Trung bình** | **P1** | P2 | P3 |
+| **Thấp** | P2 | P3 | P3 |
+
+> **Chấm hai chiều riêng rồi mới nhân** — đừng chấm thẳng ra P0/P1 theo cảm tính. Hai chiều
+> tách nhau là chỗ tranh luận trở nên cụ thể: *"cái này thiệt hại cao nhưng khả năng thấp"*
+> là một câu nói được, còn *"cái này P1"* thì không cãi được, chỉ tin hoặc không tin.
+
+## Bước 3 — Dùng mức rủi ro để chia **độ sâu** test
+
+Đây là chỗ bảng rủi ro trả lại giá trị. Không có bước này thì nó chỉ là một bảng trang trí.
+
+| Mức | Test sâu tới đâu | Tự động hoá |
+|---|---|---|
+| **P0** | nhiều kỹ thuật cùng lúc: phân lớp tương đương + giá trị biên + bảng quyết định + chuyển trạng thái | ✅ ưu tiên — cả kiểm thử hồi quy |
+| **P1** | hai kỹ thuật trở lên, phủ đủ nhánh chính + nhánh lỗi | ✅ nếu ổn định |
+| **P2** | một kỹ thuật, phủ luồng thuận + một nhánh lỗi tiêu biểu | tuỳ |
+| **P3** | danh sách kiểm tay, không cần test case đầy đủ | ❌ |
+
+**Thứ tự chạy:** rủi ro cao **và** phụ thuộc thấp làm trước — không phải "P0 làm hết rồi mới tới P1".
+Một P0 đang chờ gap chặn thì không chạy được; làm P1 sẵn sàng trước là đúng.
+
+**Tháp test:** end-to-end tự động **chỉ** cho luồng P0/P1 trọng yếu. E2E cho P2/P3 là đắt và giòn —
+tiền không đáng.
+
+## Bước 4 — Điền Entry / Exit theo rủi ro
+
+`test-plan.md §5` đã có khung. Rủi ro làm nó cụ thể hơn:
+
+- **Entry** — mọi gap 🔴 chặn đã `Answered`; **và** mọi rủi ro P0 đã có ít nhất một cách giảm thiểu ghi rõ.
+- **Exit** — phủ 100% vùng P0 · không còn defect mở ở vùng P0/P1 · tỉ lệ pass đạt ngưỡng đã khai.
+
+> **Rủi ro P0 không có cách giảm thiểu = chưa đủ điều kiện bắt đầu.** Ghi ra một rủi ro rồi
+> không nói làm gì với nó là ghi cho có.
+
+---
+
+## Điền vào `TEST_PLAN.md §6`
+
+| Rủi ro | Nguồn (1–7) | Khả năng | Thiệt hại | Mức | Giảm thiểu (loại test + kỹ thuật) |
+|---|---|---|---|---|---|
+| … | 2 · tiền | Cao | Cao | **P0** | functional/api + giá trị biên; e2e luồng thanh toán |
+
+Mỗi dòng rủi ro phải **trỏ được về BR-xx hoặc GAP-xx** đã có ở `REQUIREMENT_ANALYSIS.md` /
+`DOC_GAP.md` — rủi ro không neo vào yêu cầu nào là rủi ro tự nghĩ ra.

package/core/skills/qc/qa-planner/test-plan.md

@@ -1,7 +1,9 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
+upstream_path: skills/qa-tc-analyst/test-plan.md
+upstream_sha: f259b4d123c565a42ba6c6ec96980a8e4c66284f
 ---
 
 # Lập Test Plan
@@ -10,15 +12,15 @@ Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
 
 **Đầu vào (bắt buộc, chỉ 2 nguồn — đúng 2 file qa-analyst trả ra):**
 1. `{paths.qc_dir}/{UC-ID}/REQUIREMENT_ANALYSIS.md` — chức năng, BR-xx, AC-xx, data flow (qa-analyst).
-2. `{paths.qc_dir}/{UC-ID}/DOC_GAPS.md` — bảng gap GAP-xx, mức độ, gap Blocker (qa-analyst).
+2. `{paths.qc_dir}/{UC-ID}/DOC_GAP.md` — bảng gap GAP-xx, mức độ, gap Blocker (qa-analyst).
 
 ## Khi nào trigger
 - "lập test plan cho [Feature]" / "viết test plan"
-- Sau khi qa-analyst xong (đã có REQUIREMENT_ANALYSIS + DOC_GAPS)
+- Sau khi qa-analyst xong (đã có REQUIREMENT_ANALYSIS + DOC_GAP)
 - Trước khi qa-designer thiết kế chi tiết TC — test plan là khung định hướng
 
 ## Khi KHÔNG trigger
-- Chưa có REQUIREMENT_ANALYSIS / DOC_GAPS → chạy qa-analyst trước
+- Chưa có REQUIREMENT_ANALYSIS / DOC_GAP → chạy qa-analyst trước
 - Thiết kế test case chi tiết (.Test.md) → dùng qa-designer
 - Bóc tách yêu cầu/spec, lập danh sách gap → dùng qa-analyst
 
@@ -28,7 +30,7 @@ Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
 
 1. Đọc `REQUIREMENT_ANALYSIS.md`: nắm chức năng, các BR-xx và AC-xx, data flow,
    integration/failure point.
-2. Đọc `DOC_GAPS.md`: lấy danh sách gap, đặc biệt **gap Blocker còn Open** → đây là
+2. Đọc `DOC_GAP.md`: lấy danh sách gap, đặc biệt **gap Blocker còn Open** → đây là
    nguồn cho cột "Phụ thuộc" và cho Entry criteria.
 3. Map mỗi nhóm BR sang **layer test** của qa-designer: functional/gui-screen,
    gui-feature, api, integration, e2e/journey, non-functional.
@@ -47,7 +49,8 @@ Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
   criteria yêu cầu đóng các gap đó trước khi thiết kế TC.
 - Liệt kê **E2E journey** đầy đủ (mỗi journey: tiền điều kiện, kết quả/định tuyến kỳ
   vọng, BR, phụ thuộc, priority) + bộ **verify point chung** sau submit.
-- Mục Rủi ro: rút trực tiếp từ gap Blocker + các BR logic phức tạp.
+- Mục Rủi ro: **nạp `risk-model.md`** — quét đủ 7 nguồn, chấm khả năng × thiệt hại → P0–P3,
+  rồi dùng mức đó chia độ sâu test. Đừng chấm thẳng ra P0/P1 theo cảm tính.
 
 ---
 
@@ -63,7 +66,7 @@ Tổng hợp **output của qa-analyst** thành **Test Plan** cho một feature.
 | Feature / Project / Module | … |
 | Người lập | qa-planner |
 | Ngày / Phiên bản | … |
-| Nguồn | REQUIREMENT_ANALYSIS · DOC_GAPS |
+| Nguồn | REQUIREMENT_ANALYSIS · DOC_GAP |
 
 ## 1. Mục tiêu
 Mục tiêu test của feature (1–3 câu).
@@ -95,12 +98,12 @@ Kỹ thuật áp dụng: EP+BVA, Decision Table (cho logic điều kiện), stat
 integration, negative/exploratory; tự động hoá theo `CLAUDE.md` (Playwright + pytest-playwright + Trace + pytest-html).
 
 ## 5. Tiêu chí Vào / Ra
-- **Entry:** gap Blocker (trong DOC_GAPS) đã Answered; doc phụ thuộc sẵn sàng; môi trường + tài khoản role.
+- **Entry:** gap Blocker (trong DOC_GAP) đã Answered; doc phụ thuộc sẵn sàng; môi trường + tài khoản role.
 - **Exit:** pass P0=100%, P1≥95%; không còn defect Blocker/Critical; mọi BR/AC được trace; báo cáo pytest-html + Playwright Trace.
 
 ## 6. Rủi ro (risk-based)
-| Rủi ro | Ảnh hưởng | Mức | Giảm thiểu |
-(rút từ gap Blocker + BR logic phức tạp)
+| Rủi ro | Nguồn | Khả năng | Thiệt hại | Mức | Giảm thiểu |
+(cách chấm mức + 7 nguồn rủi ro + cách dùng mức để chia độ sâu test: xem `risk-model.md`)
 
 ## 7. Dữ liệu & Môi trường
 Tài khoản các role, dữ liệu mẫu (biên/edge), môi trường staging.

package/core/skills/qc/qa-reviewer/script/e2e.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — E2E Journey

package/core/skills/qc/qa-reviewer/script/exploratory.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Session Note — Exploratory

package/core/skills/qc/qa-reviewer/script/functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — Functional

package/core/skills/qc/qa-reviewer/script/integration.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — Integration

package/core/skills/qc/qa-reviewer/script/non-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Script — Non-Functional

package/core/skills/qc/qa-reviewer/test-case/e2e.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — E2E Journey

package/core/skills/qc/qa-reviewer/test-case/exploratory.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Charter — Exploratory

package/core/skills/qc/qa-reviewer/test-case/functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — Functional

package/core/skills/qc/qa-reviewer/test-case/integration.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — Integration
@@ -21,7 +21,7 @@ Review bộ TC tích hợp (GUI↔Backend, API, DB) và đánh giá chất lư
 ## Phase 1 — Clarify
 
 1. Đọc tất cả TC integration trong folder chỉ định; xác định loại: GUI↔Backend / API / DB
-2. Đọc REQUIREMENT_ANALYSIS + DOC_GAPS nếu có
+2. Đọc REQUIREMENT_ANALYSIS + DOC_GAP nếu có
 3. Xác định chuỗi tích hợp (caller → component → downstream)
 
 ---

package/core/skills/qc/qa-reviewer/test-case/non-functional.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Review Test Case — Non-Functional

package/core/skills/qc/qa-runner/e2e.md

@@ -1,7 +1,7 @@
 ---
 version: 1.0
 updated: 2026-06-11
-ported_from: ai-automation-qc-base
+ported_from: ui-automation-testing
 ---
 
 # Gen Script — E2E Journey