@anhth2/spec-driven-dev-plugin 0.9.2 → 0.11.0

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

@@ -0,0 +1,73 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Test Case — E2E Journey
+
+Review bộ TC end-to-end và đánh giá chất lượng.
+
+## Khi nào trigger
+- "review TC E2E cho [Feature]" / "check coverage E2E"
+- Sau khi qa-designer/e2e/journey xong, trước khi qa-runner
+
+## Khi KHÔNG trigger
+- Review TC functional 1 màn → `test-case/functional`
+- Review charter exploratory → `test-case/exploratory`
+
+---
+
+## Phase 1 — Clarify
+
+1. Đọc tất cả TC E2E (ID dạng `E2E-<FEATURE>-NN`) trong folder chỉ định
+2. Đọc TEST_PLAN để lấy danh sách journey + trục bao phủ dự kiến
+3. Đọc REQUIREMENT_ANALYSIS nếu có để đối chiếu BR
+
+---
+
+## Phase 2 — Review
+
+Đánh giá theo 4 tiêu chí:
+
+A. COVERAGE (quan trọng nhất):
+- Mỗi journey trong TEST_PLAN có TC tương ứng không?
+- Trục bao phủ (vd role × loại × bộ phận) có đủ không? (Decision Table)
+- Còn alternate flow / exception flow nào chưa có TC?
+
+B. END-TO-END INTEGRITY:
+- Steps có xuyên suốt qua các màn/module liên quan không?
+- Expected có verify **toàn chuỗi**: tạo → định tuyến → đồng bộ → hiển thị danh sách?
+- Data nhập màn A → hiện đúng màn B/DB/hệ thống ngoài không?
+- Verify points chung (V1…Vn) áp nhất quán cho mọi journey?
+
+C. INDEPENDENCE & PRECONDITION:
+- Mỗi journey có tiền điều kiện rõ (data + tài khoản/role) không?
+- Journey phụ thuộc nhau thứ tự? (vi phạm test isolation)
+- Có hướng dẫn cleanup/teardown sau mỗi journey?
+
+D. FORMAT & TRACE:
+- ID đúng dạng `E2E-<FEATURE>-NN`?
+- Mỗi TC có `Trace: [BR-xx]`; nếu không có BR phải ghi `⚠️ Chưa có Business Rule`?
+- TC phụ thuộc gap có dòng `🚫 Block: [GAP-xx]`?
+- Cuối file có Trace matrix + bảng TC block?
+- Expected là 1 bullet tổng hợp (không `✅ PASS/❌ FAIL`, không "hoạt động bình thường")?
+
+---
+
+## Checklist format file `.md`
+
+- **Metadata:** Title · Feature · Priority · Status(Draft) · Author · Tags · Trace · Block — mỗi trường 1 dòng.
+- **Test Data:** dạng list (không bảng); ghi cả tài khoản/role cần dùng.
+- **Steps:** phân biệt `[Action]`/`[Verify]`; KHÔNG có `- *Expected:* ...` sau từng bước.
+- **Expected:** 1 bullet; liệt kê chuỗi verify point rõ ràng.
+- **KHÔNG** có section `#### Python Test Mapping`.
+
+---
+
+## Output
+
+Mỗi tiêu chí: ✅ PASS | ⚠️ PARTIAL | ❌ MISSING + evidence (TC ID / journey)
+Score: A (excellent) / B (good) / C (needs improvement) / D (redo)
+Danh sách journey thiếu TC; TC cần sửa Expected; TC vi phạm isolation.
+Kết luận: sẵn sàng cho `qa-runner` chưa.

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

@@ -0,0 +1,43 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Charter — Exploratory
+ 
+Review chất lượng test charter trước khi QC chạy session.
+ 
+## Khi nào trigger
+- "review charter cho [Feature]"
+- Sau khi qa-designer/exploratory/charter xong, trước khi chạy session
+ 
+## Khi KHÔNG trigger
+- Review TC functional → dùng qa-reviewer/test-case/functional
+- Review session note → dùng qa-reviewer/script/exploratory
+ 
+---
+ 
+## Phase 1 — Read
+ 
+Đọc tất cả charter .md trong folder chỉ định + feature description nếu có.
+ 
+---
+ 
+## Phase 2 — Review
+ 
+7 tiêu chí:
+1. FOCUS: Charter đủ focus chưa? (quá rộng "Explore checkout" → cần narrow)
+2. RISK ALIGNMENT: Target vào risk cao nhất? (tiền → Money Tour, input → Saboteur)
+3. SFDIPOT COVERAGE: Tập hợp charter cover đủ 7 dimension?
+4. TOUR FIT: Tour phù hợp charter?
+5. OVERLAP: 2 charter cover cùng area? → merge
+6. MISSING: Area nào chưa có charter?
+7. TIME BUDGET: Tổng time-box fit resource QC?
+ 
+---
+ 
+## Output
+ 
+Mỗi charter: ✅ PASS | 🔧 REWORK | ✂️ SPLIT | 🔗 MERGE + feedback cụ thể
+Overall assessment + charter bổ sung nếu có gap

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

