qa-regression

name	qa-regression
description	Tạo regression test checklist trước release, phân tích blast radius, xác định go/no-go. Trigger khi: user nói "regression test", "test trước release", "verify không có regression", "sprint sign-off", "QA trước deploy production", hoặc gõ /qa-regression.

Skill: /qa-regression

Role: QA Engineer
Mục đích: Tạo regression test checklist trước release. Verify tính năng cũ không bị ảnh hưởng bởi changes mới.

---

Khi nào dùng

• Trước mỗi release / sprint end
• Sau merge PR có changes ảnh hưởng shared code (auth, middleware, DB migration)
• Khi PM yêu cầu sign-off trước khi deploy production

---

Hướng dẫn thực hiện

Bước 1 — Thu thập scope changes

Spawn subagent (dùng Agent tool) để đọc:

• git log [base]..HEAD --name-only — files đã thay đổi
• docs/tasks/[TASK-IDs]/requirements.md — tất cả tasks trong release

Subagent trả về: file list + blast radius analysis.

Bước 2 — Gate: Xác nhận regression scope

## Regression scope cho release [version/sprint]:

**Tasks trong release**: [list TASK-IDs]
**Files thay đổi**: [N files]

**Blast radius analysis**:

| Area | Risk | Lý do |
|------|------|-------|
| [Auth flow] | High | auth.service.js modified |
| [Payment] | Low | Không có changes liên quan |
| [Dashboard] | Medium | Shared component updated |

**Đề xuất test priority**:
- 🔴 Must Test: [list areas]
- 🟡 Should Test: [list areas]
- 🟢 Smoke only: [list areas — nếu thiếu thời gian, skip được]

| | Lựa chọn |
|---|---------|
| A | Confirm — tạo checklist theo scope này |
| B | Điều chỉnh scope — sửa: ___ |
| C | Khác: ___ |

Chờ confirm.

Bước 3 — Tạo Regression Checklist (HTML là format chính)

Regression checklist là one-shot decision artifact (chạy → tick → go/no-go) — format chính là HTML, không cần Markdown commit. Sinh docs/tasks/regression-[sprint-or-version].html từ template templates/html-artifact.html:

• 3 sections collapse <details> cho 🔴 Must Test / 🟡 Should Test / 🟢 Smoke
• Mỗi section là <table data-sortable> với cột: ID | Test Case | Steps | Expected | Result | Bug?
• Cột Result có <select> (Pass/Fail/Blocked) cập nhật vào data-state, đổi background row theo state
• Header có Go/No-Go badge tự động: chuyển đỏ nếu bất kỳ Must Test = Fail
• Toolbar có button "Export results" — copy bảng về Markdown để paste vào sprint report

File HTML KHÔNG commit (nằm trong docs/tasks/**/*.html đã ignore). Nếu khách JP yêu cầu evidence, export ra PDF từ browser (Cmd+P → Save as PDF) rồi attach.

Cấu trúc nội dung (skill inject vào HTML):

# Regression Test: [Sprint/Version]

**QA**: [Name]  
**Date**: [Date]  
**Release scope**: [TASK-IDs]  
**Environment**: Staging  
**Status**: In Progress / Pass / Fail

---

## 🔴 Must Test (High Risk)

### [Area 1 — ví dụ: Auth Flow]

| ID | Test Case | Steps | Expected | Result | Bug? |
|----|-----------|-------|----------|--------|------|
| RT-001 | Login với email/password hợp lệ | 1. POST /auth/login với credentials đúng | 200 + JWT token | | |
| RT-002 | Login sai password | 1. POST /auth/login với password sai | 401 + error message | | |
| RT-003 | [Feature mới vừa merge] | [...] | [...] | | |

### [Area 2 — nếu có]

| ID | Test Case | Steps | Expected | Result | Bug? |
|----|-----------|-------|----------|--------|------|
| RT-XXX | | | | | |

---

## 🟡 Should Test (Medium Risk)

| ID | Test Case | Steps | Expected | Result | Bug? |
|----|-----------|-------|----------|--------|------|
| RT-XXX | | | | | |

---

## 🟢 Smoke Test (Low Risk)

| ID | Test Case | Result |
|----|-----------|--------|
| RT-XXX | Core flow X vẫn hoạt động | |

---

## Bugs Found

| Bug ID | Severity | Test Case | Mô tả | Status |
|--------|----------|-----------|-------|--------|
| | | | | |

---

## Sign-off

- [ ] Tất cả 🔴 Must Test pass
- [ ] Không có bug Critical/High chưa fix
- [ ] PM confirm acceptable risk cho bugs Medium/Low còn mở
- [ ] QA Lead sign-off: __________________  Date: __________

Bước 4 — Gate: Sign-off confirmation

Regression checklist đã tạo với [N] test cases.

Điều kiện go/no-go:
- ✅ Go: Tất cả Must Test pass, không có Critical/High bug
- ⛔ No-go: Bất kỳ Must Test fail, hoặc có Critical bug

Sau khi chạy xong → update kết quả vào bảng và gửi kết quả cho PM.
Nếu có bug → tạo issue trên GitHub ngay, đánh priority.

---

Quy tắc

• Regression scope phải cover tất cả High Risk areas — không skip
• Nếu phát hiện bug mới → tạo issue ngay, đánh priority, không giả sử "sẽ fix sau"
• Không deploy production khi còn Critical hoặc High bug chưa xử lý
• Kết quả regression phải được lưu vào docs/tasks/ để audit trail