@educa-corp/sdd-framework 0.6.0 → 0.7.0

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

@@ -1,49 +0,0 @@
----
-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

@@ -1,36 +0,0 @@
----
-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.
-→ `{paths.qc_dir}/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 `{paths.qc_dir}/{UC-ID}/test-cases/` + summary.

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

@@ -1,35 +0,0 @@
----
-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

@@ -1,51 +0,0 @@
----
-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

@@ -1,55 +0,0 @@
----
-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

@@ -1,47 +0,0 @@
----
-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`.

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

@@ -1,49 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Gen Script — Non-Functional
-
-Skill **tự chứa**: convert TC non-functional (performance/security/accessibility/compatibility) → script/đo. Chỉ cần load file này.
-
-## Khi nào trigger
-- Convert TC non-functional (output qa-designer non-functional) sang script/kịch bản đo; TC đã Reviewed
-
-## Khi KHÔNG trigger
-- Kiểm thử chức năng → `functional/*` · tích hợp → `integration.md`
-
-## Quy ước script (bám CLAUDE.md)
-- Tiền đề: `.Test.md` đã Reviewed, có **ngưỡng đo cụ thể**. KHÔNG hardcode → `Env.*`/`CONFIG`.
-- Mỗi loại dùng công cụ phù hợp, gói trong fixture/helper:
-  - **Performance:** đo response time / throughput (pytest + timer, hoặc tích hợp k6/locust); assert ngưỡng.
-  - **Security:** test authZ (role không quyền → 403), input injection, PII không lộ, session/timeout, rate limit.
-  - **Accessibility:** axe-core/lighthouse qua Playwright; assert vi phạm = 0 ở mức WCAG mục tiêu.
-  - **Compatibility:** parametrize trình duyệt/thiết bị.
-- Assert theo **ngưỡng pass** trong TC bằng `expect()`/`assert`; bọc bước `with step("…")` (`from utils.steps import step`, **KHÔNG Allure**); marker `@pytest.mark.{performance,security,accessibility}`.
-
-## Phase 1 — Clarify
-Đọc `.Test.md` · loại + ngưỡng + công cụ · môi trường/tải mẫu · data đặc biệt.
-
-## Phase 2 — Generate
-Mỗi TC → 1 test đo + assert ngưỡng; đánh dấu test cần môi trường/tải riêng (`@pytest.mark.slow`).
-
-## Phase 3 — Verify
-`py_compile` + collect · chạy (môi trường phù hợp) · cập nhật Status TC + số đo thực tế.
-
-## Output
-Script `tests/<project>/non_functional/test_<feature>.py` + helper đo/scan. 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>/non_functional/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) + số đo thực tế.
-   - 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 + số đo vào Status/khối kết quả của `.Test.md`.

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

@@ -1,37 +0,0 @@
----
-version: 1.1
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Report — Playwright Trace + pytest-html (stack chuẩn)
-
-Skill **tự chứa**: sinh report sau khi chạy test. Stack chuẩn dự án dùng **Playwright
-Trace viewer** + **pytest-html** (KHÔNG Allure, KHÔNG dashboard tự viết). Chỉ cần load file này.
-
-## Khi nào trigger
-- Sau khi chạy test cần xuất report / xem lại bằng chứng (trace, screenshot).
-
-## Cơ chế (đã dựng sẵn ở tests/conftest.py)
-- **Trace viewer**: fixture `context` (root conftest) gọi `context.tracing.start(screenshots=True, snapshots=True, sources=True)`; teardown lưu `test-results/<nodeid>/trace.zip`.
-  - Xem: `python3 -m playwright show-trace test-results/<...>/trace.zip` → timeline + DOM snapshot + network + console (UI giống Playwright report bản JS).
-- **pytest-html**: 1 file HTML self-contained. Hook `pytest_runtest_makereport` (root conftest) đính screenshot full-page khi FAIL/SKIP.
-  - Mặc định `reports/report.html` (pytest.ini). Theo feature: `--html=reports/<feature>/report.html --self-contained-html`.
-
-## Quy trình
-1. Chạy test với report theo feature:
-   ```
-   python3 -m pytest tests/<project>/<file>.py \
-       --html=reports/<feature>/report.html --self-contained-html
-   ```
-   (Trace tự bật trong conftest → test-results/<nodeid>/trace.zip cho mọi test.)
-2. Báo path:
-   - HTML: `reports/<feature>/report.html` (on WSL, the Windows-accessible path is `\\wsl.localhost\<distro>\<repo-path>\reports\<feature>\report.html`).
-   - Trace TC fail: `test-results/<nodeid>/trace.zip` + lệnh `playwright show-trace`.
-   - Tóm tắt TOTAL / PASS / FAIL / SKIP + duration.
-
-## Nguyên tắc
-- KHÔNG dùng Allure, KHÔNG sinh dashboard HTML tự viết (đã bỏ utils/html_report.py & cộng sự).
-- Evidence trung thực: trace + screenshot phản ánh đúng lần run; FAIL/gap giữ nguyên.
-- `reports/` và `test-results/` đã gitignore (artifact nặng) — không commit.
-- Interpreter `python3`; browser = the system/installed Chromium configured via `browser_type_launch_args` in the root conftest (see the qc-playwright module) — do not hard-code a binary path.

