@relipa/ai-flow-kit 0.1.2 → 0.1.3

package/custom/skills/pr-impact-analysis/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: pr-impact-analysis
+description: Dev Artifacts Check — Phân tích PR diff để xác định phạm vi ảnh hưởng thật của thay đổi code, đề xuất regression TCs, lưu SHA tracking. Chạy đầu Gate 2a, đầu Gate 3, và sau mỗi RETEST có commit mới.
+keywords: pr, impact analysis, regression, dev artifacts, github, diff, sha, code review, gate2, gate3
+---
+
+# Dev Artifacts Check — PR Impact Analysis
+
+> **Mục đích:** Xác định **phạm vi ảnh hưởng thật** của thay đổi code từ PR của dev,
+> để tránh miss regression test khi code thay đổi mở rộng hơn scope ticket.
+>
+> **Khi nào chạy:**
+> - Đầu Gate 2 Phase 2a (sau Gate 1 APPROVED) — xác định regression scope ban đầu
+> - Đầu Gate 3 (trước khi execute) — phát hiện PR mới hoặc commit mới kể từ Gate 2
+> - Sau mỗi RETEST khi dev push commit fix — check xem fix có mở rộng impact không
+
+---
+
+## Trigger
+
+Một trong các cách:
+
+1. **TESTER khai báo trong chat:** `PR: <url>` hoặc `PR: <url1>, <url2>` (multi-repo)
+2. **AI phát hiện tự động:** Ticket có PR link đính kèm → AI đề xuất, TESTER confirm
+3. **Không có PR** → ghi nhận "chưa có dev artifacts" vào `impact-analysis.md`, không block gate
+
+---
+
+## Quy trình với mỗi PR
+
+### Step 1: Fetch PR Info
+
+Ưu tiên `gh` CLI nếu available:
+
+```bash
+gh pr view <url> --json title,body,headRefOid,files
+```
+
+Lấy về:
+- `title` — tiêu đề PR
+- `body` — PR description (thường chứa summary của dev)
+- `headRefOid` — SHA của commit đầu PR (dùng để track delta sau này)
+- `files` — danh sách files thay đổi + số dòng
+
+**Fallback (không có `gh` hoặc không phải GitHub):**
+```bash
+git fetch origin <branch>
+git diff main...<branch> --stat
+```
+Yêu cầu TESTER cung cấp branch name.
+
+---
+
+### Step 2: Phân tích theo Layer
+
+Không đổ cả diff vào context. Phân tích có chọn lọc:
+
+**Bước 2a:** Nhóm files theo layer/khu vực:
+
+| Layer | Files điển hình | Mức độ rủi ro |
+|-------|----------------|--------------|
+| Migration / Schema | `*.sql`, `*migration*`, `*schema*` | 🔴 High — ảnh hưởng toàn bộ data |
+| Middleware / Config | `middleware/*`, `config/*`, `*.env*` | 🔴 High — ảnh hưởng toàn app |
+| Shared lib / Utils | `lib/*`, `utils/*`, `helpers/*`, `common/*` | 🟡 Medium — nhiều callers |
+| Controller / API route | `controller/*`, `routes/*`, `api/*` | 🟡 Medium — ảnh hưởng endpoint |
+| Service / Business logic | `service/*`, `usecase/*`, `domain/*` | 🟡 Medium |
+| Component / Page | `components/*`, `pages/*`, `views/*` | 🟢 Low — ảnh hưởng UI cụ thể |
+| Test files | `*.test.*`, `*.spec.*`, `__tests__/*` | 🟢 Low — không ảnh hưởng prod |
+| Docs / Config | `*.md`, `*.json` (non-env) | 🟢 Ignore |
+
+**Bước 2b:** Với files rủi ro High → đọc full diff:
+
+```bash
+gh pr diff <url> -- <path/to/high-risk-file>
+```
+
+Chỉ đọc files có khả năng tác động lan rộng. Không đọc toàn bộ diff.
+
+---
+
+### Step 3: Map Code → Feature → Regression Scope
+
+Dựa trên danh sách files và diff:
+
+1. Xác định **màn hình/chức năng bị ảnh hưởng trực tiếp** (những gì PR cố tình thay đổi)
+2. Xác định **màn hình/chức năng bị ảnh hưởng gián tiếp** (callers, dependencies, shared code)
+3. Đề xuất TCs regression cần chạy thêm (ngoài TCs gốc cho feature đang test)
+
+**Ví dụ:**
+- PR sửa `UserService.findById()` → ảnh hưởng Profile page, Settings page, Order History (gọi user info)
+- PR thêm migration `ALTER TABLE orders` → ảnh hưởng Order list, Order detail, Cart checkout
+
+---
+
+### Step 4: Record SHA + Output impact-analysis.md
+
+Lưu `test-plan/impact-analysis.md`:
+
+```markdown
+# Dev Artifacts — Impact Analysis
+
+**Last updated:** [YYYY-MM-DD HH:MM] | **Gate:** [2 / 3 / RETEST]
+
+---
+
+## Dev Artifacts Reference
+
+| PR | Repo | SHA đã đọc | Summary | Lần check cuối |
+|----|------|-----------|---------|---------------|
+| #123 | repo-be | a1b2c3d | ✅ Sửa UserService.findById, thêm caching | Gate 2 |
+| #456 | repo-fe | e5f6a7b | ✅ Update ProfilePage component | Gate 2 |
+
+_(Nếu chưa có PR: "Chưa có dev artifacts — sẽ check lại ở Gate 3")_
+
+---
+
+## Impact Analysis
+
+### Vùng thay đổi (theo layer)
+
+| Layer | Files | Số dòng thay đổi | Rủi ro |
+|-------|-------|-----------------|--------|
+| Service | `UserService.java` | +45/-12 | 🟡 Medium |
+| Component | `ProfilePage.tsx` | +23/-8 | 🟢 Low |
+
+### Màn hình ảnh hưởng trực tiếp
+- **Profile Page** (`/profile`) — component thay đổi trực tiếp
+- **Settings Page** (`/settings`) — gọi UserService.findById
+
+### Màn hình ảnh hưởng gián tiếp (regression risk)
+- **Order History** (`/orders`) — sử dụng UserService.findById cho user info
+  _Lý do: caching layer mới có thể trả về stale data cho order display_
+- **Admin User Management** (`/admin/users`) — cùng service
+
+### Đề xuất Regression TCs
+
+Ngoài TCs gốc của feature, cần test thêm:
+
+| TC (Regression) | Lý do |
+|-----------------|-------|
+| Verify Order History hiển thị đúng user info | UserService.findById đã thêm caching |
+| Verify Admin User list không bị cache stale | Shared service thay đổi |
+```
+
+---
+
+## Guard Rails (bắt buộc)
+
+> ⚠️ PR diff + summary chỉ được dùng để **mở rộng độ phủ** (thêm TC, thêm vùng regression).
+> **Tuyệt đối KHÔNG dùng để xác định expected result** — expected result chỉ lấy từ ticket/spec của BA/PM.
+>
+> Lý do: nếu dev hiểu sai requirement → TC sinh từ dev artifacts cũng sai → test pass nhưng feature làm sai.
+> Khi dev artifacts mâu thuẫn với spec → flag thành câu hỏi hoặc bug tiềm năng, không sửa TC.
+
+---
+
+## Delta Detection (Gate 3 + RETEST)
+
+Khi re-run Dev Artifacts Check ở Gate 3 hoặc sau RETEST:
+
+1. Đọc SHA đã ghi trong `impact-analysis.md`
+2. Fetch SHA hiện tại của PR: `gh pr view <url> --json headRefOid`
+3. **Nếu SHA thay đổi** → có commit mới → đọc diff delta:
+   ```bash
+   gh pr diff <url> -- <files-changed-since-old-sha>
+   ```
+4. **Phân tích delta** → đề xuất TC bổ sung (mini-loop, chỉ phần thêm mới)
+5. Cập nhật SHA mới vào `impact-analysis.md`
+
+**Không cần TESTER approve lại toàn bộ Gate 2** — chỉ approve **phần delta** (TCs mới do commit mới gây ra).
+
+---
+
+## Mandatory Rules
+
+- ❌ **KHÔNG** dùng expected result từ PR description — chỉ dùng ticket/spec của BA
+- ❌ **KHÔNG** đọc full diff của toàn bộ files — chỉ đọc selective (high-risk files)
+- ✅ **PHẢI** ghi SHA đã đọc vào `impact-analysis.md` để delta detection sau này
+- ✅ **PHẢI** phân biệt rõ ảnh hưởng trực tiếp vs gián tiếp
+- ✅ Không có PR → không block gate, ghi nhận và tiến tiếp

