@educa-corp/sdd-framework 0.9.6 → 0.9.8

package/docs/plans/qc-surgery/exec-S0-guard-cam-stack-cu.md

@@ -0,0 +1,400 @@
+---
+buoc: Bước S · việc S0
+title: Đèn cơ học cấm stack QC cũ quay lại
+phu_thuoc: không (đây là việc đầu tiên của Bước S)
+trang_thai: ĐÃ TRIỂN KHAI 2026-09-17 · phạm vi thu về TẦNG SCRIPT · self-check ĐỎ 19 file (đúng ý đồ G3)
+---
+
+> ⚠️ **Đọc §1.2b trước.** Bản đầu của file này lấy phạm vi `skills/qc/**` (đỏ **27 file**).
+> Quyết định **S-SCOPE** ngày 2026-09-17 thu lại còn **tầng script** (đỏ **19 file**) — 5 tầng
+> tài liệu *(phân tích · doc-gap · test plan · thiết kế TC · review TC)* **không đổi stack**.
+> Mọi con số "27" dưới đây được giữ nguyên như bản đo gốc và có ghi chú kèm.
+
+# S0 — Dựng đèn trước, dọn sau
+
+← [`exec-S-ap-stack-typescript.md`](exec-S-ap-stack-typescript.md) · [`PLAN_v2.md`](PLAN_v2.md) · [`01-checklist.md`](01-checklist.md)
+
+| | |
+|---|---|
+| **Lớp** | Bước S · việc **1/6** — chạy **trước** S1–S5 |
+| **File code** | `bin/trace-schema.json` *(`forbidden_patterns`)* · `bin/self-check.js` *(`allSourceFiles`, R5)* |
+| **File test** | `test/run.js` — *(xem §1.1: có thể không đụng)* |
+| **Ngày xong** | — |
+| **Phụ thuộc** | không — S0 cố ý chạy khi repo **còn bẩn** |
+| **Ai dùng nó** | `node bin/self-check.js` — 1 trong 4 lệnh kiểm, chạy sau mỗi bước |
+
+---
+
+## 0 · Đo được — 2026-09-17
+
+### 0.1 · Đèn sẽ đỏ như thế nào
+
+Phạm vi quét **67 file** *(`skills/qc/**` · `commands/qc-*.tmpl` · `modules/qc-*/**`)* →
+**27 file đỏ · 146 dòng**:
+
+| Nhóm | File đỏ | Số phận |
+|---|:-:|---|
+| `skills/qc/` **còn lại** | **14** | phải sửa tay |
+| `skills/qc/qa-runner/` | 7 *(trong 8)* | **xoá** ở S2 — tự hết đỏ |
+| `commands/qc-*.tmpl` | 5 | phải sửa tay |
+| `modules/qc-*/` | 1 | **thay** ở S1 |
+
+Năm file nặng nhất: `modules/qc-playwright/stack-profile.yaml` **19 dòng** ·
+`qa-reviewer/script/non-functional.md` **15** · `qa-runner/functional/gui-screen.md` **12** ·
+`qa-reviewer/script/functional.md` **10** · `qa-runner/functional/gui-feature.md` **10**.
+
+### 0.2 · 🔴 Đèn tìm ra 10 file mà danh sách của Bước S BỎ SÓT
+
+[`exec-S §B2`](exec-S-ap-stack-typescript.md) liệt kê: `qa-runner` · `qa-reviewer/script/*` ·
+`matrix.md` · 3 lệnh script · `qc-report.tmpl` · module · `trace-schema` · `qc-base-map` · docs.
+Đèn đỏ ở **10 file nữa**, không có trong bất kỳ dòng nào của kế hoạch:
+
+| File chưa ai kể tên | Dòng | Nó đang dạy gì theo stack cũ |
+|---|:-:|---|
+| `skills/qc/qa-designer/shared/tc-metadata-format.md` | 3 | `@pytest.mark.flaky(...)` trong Tags · `conftest.py` fixture · section `#### Python Test Mapping` |
+| `skills/qc/qa-reviewer/shared/review-check-groups.md` | 4 | *"marker pytest khớp Tags"* · `@pytest.mark.flaky(reruns=2, reruns_delay=3)` |
+| `skills/qc/qa-planner/test-plan.md` | 3 | Exit criteria ghi *"báo cáo pytest-html"* |
+| `commands/qc-design-test.tmpl` | 3 | *"Output feed vào qc-design-script (Python)"* |
+| `skills/qc/qa-designer/shared/precision-rules.md` | 2 | teardown thuộc `conftest.py` scope=function |
+| `skills/qc/qa-designer/api/auth-sequence.md` | 1 | *"Token fixture (Python)"* |
+| `skills/qc/qa-reviewer/shared/review-file-template.md` | 1 | `- Mobile: @pytest.mark.flaky(...)` |
+| `skills/qc/qa-reviewer/test-case/functional.md` | 1 | *"Review Python script → dùng qa-reviewer"* |
+| `skills/qc/qa-reviewer/test-case/non-functional.md` | 1 | `@pytest.mark.performance\|security\|a11y\|i18n` |
+| `commands/qc-analyze.tmpl` | 1 | *"…hay Python (đó là qc-design-test / qc-design-script)"* |
+
+**Đây là toàn bộ lý do S0 đi trước.** Tám trong mười file nằm ở tầng **thiết kế test case** —
+`qa-designer`, `qa-reviewer/test-case` — chỗ mà không ai nghĩ *"đổi stack script"* sẽ chạm tới.
+Đi theo danh sách tay của Bước S thì mười file này **ở lại**, và `.Test.md` sinh ra sau đó vẫn
+mang `@pytest.mark.flaky` trong Tags — tức stack cũ sống tiếp trong **đầu vào** của stack mới.
+
+### 0.3 · Hai phát hiện làm đổi nội dung Bước S *(không chỉ đổi đèn)*
+
+| # | Phát hiện | Nguồn |
+|:-:|---|---|
+| **P1** | Framework hiện ghi **"No Allure"** như một luật cứng *(`stack-profile.yaml` · 12 file nhắc `Allure`)*. Chuẩn MỚI **ngược lại**: mobile **bắt buộc** Allure Report v2.x | `Mobile-Automation-Standards.md:48` · `API-Testing-Standards.md:49` · `Automation-Standards.md:515` *(OQ-01: web dùng Playwright HTML, Allure defer Phase 2)* |
+| **P2** | `BasePage` **sống sót** sang stack mới — không phải dấu vết cần xoá | `Automation-Standards.md:221` `export class BasePage` · `:108` `base.page.ts` |
+
+---
+
+## 1 · BA CÂU CHỜ CHỐT
+
+### 1.1 · Đèn sống ở đâu — R5 hay một test mới?
+
+**Bằng chứng: cơ chế này ĐÃ TỒN TẠI.** `bin/self-check.js:279` — **R5 · *"pattern bị cấm quay
+lại"***, đọc `forbidden_patterns` từ `bin/trace-schema.json`. Hiện có **11 entry**, mỗi entry
+gồm `pattern` · `gap` · `reason` · `except`. Và nó còn làm một việc mà một test viết vội sẽ
+không làm: **cảnh báo khi một `except` trở nên vô nghĩa** *(`self-check.js:293`)* — tức danh
+sách miễn trừ không mục ruỗng theo thời gian.
+
+**Nhưng R5 có hai giới hạn thật, đã đo:**
+
+| Giới hạn | Đo được | Hệ quả |
+|---|---|---|
+| `allSourceFiles()` **không quét `skills/`** | chỉ có `commands/*.tmpl` · `steps/` · `templates/` · `rules/` · `modules/` | **21 trong 27** file đỏ nằm ngoài tầm R5 |
+| `s.text.includes(fp.pattern)` — so chuỗi thô, **không có phạm vi** | `pytest` trên toàn scan set → dính `dev-gen-test` · `dev-run-test` · `dev-smoke-test` · `sync.tmpl` | 4 dương tính giả *(xem §1.3)* |
+
+| Phương án | Việc phải làm | Cái giá |
+|---|---|---|
+| **A · R5 + mở scan set + thêm trường `scope`** ⭐ | `allSourceFiles()` thêm `skills/**/*.md`; `forbidden_patterns[].scope` = mảng glob, **thiếu `scope` = toàn scan set** *(11 entry cũ không đổi hành vi)*; thêm 6 entry | đụng vào một rule đang xanh — nhưng **đã đo: mở scan set sang 64 file `skills/` làm 11 pattern cũ hit thêm 0 lần** |
+| **B · test riêng trong `test/run.js`** *(bản exec-S viết)* | 1 test mới, regex tự do, allowlist riêng | **cơ chế thứ hai cho cùng một lớp việc** — hai chỗ khai pattern bị cấm, và cái mới không có luật *"`except` phải kèm lý do"* lẫn cảnh báo except chết |
+| **C · cả hai** | R5 cho pattern thô, test cho phép đếm = 0 | thừa; hai đèn cùng đỏ một lỗi làm người ta sửa một chỗ rồi tưởng xong |
+
+**Khuyến nghị: A.** Lý do không phải *"đỡ code hơn"* — mà là: danh sách pattern bị cấm của dự
+án này **phải có đúng một chỗ để đọc**. Có hai chỗ thì lần sau người ta thêm vào chỗ sai và đèn
+không bao giờ sáng. *(Nếu chọn A thì `test/run.js` **không đổi**, vẫn 244 test — khác con số
+"244 → 245" ghi ở [`exec-S §8`](exec-S-ap-stack-typescript.md), tôi sẽ sửa lại bảng đó.)*
+
+---
+
+### 1.2 · Phạm vi có gồm `docs/` không?
+
+**Đo được:** ngoài 27 file trong phạm vi, `docs/` *(trừ `docs/plans/`)* còn **7 file · 14 dòng**
+dính. Trong đó **2 file là lane DEV** — `docs/explain/13-dev-run-test.md` ·
+`14-dev-smoke-test.md` — **hợp lệ vĩnh viễn** *(xem §1.3)*. Còn lại **5 file QC thật**:
+`02-concepts/pipeline-steps/08-qc-automation.md` · `03-guides/tester-qa.md` ·
+`04-reference/modules.md` · `explain/17-qc-design-test.md` · `explain/19-qc-run-test.md`.
+
+| Phương án | Cái giá |
+|---|---|
+| **Không gồm `docs/`** ⭐ | S5 sửa 5 file bằng tay; sau này docs **drift lại được trong im lặng**. Nhưng `docs/` chưa bao giờ nằm trong scan set của self-check — kéo nó vào là mở một mặt trận mới giữa Bước S |
+| Gồm `docs/**` trừ `docs/plans/` | chặt hơn; phải thêm `except` cho 2 file DEV, và mọi đoạn **kể lịch sử** *("stack cũ là Python")* sau này đều phải xin `except` |
+
+**Khuyến nghị: không gồm `docs/` ở S0.** Ghi thành **một dòng nợ có chủ**, không phải một chỗ
+quên. Lý do: `docs/` là nơi duy nhất **cần** nói *"trước đây là Python"* — đèn ở đó sẽ cãi nhau
+với chính nhu cầu của tài liệu, và cãi nhau thì người ta cấp `except` bừa. `docs/plans/` thì
+chắc chắn phải nằm ngoài: cả file anh đang đọc vi phạm pattern **hàng chục lần**.
+
+---
+
+### 1.2b · 🔴 S-SCOPE — phạm vi thu về TẦNG SCRIPT *(chốt 2026-09-17, SAU khi S0 đã chạy)*
+
+**Quyết định:** chỉ thay TypeScript cho Python **ở các trạm phía sau (tầng script)**, theo
+`qc-base-new`. Năm tầng tài liệu **không đổi stack**: phân tích yêu cầu · quét doc-gap · lập test
+plan · thiết kế test case · review test case.
+
+**Đo trước khi chốt** *(đây là số làm quyết định này có căn cứ)*:
+
+| Đo | Kết quả |
+|---|---|
+| 5 tầng tài liệu | **41 file · 0 file chạy được** — 100 % `.md`, là hướng dẫn cho agent |
+| Lệnh QC gọi script của framework | **0** |
+| `upstream/qc-base-new/` (7 file · 98 KB) nhắc `python\|pytest\|pandas\|jupyter\|.py` | **0 lần** |
+| Python **chạy được** duy nhất từng có ở lane QC | 2 file kho CŨ: `qa-gate/styled-report-*.py`, state `undecided`, `targets: []`, **chưa bao giờ port** |
+
+Nên *"Python vs TypeScript"* **không phải một trục có thật** ở 5 tầng đó: không có chương trình
+nào ở đấy, bằng ngôn ngữ nào cũng vậy.
+
+**Phạm vi đèn đổi theo:**
+
+```
+skills/qc/qa-runner/**              skills/qc/qa-reviewer/script/**
+skills/qc/qa-automation-assess/**   commands/qc-*.tmpl
+modules/qc-*/**
+```
+
+**Kết quả đo lại: đỏ 27 → 19 file.** Tám file rời khỏi tầm — và 16 dòng của chúng chia **bốn
+nhóm không cùng loại**:
+
+| Nhóm | Dòng | Là gì | Xử lý |
+|---|:-:|---|---|
+| **A** khai stack trong Test Plan | 3 | `qa-planner/test-plan.md` — *"báo cáo pytest-html + Playwright Trace"* | **nợ** — Test Plan là tài liệu chị QC **ký**; ký một kế hoạch mô tả công cụ không còn dùng là sai ở mức hồ sơ |
+| **B** marker/fixture pytest làm **quy ước viết TC** | 10 | `@pytest.mark.flaky` trong Tags · `conftest.py` trong Preconditions | **nợ, chủ là chị QC** — xem ⚠️ dưới |
+| **C** luật **CẤM** khuôn cũ | 2 | *"Không thêm `#### Python Test Mapping`"* · *"còn `#### Python Test Mapping` → `[OLD_TEMPLATE]`"* | **GIỮ NGUYÊN — đây là guard, không phải Python** |
+| **D** chỉ đường | 1 | *"Review Python script → dùng qa-reviewer"* | nợ, 1 dòng |
+
+> 🔴 **Nhóm C là chỗ bản S0 đầu tiên sai.** Hai dòng đó **cấm** Python, và đèn đang bắt chúng.
+> Ai dọn theo danh sách đỏ một cách máy móc sẽ **xoá mất một guard đang làm việc**. Thu phạm vi
+> đã giải quyết: chúng nằm ngoài tầm, **không cần `except`** — và như vậy tốt hơn `except`, vì
+> `except` là *"ngoại lệ trong vùng ta quản"*, còn đây là *"không thuộc vùng ta quản"*.
+
+> ⚠️ **Nhóm B không phải chuyện dịch cú pháp — nó đảo ngược ý nghĩa.**
+> `@pytest.mark.flaky(reruns=2, reruns_delay=3)` = **tự chạy lại 2 lần, test VẪN trong suite
+> chính**. `@flaky` của chuẩn mới *(`Automation-Standards.md` §11)* = **QUARANTINE: exclude khỏi
+> main suite**, điều tra trong 1 sprint, ghi Automation Health Log. Hôm nay
+> `review-check-groups.md:93` **ép** mọi TC mobile mang marker cũ; dịch thẳng sang chuẩn mới
+> thành *ép mọi TC mobile bị cách ly khỏi suite chính*.
+> Thêm nữa: **retry ×2 đã chuyển sang runner từ Đợt 1 b3** — marker trong TC giờ là **nguồn thứ
+> hai** quyết định cùng một việc. Đây là **một quyết định về luật QC**, thuộc chị QC.
+
+---
+
+### 1.3 · Bộ pattern — cấm chữ gì, và cố ý KHÔNG cấm chữ gì?
+
+> 🔴 **Điểm dễ sai nhất của cả S0.** Xem B1.
+
+**Đề xuất 6 pattern**, tất cả `scope: ["skills/qc/**", "commands/qc-*.tmpl", "modules/qc-*/**"]`:
+
+| Pattern | Bắt gì | File dính *(trong phạm vi)* |
+|---|---|:-:|
+| `pytest` | tên test runner cũ | 18 |
+| `Python` · `python` | tên ngôn ngữ — **hai entry** vì R5 so chuỗi phân biệt hoa thường | 16 · 11 |
+| `conftest.py` | cơ chế fixture của pytest | 8 |
+| `_page.py` | quy ước đặt tên Page Object cũ | 4 |
+| `.py` | mọi đuôi file Python còn sót | 17 |
+
+**Cố ý KHÔNG cấm — có bằng chứng:**
+
+| Chữ | Dính | Vì sao giữ |
+|---|:-:|---|
+| `Allure` | 12 file | Chuẩn mobile MỚI **bắt buộc** Allure v2.x *(P1)*. Cấm nó là mã hoá một luật **ngược tài liệu Approved** |
+| `BasePage` | 6 file | Chuẩn web MỚI vẫn dùng — `export class BasePage` *(P2)* |
+| `time.sleep` | 9 file | Là **anti-pattern nội dung**, không phải dấu vết stack. Luật *"không hardcode wait"* sống tiếp, chỉ đổi cách viết (`waitForTimeout`). Thuộc S2, không thuộc đèn |
+| `test_<feature>` | 9 file | Quy ước đặt tên — sẽ đổi ở S2 cùng nội dung, cấm ở đây là đỏ hai lần một lỗi |
+
+**Khuyến nghị: đúng 6 pattern trên.** Hẹp, và nói rõ là hẹp *([`PLAN_v2 §8 luật 4`](PLAN_v2.md))*.
+
+---
+
+# PHẦN A — Chuyện gì đang xảy ra
+
+## A1 · Vấn đề
+
+Đội QC bỏ một bộ công cụ hồi tháng trước, nhưng hơn trăm dòng viết theo bộ cũ vẫn nằm rải rác
+trong bộ khung — và cho tới sáng nay **không ai biết chính xác là bao nhiêu dòng, ở những file
+nào**. Dọn bằng mắt thì sẽ sót, và chỗ sót không kêu lên: nó lặng lẽ dạy sai cho lần chạy sau.
+Còn một nửa nữa của vấn đề: dọn xong rồi, vài tháng sau một người chép lại một đoạn từ file cũ,
+và hiện không có gì chặn.
+
+## A2 · Cách giải quyết, nói bằng một hình ảnh
+
+Như dán biển *"không để đồ ở đây"* lên lối thoát hiểm, thay vì dặn miệng từng người rồi mong
+người vào sau còn nhớ. Biển không dọn hộ đống đồ đang có — nó chỉ bảo đảm rằng dọn xong thì
+không ai chất lại mà không bị nhắc.
+
+## A3 · Xong rồi thì thấy gì khác
+
+Chạy `node bin/self-check.js` **ngay hôm nay** sẽ ra một dòng đỏ liệt kê đúng **27 file**. Dọn
+xong ở các việc sau thì dòng đó biến mất. Và nếu về sau ai chép lại một đoạn cũ vào, nó hiện lại
+ngay lần chạy kế — không cần ai nhớ luật.
+
+## A4 · Thuật ngữ dùng ở trên
+
+- **bộ công cụ / stack** — ngôn ngữ + thư viện mà test được viết bằng. Bộ cũ: Python + pytest. Bộ mới: TypeScript + Playwright.
+- **đèn / guard / rule** — một phép kiểm tự động; đỏ thì không được commit.
+- **`self-check`** — một trong bốn lệnh kiểm, soi tính nhất quán của chính bộ khung. Đang có 22 luật, đánh số R1–R22.
+- **R5** — luật *"pattern bị cấm quay lại"*, đã có sẵn; S0 thêm việc cho nó chứ không dựng luật mới.
+- **pattern** — một đoạn chữ bị cấm xuất hiện, ví dụ `pytest`.
+- **`except`** — danh sách file được phép chứa đoạn chữ đó, **mỗi file kèm một lý do viết ra**.
+- **phạm vi / scope** — vùng file mà một luật soi tới. Ngoài vùng thì luật im.
+
+---
+
+> ### ✅ Phép thử bắt buộc trước khi coi Phần A là xong
+> **Đã thử với:** tự đọc to · **ngày:** 2026-09-17 ·
+> **phải giải thích thêm chỗ nào:** câu *"đèn không dọn hộ"* ở A2 — người nghe lần đầu tưởng
+> S0 đã sửa xong 27 file. Đã thêm một câu ở A3 tách rõ *"hôm nay đỏ"* và *"dọn ở các việc sau"*.
+
+---
+
+# PHẦN B — Chi tiết kỹ thuật
+
+## B1 · Cách hiển nhiên là gì, và vì sao nó sai
+
+### Cách hiển nhiên — cấm chữ `Python` và `pytest` trên toàn repo
+
+9/10 người viết đúng một dòng: *"không file nào được chứa `python` hay `pytest`"*, chạy, thấy
+đỏ, và thấy mình đang làm đúng.
+
+**Vì sao sai — ba lý do, tất cả đo được:**
+
+**1 · Python là ngôn ngữ sản phẩm hạng nhất của chính framework này.** `modules/context-engineering`
+là một module Python thật; `commands/dev-gen-test.tmpl:190` ghi *"**Nếu language = Python** (mặc
+định)"*; `commands/dev-run-test.tmpl:69` in `pytest tests/{domain}/{test_file}.py -v`;
+`commands/sync.tmpl:317` nhận diện dự án qua `requirements.txt` / `pyproject.toml`. Cấm toàn cục
+làm đỏ **4 lệnh lane DEV** — **100 % dương tính giả**. Thứ bị bỏ là **Python với tư cách stack
+TEST của QC**, không phải Python. Đèn phải khoá theo **phạm vi**, không theo từ.
+
+**2 · Cấm theo "mùi của stack cũ" sẽ cấm nhầm thứ sống sót.** Cách hiển nhiên phiên bản hăng hái
+hơn là quét luôn mọi chữ trông giống bộ cũ. Đo thì: `Allure` dính **12 file** — và
+`Mobile-Automation-Standards.md:48` khai **Reporting | Allure Report | v2.x** là bắt buộc;
+`BasePage` dính **6 file** — và `Automation-Standards.md:221` có `export class BasePage`. Cấm hai
+chữ này là **mã hoá vào máy một luật ngược với tài liệu Approved**, rồi sáu tháng sau có người
+mất nửa ngày để hiểu vì sao đèn không cho họ làm đúng chuẩn.
+
+> Riêng `Allure` còn là một **mâu thuẫn nội dung** mà Bước S phải xử, không phải chuyện đèn:
+> framework đang ghi *"No Allure"* như luật cứng, chuẩn mobile mới thì bắt buộc. Xem §0.3 P1.
+
+**3 · Dựng một test mới là bỏ qua một cơ chế đã có.** `R5` + `forbidden_patterns` đã làm đúng
+việc này cho **11 pattern**, và có một tính chất mà test viết tay hay thiếu: nó **cảnh báo khi
+một `except` không còn cần thiết**. Đặt danh sách cấm ở chỗ thứ hai nghĩa là lần sau người ta
+thêm vào chỗ sai — và một đèn không bao giờ sáng thì tệ hơn không có đèn, vì nó trông như có.
+
+## B2 · Cách làm đúng
+
+**Ba sửa đổi nhỏ, không sửa đổi nào chạm nội dung QC** *(nội dung là việc của S1–S5)*.
+
+**① Mở scan set.** `bin/self-check.js` · `allSourceFiles()` thêm một dòng:
+`push(path.join(ROOT,'skills'), f => f.endsWith('.md'))`.
+
+> **Đã đo trước khi đề xuất:** chạy thử 11 pattern hiện có trên **64 file** `skills/**/*.md` →
+> **0 hit**. Mở scan set **không làm đỏ** bất cứ thứ gì đang xanh. Con số này là điều kiện để
+> phương án A an toàn; không có nó thì đây chỉ là một lời hứa.
+
+**② Thêm trường `scope` cho `forbidden_patterns`.** Mảng glob. **Thiếu `scope` = toàn scan set**
+— nên **11 entry cũ giữ nguyên hành vi, không phải sửa một entry nào**. Lọc thêm đúng một mệnh
+đề vào vòng lặp R5 ở `self-check.js:284`:
+
+```
+const inScope = s => !fp.scope || fp.scope.some(g => match(g, s.rel));
+const hits = sources.filter(s => inScope(s) && s.text.includes(fp.pattern) && !except.has(s.rel));
+```
+
+**③ Thêm 6 entry**, mỗi entry `scope: ["skills/qc/**","commands/qc-*.tmpl","modules/qc-*/**"]`,
+`gap: "S0"`, và `reason` nói **hậu quả**, không nói luật:
+
+> *"Stack test của QC chốt 2026-09-10 là TypeScript + Playwright (web/api) và WDIO+Appium
+> (mobile), xác nhận qua email. Một dòng `pytest` còn sót trong phạm vi QC không làm đỏ test
+> nào — nó chỉ làm lệnh sinh ra script mà không dự án nào chạy được, và lỗi đó hiện ra ở lần
+> chạy thật của QC chứ không ở CI. Python vẫn hợp lệ ở lane DEV; vì thế entry này có `scope`."*
+
+**Vì sao 6 pattern chứ không 2:** `pytest` + `Python` bỏ sót **8 file** chỉ mang dấu vết hình
+dạng (`conftest.py`, `_page.py`, `.py` trần). Vì sao không 10: xem §1.3 — bốn chữ còn lại sống
+sót sang stack mới hoặc thuộc tầng nội dung.
+
+**Vì sao `Python` và `python` là hai entry:** `String.includes` phân biệt hoa thường, và R5 cố ý
+dùng so chuỗi thô thay vì regex *(pattern là **chữ** người đọc được, không phải biểu thức người
+phải giải mã)*. Hai entry là cái giá của tính chất đó — chấp nhận, và ghi lại đây để người sau
+đừng "tối ưu" nó thành regex rồi làm hỏng 11 entry kia.
+
+## B3 · Nếu làm sai thì hỏng theo kiểu nào
+
+**Ồn 🟠 — và Ồn là kiểu hỏng riêng của mọi cái đèn.**
+
+Hỏng ở đâu: phạm vi quá rộng *(cấm toàn repo)* → 4 lệnh DEV đỏ oan. Người ta không gỡ luật —
+người ta cấp `except` cho 4 file, rồi lần sau cấp tiếp, và sau đủ nhiều lần thì `except` dài hơn
+danh sách cấm. Lúc đó **R5 vẫn xanh và không còn nghĩa gì**. Ai phát hiện: không ai — đó là chỗ
+tệ. Một luật bị rỗng ruột trông y hệt một luật đang làm việc.
+
+Kiểu hỏng phụ — **Im lặng 🔴** nếu phạm vi quá hẹp: bỏ `docs/` ra ngoài *(khuyến nghị §1.2)*
+nghĩa là Python **quay lại qua đường tài liệu** được. Đây là một **lỗ đã biết, cố ý để lại**,
+và vì thế nó phải thành một dòng nợ có người chịu — xem §9.
+
+## B4 · Verify bằng gì
+
+| # | Phép thử | Kết quả mong đợi | **Chạy thật 09-17** |
+|:-:|---|---|---|
+| 1 | `node bin/self-check.js` **ngay sau ①②③, trước khi sửa nội dung** | **R5 ĐỎ** | ✅ **ĐỎ 27 file** *(phạm vi gốc)* → sau **S-SCOPE**: **ĐỎ 19 file** — 7 `qa-runner` *(sẽ xoá)* · 5 `qa-reviewer/script` · 1 `qa-automation-assess` · 5 `commands/qc-*` · 1 `modules/qc-*` |
+| 2 | So output `self-check` trước/sau khi **chỉ** làm ① | khác biệt **0 dòng** | ✅ **xanh y nguyên** — mở scan set sang `skills/` không đỏ thêm gì |
+| 3 | `node test/run.js` | **244/244**, không đổi | ✅ **244/244** |
+| 4 | `node bin/build.js` · `node bin/lint-trace.js` | xanh | ✅ cả hai xanh |
+| 5 | **Phá:** thêm `pytest` vào `commands/dev-gen-test.tmpl` | **KHÔNG đỏ** | ✅ **0 lần nhắc** trong output R5 — `scope` chặn thật |
+| 6 | **Phá:** thêm `pytest` vào một file `skills/qc` **đang sạch** | **ĐỎ** | ✅ `qa-runner/exploratory/session.md` → **1 lần nhắc** |
+| 6b | **Phá:** thêm `pytest` vào **tầng tài liệu** `qa-designer/e2e/journey.md` | **KHÔNG đỏ** *(sau S-SCOPE)* | ✅ **0 lần nhắc** — 5 tầng tài liệu thật sự ngoài tầm |
+| 7a | **Phá:** `except` trỏ file **đã sạch** | **WARN R5** | ✅ `⚠️ [R5] \`_page.py\`: except \`…/risk-model.md\` không còn chứa pattern (hoặc ngoài scope)` |
+| 7b | **Phá:** `except` trỏ file **đang đỏ** | file đó **biến mất** khỏi danh sách | ✅ `matrix.md` rời khỏi danh sách của `_page.py`, 3 file kia ở lại |
+| 9 | `scope` phủ **thư mục S2 sắp tạo** *(`qa-script-designer/**` · `qa-script-runner/**`)* | 2 glob có mặt · WARN *"khớp 0 file"* cho tới khi S2 tạo chúng | ✅ **2 WARN đúng 2 thư mục đó** — và WARN sẽ tự tắt khi S2 tạo file |
+| 10 | Sau S2, glob `skills/qc/qa-runner/**` trở thành glob chết | WARN *"khớp 0 file"* → **gỡ glob trong CHÍNH commit của S2** | ⏳ chờ S2 |
+| 8 | Sau S1–S5 | R5 **xanh**, `except` **rỗng**, **0 WARN scope** | ⏳ chờ S1–S5 |
+
+> **Phép thử 5 và 6 ra ngược nhau — đó là điều phải chứng minh.** Cùng đỏ nghĩa là `scope` bị bỏ
+> qua; cùng xanh nghĩa là pattern không khớp gì. Một xanh một đỏ mới nói `scope` đang làm việc.
+>
+> **Đèn đỏ ở đâu — bản ghi 2026-09-17** *(đây là bằng chứng của `G3`, chụp lại vì cây git sẽ
+> xanh suốt — xem [`exec-S §8`](exec-S-ap-stack-typescript.md))*:
+>
+> | Pattern | File đỏ |
+> |---|:-:|
+> | `pytest` | 21 |
+> | `Python` | 19 |
+> | `python` | 13 |
+> | `conftest.py` | 8 |
+> | `_page.py` | 4 |
+> | `.py` | 16 |
+> | **hợp** | **27** |
+
+> Phép thử **5** và **6** là hai phép quan trọng nhất và chúng phải chạy **ngược nhau**. Một cái
+> xanh một cái đỏ mới chứng minh `scope` đúng; cả hai cùng đỏ nghĩa là `scope` bị bỏ qua, cả hai
+> cùng xanh nghĩa là pattern không khớp gì cả.
+
+## B5 · Bài học
+
+- **2026-09-17** — Định viết đèn thành một test mới trong `test/run.js` *(exec-S §B2 đã viết thế)*. Đọc `self-check.js:279` thì **R5 đã là đúng cơ chế đó**, kèm cả `except` có lý do và cảnh báo except chết. Nguyên nhân thật: kế hoạch được viết từ *"cần một đèn"* chứ không từ *"đã có đèn nào chưa"*. Sửa: trước khi thêm một cơ chế, **grep tên lớp việc trong `bin/` đã**.
+- **2026-09-17** — Bản nháp đầu định cấm luôn `Allure` và `BasePage` vì trông giống stack cũ. Đối chiếu `qc-base-new/` thì cả hai **sống sót**, và Allure còn **bắt buộc** cho mobile. Nguyên nhân thật: suy *"cũ"* từ trí nhớ thay vì tra tài liệu Approved. Sửa: mọi pattern định cấm phải `grep` qua `upstream/qc-base-new/` trước.
+- **2026-09-17** — Phạm vi đèn trỏ `skills/qc/qa-runner/**` — **thư mục S2 sắp XOÁ** — và không trỏ `qa-script-designer/**` · `qa-script-runner/**` — **hai thư mục S2 sắp TẠO**. Sau S2 đèn sẽ **xanh vì rỗng, không vì sạch**: 6 file skill TypeScript mới ra đời **không ai canh**. Nguyên nhân thật: phạm vi được viết theo **hiện trạng** trong khi rule này sinh ra để canh **trạng thái sau khi đổi**. Sửa: thêm 2 glob, **và** thêm cảnh báo `scope` khớp 0 file — vì lỗi này tôi bắt được bằng tay, lần sau sẽ không ai bắt.
+- **2026-09-17** — Lúc chạy phép thử 7, dùng `JSON.stringify(schema, null, 2)` để chèn `except` tạm → **reformat toàn bộ 3.100 dòng** của `trace-schema.json`. Không hỏng gì vì có bản sao, nhưng `git diff --stat` suýt không đọc được. Nguyên nhân thật: sửa một file cấu hình lớn bằng parse–ghi-lại thay vì sửa tại chỗ. Sửa: phép thử phá trên file JSON lớn phải **sao lưu trước, `git diff --stat` sau** — đã làm và xác nhận đúng **38 dòng thêm, 0 dòng đổi**.
+
+## B6 · Copy được / không copy được
+
+| | |
+|---|---|
+| ✅ **Copy được sang dự án khác** | Dựng đèn **trước** khi dọn, và lấy danh sách đỏ làm danh sách việc *(đèn tìm ra 10 file mà người viết kế hoạch không nghĩ tới)*; `scope` mặc định = toàn bộ để entry cũ không đổi hành vi; mỗi miễn trừ kèm lý do + cảnh báo khi miễn trừ hết cần; hai phép thử phá **ngược nhau** để chứng minh phạm vi |
+| ⚠️ **Chỉ đúng ở đây** | Tên `R5` và hình dạng `forbidden_patterns`; việc Python là ngôn ngữ sản phẩm hợp lệ *(dự án khác có thể cấm toàn cục là đúng)*; 6 pattern cụ thể; `docs/plans/` nằm ngoài vì kế hoạch phải trích dẫn pattern |
+
+## B7 · Link
+
+- [`exec-S-ap-stack-typescript.md`](exec-S-ap-stack-typescript.md) — §8 *(S0 là việc 1/6)*, §B2 *(danh sách file — §0.2 của file này bổ sung 10 file)*
+- [`PLAN_v2.md`](PLAN_v2.md) — §7 `G3` *("dựng rule trước khi vá")* · §8 luật 1 và luật 4
+- `bin/self-check.js:279` — R5 · `:90` `allSourceFiles()` · `:293` cảnh báo except chết
+- `bin/trace-schema.json` — `forbidden_patterns` *(11 entry)*
+- `upstream/qc-base-new/` — `Automation-Standards.md:221` `BasePage` · `Mobile-Automation-Standards.md:48` Allure
+
+---
+
+## 9 · Nợ S0 để lại — có chủ, không phải chỗ quên
+
+| Nợ | Vì sao để lại | Ai / khi nào |
+|---|---|---|
+| `docs/` **ngoài tầm đèn** — 5 file QC còn Python sau S5 vẫn không được canh | `docs/` cần nói *"trước đây là Python"*; đèn ở đó sẽ đẻ ra `except` bừa *(§1.2)* | rà lại sau Đợt 4, khi biết docs ổn định tới đâu |
+| Đèn canh **chữ**, không canh **hình dạng** — một skill viết đúng TypeScript nhưng bố cục thư mục kiểu pytest vẫn qua | Canh hình dạng cần parse, không phải so chuỗi | nếu tái phát thì mới dựng; đừng dựng trước |
+| **8 file · 16 dòng ở 5 tầng tài liệu** vẫn mô tả stack Python — ngoài tầm đèn sau `S-SCOPE` | Quyết định 09-17: 5 tầng đó không đổi stack | **nhóm A + D** *(4 dòng)*: sửa bất cứ lúc nào, không chặn ai. **nhóm B** *(10 dòng)*: **chị QC** — xem ⚠️ ở §1.2b, nó đảo ngược ý nghĩa chứ không phải đổi cú pháp. **nhóm C** *(2 dòng)*: **không sửa**, đó là guard |
+| **Hệ quả trực tiếp của nhóm B:** `.Test.md` do trạm 3 sinh ra vẫn dặn QC ghi `@pytest.mark.flaky`, còn trạm 6 sinh script TypeScript **không hiểu marker đó** | Là giá của `S-SCOPE`, đã biết khi chốt | người sinh script phải tự dịch mỗi lần. Ghi ra đây để nó là **một lựa chọn**, không phải một chỗ quên |