package/skills/setup-ai-first/SKILL.md

@@ -1,19 +0,0 @@
----
-description: Cài đặt framework Spec-Driven Development, và sinh/làm mới tài liệu kiến trúc (architecture.md SSOT). Trigger when: "/setup-ai-first", "/generate-architecture", "setup spec-driven workflow", "initialize ai-first framework", "cài đặt framework", "khởi tạo spec-driven", "set up this workflow", "how do I start using this framework", "sinh architecture", "tạo tài liệu kiến trúc", "generate architecture doc", "refresh architecture", "scan codebase architecture".
----
-
-# /setup-ai-first · /generate-architecture — Foundation Skills (SA / Tech Lead)
-
-Skill này xử lý `/setup-ai-first` và `/generate-architecture`. Để **không lệch** (umbrella/services routing, cấu trúc, trust-gate), skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /setup-ai-first — Initialize SDD Framework in a Project
-
-→ **Đọc và tuân theo `commands/setup-ai-first.md`** với cùng `$ARGUMENTS`.
-
-Command lo: tạo cấu trúc thư mục + feature-package on demand · CLAUDE.md + `.agent/project-context.yaml` (gồm umbrella `services` routing) · seed `architecture.md` (Step 3.5) · nhắc PO đặt row `Domain` (bảng Metadata) khớp services config · verify môi trường.
-
-## /generate-architecture — Sinh / làm mới Architecture Context (SSOT)
-
-→ **Đọc và tuân theo `commands/generate-architecture.md`** với cùng `$ARGUMENTS`.
-
-Command lo: phân giải target (single-service / per-service umbrella) · phát hiện greenfield vs brownfield · **scan codebase** (build-file/DI/middleware/config/CI) → draft từng section kèm bằng chứng · xoá section [OPTIONAL] không dùng · **trust-gate** `verified_by: AI-draft` · refresh có kiểm soát (không đè bản người đã verify) · bàn giao cho người verify.

package/skills/setup-ai-first/SKILL.tmpl

@@ -1,19 +0,0 @@
----
-description: Cài đặt framework Spec-Driven Development, và sinh/làm mới tài liệu kiến trúc (architecture.md SSOT). Trigger when: "/setup-ai-first", "/generate-architecture", "setup spec-driven workflow", "initialize ai-first framework", "cài đặt framework", "khởi tạo spec-driven", "set up this workflow", "how do I start using this framework", "sinh architecture", "tạo tài liệu kiến trúc", "generate architecture doc", "refresh architecture", "scan codebase architecture".
----
-
-# /setup-ai-first · /generate-architecture — Foundation Skills (SA / Tech Lead)
-
-Skill này xử lý `/setup-ai-first` và `/generate-architecture`. Để **không lệch** (umbrella/services routing, cấu trúc, trust-gate), skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /setup-ai-first — Initialize SDD Framework in a Project
-
-→ **Đọc và tuân theo `commands/setup-ai-first.md`** với cùng `$ARGUMENTS`.
-
-Command lo: tạo cấu trúc thư mục + feature-package on demand · CLAUDE.md + `.agent/project-context.yaml` (gồm umbrella `services` routing) · seed `architecture.md` (Step 3.5) · nhắc PO đặt row `Domain` (bảng Metadata) khớp services config · verify môi trường.
-
-## /generate-architecture — Sinh / làm mới Architecture Context (SSOT)
-
-→ **Đọc và tuân theo `commands/generate-architecture.md`** với cùng `$ARGUMENTS`.
-
-Command lo: phân giải target (single-service / per-service umbrella) · phát hiện greenfield vs brownfield · **scan codebase** (build-file/DI/middleware/config/CI) → draft từng section kèm bằng chứng · xoá section [OPTIONAL] không dùng · **trust-gate** `verified_by: AI-draft` · refresh có kiểm soát (không đè bản người đã verify) · bàn giao cho người verify.