package/custom/skills/retest-orchestration/SKILL.md

@@ -0,0 +1,191 @@
+---
+name: retest-orchestration
+description: Gate 3 RETEST loop — Parse lệnh "RETEST: TC_ID" từ TESTER, re-run Dev Artifacts Check (phát hiện commit mới), chạy Playwright selective cho TCs được chỉ định, cập nhật evidence và bug status.
+keywords: gate3, retest, loop, re-execute, playwright, dev artifacts, delta, bug fix, selective test
+---
+
+# RETEST Orchestration — Gate 3 Loop
+
+> **Mục đích:** Xử lý lệnh `RETEST` từ TESTER sau khi dev fix bug, re-run Playwright có chọn lọc,
+> và cập nhật evidence + bug status tương ứng.
+>
+> **Trigger:** TESTER gõ `RETEST: AD10_002` hoặc `RETEST: AD10_001, AD10_002, AD10_003`
+
+---
+
+## Trigger Syntax
+
+```
+RETEST: AD10_002                    # Re-run 1 TC
+RETEST: AD10_002, AD10_005          # Re-run nhiều TCs
+RETEST: AD10_002, AD10_005, AD10_008
+```
+
+AI parse TC IDs từ text sau `RETEST:` (case-insensitive, trim whitespace, split by comma).
+
+---
+
+## Step 1: Re-run Dev Artifacts Check
+
+Trước khi re-execute, **luôn luôn** chạy Dev Artifacts Check (invoke `pr-impact-analysis` skill):
+
+**Lý do:** Dev commit fix có thể thay đổi thêm code ngoài chỗ đang fix → cần phát hiện và cover.
+
+1. Đọc SHA đã ghi trong `test-plan/impact-analysis.md`
+2. Fetch SHA hiện tại: `gh pr view <url> --json headRefOid`
+3. **Nếu SHA không thay đổi** → skip delta analysis, tiến sang Step 2
+4. **Nếu SHA thay đổi** → có commit mới:
+   - Phân tích diff delta (chỉ phần thay đổi từ SHA cũ → SHA mới)
+   - Đề xuất TC bổ sung nếu có area mới bị ảnh hưởng
+   - Hiển thị **mini-loop prompt:**
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚠️ RETEST — DELTA DETECTED
+
+Dev đã push commit mới (SHA: [old] → [new])
+Diff mới ảnh hưởng thêm:
+  - [file/area 1] → [feature bị ảnh hưởng]
+  - [file/area 2] → [feature bị ảnh hưởng]
+
+Đề xuất TC bổ sung:
+  - TC_[Module]_XXX: [Scenario mới cần test do delta]
+
+→ Type APPROVED to add these TCs and continue RETEST
+→ Type SKIP to proceed without new TCs
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+   - TESTER gõ `APPROVED` → generate scripts cho TC mới → thêm vào RETEST list
+   - TESTER gõ `SKIP` → tiến sang Step 2 chỉ với TCs ban đầu
+   - Cập nhật SHA mới vào `impact-analysis.md`
+
+---
+
+## Step 2: Execute Playwright (Selective)
+
+Chạy Playwright chỉ cho các TCs được chỉ định:
+
+```bash
+BASE_URL=<baseUrl> npx playwright test --grep "AD10_002|AD10_005" --headed
+```
+
+**Nếu một TC không có script** (type = Manual hoặc script chưa được sinh):
+- Hiển thị: `⚠️ AD10_011: Không có Playwright script (Manual TC). Tester cần test thủ công.`
+- Bỏ qua TC đó, tiếp tục với các TCs còn lại
+
+**Nếu script bị lỗi syntax** (script cũ, selector đã hỏng):
+- Hiển thị error cụ thể
+- Đề xuất re-generate script: `Muốn tôi cập nhật script cho TC này không?`
+
+---
+
+## Step 3: Cập nhật Evidence
+
+Invoke `evidence-aggregation` skill cho RETEST results:
+
+**Không xóa evidence cũ** — tạo subfolder theo run:
+
+```
+evidence/
+├── AD10_002-error-sai-password/
+│   ├── run-1/          ← Original run (FAIL)
+│   │   ├── failure-screenshot.png
+│   │   └── result.md
+│   └── run-2/          ← RETEST run (kết quả mới)
+│       ├── step-01.png
+│       └── result.md
+```
+
+**result.md của run mới** phải link về run cũ:
+
+```markdown
+# Result: AD10_002 — RETEST Run 2
+
+**Status:** ✅ PASS (Previous: ❌ FAIL — Run 1)
+**Run date:** [YYYY-MM-DD HH:MM]
+**Bug reference:** bugs/BUG-001-error-message-khong-hien.md → RESOLVED
+
+...
+```
+
+---
+
+## Step 4: Cập nhật Bug Status
+
+Với mỗi TC trong RETEST:
+
+**TC pass sau RETEST** (trước đó fail):
+- Đọc `bugs/` để tìm BUG liên quan đến TC_ID đó
+- Cập nhật BUG file: thêm section Resolution:
+
+```markdown
+## Resolution
+
+**Status:** ✅ RESOLVED
+**Fixed in commit:** [SHA từ impact-analysis.md]
+**Retest result:** ✅ PASS — [YYYY-MM-DD]
+**Retest evidence:** evidence/AD10_002-error-sai-password/run-2/
+```
+
+**TC vẫn fail sau RETEST**:
+- Cập nhật BUG file: thêm RETEST attempt:
+
+```markdown
+## Retest History
+
+| Run | Date | Result | Notes |
+|-----|------|--------|-------|
+| 1 | [Date] | ❌ FAIL | Initial run |
+| 2 | [Date] | ❌ FAIL | Dev fix không resolve issue |
+
+**Action needed:** Dev cần investigate thêm. Error vẫn reproduce với [details].
+```
+
+---
+
+## Step 5: Display RETEST Summary
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔁 RETEST COMPLETE
+
+TCs re-executed: [N]
+  ✅ Now PASS: [N] (bugs RESOLVED)
+  ❌ Still FAIL: [N] (bugs remain OPEN)
+  ⏭ Skipped (Manual): [N]
+
+Bugs updated:
+  ✅ RESOLVED: BUG-001, BUG-003
+  🔴 Still OPEN: BUG-002, BUG-004
+
+[Nếu còn critical/high bugs open:]
+→ Review bugs: bugs/
+→ Dev cần fix thêm: [list bugs còn open]
+→ Type RETEST: [TC_ID] when dev fixes again
+
+[Nếu tất cả critical/high bugs đã resolved:]
+→ All critical/high issues resolved! ✅
+→ Type APPROVED to proceed to Gate 4 (Test Report)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Loop Continuation
+
+Gate 3 loop tiếp tục cho đến khi:
+- **Điều kiện kết thúc loop:** Tất cả Critical và High bugs đã RESOLVED và pass RETEST
+- **Medium/Low bugs:** TESTER có thể chọn defer (không bắt buộc phải pass trước Gate 4)
+- **TESTER gõ `APPROVED`** → Gate 4 bắt đầu (invoke `generate-test-report` skill)
+
+---
+
+## Mandatory Rules
+
+- ✅ **PHẢI** re-run Dev Artifacts Check trước mỗi RETEST (kể cả delta = 0)
+- ✅ **PHẢI** cập nhật bug status sau mỗi RETEST
+- ✅ Evidence của các run phải được giữ lại (không xóa)
+- ❌ **KHÔNG** tự động chuyển sang Gate 4 — chỉ khi TESTER gõ APPROVED
+- ❌ **KHÔNG** skip delta analysis kể cả khi TESTER nói "chỉ 1 dòng fix"
+- ✅ Manual TCs → nhắc TESTER test thủ công, không bỏ qua

