@relipa/ai-flow-kit 0.1.2 → 0.1.4-beta.0

package/custom/templates/shared/create-testcase-workflow.md

@@ -0,0 +1,470 @@
+## [QA] 4-Gate TestCase Creation Workflow
+
+> **For:** `create-testcase`
+> **Persona:** Quality Assurance (QA)
+> **Goal:** Chuyển đổi yêu cầu thô (SRS / Backlog / Jira / Spec file) thành bộ Test Case hoàn chỉnh sẵn sàng thực thi, tuân theo quy trình QA Workflow chuẩn.
+> **Interaction Rules:** Hỏi ONE câu hỏi tại một thời điểm — đợi QA trả lời trước khi tiếp tục. KHÔNG hỏi nhiều câu cùng lúc.
+
+---
+
+### QA Skills
+
+Các skill sau đây được cài tự động vào `.claude/skills/test-skills/` khi chạy `ak init` hoặc `ak up`.
+
+| Skill | File |
+|---|---|
+| `QA Writing Standards` | `.claude/skills/test-skills/rules/QA_Writing_Standards.md` |
+| `Directory & Naming Convention` | `.claude/skills/test-skills/rules/Directory_and_Naming_Convention.md` |
+| `Template TestCase` | `.claude/skills/test-skills/template/template_testcase.md` |
+| `00.01 Requirement Analysis` | `.claude/skills/test-skills/categories/00-core/00.01.requirement-analysis.md` |
+| `00.02 Risk Analysis` | `.claude/skills/test-skills/categories/00-core/00.02.risk-analysis.md` |
+| `00.03 Test Scenario Builder` | `.claude/skills/test-skills/categories/00-core/00.03.test-scenario-builder.md` |
+| `00.04 TestCase Review` | `.claude/skills/test-skills/categories/00-core/00.04.testcase-review.md` |
+| `01.01 BVA` | `.claude/skills/test-skills/categories/01-test-design/01.01.boundary-value-analysis.md` |
+| `01.02 EP` | `.claude/skills/test-skills/categories/01-test-design/01.02.equivalence.partitioning.md` |
+| `01.03 Decision Table` | `.claude/skills/test-skills/categories/01-test-design/01.03.decision-table.md` |
+| `01.04 State Transition` | `.claude/skills/test-skills/categories/01-test-design/01.04.state.transition.md` |
+| `01.05 Pairwise` | `.claude/skills/test-skills/categories/01-test-design/01.05.pairwise.md` |
+| `01.06 Error Guessing` | `.claude/skills/test-skills/categories/01-test-design/01.06.error-guessing.md` |
+| `02.01 UI Layout` | `.claude/skills/test-skills/categories/02-ui-testing/02.01.UI-layout.md` |
+| `02.02 Form Validation` | `.claude/skills/test-skills/categories/02-ui-testing/02.02.form-validation.md` |
+| `02.03 Navigation` | `.claude/skills/test-skills/categories/02-ui-testing/02.03.navigation.md` |
+| `02.04 Localization` | `.claude/skills/test-skills/categories/02-ui-testing/02.04.localization.md` |
+| `03.01 CRUD Testing` | `.claude/skills/test-skills/categories/03-business-testing/03.01.CRUD-testing.md` |
+| `03.02 Workflow Testing` | `.claude/skills/test-skills/categories/03-business-testing/03.02.workflow-testing.md` |
+| `03.03 Permission Testing` | `.claude/skills/test-skills/categories/03-business-testing/03.03.permission-testing.md` |
+| `03.04 Dependency Validation` | `.claude/skills/test-skills/categories/03-business-testing/03.04.dependency-validation.md` |
+| `03.05 Notification Testing` | `.claude/skills/test-skills/categories/03-business-testing/03.05.notification-testing.md` |
+| `03.06 Calculation Testing` | `.claude/skills/test-skills/categories/03-business-testing/03.06.calculation.testing.md` |
+| `04.01 Database Testing` | `.claude/skills/test-skills/categories/04-data-testing/04.01.database-testing.md` |
+| `04.04 Duplicate Handling` | `.claude/skills/test-skills/categories/04-data-testing/04.04.duplicate-handling.md` |
+| `05.04 File Upload/Download` | `.claude/skills/test-skills/categories/05-integration/05.04.file-upload-download.md` |
+| `99.01 Coverage Review` | `.claude/skills/test-skills/categories/99-review/99.01.coverage-review.md` |
+
+---
+
+### Cấu trúc thư mục đầu ra
+
+```
+docs/ak-{project}/testcase/
+├── Result/
+│   ├── [functionId]_01_Requirement_Analysis_Result.md     ← Gate 1 tạo
+│   ├── [functionId]_02_Test_Scenarios_Result.md           ← Gate 2 tạo
+│   ├── [functionId]_03_Test_Cases_Draft_Result.md         ← Gate 3 tạo
+│   └── [functionId]_04_Test_Cases_Final_Result.md         ← Gate 4 tạo (đồng thời với TestCase)
+├── QA/
+│   ├── [functionId]_01_Requirement_Analysis_QA.md         ← Gate 1 tạo (nếu có issue)
+│   ├── [functionId]_02_Scenario_Building_QA.md            ← Gate 2 tạo (nếu có issue)
+│   ├── [functionId]_03_Test_Design_QA.md                  ← Gate 3 tạo (nếu có issue)
+│   └── [functionId]_04_Test_Review_QA.md                  ← Gate 4 tạo
+└── TestCase/
+    └── [functionId]_TestCase.md                           ← Gate 4 tạo đồng thời với 04_Final_Result
+```
+
+Ví dụ: `functionId = AD06`, `project = kcandy` → thư mục gốc là `docs/ak-kcandy/testcase/`
+
+---
+
+### Quy trình tổng quan 4 Gates
+
+```
+(testcase/ = docs/ak-{project}/testcase/ — viết tắt cho ngắn gọn)
+
+[Input: SRS / Jira / Backlog / Spec file] → Pre-flight: xác định functionId + thư mục đầu ra
+    ↓
+Gate 1: Phân tích yêu cầu & Đánh giá rủi ro  → testcase/Result/ + testcase/QA/
+    ↓ APPROVED
+Gate 2: Xây dựng Kịch bản (Scenario Building) → testcase/Result/ + testcase/QA/
+    ↓ APPROVED
+Gate 3: Thiết kế Test Case chi tiết           → testcase/Result/ + testcase/QA/
+    ↓ APPROVED
+Gate 4: Review & Tối ưu hóa                  → testcase/Result/ + testcase/QA/
+                                              + testcase/TestCase/[functionId]_TestCase.md
+    ↓ APPROVED (Fully / Conditionally)
+Sẵn sàng thực thi kiểm thử
+```
+
+---
+
+### GATE 1 — Phân tích yêu cầu & Đánh giá rủi ro (auto-start)
+
+**Mục tiêu:** Tiếp nhận đầu vào, hiểu nghiệp vụ, xác định phạm vi kiểm thử, nhận diện rủi ro và phát hiện vấn đề cần làm rõ trước khi xây dựng kịch bản.
+
+**Đầu ra (Outputs):**
+- `docs/ak-{project}/testcase/Result/[functionId]_01_Requirement_Analysis_Result.md`
+- `docs/ak-{project}/testcase/QA/[functionId]_01_Requirement_Analysis_QA.md` (nếu có issue)
+
+**Bước thực hiện:**
+
+#### Bước 0: Pre-flight — Xác định functionId và thư mục đầu ra
+
+**Xác định `functionId`:**
+
+Kiểm tra theo thứ tự ưu tiên:
+1. Trường `functionId` hoặc `screenId` trong `.aiflow/context/current.json`
+2. Rút gọn từ `ticketId` — bỏ dấu gạch, giữ ký hiệu (ví dụ: `AD-06` → `AD06`)
+3. Nếu không tìm thấy → **hỏi QA ngay**:
+
+```
+Không tìm thấy functionId trong context.
+Vui lòng cung cấp mã định danh cho chức năng này (ví dụ: AD06, TC-LOGIN, PM-003):
+```
+
+→ Đợi QA trả lời, ghi nhận giá trị, dùng cho toàn bộ workflow.
+
+**Xác định `{project}` và thư mục đầu ra:**
+
+1. Lấy `{project}` theo thứ tự ưu tiên:
+   - Trường `project` trong `.aiflow/context/current.json`
+   - Tên thư mục gốc workspace (chuyển lowercase, thay space bằng `-`)
+
+2. Kiểm tra tồn tại thư mục `docs/ak-{project}/testcase/` trong root dự án:
+   - **Tìm thấy** → thông báo xác nhận:
+     ```
+     ✓ Thư mục đầu ra: docs/ak-{project}/testcase/
+     ✓ functionId: [functionId]
+     → Bắt đầu Gate 1...
+     ```
+   - **Không tìm thấy** → **hỏi QA**:
+     ```
+     Không tìm thấy thư mục docs/ak-{project}/testcase/.
+     Tên project là gì? (ví dụ: kcandy, crm-app)
+     ```
+     → Nhận tên project từ QA → chuyển lowercase → tạo toàn bộ cây thư mục:
+     ```
+     docs/ak-{project}/testcase/Result/
+     docs/ak-{project}/testcase/QA/
+     docs/ak-{project}/testcase/TestCase/
+     ```
+     → Thông báo:
+     ```
+     ✓ Đã tạo thư mục: docs/ak-{project}/testcase/
+     ✓ functionId: [functionId]
+     → Bắt đầu Gate 1...
+     ```
+
+#### Bước 1: Đọc và tổng hợp đầu vào
+- Đọc `.aiflow/context/current.json` — tiêu đề, mô tả, acceptance criteria, liên kết tài liệu
+- Nếu description có URL → chạy `ak fetch-links <url>` để tải nội dung
+- Nếu có `supplementaryContext[]` → đọc từng item (SRS file, Figma link, API spec, spec MD file)
+- Nếu có file yêu cầu thô được chỉ định → đọc file đó
+
+#### Bước 2: Phân tích yêu cầu và đánh giá rủi ro
+- **READ skill:** `.claude/skills/test-skills/rules/QA_Writing_Standards.md` — đọc trước để nắm quy ước chung
+- **READ skill:** `.claude/skills/test-skills/categories/00-core/00.01.requirement-analysis.md`
+- **READ skill:** `.claude/skills/test-skills/categories/00-core/00.02.risk-analysis.md`
+- Phân tích đầy đủ **16 mục** theo skill 00.01:
+  1. Module/Màn hình/Feature cụ thể
+  2. Ranh giới scope (In-Scope / Out-of-Scope)
+  3. Feature Overview
+  4. Main Flow (Happy Path)
+  5. Alternative Flows / Ngoại lệ
+  6. User Roles / Permissions
+  7. Business Rules
+  8. Validations (Required, Maxlength, Unique, Format, v.v.)
+  9. State / Status
+  10. API / External System
+  11. Accessibility
+  12. Compatibility (Browser/Device)
+  13. Test Data dependencies
+  14. Third-party integrations
+  15. Risk / điểm dễ lỗi
+  16. Q&A / Out of Scope
+- Đánh giá rủi ro theo skill 00.02: kỹ thuật, dữ liệu, nghiệp vụ, hệ thống
+- **Issue Handling:**
+  - Critical/Major → DỪNG, tạo QA artifact, chờ phản hồi (không sinh Result artifact)
+  - Minor → Ghi TBD marker (`[TBD — <issue-id>: mô tả]`), tiếp tục, carry-forward sang gate sau
+
+#### Bước 3: Soạn thảo kết quả phân tích yêu cầu
+- Artifact đầu ra phải có: Feature Summary, Actor & Persona, Business Rules (16 mục), Risk Matrix, Test Scope
+- Lưu: `docs/ak-{project}/testcase/Result/[functionId]_01_Requirement_Analysis_Result.md`
+
+#### Bước 4: Soạn thảo QA Artifact (nếu có issue)
+- Cấu trúc: Metadata, Detected Issues (Severity), Clarification Questions, Assumptions, Resolution Tracking
+- Lưu: `docs/ak-{project}/testcase/QA/[functionId]_01_Requirement_Analysis_QA.md`
+
+#### Bước 5: Gate Review & Pause
+- **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-1-[functionId].md`
+- Hiển thị gate pause message — đợi **APPROVED**
+
+**Khi APPROVED:**
+→ **INVOKE** `gate-review` skill (verify mode) — chạy `ak review check --gate 1 --ticket [functionId]`
+→ Nếu passed: `ak gate 1 approved --ticket [functionId]` → chuyển Gate 2
+→ Nếu blocked: làm theo gate-review skill response protocol
+
+**Definition of Done:**
+- [ ] `functionId` và `{project}` đã được xác định, thư mục đầu ra đã sẵn sàng
+- [ ] File `01_Requirement_Analysis_Result.md` có đủ 16 mục + Risk Matrix + Test Scope
+- [ ] File `01_Requirement_Analysis_QA.md` đã tạo nếu có issue (Critical/Major đã giải quyết)
+- [ ] Không có giả định nào được tự ý chốt thành fact mà không đưa vào QA
+
+> **Telemetry:** Run `ak gate 1 start --ticket [functionId]` khi bắt đầu gate này.
+> Run `ak gate 1 approved --ticket [functionId]` sau khi gate-review verify passed. Run as-is — không thêm shell redirects.
+
+---
+
+### GATE 2 — Xây dựng Kịch bản kiểm thử (Scenario Building)
+
+**Mục tiêu:** Phác thảo các kịch bản kiểm thử mức cao (High-level Scenarios) bao phủ toàn bộ luồng nghiệp vụ, trường hợp ngoại lệ và các rủi ro đã nhận diện ở Gate 1.
+
+**Điều kiện vào Gate 2:** Gate 1 đã **APPROVED** và `01_Requirement_Analysis_Result.md` đã hoàn chỉnh.
+
+**Đầu vào (Inputs):**
+- `docs/ak-{project}/testcase/Result/[functionId]_01_Requirement_Analysis_Result.md`
+
+**Đầu ra (Outputs):**
+- `docs/ak-{project}/testcase/Result/[functionId]_02_Test_Scenarios_Result.md`
+- `docs/ak-{project}/testcase/QA/[functionId]_02_Scenario_Building_QA.md` (nếu có issue)
+
+**Bước thực hiện:**
+
+#### Bước 1: Đọc artifact đầu vào
+- Đọc `[functionId]_01_Requirement_Analysis_Result.md` — nắm toàn bộ 16 mục, Risk Matrix, Business Rules
+
+#### Bước 2: Áp dụng skills xây dựng kịch bản (luôn áp dụng)
+- **READ skill:** `.claude/skills/test-skills/categories/00-core/00.03.test-scenario-builder.md`
+- **READ skill:** `.claude/skills/test-skills/categories/01-test-design/01.06.error-guessing.md`
+- **READ skill:** `.claude/skills/test-skills/categories/03-business-testing/03.02.workflow-testing.md`
+- Kiểm tra có domain skill applicable: `.claude/skills/test-skills/categories/08-domain-skills/`
+- Xây dựng kịch bản đa chiều:
+  - Happy Path (Main Flow)
+  - Negative scenarios
+  - Boundary conditions
+  - Exception scenarios (double-click, timeout, mất mạng)
+  - Permission / Role-based scenarios
+  - E2E (End-to-End) business flow
+
+#### Bước 3: Áp dụng skills có điều kiện
+- **[Nếu có status/lifecycle field]** READ: `.claude/skills/test-skills/categories/01-test-design/01.04.state.transition.md` — thiết kế kịch bản cho mọi transition hợp lệ và không hợp lệ
+- **[Nếu phụ thuộc feature/service khác]** READ: `.claude/skills/test-skills/categories/03-business-testing/03.04.dependency-validation.md` — kịch bản khi dependency lỗi
+- **[Nếu có notification trigger]** READ: `.claude/skills/test-skills/categories/03-business-testing/03.05.notification-testing.md`
+
+#### Bước 4: Soạn thảo kết quả Scenario Building
+- Bảng Scenarios với format:
+  - Scenario ID: `TS_<SCREEN_NUMBER>_<SEQ>` (vd: `TS_06_001` cho AD06)
+  - Cột: Scenario ID, Feature/Module, Check List, Scenario Type, Target Req ID, Priority, Test Data
+- Business Flow Mapping (E2E diagram dạng text)
+- Draft RTM (Scenario ID → Requirement ID từ `01_Requirement_Analysis_Result.md`)
+- Lưu: `docs/ak-{project}/testcase/Result/[functionId]_02_Test_Scenarios_Result.md`
+
+#### Bước 5: Soạn thảo QA Artifact (nếu có issue)
+- Lưu: `docs/ak-{project}/testcase/QA/[functionId]_02_Scenario_Building_QA.md`
+- Minor issues → TBD marker + carry-forward, tiếp tục workflow
+
+#### Bước 6: Gate Review & Pause
+- **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-2-[functionId].md`
+- Hiển thị gate pause message — đợi **APPROVED**
+
+**Khi APPROVED:**
+→ **INVOKE** `gate-review` skill (verify mode) — chạy `ak review check --gate 2 --ticket [functionId]`
+→ Nếu passed: `ak gate 2 approved --ticket [functionId]` → chuyển Gate 3
+→ Nếu blocked: làm theo gate-review skill response protocol
+
+**Definition of Done:**
+- [ ] 100% luồng Happy Path từ 16 mục đã bao phủ
+- [ ] Có đủ Negative / Boundary / Exception / Permission scenarios
+- [ ] Scenario ID format `TS_<SCREEN_NUMBER>_<SEQ>` đúng quy ước
+- [ ] Draft RTM mapping Scenario → Requirement ID đầy đủ
+- [ ] Critical/Major issues trong QA file đã giải quyết
+
+> **Telemetry:** Run `ak gate 2 start --ticket [functionId]` khi bắt đầu gate này.
+> Run `ak gate 2 approved --ticket [functionId]` sau khi gate-review verify passed. Run as-is — không thêm shell redirects.
+
+---
+
+### GATE 3 — Thiết kế Test Case chi tiết
+
+**Mục tiêu:** Cụ thể hóa các kịch bản thành Test Case chi tiết với đầy đủ bước thực hiện, dữ liệu test và kết quả mong đợi cụ thể, đo được — bất kỳ ai cũng có thể thực thi được.
+
+**Điều kiện vào Gate 3:** Gate 2 đã **APPROVED** và `02_Test_Scenarios_Result.md` đã hoàn chỉnh.
+
+**Đầu vào (Inputs):**
+- `docs/ak-{project}/testcase/Result/[functionId]_01_Requirement_Analysis_Result.md`
+- `docs/ak-{project}/testcase/Result/[functionId]_02_Test_Scenarios_Result.md`
+
+**Đầu ra (Outputs):**
+- `docs/ak-{project}/testcase/Result/[functionId]_03_Test_Cases_Draft_Result.md`
+- `docs/ak-{project}/testcase/QA/[functionId]_03_Test_Design_QA.md` (nếu có issue)
+
+**Bước thực hiện:**
+
+#### Bước 1: Đọc template và quy ước bắt buộc
+- **READ template:** `.claude/skills/test-skills/template/template_testcase.md` — **BẮT BUỘC** tuân thủ 100%
+- **READ skill:** `.claude/skills/test-skills/rules/QA_Writing_Standards.md`
+
+#### Bước 2: Áp dụng kỹ thuật thiết kế TC cơ bản (luôn áp dụng)
+- **READ:** `.claude/skills/test-skills/categories/01-test-design/01.01.boundary-value-analysis.md` — BVA cho tất cả trường số/text có giới hạn
+- **READ:** `.claude/skills/test-skills/categories/01-test-design/01.02.equivalence.partitioning.md` — EP phân nhóm giá trị tương đương
+- **READ:** `.claude/skills/test-skills/categories/01-test-design/01.03.decision-table.md` — Decision Table cho logic có nhiều điều kiện
+- **READ:** `.claude/skills/test-skills/categories/01-test-design/01.06.error-guessing.md` — Error Guessing → toàn bộ section 3.5 Exceptions
+
+#### Bước 3: Thiết kế TC UI (luôn áp dụng)
+- **READ:** `.claude/skills/test-skills/categories/02-ui-testing/02.01.UI-layout.md` — đối chiếu layout, spacing, font với Figma
+- **READ:** `.claude/skills/test-skills/categories/02-ui-testing/02.02.form-validation.md` — **MANDATORY** — ma trận validation TẤT CẢ trường input (cả Required và Optional)
+- **READ:** `.claude/skills/test-skills/categories/02-ui-testing/02.03.navigation.md` — TC truy cập URL, nút Back/Forward, Deep Link
+- **READ:** `.claude/skills/test-skills/categories/02-ui-testing/02.04.localization.md` — TC ký tự Kanji, Halfwidth/Fullwidth, đa ngôn ngữ
+
+#### Bước 4: Thiết kế TC Business và Data (luôn áp dụng)
+- **READ:** `.claude/skills/test-skills/categories/03-business-testing/03.01.CRUD-testing.md` — CRUD flows
+- **READ:** `.claude/skills/test-skills/categories/03-business-testing/03.03.permission-testing.md` — phân quyền theo Actor
+- **READ:** `.claude/skills/test-skills/categories/04-data-testing/04.01.database-testing.md` — xác minh dữ liệu lưu đúng vào DB
+- **READ:** `.claude/skills/test-skills/categories/04-data-testing/04.04.duplicate-handling.md` — ràng buộc Unique
+
+#### Bước 5: Áp dụng skills có điều kiện
+- **[Nếu có file upload field]** READ: `.claude/skills/test-skills/categories/05-integration/05.04.file-upload-download.md` — định dạng, dung lượng, MIME spoofing, drag & drop
+- **[Nếu có status/lifecycle field]** READ: `.claude/skills/test-skills/categories/01-test-design/01.04.state.transition.md`
+- **[Nếu nhiều tham số đầu vào cần tổ hợp]** READ: `.claude/skills/test-skills/categories/01-test-design/01.05.pairwise.md`
+- **[Nếu có notification trigger]** READ: `.claude/skills/test-skills/categories/03-business-testing/03.05.notification-testing.md`
+- **[Nếu có calculated/computed fields]** READ: `.claude/skills/test-skills/categories/03-business-testing/03.06.calculation.testing.md`
+
+#### Bước 6: Soạn thảo Draft Test Cases
+- Viết TC theo đúng template chuẩn — **không tự định nghĩa cấu trúc mới**
+- TC ID format: `TC-<FEATURE>-<SEQ>` (vd: `TC-TAG-001`, `TC-LOGIN-005`)
+- Naming convention section 3.3 (Validation): TC Name **bắt buộc** bắt đầu bằng `"Kiểm tra trường [Tên Trường]..."`
+- Cấu trúc output theo 5 sections của template:
+  - **Section 3.1**: Access & Authorization
+  - **Section 3.2**: UI/UX (layout, giao diện)
+  - **Section 3.3**: Input Validation (sub-table riêng cho từng field)
+  - **Section 3.4**: Business Rules (CRUD, logic nghiệp vụ, DB verify)
+  - **Section 3.5**: Exceptions & Systems (Error Guessing cases)
+- Bổ sung: Coverage Matrix (Scenario ID → TC ID), Test Data tổng hợp
+- Ghi TBD marker khi thiếu thông tin: `[TBD — <issue-id>: mô tả ngắn]`
+- Lưu: `docs/ak-{project}/testcase/Result/[functionId]_03_Test_Cases_Draft_Result.md`
+
+#### Bước 7: Soạn thảo QA Artifact (nếu có issue)
+- Lưu: `docs/ak-{project}/testcase/QA/[functionId]_03_Test_Design_QA.md`
+- Cấu trúc: Metadata, Detected Issues, Clarification Questions, Assumptions, Resolution Tracking
+
+#### Bước 8: Gate Review & Pause
+- **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-3-[functionId].md`
+- Hiển thị gate pause message — đợi **APPROVED**
+
+**Khi APPROVED:**
+→ **INVOKE** `gate-review` skill (verify mode) — chạy `ak review check --gate 3 --ticket [functionId]`
+→ Nếu passed: `ak gate 3 approved --ticket [functionId]` → chuyển Gate 4
+→ Nếu blocked: làm theo gate-review skill response protocol
+
+**Definition of Done:**
+- [ ] 100% tuân thủ `template_testcase.md` — không tự định nghĩa cấu trúc mới
+- [ ] Mọi trường input (cả Required và Optional) đã qua ma trận skill 02.02
+- [ ] TC Name section 3.3 bắt đầu bằng `"Kiểm tra trường [Tên Trường]..."`
+- [ ] Coverage Matrix mapping Scenario ID → TC ID đầy đủ
+- [ ] TBD marker ghi đúng format khi thiếu thông tin
+- [ ] Critical/Major issues trong QA file đã giải quyết
+
+> **Telemetry:** Run `ak gate 3 start --ticket [functionId]` khi bắt đầu gate này.
+> Run `ak gate 3 approved --ticket [functionId]` sau khi gate-review verify passed. Run as-is — không thêm shell redirects.
+
+---
+
+### GATE 4 — Review & Tối ưu hóa
+
+**Mục tiêu:** Chốt chặn chất lượng toàn bộ bộ Test Case — bao phủ 100% yêu cầu, không trùng lặp, loại bỏ out-of-scope, và sinh artifact giao nộp hoàn chỉnh.
+
+**Điều kiện vào Gate 4:** Gate 3 đã **APPROVED** và `03_Test_Cases_Draft_Result.md` đã hoàn chỉnh.
+
+**Đầu vào (Inputs):**
+- `docs/ak-{project}/testcase/Result/[functionId]_01_Requirement_Analysis_Result.md`
+- `docs/ak-{project}/testcase/Result/[functionId]_03_Test_Cases_Draft_Result.md`
+
+**Đầu ra (Outputs) — sinh ĐỒNG THỜI:**
+- `docs/ak-{project}/testcase/Result/[functionId]_04_Test_Cases_Final_Result.md`
+- `docs/ak-{project}/testcase/QA/[functionId]_04_Test_Review_QA.md`
+- `docs/ak-{project}/testcase/TestCase/[functionId]_TestCase.md`
+
+> **Quy tắc Gate 4:** Ba artifact trên phải được sinh ĐỒNG THỜI. Không tạo một file mà thiếu file kia.
+
+**Bước thực hiện:**
+
+#### Bước 1: Review nội dung và đánh giá bao phủ
+- **READ skill:** `.claude/skills/test-skills/categories/00-core/00.04.testcase-review.md`
+- **READ skill:** `.claude/skills/test-skills/categories/99-review/99.01.coverage-review.md`
+- Checklist review bắt buộc:
+  - [ ] 100% Requirement (16 mục) có TC tương ứng?
+  - [ ] Không có TC test item Out-of-Scope (mục 2 trong 16 mục)?
+  - [ ] Steps rõ ràng, có thể reproduce (không mơ hồ)?
+  - [ ] Expected Result cụ thể và đo được (tránh "hoạt động đúng")?
+  - [ ] Không có TC trùng lặp logic?
+  - [ ] TBD markers ghi đúng `[TBD — <issue-ref>: mô tả]`?
+  - [ ] Minor issues carry-forward đã ghi nhận vào QA file?
+
+#### Bước 2: Tối ưu hóa bộ Test Case
+- Loại bỏ TC trùng lặp, gộp luồng nếu hợp lý
+- Phát hiện TC test item Out-of-Scope → sửa và ghi vào Findings
+- Kiểm tra traceability xuyên suốt: Req ID → Scenario ID → Draft TC ID → Final TC ID
+
+#### Bước 3: Soạn thảo Final Result (gồm review metadata)
+- Artifact `[functionId]_04_Test_Cases_Final_Result.md` gồm:
+  - Review Summary (số TC tổng, pass/fail trong review)
+  - Review Findings (danh sách issue phát hiện)
+  - Coverage Validation (đối chiếu Req → TC)
+  - Final Test Cases (Approved, đã loại trùng và out-of-scope)
+  - RTM Final (Req ID → Scenario ID → TC ID)
+  - Sign-off Status (xem bảng bên dưới)
+- Lưu: `docs/ak-{project}/testcase/Result/[functionId]_04_Test_Cases_Final_Result.md`
+
+#### Bước 4: Soạn thảo QA Artifact
+- Artifact `[functionId]_04_Test_Review_QA.md` gồm: Metadata, Findings, Issues, Sign-off Status
+- Lưu: `docs/ak-{project}/testcase/QA/[functionId]_04_Test_Review_QA.md`
+
+#### Bước 5: Sinh TestCase Artifact — BẮT BUỘC đồng thời với Bước 3 & 4
+- Artifact `[functionId]_TestCase.md` theo `template_testcase.md` — **chỉ gồm:**
+  - **Mục 1**: Thông tin chung (điền functionId, ngày tạo)
+  - **Mục 2**: Kết quả kiểm thử tổng hợp (reset về 0 chờ execution)
+  - **Mục 3**: Danh sách Test Cases Chi Tiết (toàn bộ 5 sections đã Approved)
+- **KHÔNG chứa:** Review Summary, Findings, RTM, Coverage Matrix, Sign-off (thuộc `04_Final_Result.md`)
+- Lưu: `docs/ak-{project}/testcase/TestCase/[functionId]_TestCase.md`
+
+#### Bước 6: Xác nhận Sign-off Status
+
+| Status | Điều kiện |
+|---|---|
+| ✅ **Fully Approved** | 0 Critical / 0 Major / 0 Minor còn mở, 0 TBD |
+| ✅ **Conditionally Approved** | 0 Critical / 0 Major, còn Minor/TBD — được phép thực thi trừ TC có TBD |
+| ⚠️ **Need Update** | Còn Major issue chưa giải quyết |
+| ❌ **Rejected** | Còn Critical issue, coverage < 100%, hoặc vi phạm template |
+
+#### Bước 7: Gate Review & Pause
+- **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-4-[functionId].md`
+- Hiển thị gate pause message — đợi **APPROVED**
+
+**Khi APPROVED:**
+→ **INVOKE** `gate-review` skill (verify mode) — chạy `ak review check --gate 4 --ticket [functionId]`
+→ Nếu passed: `ak gate 4 approved --ticket [functionId]` → Bộ Test Case hoàn thành, sẵn sàng thực thi
+→ Nếu blocked: làm theo gate-review skill response protocol
+
+**Definition of Done:**
+- [ ] `[functionId]_04_Test_Cases_Final_Result.md` có đủ Review Summary, Findings, Coverage Validation, RTM Final, Sign-off
+- [ ] `[functionId]_TestCase.md` chỉ chứa Section 1+2+3 theo template chuẩn, không có review metadata
+- [ ] Ba file sinh ĐỒNG THỜI — không tạo một thiếu file kia
+- [ ] Traceability xuyên suốt: Req ID → Scenario ID → Draft TC ID → Final TC ID
+- [ ] Sign-off status đã xác định (Fully / Conditionally / Need Update / Rejected)
+
+> **Telemetry:** Run `ak gate 4 start --ticket [functionId]` khi bắt đầu gate này.
+> Run `ak gate 4 approved --ticket [functionId]` sau khi gate-review verify passed. Run as-is — không thêm shell redirects.
+
+---
+
+### Bản đồ Skills theo Gate
+
+| Gate | Skills đọc | Output |
+|---|---|---|
+| Gate 1 | `QA_Writing_Standards`, `00.01 Requirement Analysis`, `00.02 Risk Analysis` | `01_Requirement_Analysis_Result.md`, `01_QA.md` |
+| Gate 2 | `00.03 Scenario Builder`, `01.06 Error Guessing`, `03.02 Workflow Testing`, Domain skills | `02_Test_Scenarios_Result.md`, `02_QA.md` |
+| Gate 3 | `template_testcase`, `01.01 BVA`, `01.02 EP`, `01.03 Decision Table`, `01.06 Error Guessing`, `02.01`–`02.04`, `03.01`, `03.03`, `04.01`, `04.04` | `03_Test_Cases_Draft_Result.md`, `03_QA.md` |
+| Gate 4 | `00.04 TC Review`, `99.01 Coverage Review` | `04_Final_Result.md`, `04_QA.md`, `[functionId]_TestCase.md` |
+
+---
+
+### Quy tắc bắt buộc
+
+- ❌ **KHÔNG** bỏ qua thứ tự Gate — luôn đi từ Gate 1 → 2 → 3 → 4
+- ❌ **KHÔNG** tự suy diễn nghiệp vụ — ghi rõ Assumption và TBD khi thiếu thông tin
+- ❌ **KHÔNG** sinh `04_Final_Result.md` mà thiếu `[functionId]_TestCase.md` (hoặc ngược lại)
+- ❌ **KHÔNG** tiến gate tiếp theo khi còn issue Critical hoặc Major chưa giải quyết
+- ✅ **BẮT BUỘC** chạy Bước 0 ở Gate 1 — xác nhận `functionId` và thư mục đầu ra trước khi làm bất cứ điều gì
+- ✅ **BẮT BUỘC** đọc skill từ `.claude/skills/test-skills/` — không suy luận từ bộ nhớ
+- ✅ **BẮT BUỘC** invoke `gate-review` cuối mỗi gate và chờ APPROVED
+- ✅ **BẮT BUỘC** tuân thủ 100% `template_testcase.md` ở Gate 3 và Gate 4
+- ✅ **BẮT BUỘC** ba artifact Gate 4 sinh ĐỒNG THỜI
+- ✅ **BẮT BUỘC** Issue Critical/Major phải giải quyết xong trước khi sinh Result artifact