package/skills/spec/SKILL.md

@@ -1,19 +0,0 @@
----
-description: Sinh file BDD .feature từ một PRD đã duyệt, hoặc sinh tài liệu technical design. Trigger when: "/generate-bdd", "/generate-tech-docs", "tạo BDD", "tạo spec", "generate feature file", "write BDD scenarios", "tạo technical design", "tech design", "sinh tech docs", "API design", "sinh .feature".
----
-
-# Spec Skills — BDD & Technical Design
-
-Skill này xử lý `/generate-bdd` và `/generate-tech-docs`. Để **không lệch schema/gate**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /generate-bdd — Sinh BDD Feature Files
-
-→ **Đọc và tuân theo `commands/generate-bdd.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard PRD approved + Design Spec (approved/độ-tươi/sanity) cho FE/App · Platform Selection web/app/system · System BDD synthesis (tổng hợp web+app, cross-platform conflict) · Version Check drift · proposal tester (chỉ `accepted`) · R1–R10 + C1–C5 + NHÓM grouping · `@trace` header đầy đủ + trace TSV.
-
-## /generate-tech-docs — Sinh Technical Design Document
-
-→ **Đọc và tuân theo `commands/generate-tech-docs.md`** với cùng `$ARGUMENTS`.
-
-Command lo: platform-aware (BE = API contract · FE/App = client design GATED trên System BDD + BE contract) · §2b Test Selectors · brownfield reverse-document · review-tech-docs T1–T7 (T7 sign-off) sau đó.

package/skills/spec/SKILL.tmpl

@@ -1,19 +0,0 @@
----
-description: Sinh file BDD .feature từ một PRD đã duyệt, hoặc sinh tài liệu technical design. Trigger when: "/generate-bdd", "/generate-tech-docs", "tạo BDD", "tạo spec", "generate feature file", "write BDD scenarios", "tạo technical design", "tech design", "sinh tech docs", "API design", "sinh .feature".
----
-
-# Spec Skills — BDD & Technical Design
-
-Skill này xử lý `/generate-bdd` và `/generate-tech-docs`. Để **không lệch schema/gate**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /generate-bdd — Sinh BDD Feature Files
-
-→ **Đọc và tuân theo `commands/generate-bdd.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard PRD approved + Design Spec (approved/độ-tươi/sanity) cho FE/App · Platform Selection web/app/system · System BDD synthesis (tổng hợp web+app, cross-platform conflict) · Version Check drift · proposal tester (chỉ `accepted`) · R1–R10 + C1–C5 + NHÓM grouping · `@trace` header đầy đủ + trace TSV.
-
-## /generate-tech-docs — Sinh Technical Design Document
-
-→ **Đọc và tuân theo `commands/generate-tech-docs.md`** với cùng `$ARGUMENTS`.
-
-Command lo: platform-aware (BE = API contract · FE/App = client design GATED trên System BDD + BE contract) · §2b Test Selectors · brownfield reverse-document · review-tech-docs T1–T7 (T7 sign-off) sau đó.

package/skills/test/SKILL.md

@@ -1,18 +0,0 @@
----
-description: Sinh unit và integration test từ BDD spec, chạy test suite và report kết quả, hoặc dev-smoke-test các API endpoint live trên service đang chạy. Trigger when: "/dev-gen-test", "/dev-run-test", "/dev-smoke-test", "tạo test", "viết test", "chạy test", "generate tests", "run tests", "test kết quả", "smoke test", "test API", "kiểm tra endpoint đang chạy".
----
-
-# Test Skills — Generate, Run & Smoke (Dev Self-Check)
-
-Skill này xử lý `/dev-gen-test`, `/dev-run-test`, `/dev-smoke-test` — **dev self-check** (`dev_selftest`), KHÔNG phải QC chính thức (`/qc-*`). Để **không lệch**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command.
-
-## /dev-gen-test — Sinh test dev self-check
-→ **Đọc và tuân theo `commands/dev-gen-test.md`** với cùng `$ARGUMENTS`.
-
-## /dev-run-test — Chạy test & ghi `dev_selftest`
-→ **Đọc và tuân theo `commands/dev-run-test.md`** với cùng `$ARGUMENTS`.
-(Command lo: bảng phân tích lỗi theo platform · ghi `dev_selftest`/`dev_selftest_at` vào trace TSV.)
-
-## /dev-smoke-test — Smoke test service/app đang chạy
-→ **Đọc và tuân theo `commands/dev-smoke-test.md`** với cùng `$ARGUMENTS`.
-(Command lo: flow theo từng platform — backend curl/health · web E2E Playwright/Cypress · mobile device/emulator · LLM pipeline.)