package/custom/skills/script-sync/SKILL.md

@@ -0,0 +1,208 @@
+---
+name: script-sync
+description: Sync test cases với Playwright scripts theo cơ chế hash. Với mỗi TC_ID trong TC file, kiểm tra script hiện tại bằng @tc-hash comment — gen mới nếu chưa có, update nếu TC thay đổi, skip nếu không đổi. Dùng Playwright MCP để lấy selector thật khi gen/update.
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash, mcp__playwright__browser_navigate, mcp__playwright__browser_snapshot, mcp__playwright__browser_generate_locator, mcp__playwright__browser_click, mcp__playwright__browser_type, mcp__playwright__browser_close
+---
+
+# Skill: script-sync
+
+Sync test cases (từ TC file `.md`) với Playwright spec files, sử dụng **hash-based change detection**
+để chỉ gen/update những TC thực sự thay đổi — tránh overwrite script đang chạy tốt.
+
+---
+
+## Input
+
+Được gọi từ `execute-flow` skill (Gate 2) với context:
+
+- `tcFile`: path đến TC file markdown (vd `testcases/AD10.md`)
+- `repo`: tên repo (vd `repo-fe`)
+- `screenId`: mã màn hình, always lowercase (vd `ad10`, not `AD10`) — directory paths use lowercase; spec file name `{ScreenID}.spec.ts` remains uppercase
+- `baseUrl`: URL của app để Playwright MCP snapshot
+
+---
+
+## Hash Computation
+
+**Công thức:** `SHA1(TC_ID + "|" + Steps + "|" + Expected Result)` → lấy 8 ký tự đầu.
+
+Các trường lấy từ TC file:
+- `TC_ID`: cột "Test Case ID"
+- `Steps`: cột "Steps" (giữ nguyên text, bao gồm số thứ tự)
+- `Expected Result`: cột "Expected Result"
+
+Không tính vào hash: `Severity`, `Pre-condition`, `Data Test`, `Ticket ID`, `Comment`, `R1/R2 columns`.
+
+**Mục đích:** Hash chỉ thay đổi khi steps hoặc expected result thay đổi — sửa comment/severity không trigger update.
+
+---
+
+## Spec File Structure
+
+Mỗi TC trong spec file có metadata comment ngay trước `test()`:
+
+```typescript
+// @screen-id: AD10
+// @screen-name: Create Product
+// @repo: repo-fe
+// @screen-url: /admin/products/create
+// @generated: YYYY-MM-DD
+
+import { test, expect } from '../../shared/fixtures/test'
+import { AD10Page } from '../pages/AD10Page'
+
+test.describe('AD10 - Create Product', () => {
+
+  // @tc-hash: a3f9b2c1
+  // @tc-id: AD10_001
+  test('AD10_001 - Truy cập trực tiếp qua URL khi chưa đăng nhập', async ({ page }) => {
+    // ...
+  })
+
+  // @tc-hash: d7e2f4a9
+  // @tc-id: AD10_002
+  test('AD10_002 - Truy cập trực tiếp qua URL khi đã đăng nhập', async ({ page }) => {
+    // ...
+  })
+
+})
+```
+
+---
+
+## Sync Algorithm
+
+### Bước 1: Parse TC file
+
+Đọc TC file, extract từ Section 3 (Danh sách Test Cases Chi Tiết):
+- TC_ID, Test Case Name, Steps, Expected Result, Severity
+
+Nhận diện **Manual TCs** — các TC không thể automation:
+- Steps đề cập "kiểm tra DB", "kiểm tra email", "kiểm tra file system"
+- Steps quá mơ hồ: "Quan sát giao diện", "Kiểm tra layout, màu sắc"
+- Steps yêu cầu hành động ngoài browser: restart server, check log file
+
+### Bước 2: Scan spec file hiện tại
+
+Tìm `ak-test/{repo}/scripts/{screenId}/{ScreenID}.spec.ts`.
+
+Nếu tồn tại: đọc file, extract tất cả cặp `@tc-hash` + `@tc-id` bằng regex:
+```
+// @tc-hash: ([a-f0-9]{8})
+// @tc-id: ([A-Za-z0-9_]+)
+```
+
+Tạo map: `{ [TC_ID]: hash }` từ spec file hiện tại.
+
+### Bước 3: Classify từng TC
+
+Với mỗi TC trong TC file:
+
+| Điều kiện | Status | Hành động |
+|-----------|--------|-----------|
+| TC là Manual TC | `manual` | Bỏ qua, đánh dấu Untest |
+| Không có trong spec file | `new` | Gen script mới |
+| Có trong spec file, hash khớp | `skipped` | Không làm gì |
+| Có trong spec file, hash khác | `updated` | Update test block |
+
+### Bước 4: Gen script cho TCs có status `new`
+
+Với mỗi TC cần gen mới:
+
+1. Tính hash mới: `SHA1(TC_ID + "|" + Steps + "|" + Expected Result)[:8]`
+2. Dùng Playwright MCP để lấy selectors thật:
+   - `mcp__playwright__browser_navigate` → `baseUrl + screenUrl`
+   - `mcp__playwright__browser_snapshot` → lấy accessibility tree
+   - Với từng element trong Steps: `mcp__playwright__browser_generate_locator`
+3. Sinh test block với metadata comments:
+
+```typescript
+  // @tc-hash: {hash}
+  // @tc-id: {TC_ID}
+  test('{TC_ID} - {Test Case Name}', async ({ page }) => {
+    const pageObj = new {ScreenID}Page(page)
+    // Step 1: {step text}
+    await pageObj.{action}()
+    // Step 2: {step text}
+    await pageObj.{action}()
+    // Expected: {expected result}
+    await expect(page.{locator}).{assertion}
+  })
+```
+
+4. Nếu spec file chưa tồn tại: tạo file mới với file header + describe wrapper + test block.
+5. Nếu spec file đã tồn tại: append test block vào trước closing `})` của `test.describe`.
+6. Nếu `{ScreenID}Page.ts` chưa tồn tại: tạo Page Object với locators cho các elements đã snapshot.
+
+**File header khi tạo spec mới:**
+```typescript
+// @screen-id: {ScreenID}
+// @screen-name: {Screen Name}
+// @repo: {repo}
+// @screen-url: {url path}
+// @generated: {YYYY-MM-DD}
+
+import { test, expect } from '../../shared/fixtures/test'
+import { {ScreenID}Page } from '../pages/{ScreenID}Page'
+
+test.describe('{ScreenID} - {Screen Name}', () => {
+```
+
+### Bước 5: Update test block cho TCs có status `updated`
+
+1. Tính hash mới
+2. Snapshot DOM với Playwright MCP (các element có thể thay đổi selector nếu TC đổi)
+3. Tìm block cũ trong spec file bằng pattern:
+   ```
+   // @tc-hash: {old-hash}\n  // @tc-id: {TC_ID}\n  test(...)
+   ```
+4. Replace toàn bộ block cũ (từ `// @tc-hash` đến closing `})` của test) bằng block mới
+
+### Bước 6: Xử lý TCs không gen được
+
+| Lý do | Marker |
+|-------|--------|
+| TC manual (DB/email/file check) | `[MANUAL]` — Untest |
+| Steps mơ hồ, không map được selector | `[NEEDS_CLARIFY]` — hỏi tester |
+| Playwright MCP không snapshot được (iframe, native dialog) | `[BLOCKED: {lý do}]` |
+| Race condition (double-click, network timing) | `[BLOCKED: timing-dependent]` |
+
+Với `[NEEDS_CLARIFY]`: hỏi tester rõ element nào cần tương tác, sau đó gen.
+
+### Bước 7: Đóng browser
+
+```
+mcp__playwright__browser_close
+```
+
+---
+
+## Output Summary
+
+```
+📊 SCRIPT SYNC SUMMARY — {ScreenID}
+
+✅ Gen mới:  {N} TCs → {ScreenID}.spec.ts
+🔄 Updated:  {N} TCs → hash refreshed
+⏭️ Skipped:  {N} TCs → không đổi
+⚠️ Manual:   {N} TCs → {TC_IDs} (lý do)
+❌ Blocked:  {N} TCs → {TC_IDs} (lý do)
+
+→ Script: ak-test/{repo}/scripts/{screenId}/{ScreenID}.spec.ts
+→ Page Object: ak-test/{repo}/scripts/pages/{ScreenID}Page.ts
+```
+
+Trả về danh sách kết quả cho `execute-flow`:
+- Danh sách TC_IDs có thể chạy automation (gen mới + updated + skipped)
+- Danh sách TC_IDs manual (Untest)
+- Danh sách TC_IDs blocked (Pending)
+
+---
+
+## Mandatory Rules
+
+- ❌ **Không bao giờ bịa selector** — phải dùng Playwright MCP snapshot
+- ❌ **Không overwrite** test block có hash match — skip hoàn toàn
+- ✅ Ưu tiên locator: `getByRole` > `getByLabel` > `getByPlaceholder` > `getByText` > `getByTestId` > CSS
+- ✅ Không tạo lại `BasePage.ts` / `fixtures/test.ts` nếu đã tồn tại
+- ✅ Viết test names và comments bằng tiếng Việt