@@ -0,0 +1,76 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Test Case — Functional
+ 
+Review bộ functional TC và đánh giá chất lượng.
+ 
+## Khi nào trigger
+- "review TC cho [Feature]" / "check coverage"
+- Sau khi qa-designer xong, trước khi PO approve hoặc trước khi qa-runner
+ 
+## Khi KHÔNG trigger
+- Review Python script → dùng qa-reviewer
+- Review charter exploratory → dùng qa-reviewer/test-case/exploratory
+ 
+---
+ 
+## Phase 1 — Clarify
+ 
+1. Đọc tất cả .Test.md trong folder được chỉ định
+2. Đọc requirement/spec/user story nếu QC cung cấp
+3. Nếu không có requirement → review dựa trên TC content (vẫn check internal consistency)
+ 
+---
+ 
+## Phase 2 — Review
+ 
+Đánh giá theo 4 tiêu chí:
+ 
+A. COVERAGE (quan trọng nhất):
+- Requirement nào chưa được phủ?
+- TC nào không trace được về requirement? (TC dư)
+- Thiếu negative / edge / boundary test?
+ 
+B. TECHNIQUE:
+- Field có constraints → có EP + BVA không?
+- Logic AND/OR → có Decision Table không?
+- State → có transition hợp lệ VÀ forbidden không?
+- Thiếu implicit requirement? (rate limit, concurrent, audit, session, security)
+ 
+C. QUALITY:
+- Title rõ scenario + expected?
+- Expected result CỤ THỂ (2 QC test ra cùng kết luận)?
+- Test data có giá trị cụ thể (không placeholder)?
+- Mỗi TC chỉ verify 1 thing?
+- Priority đúng (core function = P0)?
+ 
+D. ANTI-PATTERN:
+- TC chung chung, không actionable?
+- Expected dạng "hiển thị đúng" (cảm tính)?
+- Hardcode credentials/URL?
+ 
+---
+
+## Checklist format file `.md` (đối chiếu skill layer qa-designer)
+
+- **Metadata:** đủ Title, Feature, Priority, Status, Author, Tags, **Trace**; Priority `P0/P1/P2` (không emoji); Status `Draft` text thuần; mỗi trường 1 dòng riêng.
+- **Trace:** mỗi TC link `[BR-xx](REQUIREMENT_ANALYSIS.md#3-business-rules)`; TC không có BR → phải có ⚠️ cảnh báo (không để trống/`—`).
+- **TC bị block:** TC phụ thuộc gap có dòng `🚫 Block: [GAP-xx]`; cuối file có **Trace matrix** (BR↔TC) + **bảng TC bị block** (Gap↔TC).
+- **Test Data:** dạng list (`- **Trường:** giá trị`), không dùng bảng.
+- **Test Steps:** phân biệt `[Action]`/`[Verify]`; KHÔNG có `- *Expected:* ...` sau mỗi bước.
+- **Expected Result:** 1 dòng bullet `-`, cụ thể; KHÔNG `✅ PASS/❌ FAIL`; không viết "hoạt động bình thường".
+- **KHÔNG** có section `#### Python Test Mapping`.
+- **1 concept/TC**; phân nhóm GUI / Functional.
+
+---
+ 
+## Output
+ 
+Mỗi tiêu chí: ✅ PASS | ⚠️ PARTIAL | ❌ MISSING + evidence cụ thể
+Score: A (excellent) / B (good) / C (needs improvement) / D (redo)
+Đề xuất TC cần thêm/sửa/xoá, sắp theo priority. Liệt kê TC thiếu Trace BR (⚠️) cần bổ sung.
+

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