package/skills/test/SKILL.tmpl

@@ -1,18 +0,0 @@
----
-description: Sinh unit và integration test từ BDD spec, chạy test suite và report kết quả, hoặc dev-smoke-test các API endpoint live trên service đang chạy. Trigger when: "/dev-gen-test", "/dev-run-test", "/dev-smoke-test", "tạo test", "viết test", "chạy test", "generate tests", "run tests", "test kết quả", "smoke test", "test API", "kiểm tra endpoint đang chạy".
----
-
-# Test Skills — Generate, Run & Smoke (Dev Self-Check)
-
-Skill này xử lý `/dev-gen-test`, `/dev-run-test`, `/dev-smoke-test` — **dev self-check** (`dev_selftest`), KHÔNG phải QC chính thức (`/qc-*`). Để **không lệch**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command.
-
-## /dev-gen-test — Sinh test dev self-check
-→ **Đọc và tuân theo `commands/dev-gen-test.md`** với cùng `$ARGUMENTS`.
-
-## /dev-run-test — Chạy test & ghi `dev_selftest`
-→ **Đọc và tuân theo `commands/dev-run-test.md`** với cùng `$ARGUMENTS`.
-(Command lo: bảng phân tích lỗi theo platform · ghi `dev_selftest`/`dev_selftest_at` vào trace TSV.)
-
-## /dev-smoke-test — Smoke test service/app đang chạy
-→ **Đọc và tuân theo `commands/dev-smoke-test.md`** với cùng `$ARGUMENTS`.
-(Command lo: flow theo từng platform — backend curl/health · web E2E Playwright/Cypress · mobile device/emulator · LLM pipeline.)

package/steps/business-language.md

