@anhth2/spec-driven-dev-plugin 0.10.0 → 0.12.0

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

@@ -0,0 +1,46 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Functional GUI Feature (đa màn hình)
+
+Skill **tự chứa** để viết TC functional cho feature có luồng span ≥ 2 màn hình
+(wizard, master-detail, popup→list). Chỉ cần load file này.
+
+## Khi nào trigger
+- "viết test case cho feature [X]" mà flow đi qua nhiều màn/route, truyền state giữa bước
+
+## Khi KHÔNG trigger
+- Gọn trong 1 màn → `functional/gui-screen` · API thuần → `functional/api`
+- Hành trình nghiệp vụ đầu-cuối + đồng bộ hệ thống → `e2e/journey`
+
+---
+
+## Format file `TC_<FEATURE>.md` (bắt buộc)
+- 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`.
+- **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.
+
+## Kỹ thuật áp dụng
+- **Use Case** cho flow tổng: main (P0) → alternate (P1) → exception (negative).
+- **Decision Table** cho điểm rẽ nhánh (điều kiện qua bước/nhảy màn).
+- **State Transition** nếu có trạng thái xuyên bước (draft→submitted…).
+- **EP/BVA** cho field trên từng màn.
+
+## Phase 1 — Clarify
+Liệt kê các màn/route + thứ tự điều hướng · state/dữ liệu truyền giữa màn (giữ/reset khi back) ·
+điểm rẽ nhánh · platform · CRUD scope · cleanup.
+
+## Phase 2 — Write
+- Nhóm TC: GUI từng màn → **điều hướng** (forward/back/giữ-reset state, deep-link) → happy path xuyên flow → negative.
+- Đặc biệt phủ: back có mất dữ liệu không, dữ liệu bắt buộc để qua bước sau, hủy giữa flow.
+- Mỗi TC bám khối Format; trace BR; gap chặn → 🚫 Block.
+
+## Output
+File `TC_<FEATURE>.md` trong `{paths.qc_dir}/{UC-ID}/test-cases/`. In bảng TC + Trace matrix + bảng TC block.
+Bàn giao `qa-reviewer` (test-case).

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

@@ -0,0 +1,52 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Functional GUI Screen (1 màn hình)
+
+Skill **tự chứa** để viết TC functional cho 1 màn hình đơn lẻ (web/mobile). Chỉ cần load file này.
+
+## Khi nào trigger
+- "viết test case cho màn hình [X]" — feature gọn trong 1 screen (1 page web / 1 Activity/VC)
+
+## Khi KHÔNG trigger
+- Flow span ≥ 2 màn → `functional/gui-feature`
+- API không qua UI → `functional/api`
+- Tích hợp 2+ module → `integration/*` · hành trình đầu-cuối → `e2e/journey`
+
+---
+
+## Format file `TC_<FEATURE>.md` (bắt buộc)
+- 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.
+- **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.
+
+## Kỹ thuật áp dụng
+- Field có ràng buộc (độ dài/số/ngày) → **EP** (mỗi phân vùng 1 TC, tag `ep`) + **BVA** (4 TC min−1/min/max/max+1, tag `bva`).
+- Logic nhiều điều kiện / cascade dropdown / permission → **Decision Table** (mỗi rule = 1 TC).
+- Element/đối tượng có trạng thái enabled/disabled, vòng đời → **State Transition** (chuyển đổi hợp lệ + cấm).
+- Luồng thao tác trên màn → **Use Case** (main P0 → alternate P1 → exception negative).
+
+## Phase 1 — Clarify
+Platform (web Playwright/mobile) · screen+route · domain (form-crud/listing/auth/settings) · CRUD scope ·
+mutating actions OK? · cleanup policy. Thiếu → hỏi trước khi viết.
+
+## Phase 2 — Explore
+Dump element: buttons, inputs, dropdowns, table headers, modal states. Mỗi element →
+chức năng (input/action/display/nav) · constraint (required/min-max/format/enabled) · state change · câu hỏi "what if".
+
+## Phase 3 — Write
+- **Nhóm 1 GUI:** title → buttons → inputs → date picker → dropdowns → bảng (header→row count→checkbox→từng cột) → pagination.
+- **Nhóm 2 Functional:** filter (đơn→combined) → search → reset → pagination → data integrity → actions → negative.
+- Phủ implicit: rate limit, concurrent, session, empty state, max data, special chars.
+- Mỗi TC bám khối Format trên; trace BR; TC chặn bởi gap → 🚫 Block.
+
+## Output
+File `TC_<FEATURE>.md` trong `{paths.qc_dir}/{UC-ID}/test-cases/`. In bảng `TC_ID | Title | Priority | Tags | Trace`
++ Trace matrix + bảng TC block. Bàn giao `qa-reviewer` (test-case).

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

@@ -0,0 +1,42 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Integration API
+
+Skill **tự chứa** để viết TC tích hợp qua API: caller → API → service/DB/hệ thống ngoài,
+verify luồng dữ liệu & contract giữa các thành phần. Chỉ cần load file này.
+
+## Khi nào trigger
+- Test điểm tích hợp API ↔ service backend / hệ thống ngoài (vd LMS ↔ CRM)
+- Verify dữ liệu sau gọi API lan tới chặng tiếp (DB/event)
+
+## Khi KHÔNG trigger
+- Chỉ verify request/response 1 endpoint → `functional/api`
+- Verify riêng trạng thái DB → `integration/db` · message/event → `integration/kafka`
+
+---
+
+## 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 đủ).
+- **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.
+
+## Kỹ thuật áp dụng
+- **Interface/Contract:** verify schema request/response giữa caller↔callee.
+- **Data flow verification:** theo sơ đồ data flow, mỗi chặng verify dữ liệu biến đổi đúng.
+- **Decision Table** khi định tuyến/đồng bộ phụ thuộc nhiều điều kiện.
+- **Error/Retry/Timeout/Concurrency:** failure point, thao tác đồng thời (sinh số không trùng).
+
+## Phase 1 — Clarify
+Chuỗi tích hợp (caller→API→service/DB/API ngoài) · contract mỗi interface · điều kiện định tuyến/đồng bộ
+(vd điều kiện đổ CRM) · failure point (timeout, lỗi service ngoài, partial commit).
+
+## Phase 2 — Write
+Nhóm TC: happy (dữ liệu đúng đầu→cuối) → contract negative (input sai → mã lỗi đúng) → failure/timeout/retry
+→ concurrency → điều kiện đồng bộ (đổ/không đổ). Mỗi TC bám Format; trace BR; gap chặn → 🚫 Block.
+
+## Output
+File TC integration trong `{paths.qc_dir}/{UC-ID}/test-cases/`. Ưu tiên P0 cho định tuyến & tiền-dữ liệu. Bàn giao `qa-reviewer`.

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

@@ -0,0 +1,39 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Integration DB
+
+Skill **tự chứa** để viết TC verify **trạng thái dữ liệu trong DB** sau action:
+insert/update/soft-delete đúng giá trị, side-effect, toàn vẹn. Chỉ cần load file này.
+
+## Khi nào trigger
+- Kiểm tra bản ghi DB sau thao tác (tạo ticket → ghi đúng bảng/cột); soft-delete, default, audit log
+
+## Khi KHÔNG trigger
+- Chỉ verify response API → `functional/api`/`integration/api` · message/event → `integration/kafka`
+
+---
+
+## 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)`.
+- **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.
+
+## Kỹ thuật áp dụng
+- **State/DB verification:** verify bản ghi sau action (giá trị từng cột, flag, timestamp).
+- **Data flow:** dữ liệu từ input lan tới DB đúng. **Decision Table** nếu ghi phụ thuộc điều kiện.
+
+## Phase 1 — Clarify
+Bảng & cột bị ảnh hưởng + giá trị kỳ vọng · loại thao tác (insert/update/soft-delete/cascade) ·
+side-effect (audit log, timestamp, người tạo/sửa) · cleanup/rollback dữ liệu test.
+
+## Phase 2 — Write
+Nhóm TC: ghi đúng giá trị (happy) → default/null đúng → update không đụng cột khác → soft-delete (flag đúng)
+→ audit log → ràng buộc/unique (negative). Mỗi TC bám Format; trace BR; gap chặn → 🚫 Block.
+
+## Output
+File TC trong `{paths.qc_dir}/{UC-ID}/test-cases/`. Ghi rõ query kiểm tra DB + yêu cầu cleanup;
+không hardcode ID, chuẩn bị/dọn data qua fixture. Bàn giao `qa-reviewer`.

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

@@ -0,0 +1,40 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Integration GUI ↔ Backend
+
+Skill **tự chứa** để viết TC tích hợp UI ↔ backend: UI gọi API đúng, render đúng kết quả/
+lỗi từ server, đồng bộ trạng thái hai chiều. Chỉ cần load file này.
+
+## Khi nào trigger
+- UI phản ánh đúng dữ liệu/lỗi backend (lookup, list, validate server-side); UI gọi đúng API + xử lý response
+
+## Khi KHÔNG trigger
+- Chỉ test layout/element tĩnh 1 màn → `functional/gui-screen`
+- Chỉ test API không qua UI → `functional/api`/`integration/api`
+
+---
+
+## 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)`.
+- **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.
+
+## Kỹ thuật áp dụng
+- **Data flow UI→API→UI:** verify request gửi đúng + render response đúng.
+- **Error handling:** lỗi server (4xx/5xx) → message UI đúng. **State:** loading/empty/error.
+
+## Phase 1 — Clarify
+Điểm UI gọi backend (action→API) · mapping response→hiển thị (list/dropdown/message) ·
+trạng thái loading/empty/error · debounce/cancel khi đổi input.
+
+## Phase 2 — Write
+Nhóm TC: UI render đúng dữ liệu backend (happy) → empty state → lỗi server → message đúng → loading state
+→ đổi input reset/cancel request → đồng bộ sau action (tạo xong → list cập nhật). Locator ưu tiên data-testid/role.
+Mỗi TC bám Format; trace BR; gap chặn → 🚫 Block.
+
+## Output
+File TC trong `{paths.qc_dir}/{UC-ID}/test-cases/`. Mỗi TC nêu API liên quan + biểu hiện UI. Bàn giao `qa-reviewer`.

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

@@ -0,0 +1,40 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Integration Kafka (Message/Event)
+
+Skill **tự chứa** để viết TC tích hợp qua Kafka: producer phát event đúng, consumer xử lý
+đúng, đảm bảo ordering/idempotency/retry. Chỉ cần load file này.
+
+## Khi nào trigger
+- Action sinh event Kafka (vd tạo ticket → phát event sang service/CRM); verify topic/payload/thứ tự/khử trùng
+
+## Khi KHÔNG trigger
+- Tích hợp đồng bộ qua API → `integration/api` · verify DB → `integration/db`
+
+---
+
+## 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)`.
+- **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.
+
+## Kỹ thuật áp dụng
+- **Message/event:** verify topic, key, payload schema, điều kiện phát.
+- **Ordering & idempotency:** thứ tự theo key, message trùng/out-of-order.
+- **Error/Retry:** consumer lỗi → retry/DLQ.
+
+## Phase 1 — Clarify
+Topic/key/payload + điều kiện phát (khi nào phát/không) · consumer xử lý gì + side-effect + idempotent ·
+yêu cầu ordering · xử lý trùng/out-of-order/lỗi (retry, DLQ).
+
+## Phase 2 — Write
+Nhóm TC: phát đúng topic+payload (happy) → điều kiện không phát → consumer xử lý đúng → message trùng (idempotent)
+→ out-of-order → consumer lỗi → retry/DLQ → ordering theo key. Setup/teardown consumer test.
+Mỗi TC bám Format; trace BR; gap chặn → 🚫 Block.
+
+## Output
+File TC trong `{paths.qc_dir}/{UC-ID}/test-cases/`. Mỗi TC ghi topic, key, payload cần verify + hành vi consumer. Bàn giao `qa-reviewer`.

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

@@ -0,0 +1,40 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Test Case — Non-Functional
+
+Skill **tự chứa** để viết TC phi chức năng: performance, security, accessibility, compatibility.
+Trọng tâm "hệ thống hoạt động TỐT thế nào". Chỉ cần load file này.
+
+## Khi nào trigger
+- Yêu cầu hiệu năng/tải, bảo mật, accessibility, tương thích; feature có SLA, dữ liệu nhạy cảm, hoặc data lớn
+
+## Khi KHÔNG trigger
+- Kiểm thử chức năng theo đặc tả → `functional/*` · tích hợp module → `integration/*`
+
+---
+
+## 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)`.
+- **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.
+
+## Kỹ thuật / loại
+- **Performance:** response time dưới tải mục tiêu; danh sách lớn (max data); pagination; concurrency.
+- **Security:** authZ/role (truy cập trái phép → chặn), injection, PII (SĐT) không lộ, session/timeout, rate limit.
+- **Accessibility:** keyboard nav, focus, label/aria, contrast (WCAG).
+- **Compatibility:** trình duyệt/thiết bị/độ phân giải mục tiêu.
+
+## Phase 1 — Clarify
+Loại non-functional + tiêu chí đo (ngưỡng cụ thể: thời gian, số user, WCAG level) · môi trường & công cụ
+(load tool, scanner, axe/lighthouse) · dữ liệu/tải mẫu.
+
+## Phase 2 — Write
+Mỗi TC bám Format; **Expected có ngưỡng pass + công cụ đo**; đánh dấu TC cần môi trường/data đặc biệt.
+Trace BR; gap chặn → 🚫 Block.
+
+## Output
+File TC non-functional trong `{paths.qc_dir}/{UC-ID}/test-cases/`. Mỗi TC ghi tiêu chí đo + ngưỡng + công cụ. Bàn giao `qa-reviewer`.

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

@@ -0,0 +1,120 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Lập Test Plan
+
+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).
+
+## Khi nào trigger
+- "lập test plan cho [Feature]" / "viết test plan"
+- Sau khi qa-analyst xong (đã có REQUIREMENT_ANALYSIS + DOC_GAPS)
+- 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
+- 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
+
+---
+
+## Phase 1 — Thu thập đầu vào
+
+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à
+   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.
+4. **Bỏ qua nội dung gạch ngang** (đã loại ở qa-analyst) — không đưa vào plan.
+
+---
+
+## Phase 2 — Lập Test Plan
+
+Điền đủ template bên dưới. Nguyên tắc:
+- Mỗi **vùng test** map về BR-xx cụ thể, gắn **Layer + Loại test + Priority + ước lượng TC**;
+  hiển thị **rule chi tiết** ngay trong bảng (cột riêng, dùng `<br>` cho nhiều rule).
+- **Priority theo rủi ro suy ra từ BR + gap:** core function / logic định tuyến / sinh
+  mã / tiền-dữ liệu = P0.
+- Vùng/journey còn phụ thuộc **gap Blocker** → ghi rõ cột "Phụ thuộc" (GAP#); Entry
+  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.
+
+---
+
+## Output — Template `TEST_PLAN.md`
+
+Đặt tại `{paths.qc_dir}/{UC-ID}/TEST_PLAN.md`:
+
+```markdown
+# Test Plan – <Feature>
+
+| Trường | Giá trị |
+|---|---|
+| Feature / Project / Module | … |
+| Người lập | qa-planner |
+| Ngày / Phiên bản | … |
+| Nguồn | REQUIREMENT_ANALYSIS · DOC_GAPS |
+
+## 1. Mục tiêu
+Mục tiêu test của feature (1–3 câu).
+
+## 2. Phạm vi
+- **In scope:** chức năng/BR được test.
+- **Out of scope:** phần để tài liệu/feature khác; nội dung gạch ngang đã loại.
+
+## 3. Test items theo vùng & độ ưu tiên
+Bảng — mỗi vùng kèm rule chi tiết + metadata:
+
+| # | Vùng test | Rule chi tiết | Layer (qa-designer) | Loại test | Pri | Ước lượng |
+|---|---|---|---|---|---|---|
+| ① | <vùng> | **BR-xx:** … <br>**BR-yy:** … | functional/gui-screen | Functional/Negative | P0 | n |
+| … | … | … | … | … | … | … |
+
+> Tổng ước lượng sơ bộ: ~N test case (+ E2E).
+
+### 3.1 Danh sách E2E đầy đủ
+Verify points chung (sau Submit): V1 tạo thành công · V2 mã/ID đúng · V3 hiển thị danh
+sách · V4… · Trục bao phủ: <các chiều tổ hợp>.
+
+| ID | Journey | Tiền điều kiện | Kết quả kỳ vọng | BR | Phụ thuộc | Pri |
+|---|---|---|---|---|---|---|
+| E2E-XX-01 | … | … | … | BR-… | GAP# | P0 |
+
+## 4. Cách tiếp cận (Test approach)
+Kỹ thuật áp dụng: EP+BVA, Decision Table (cho logic điều kiện), state/lookup,
+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.
+- **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)
+
+## 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.
+
+## 8. Deliverables
+Test case `.Test.md`, script Playwright/pytest + Page Object, báo cáo pytest-html + Playwright Trace.
+
+## 9. Lịch trình (milestone phụ thuộc gap)
+| Mốc | Điều kiện | Trạng thái |
+M0 phân tích → M1 đóng gap → M2 thiết kế TC → M3 review TC → M4 chạy → M5 review script.
+
+## 10. Trạng thái hiện tại
+Blocked/Ready + phần có thể làm sớm (không phụ thuộc gap Blocker).
+```
+
+Kết thúc bằng: tóm tắt số vùng test + tổng TC ước lượng + trạng thái (Ready/Blocked dựa
+trên gap Blocker còn Open) và gợi ý bước kế tiếp (bàn giao qa-designer khi đã Ready).

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

@@ -0,0 +1,87 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Test Script — E2E Journey
+
+Review Python pytest script cho test end-to-end và đánh giá chất lượng code.
+
+## Khi nào trigger
+- "review script E2E cho [Feature]" / "check code E2E quality"
+- Sau khi qa-runner sinh script E2E, trước khi merge
+
+## Khi KHÔNG trigger
+- Review script functional 1 màn → `script/functional`
+- Review script integration → `script/integration`
+- Review session note → `script/exploratory`
+
+---
+
+## Phase 1 — Clarify
+
+1. Đọc file Python test E2E được chỉ định (thường `tests/<project>/e2e/test_*.py`)
+2. Đọc các Page Object liên quan (nhiều PO cho nhiều màn)
+3. Đọc TC E2E Markdown gốc để so sánh coverage journey
+
+---
+
+## Phase 2 — Review
+
+Đánh giá theo 6 tiêu chí:
+
+A. JOURNEY COVERAGE:
+- Mỗi journey trong TC E2E có test function tương ứng không?
+- Test function có traverse đủ các màn/module của journey không?
+- Main flow / alternate flow / exception flow đủ không?
+
+B. CROSS-MODULE DATA INTEGRITY:
+- Data nhập ở Page A có được verify ở Page B/DB/hệ thống ngoài không?
+- Assertion sau mỗi chặng (không chỉ assert ở bước cuối)?
+- Không bỏ qua bước trung gian để "shortcut" đến màn cuối?
+
+C. FIXTURE & PRECONDITION:
+- Precondition phức tạp (nhiều entity) có fixture riêng, không inline trong test?
+- Fixture tạo data → có teardown/cleanup tương ứng (yield + cleanup)?
+- Không hardcode ID của entity đã tạo ở bước trước → dùng biến trả về fixture?
+- Fixture scope đúng (`function` cho E2E, không dùng `session`)?
+
+D. WAIT & TIMING:
+- Timeout đủ dài cho navigation giữa màn (≥15s cho `networkidle`)?
+- Không `time.sleep()`; dùng `wait_for_url` / `wait_for_load_state` / `expect(...).to_be_visible`?
+- Không timeout ngắn (<5s) cho API call cross-module?
+
+E. ASSERTION DEPTH:
+- Không chỉ assert URL cuối; phải assert nội dung tại mỗi chặng?
+- Verify đúng data flow: giá trị nhập màn A xuất hiện đúng ở màn B?
+- Negative journey (thất bại giữa chừng): assert đúng màn dừng lại + thông báo lỗi?
+
+F. CONVENTION:
+- Marker `@pytest.mark.e2e` + `@pytest.mark.smoke` (nếu critical journey)?
+- Marker phân loại = tên journey; docstring = TC ID + mô tả journey?
+- `with step(...)` (`from utils.steps`) rõ từng chặng (màn nào → hành động nào)?
+- Docstring ghi TC ID + mô tả journey ngắn?
+
+---
+
+## Checklist chi tiết
+
+### Page Objects
+- Mỗi màn có PO riêng; test không gọi `page.click()` / `page.fill()` trực tiếp.
+- Selector constants khai báo đầu class; không rải rác trong test.
+- Action method `return self` để chain; assertion method gọi `take_screenshot()` cuối.
+
+### Test file
+- Fixture `logged_in_page` hoặc fixture composite (vd `logged_in_as_teacher`) làm base.
+- Không dùng biến global chia sẻ state giữa test function.
+- Compile & collect trước submit: `python3 -m py_compile` + `pytest --collect-only -q`.
+- Số journey collect = số TC E2E trong `.md`.
+
+---
+
+## Output
+
+Mỗi issue: `file:line` | severity | mô tả | suggestion fix.
+Severity: 🔴 fix ngay (missing cleanup, dữ liệu không verify cross-module, shortcut journey) · 🟠 quan trọng (timeout thiếu, assertion chỉ ở bước cuối) · 🟡 nhỏ (style, docstring/title sai).
+Score: A/B/C/D · Top 5 issue cần fix trước merge.

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

@@ -0,0 +1,45 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Session Note — Exploratory
+ 
+Review session note sau khi test, coaching QC cải thiện kỹ năng.
+ 
+## Khi nào trigger
+- "review session note" / sau khi QC hoàn thành exploratory session
+- Khi lead/senior muốn đánh giá chất lượng session của junior
+ 
+## Khi KHÔNG trigger
+- Review Python script → dùng qa-reviewer/script/functional
+- Review charter → dùng qa-reviewer/test-case/exploratory
+ 
+---
+ 
+## Phase 1 — Read
+ 
+Đọc session note .md được chỉ định.
+ 
+---
+ 
+## Phase 2 — Review
+ 
+7 tiêu chí:
+1. CHARTER COMPLETION: Đi đúng charter? Coverage %?
+2. NOTE QUALITY: Ratio #TEST / #BUG ≥ 3:1? Mỗi #TEST có mô tả action + observation?
+3. BUG QUALITY: Steps rõ? Expected/Actual cụ thể? Severity hợp lý?
+4. OBSERVATION DEPTH: Có dùng FEW HICCUPPS? Hay chỉ test surface?
+5. TIME ALLOCATION: Setup <15%, Test >70%, Investigation <15%?
+6. FOLLOW-UP: #QUESTION gửi dev? #IDEA move vào ideas/?
+7. DEBRIEF: Có Summary cuối? Coverage, risks, next recommendation?
+ 
+---
+ 
+## Output
+ 
+Score: A (excellent) / B (good) / C (needs improvement) / D (redo)
+Mỗi tiêu chí: ✅/⚠️/❌ + feedback cụ thể
+Top 3 improvement suggestions (coaching tone)
+Đề xuất charter tiếp theo nếu chưa đủ coverage

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

@@ -0,0 +1,101 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Test Script — Functional
+ 
+Review Python pytest script và đánh giá chất lượng code.
+ 
+## Khi nào trigger
+- "review script cho [Feature]" / "check code quality"
+- Sau khi qa-runner xong, trước khi merge vào main
+ 
+## Khi KHÔNG trigger
+- Review TC nghiệp vụ → dùng qa-reviewer
+- Review exploratory session note → dùng qa-reviewer/script/exploratory
+ 
+---
+ 
+## Phase 1 — Clarify
+ 
+1. Đọc file Python test được chỉ định
+2. Đọc Page Object liên quan
+3. Đọc TC markdown gốc (để so sánh coverage)
+ 
+---
+ 
+## Phase 2 — Review
+ 
+Đánh giá theo 6 tiêu chí:
+ 
+A. LOCATOR:
+- XPath dài/phức tạp → đề xuất data-testid / role
+- Locator phụ thuộc text tiếng Việt → fragile khi đổi copy
+- Locator nằm trong Page Object, KHÔNG hardcode trong test
+- Dùng .first()/[n] → không reliable
+ 
+B. WAIT & TIMING:
+- time.sleep() → phải đổi sang Playwright auto-wait / expect
+- Timeout quá ngắn (<3s) hoặc quá dài (>30s)
+ 
+C. TEST INDEPENDENCE:
+- Hardcode user ID/data ID → fragile
+- Phụ thuộc thứ tự chạy (test_b cần test_a)
+- Thiếu cleanup/teardown khi tạo data
+- Global state
+ 
+D. ASSERTION:
+- assert True / not error → vô nghĩa
+- Chỉ assert URL, không assert content → thiếu
+- Thiếu negative assertion
+ 
+E. CONVENTION:
+- Marker đúng (@pytest.mark.functional + platform)?
+- Tên: test_<feature>_<scenario>_<expected>?
+- Docstring có TC_ID?
+- Fixture từ conftest, không tự tạo browser?
+ 
+F. PAGE OBJECT:
+- Test gọi page.click() trực tiếp → phải qua PO
+- PO method quá dài (>15 dòng) → tách
+ 
+---
+
+## Checklist chi tiết review code
+
+### Phần 1 — Page Object (`pages/<feature>_page.py`)
+- Kế thừa `BasePage`; selector constants `UPPER_SNAKE_CASE` tập trung đầu class (không rải rác).
+- Tách 3 lớp: Locators (`_private()` chỉ trả `Locator`) → Actions (`public()` + `return self`, KHÔNG decorator) → Assertions (`assert_*()` + `expect()` + `take_screenshot()` cuối).
+- Wait: KHÔNG `time.sleep()`; `wait_for_timeout()` chỉ khi cần (≤1000ms); sau nav/submit dùng `wait_for_load_state("networkidle")`; không `wait_for_timeout` ngay sau `networkidle`.
+- KHÔNG hardcode URL/credential/timeout → `Env.*`, `CONFIG`.
+- Column index dùng named constant (`COL_TTHAI = 7`), không magic number `cells[7]`.
+- Assertion: dùng `expect()` cho element; `assert` Python cho logic (count/regex); screenshot tên `TC<NNN>_mo_ta`; KHÔNG silent fail → `raise AssertionError`, không `log.warning`.
+- Lỗi assertion hay gặp: "ordered" phải verify thứ tự thật (`last_pos`); đúng cột; Counter ≠ Pagination total (không assert `==`); P0 strict / P1 `_or_empty`.
+- Public API: có `get_row_count()`, `get_all_rows()` thay vì test gọi `_private()`; helper trả data là method thường (không cần bọc step).
+
+### Phần 2 — Test file (`tests/test_<feature>.py`)
+- Đủ class `TestFeatureUI` / `TestFeatureFunctional` / `TestFeatureNegative`; fixture scope `function`, base `logged_in_page`.
+- KHÔNG Allure: phân loại/độ ưu tiên qua pytest markers (`smoke`/`regression`/domain); docstring/`__doc__` ghi `TC_FEATURE_NNN – …`; Priority khớp marker (P0→smoke, P1/P2→regression).
+- Marker: ≥1 category (`smoke`/`regression`) + 1 domain (`ui`/`filter`/`search`/`pagination`/`action`/`negative`); đã đăng ký `pytest.ini`.
+- Step: bọc bước bằng `with step("…")` (`from utils.steps import step`) rõ Action/Verify; KHÔNG step rỗng `: pass`.
+- Isolation: độc lập thứ tự; không global state; không gọi `_private()` từ test.
+- Logic nghiệp vụ nghi ngờ → `@pytest.mark.xfail(strict=False, reason=...)` giải thích rõ.
+
+### Phần 4 — Tổng quát
+- Compile & collect bắt buộc trước submit:
+  `python3 -m py_compile pages/<f>_page.py tests/test_<f>.py` · `pytest tests/test_<f>.py --collect-only -q`
+- Số test collect = số TC trong `.md`; không warning marker chưa đăng ký.
+- Naming: class `PascalCase`+`Page`; method `test_TC<NNN>_<snake>`; constant `UPPER_SNAKE`; locator `_snake()`; action `verb_noun()`; assert `assert_condition()`.
+
+### Lỗi phổ biến (TC_TRUCLOP)
+empty step `:pass` · test gọi `_private()` · Counter≠Pagination → xfail · "ordered" không verify thứ tự · magic `cells[7]` · silent fail → raise · Reset thiếu domain marker · `wait_for_timeout` thừa sau networkidle · orphan selector constant.
+
+---
+ 
+## Output
+ 
+Mỗi issue: file:line | severity | mô tả | suggestion fix.
+Severity: 🔴 fix ngay (sai logic, POM breach, silent fail) · 🟠 quan trọng (fragile selector, wrong column, missing assert) · 🟡 nhỏ (style, thừa wait, orphan constant).
+Score: A/B/C/D · Top 5 issue cần fix trước.