@@ -0,0 +1,69 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Test Case — Integration
+
+Review bộ TC tích hợp (GUI↔Backend, API, DB) và đánh giá chất lượng.
+
+## Khi nào trigger
+- "review TC integration cho [Feature]" / "check TC tích hợp"
+- Sau khi qa-designer/integration/* xong, trước khi qa-runner
+
+## Khi KHÔNG trigger
+- Review TC functional 1 màn/endpoint → `test-case/functional`
+- Review E2E xuyên nhiều module → `test-case/e2e`
+
+---
+
+## 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ó
+3. Xác định chuỗi tích hợp (caller → component → downstream)
+
+---
+
+## Phase 2 — Review
+
+Đánh giá theo 4 tiêu chí:
+
+A. COVERAGE:
+- Mỗi điểm tích hợp (API call / DB write / event) trong chuỗi có TC tương ứng?
+- Đủ nhóm: happy → empty state / null → lỗi server (4xx/5xx) → failure/timeout → concurrency?
+- TC GUI↔Backend: có verify cả request gửi đúng lẫn render response đúng?
+
+B. INTEGRATION DEPTH (theo loại):
+- **GUI↔Backend:** Expected ghi rõ API liên quan + biểu hiện UI; state loading/empty/error đủ.
+- **API:** schema request/response đúng; failure/retry/timeout có TC; định tuyến phụ thuộc điều kiện có Decision Table.
+- **DB:** Expected ghi `bảng.cột = giá trị` cụ thể; có TC soft-delete, audit log, unique constraint; có hướng dẫn cleanup/query kiểm tra.
+
+C. QUALITY:
+- Expected CỤ THỂ (không "phản hồi đúng", "lưu thành công" chung chung)?
+- Test Data đủ (endpoint, payload mẫu, bảng/cột kiểm tra, điều kiện định tuyến)?
+- TC concurrency: mô tả rõ 2+ request đồng thời + kết quả kỳ vọng?
+
+D. FORMAT & TRACE:
+- Metadata đủ; Trace `[BR-xx]` hoặc `⚠️ Chưa có Business Rule`; `🚫 Block: [GAP-xx]` nếu bị chặn?
+- Cuối file có Trace matrix + bảng TC block?
+- Steps phân biệt `[Action]`/`[Verify]`; Expected 1 bullet; KHÔNG `✅/❌` inline.
+
+---
+
+## Checklist format file `.md`
+
+- **Test Data:** dạng list; ghi rõ endpoint/payload/bảng cần kiểm tra.
+- **Expected (DB):** phải có dạng `bảng.cột = giá trị` + query kiểm tra + cleanup instruction.
+- **Expected (API):** ghi mã HTTP + cấu trúc response + downstream effect.
+- **Expected (GUI):** ghi API gọi + biểu hiện UI (message/state/list cập nhật).
+
+---
+
+## Output
+
+Mỗi tiêu chí: ✅ PASS | ⚠️ PARTIAL | ❌ MISSING + evidence (TC ID / điểm tích hợp)
+Score: A (excellent) / B (good) / C (needs improvement) / D (redo)
+Điểm tích hợp thiếu TC; TC Expected mờ nhạt; TC DB thiếu cleanup.
+Kết luận: sẵn sàng cho `qa-runner` chưa.

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

@@ -0,0 +1,73 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Review Test Case — Non-Functional
+
+Review bộ TC phi chức năng (performance, security, accessibility, compatibility) và đánh giá chất lượng.
+
+## Khi nào trigger
+- "review TC non-functional cho [Feature]" / "check TC hiệu năng/bảo mật/accessibility"
+- Sau khi qa-designer/non-functional xong, trước khi qa-runner
+
+## Khi KHÔNG trigger
+- Review TC chức năng → `test-case/functional`
+- Review TC tích hợp → `test-case/integration`
+
+---
+
+## Phase 1 — Clarify
+
+1. Đọc tất cả TC non-functional trong folder chỉ định; xác định loại: performance / security / accessibility / compatibility
+2. Đọc REQUIREMENT_ANALYSIS để lấy SLA, ngưỡng, môi trường mục tiêu
+3. Xác định công cụ đo đã được thống nhất (load tool, scanner, axe, lighthouse…)
+
+---
+
+## Phase 2 — Review
+
+Đánh giá theo 4 tiêu chí:
+
+A. COVERAGE (theo loại):
+- **Performance:** đủ scenario tải mục tiêu (normal / peak / max-data / concurrency / pagination)?
+- **Security:** có TC cho authZ/role (truy cập trái phép), injection, PII không lộ, session/timeout, rate limit?
+- **Accessibility:** có TC cho keyboard nav, focus order, label/aria, contrast (WCAG level rõ)?
+- **Compatibility:** liệt kê đủ browser/device/độ phân giải mục tiêu; mỗi target có TC riêng?
+
+B. MEASURABILITY — tiêu chí quan trọng nhất:
+- Expected có **ngưỡng pass cụ thể** không? (vd `< 2s`, `0 critical issues`, `WCAG 2.1 AA`)
+- Expected **không được** dùng: "nhanh", "ổn định", "hiển thị đúng", "bảo mật tốt"
+- Có ghi công cụ đo kèm theo ngưỡng không?
+- Performance TC: ghi rõ số user đồng thời, kích thước data, thời gian tải tối đa?
+- Security TC: ghi rõ payload thử nghiệm (OWASP top 10 input mẫu)?
+
+C. ENVIRONMENT & DATA:
+- TC cần môi trường đặc biệt (load test server, staging) có ghi chú rõ không?
+- TC cần data lớn / pre-populated data có hướng dẫn chuẩn bị?
+- Cleanup / teardown sau mỗi TC (đặc biệt security test)?
+
+D. FORMAT & TRACE:
+- Metadata đủ; Trace `[BR-xx]` / SLA source rõ; `🚫 Block: [GAP-xx]` nếu bị chặn?
+- Steps phân biệt `[Action]`/`[Verify]`; Expected 1 bullet; KHÔNG `✅/❌` inline?
+- Cuối file có Trace matrix + bảng TC block?
+
+---
+
+## Checklist format file `.md`
+
+- **Expected:** PHẢI có `ngưỡng + đơn vị + công cụ đo` — không có → ❌ MISSING.
+- **Performance TC:** ghi `concurrent users`, `data volume`, `target response time`.
+- **Security TC:** ghi `attack vector`, `input payload`, `expected block/response`.
+- **Accessibility TC:** ghi `WCAG version + level`, `tool (axe/lighthouse)`.
+- **Compatibility TC:** ghi `browser/OS version + device/resolution`.
+
+---
+
+## Output
+
+Mỗi tiêu chí: ✅ PASS | ⚠️ PARTIAL | ❌ MISSING + evidence (TC ID)
+Score: A (excellent) / B (good) / C (needs improvement) / D (redo)
+Danh sách TC Expected mờ nhạt (thiếu ngưỡng); loại non-functional thiếu coverage.
+Kết luận: sẵn sàng cho `qa-runner` chưa; ghi rõ TC nào cần môi trường đặc biệt.

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

@@ -0,0 +1,49 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Gen Script — E2E Journey
+
+Skill **tự chứa**: convert journey `.Test.md` → Python pytest + Playwright đầu→cuối xuyên nhiều màn/module. Chỉ cần load file này.
+
+## Khi nào trigger
+- Convert TC E2E journey (output qa-designer e2e/journey) sang script; TC đã Reviewed
+
+## Khi KHÔNG trigger
+- Test 1 màn/field → `functional/*` · 1 điểm tích hợp → `integration.md`
+
+## Quy ước script (bám CLAUDE.md)
+- Tiền đề: `.Test.md` đã Reviewed. KHÔNG hardcode → `Env.*`/`CONFIG`; KHÔNG `time.sleep()` → `expect()`.
+- Dùng chuỗi Page Object xuyên các màn; verify points (V1…Vn) thành các `assert_*()` rõ ràng.
+- **Tiền điều kiện qua fixture** (tài khoản role, dữ liệu lớp/buổi); **cleanup** sau journey; mỗi journey độc lập.
+- Cần verify hệ thống ngoài (DB/CRM) → client/fixture riêng. Bọc mỗi chặng `with step("…")` (`from utils.steps import step`, **KHÔNG Allure**); assertion `expect()`; marker `@pytest.mark.e2e`.
+- Naming: class `TestFeatureE2E`, method `test_E2E_<NN>_<snake>`.
+
+## Phase 1 — Clarify
+Đọc journey `.Test.md` · các màn/PO + hệ thống verify · tài khoản role & data cần dựng · điểm cleanup.
+
+## Phase 2 — Generate
+Mỗi journey → 1 test; bọc từng bước `with step("…")`; cuối journey verify đủ V1…Vn (tạo/mã/định tuyến/đồng bộ/danh sách).
+Journey còn phụ thuộc gap → tạo test `@pytest.mark.skip(reason="GAP-xx")` hoặc xfail.
+
+## Phase 3 — Verify
+`py_compile` + `pytest --collect-only -q` · chạy (môi trường staging + CRM) · cập nhật Status TC.
+**Phân loại FAIL: script-bug vs product-gap** — journey fail vì 1 bước feature chưa wire = gap (giữ FAIL/skip + bằng chứng), không phải lỗi script; sai selector/state mới sửa script.
+
+## Output
+Script `tests/<project>/e2e/test_<feature>.py` + Page Object/client tái dùng. Bàn giao `qa-reviewer`.
+
+## Phase 4 — Report (bắt buộc sau khi chạy test)
+Report = **Playwright Trace viewer + pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết).
+
+1. Chạy test kèm pytest-html (trace đã bật sẵn ở conftest → mỗi test có `test-results/<nodeid>/trace.zip`):
+   ```bash
+   pytest tests/<project>/e2e/test_<feature>.py --html=reports/<feature>/report.html --self-contained-html
+   ```
+2. Gửi cho người dùng:
+   - HTML report: `reports/<feature>/report.html` (self-contained, mở trực tiếp).
+   - Trace từng test (debug step-by-step): `python3 -m playwright show-trace test-results/<nodeid>/trace.zip`.
+   - Tóm tắt: **TOTAL / PASS / FAIL / SKIP** + duration.
+3. TC Fail → mở trace tương ứng để xem timeline/DOM snapshot/network, phân loại script-bug vs product-gap; ghi mô tả lỗi tiếng Việt dễ hiểu vào Status/khối kết quả của `.Test.md`.

package/skills/qc/qa-runner/exploratory/session.md

@@ -0,0 +1,36 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Session Template & Convert Findings — Exploratory
+
+Skill **tự chứa**, 2 mode:
+- **Mode 1:** sinh session note template trước khi test.
+- **Mode 2:** convert findings (#BUG/#IDEA) → bug report + functional TC mới.
+
+## Khi nào trigger
+- Mode 1: "tạo template cho session" / trước exploratory session
+- Mode 2: "convert findings" / "tạo bug report" / sau session
+
+## Khi KHÔNG trigger
+- Sinh charter → `qa-designer/exploratory/charter.md` · review session note → `qa-reviewer/script/exploratory.md`
+
+---
+
+## Mode 1 — Generate Session Template
+Input: charter + tour + tester + time-box. Tạo file gồm: metadata (date/tester/charter/tour/env/data) ·
+`#SETUP` (bước chuẩn bị) · `#TEST` (5–8 gợi ý theo tour) · `#BUG` template (title, severity, steps,
+expected/actual) · `#QUESTION`, `#IDEA` placeholder · summary cuối session.
+→ `docs/<project>/exploratory/sessions/<YYYY-MM-DD>_<tester>.md`
+
+## Mode 2 — Convert Findings
+Input: session note (#BUG + #IDEA).
+- **Bug report** mỗi #BUG: title, severity, priority, steps to reproduce, expected/actual, hypothesis root cause.
+- **Functional TC mới:** mỗi #BUG đã fix → 1–2 TC regression; mỗi #IDEA → TC nếu đủ rõ (hoặc backlog).
+  Đặt đúng layer; bám format TC (Test Data list, Trace BR, 🚫 Block); trace "Origin: Exploratory session <date>".
+- **Weekly summary** (nếu yêu cầu): overview, top findings, coverage gap, recommendations.
+
+## Output
+Mode 1: file session note. Mode 2: bug reports + file TC trong `docs/<project>/<feature>/` + summary.

package/skills/qc/qa-runner/functional/api.md

@@ -0,0 +1,35 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Gen Script — Functional API
+
+Skill **tự chứa**: convert `.Test.md` API → Python pytest (requests/httpx), không qua UI. Chỉ cần load file này.
+
+## Khi nào trigger
+- Convert TC API (output qa-designer functional/api) sang script; TC đã Reviewed
+
+## Khi KHÔNG trigger
+- Test qua UI → `functional/gui-screen.md` · tích hợp đa thành phần → `integration.md`
+
+## Quy ước script (bám CLAUDE.md)
+- Tiền đề: `.Test.md` đã Reviewed. KHÔNG hardcode base URL/token → `Env.*`/`CONFIG`.
+- Client API gói trong helper/fixture (base url, auth header); KHÔNG rải request rời rạc trong test.
+- Assertion: `assert` cho status code + field response (jsonpath); `with step(...)` (`from utils.steps`) cho mỗi call.
+- Marker `@pytest.mark.api` + category; fixture `function`; test độc lập (tạo→cleanup data qua API/teardown).
+- Naming: class `TestFeatureAPI`, method `test_TC<NNN>_<snake>`.
+
+## Phase 1 — Clarify
+Đọc `.Test.md` · base url/auth/role · client/fixture đã có chưa · data setup/cleanup.
+
+## Phase 2 — Generate
+Mỗi TC → 1 test gọi endpoint với request từ Test Data; assert **status code + field body** theo Expected.
+Nhóm happy/validation/auth/not-found/edge. Data từ `test_data/`.
+
+## Phase 3 — Verify
+`py_compile` + `pytest --collect-only -q` · chạy · cập nhật Status TC · in mapping.
+
+## Output
+Script `tests/<project>/functional/api/test_<feature>.py` + API client/fixture nếu mới. Bàn giao `qa-reviewer`.

package/skills/qc/qa-runner/functional/gui-feature.md

@@ -0,0 +1,51 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Gen Script — Functional GUI Feature (đa màn hình)
+
+Skill **tự chứa**: convert `.Test.md` feature span ≥2 màn → Python pytest + Playwright. Chỉ cần load file này.
+
+## Khi nào trigger
+- Convert TC feature đa màn (output qa-designer gui-feature) sang script; TC đã Reviewed
+
+## Khi KHÔNG trigger
+- Gọn 1 màn → `functional/gui-screen.md` · API → `functional/api.md` · đầu-cuối + đồng bộ → `e2e.md`
+
+## Quy ước script (bám CLAUDE.md)
+- Tiền đề: `.Test.md` đã Reviewed. KHÔNG `time.sleep()` → `expect()`/auto-wait; KHÔNG hardcode → `Env.*`/`CONFIG`.
+- **Một Page Object / màn**; điều hướng giữa màn là action trả về PO màn kế (`return NextPage(self.page)`).
+- PO 3 lớp (kế thừa slim `BasePage`, **KHÔNG Allure**) + bọc bước `with step("…")` (`from utils.steps import step`); assertion `expect()`; mọi interaction qua PO; selector constants `UPPER_SNAKE`.
+- Marker + fixture pytest-playwright từ root `tests/conftest.py` (`page`/`logged_in_page`/`logged_in_page_gv`/`login_page`/`dashboard`); test độc lập + cleanup; naming `Test*{...}` / `test_TC<NNN>_<snake>`.
+
+## Phase 1 — Clarify
+Đọc `.Test.md` · liệt kê các màn/PO cần · state truyền giữa màn · fixture dựng tiền điều kiện (data qua nhiều bước).
+**Probe DOM thật trước khi viết selector** (SPA React/Next không `data-testid`): dump class/`aria-label`/role → BEM `feature__el`, carousel dot thường `role="tab"` + class `--active` (không `aria-selected`).
+
+## Phase 2 — Generate
+**PHỦ HẾT 100%**: 1 test cho **MỌI** TC trong file (`grep -cE "^#{2,4} *TC_"` = số test phải sinh), KHÔNG chọn tập đại diện, KHÔNG để TC nào Draft; TC bất khả thi → `pytest.skip`/`xfail` + lý do.
+Bọc mỗi chặng bằng `with step("…")`; dùng chuỗi PO theo điều hướng.
+Phủ TC điều hướng forward/back/giữ-reset state. Data từ `test_data/`. Marker mới (`bva ep e2e`…) đăng ký `pytest.ini`.
+
+## Phase 3 — Verify
+`py_compile` + `pytest --collect-only -q` (**số collect = tổng TC**; thiếu → sinh nốt) · chạy · cập nhật Status TC (verify KHÔNG còn Draft) · in mapping.
+**Gom nhóm role/account** tự áp qua `utils/test_ordering.py` (root conftest); fixture auth mới → `register_auth_fixtures([...])`. ⚠️ Run dài bị **WSL suspend** có thể gây flaky login/timeout → re-run TC đó + merge report.
+**Phân loại FAIL: script-bug (sửa selector/logic, chạy lại) vs product-gap** (feature chưa wire/defect → giữ FAIL + ghi bằng chứng vào khối "Kết quả thực thi" đầu `.Test.md`, không fake-pass).
+
+## Output
+Script + nhiều Page Object (mỗi màn) trong `pages/<project>/...`. Bàn giao `qa-reviewer` (script).
+
+## Phase 4 — Report (bắt buộc sau khi chạy test)
+Report = **Playwright Trace viewer + pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết).
+
+1. Chạy test kèm pytest-html (trace đã bật sẵn ở conftest → mỗi test có `test-results/<nodeid>/trace.zip`):
+   ```bash
+   pytest tests/<project>/.../test_<feature>.py --html=reports/<feature>/report.html --self-contained-html
+   ```
+2. Gửi cho người dùng:
+   - HTML report: `reports/<feature>/report.html` (self-contained, mở trực tiếp).
+   - Trace từng test (debug step-by-step): `python3 -m playwright show-trace test-results/<nodeid>/trace.zip`.
+   - Tóm tắt: **TOTAL / PASS / FAIL / SKIP** + duration.
+3. TC Fail → mở trace tương ứng để xem timeline/DOM snapshot/network, phân loại script-bug vs product-gap; ghi mô tả lỗi tiếng Việt dễ hiểu vào Status/khối kết quả của `.Test.md`.

package/skills/qc/qa-runner/functional/gui-screen.md

@@ -0,0 +1,55 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Gen Script — Functional GUI Screen (1 màn hình)
+
+Skill **tự chứa**: convert `.Test.md` (1 màn) → Python pytest + Playwright. Chỉ cần load file này.
+
+## Khi nào trigger
+- "generate script cho [Screen]" / convert TC sang Python; đã có `.Test.md` (output qa-designer gui-screen), TC đã Reviewed
+
+## Khi KHÔNG trigger
+- Chưa có TC `.md` → chạy qa-designer trước · TC chưa review → qa-reviewer trước
+- Feature cross-screen → `functional/gui-feature.md` · API → `functional/api.md`
+
+## Quy ước script (bám CLAUDE.md)
+- Tiền đề: có `.Test.md` đã Reviewed. KHÔNG `time.sleep()` → `expect()`/auto-wait; KHÔNG hardcode → `Env.*`/`CONFIG`.
+- Page Object 3 lớp (kế thừa slim `BasePage`, **KHÔNG Allure**): locators `_x()` → actions `verb_noun()`+`with step("…")`+`return self` → assertions `assert_x()`+`expect()`; mọi interaction **qua PO** (không `page.click()` trực tiếp); selector constants `UPPER_SNAKE` đầu class.
+- Bọc bước bằng `with step("…")` (`from utils.steps import step`) — **KHÔNG Allure** · marker category+domain (đăng ký `pytest.ini`) · fixture pytest-playwright từ root `tests/conftest.py` (`page`/`logged_in_page`/`logged_in_page_gv`/`login_page`/`dashboard`) · test độc lập + cleanup.
+- Naming: class `TestFeature{UI,Functional,Negative}`, method `test_TC<NNN>_<snake>`; docstring = TC title; comment TC_ID + link `.md`.
+
+## Phase 1 — Clarify
+Đọc `.Test.md` (confirm Reviewed) · platform (web Playwright/mobile) · Page Object đã có chưa → tạo nếu cần · fixture setup data?
+**Probe DOM thật trước khi viết selector** (SPA không `data-testid`): dump class/`aria-label`/role bằng script Playwright tạm → ghi selector đúng (BEM `feature__el`; element interactive có thể `role="tab/menuitem"` + class `--active`).
+
+## Phase 2 — Generate
+**PHỦ HẾT 100%**: sinh 1 `test_TC<NNN>_<scenario>` cho **MỌI** TC trong file — KHÔNG chọn tập đại diện, KHÔNG bỏ TC nào. Đếm tổng TC đầu file (`grep -cE "^#{2,4} *TC_"`) = số test phải sinh.
+TC không thể tự động hóa (precondition bất khả thi, cần data cố định, feature chưa wire) → vẫn viết 1 test với `pytest.skip("lý do")` / `pytest.mark.xfail` — KHÔNG để Draft.
+Map nhóm GUI→`TestFeatureUI`, Functional→`TestFeatureFunctional`, Negative→`TestFeatureNegative`. Assertion qua `assert_*()` của PO; test data từ `test_data/`, không hardcode. Marker mới (`bva ep`…) đăng ký `pytest.ini`.
+
+## Phase 3 — Verify
+`py_compile` + `pytest --collect-only -q` (**số collect = tổng TC trong file**, nếu thiếu → quay lại Phase 2 sinh nốt) · chạy test · cập nhật **Status** TC (Pass/Fail/Skip) · in mapping TC_ID→function→file.
+**Gom nhóm role/account**: thứ tự chạy đã tự gom cùng (role, account) liền nhau qua `utils/test_ordering.py` (hook ở root conftest) — fixture auth mới thì `register_auth_fixtures([...])`.
+⚠️ Run dài có thể bị **WSL suspend** (máy ngủ) làm vài TC lỗi login/timeout = flaky (không phải gap SP) → re-run đúng các TC đó + merge vào report (xem `report/report.md`).
+**Verify KHÔNG còn Draft**: `grep -c "Status: Draft" <file>.Test.md` = 0 trước khi bàn giao.
+**Mỗi FAIL phân loại script-bug vs product-gap** (probe trực tiếp): sai selector/expectation → sửa script & chạy lại; feature không phản hồi sau timeout → giữ FAIL + ghi bằng chứng (không fake-pass).
+
+## Output
+Script `tests/<project>/.../test_<screen>.py` + Page Object `pages/<project>/.../<Screen>Page.py` (nếu mới).
+Bàn giao `qa-reviewer` (script).
+
+## Phase 4 — Report (bắt buộc sau khi chạy test)
+Report = **Playwright Trace viewer + pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết).
+
+1. Chạy test kèm pytest-html (trace đã bật sẵn ở conftest → mỗi test có `test-results/<nodeid>/trace.zip`):
+   ```bash
+   pytest tests/<project>/.../test_<screen>.py --html=reports/<feature>/report.html --self-contained-html
+   ```
+2. Gửi cho người dùng:
+   - HTML report: `reports/<feature>/report.html` (self-contained, mở trực tiếp).
+   - Trace từng test (debug step-by-step): `python3 -m playwright show-trace test-results/<nodeid>/trace.zip`.
+   - Tóm tắt: **TOTAL / PASS / FAIL / SKIP** + duration.
+3. TC Fail → mở trace tương ứng để xem timeline/DOM snapshot/network, phân loại script-bug vs product-gap; ghi mô tả lỗi tiếng Việt dễ hiểu vào Status/khối kết quả của `.Test.md`.

package/skills/qc/qa-runner/integration.md

@@ -0,0 +1,47 @@
+---
+version: 1.0
+updated: 2026-06-11
+ported_from: ai-automation-qc-base
+---
+
+# Gen Script — Integration
+
+Skill **tự chứa**: convert `.Test.md` tích hợp (API↔DB↔service↔queue↔UI) → Python pytest. Chỉ cần load file này.
+
+## Khi nào trigger
+- Convert TC integration (output qa-designer integration/*) sang script; TC đã Reviewed
+
+## Khi KHÔNG trigger
+- Chỉ 1 endpoint/UI đơn → `functional/*` · hành trình đầu-cuối → `e2e.md`
+
+## Quy ước script (bám CLAUDE.md)
+- Tiền đề: `.Test.md` đã Reviewed. KHÔNG hardcode endpoint/DSN/topic → `Env.*`/`CONFIG`.
+- Mỗi hệ thống có client/helper riêng (API client, DB session, Kafka producer/consumer) gói trong fixture.
+- Verify đúng chặng: response (assert), DB (query qua fixture), event (consume + assert payload).
+- **Cleanup bắt buộc** sau khi tạo data; test độc lập; concurrency dùng thread/async khi cần.
+- Bọc mỗi chặng `with step("…")` (`from utils.steps import step`, **KHÔNG Allure**); assertion `expect()`; marker `@pytest.mark.integration` + domain; naming `TestFeatureIntegration` / `test_TC<NNN>_<snake>`.
+
+## Phase 1 — Clarify
+Đọc `.Test.md` · chuỗi tích hợp & chặng cần verify · client/fixture (API/DB/Kafka) đã có chưa · setup/teardown data.
+
+## Phase 2 — Generate
+Mỗi TC → 1 test theo data flow: gọi action → verify từng chặng (response/DB/event). Nhóm happy/contract-negative/failure-retry/concurrency/đồng bộ.
+
+## Phase 3 — Verify
+`py_compile` + `pytest --collect-only -q` · chạy (cần môi trường staging/CRM/Kafka) · cập nhật Status TC.
+
+## Output
+Script `tests/<project>/integration/test_<feature>.py` + client/fixture (DB/Kafka/API) nếu mới. Bàn giao `qa-reviewer`.
+
+## Phase 4 — Report (bắt buộc sau khi chạy test)
+Report = **Playwright Trace viewer + pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết).
+
+1. Chạy test kèm pytest-html (trace đã bật sẵn ở conftest → mỗi test có `test-results/<nodeid>/trace.zip`):
+   ```bash
+   pytest tests/<project>/integration/test_<feature>.py --html=reports/<feature>/report.html --self-contained-html
+   ```
+2. Gửi cho người dùng:
+   - HTML report: `reports/<feature>/report.html` (self-contained, mở trực tiếp).
+   - Trace từng test (debug step-by-step): `python3 -m playwright show-trace test-results/<nodeid>/trace.zip`.
+   - Tóm tắt: **TOTAL / PASS / FAIL / SKIP** + duration.
+3. TC Fail → mở trace tương ứng để xem timeline/DOM snapshot/network, phân loại script-bug vs product-gap; ghi mô tả lỗi tiếng Việt dễ hiểu vào Status/khối kết quả của `.Test.md`.