@@ -1,56 +0,0 @@
-# Business Language Guard — chặn thuật ngữ kỹ thuật rò vào tài liệu nghiệp vụ
-
-Tài liệu nghiệp vụ (PRD, product-definition) mô tả **WHAT** — chỉ ngôn ngữ nghiệp vụ. Guard này chạy **mỗi khi viết hoặc sửa** prose (gen mới, áp fix `--resume`, hiệu chỉnh): **quét và xử lý** các thuật ngữ kỹ thuật/UI phổ thông bên dưới **trước khi ghi**.
-
-> Guard này là **baseline framework**, chạy **song song** với Banned Terms của `business-dictionary.md` (cơ chế dictionary giữ nguyên; project vẫn bổ sung term đặc thù vào đó). Khi cả hai cùng áp, ưu tiên bản chuẩn của dictionary nếu có.
-
-## Bản đồ xử lý (4 nhóm)
-
-**Nhóm 1 — Tương tác/triển khai → DIỄN ĐẠT LẠI sang nghiệp vụ (giữ nguyên nghĩa):**
-
-| Kỹ thuật/UI | Cách nói nghiệp vụ |
-|---|---|
-| re-render / render lại / reload / refresh (màn) | "hiển thị lại {tên màn}" |
-| timeout | "quá thời gian chờ" |
-| lỗi mạng / network error | "lỗi kết nối" |
-| UI / giao diện (khi chỉ một màn) | "màn" / "màn hình" |
-| click / tap | "bấm" / "chọn" |
-| popup / modal (nếu chỉ là khái niệm hiển thị) | "hộp thoại" / "thông báo" |
-| disable / enable (nút) | "khoá" / "mở" thao tác |
-| redirect / navigate | "chuyển tới {màn}" |
-
-**Nhóm 2 — Visual thuần → CHUYỂN Design Spec (bỏ khỏi PRD, ghi nhận lại):**
-`spinner`, `loading indicator`, `animation`, `fade/slide`, màu sắc, font, layout pixel, micro-interaction → *"Chi tiết visual này thuộc Design Spec — ghi nhận để tạo Design Spec sau."*
-
-**Nhóm 3 — Backend/contract thuần → BỎ khỏi PRD (thuộc Tech Docs):**
-`API`, `endpoint`, `token/JWT`, `HTTP status`, tên class/bảng/cột DB, query, payload, header.
-*(Ngoại lệ DUY NHẤT: Appendix "Existing API Contract" khi `API Source: existing` — xem Platform Strategy.)*
-
-**Nhóm 4 — Ẩn dụ dữ liệu/cài đặt cho trạng thái nghiệp vụ → XÉT THEO NGHĨA (KHÔNG phải bảng thay thế):**
-
-Các từ như `cờ / flag`, `biến / trường / field`, `giá trị / value`, `trả về / return`, `đọc / ghi (cờ)` **đa nghĩa** — kỹ thuật ở ngữ cảnh này, nghiệp vụ ở ngữ cảnh khác. **ĐỪNG thay máy móc.** Một từ chỉ là leak khi **cả hai** điều sau đúng:
-1. Nó chỉ một **artifact lưu trữ/cơ chế** (cờ, biến, trường, giá trị-trả-về, đọc/ghi) đứng thay cho một **trạng thái/khái niệm nghiệp vụ**; VÀ
-2. Khái niệm đó **đã có tên nghiệp vụ** (trong business-dictionary hoặc hiển nhiên).
-
-→ Cả hai đúng: viết lại theo **tên nghiệp vụ**, ưu tiên term chuẩn trong business-dictionary.
-→ Từ **tự nó là khái niệm nghiệp vụ**: **GIỮ NGUYÊN**.
-
-| Reframe (là leak) | Giữ nguyên (nghiệp vụ thật) |
-|---|---|
-| "cờ tình trạng = chưa làm" → "con *chưa làm khảo sát*" (có term Tình trạng khảo sát) | "giá trị đơn hàng", "giá trị hợp đồng" |
-| "cờ trả giá trị lạ" → "không đọc được tình trạng khảo sát" | "khách trả về sản phẩm" (hoàn hàng) |
-| "đọc cờ thất bại" → "không xác định được tình trạng" | "trả kết quả học tập cho phụ huynh" |
-
-**Neo an toàn:** lái theo business-dictionary — nếu đang diễn giải một khái niệm **đã có entry** thì dùng đúng term đó. Hỏi *"khái niệm này có tên nghiệp vụ chưa"*, KHÔNG hỏi *"từ này có bị cấm không"*.
-
-**Luật code-format:** trong prose nghiệp vụ, **không bọc backtick/`code`** quanh giá trị/trạng thái nghiệp vụ (`chưa làm`, `đã nộp`) — code-format báo hiệu "token kỹ thuật". Dùng *nghiêng* hoặc "trong ngoặc kép". Backtick chỉ dành cho định danh code/kỹ thuật thật.
-
-## Quy tắc áp dụng
-- Quét toàn bộ text sắp ghi (User Story, AC, BR, Business Logic, Scope, Edge Cases, Assumptions…).
-- Nhóm 1 → thay tại chỗ, giữ nguyên nghĩa nghiệp vụ. **Đồng bộ cách diễn đạt** với chỗ đã có sẵn trong cùng tài liệu (vd nếu "quá thời gian chờ" đã dùng ở một BR → dùng nhất quán ở mọi nơi).
-- Nhóm 2 → gỡ khỏi prose nghiệp vụ + nhắc chuyển Design Spec.
-- Nhóm 3 → gỡ khỏi PRD (trừ ngoại lệ brownfield).
-- Nhóm 4 → **xét ngữ cảnh, KHÔNG thay máy móc**: chỉ reframe khi là ẩn dụ dữ liệu cho một khái niệm đã có tên nghiệp vụ (ưu tiên term dictionary); **giữ nguyên** khi từ mang nghĩa nghiệp vụ thật. Đồng thời bỏ backtick khỏi giá trị nghiệp vụ trong prose.
-- Nếu term không có trong bản đồ nhưng rõ ràng là tên kỹ thuật/triển khai → vẫn diễn đạt lại theo tinh thần Nhóm 1, đừng để lọt.
-
-**Checklist (dùng ở Quality Checklist của lệnh):** 0 thuật ngữ kỹ thuật/UI (re-render, UI, timeout, spinner, API/endpoint/token…) trong prose nghiệp vụ — đã diễn đạt lại (Nhóm 1) / chuyển Design Spec (Nhóm 2) / bỏ về Tech Docs (Nhóm 3); 0 ẩn dụ dữ liệu cho trạng thái đã có tên nghiệp vụ (cờ/giá trị/đọc-ghi khi là artifact — Nhóm 4) và 0 backtick bọc giá trị nghiệp vụ.