---
name: qa-testplan
description: >
  Tạo test plan toàn diện từ spec/user stories: strategy, test cases happy/edge/negative, exit criteria.
  Trigger khi: user nói "tạo test plan", "viết test cases", "soạn kế hoạch test",
  "create test plan", "QA plan cho feature", "test strategy", hoặc gõ /qa-testplan.
---

# Skill: /qa-testplan
**Role**: QA Engineer  
**Mục đích**: Tạo test plan toàn diện từ spec/user stories, bao gồm test cases và strategy.

---

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

### Bước 1 — Đọc input

Đọc `docs/tasks/[TASK-ID]/requirements.md` và màn hình/API docs liên quan.

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

```
## Tôi sẽ tạo test plan cho: [Feature name]

Tôi đọc spec và xác định:
- [N] Acceptance Criteria cần verify
- [M] Business Rules cần test
- Màn hình liên quan: [list]
- API liên quan: [list]

Trước khi soạn test plan, tôi cần hỏi:

| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | Test level cần cover? | A: Unit / B: Integration / C: E2E / D: Performance / E: Security / F: Tất cả / G: Khác: ___ |
| 2 | Môi trường test? | A: Dev / B: Staging / C: Prod-like / D: Khác: ___ |
| 3 | Có dữ liệu test đặc biệt cần chuẩn bị không? | A: Không / B: Có — loại data: ___ / C: Khác: ___ |
| 4 | Regression scope — những gì cần retest? | _(liệt kê features/flows cần retest)_ |
```

### Bước 3 — Tạo Test Plan

Tạo `docs/tasks/[TASK-ID]/test-plan.md` sử dụng template `templates/test-plan.md`.

### Bước 3.5 — Render HTML companion (interactive checklist)

Sinh `docs/tasks/[TASK-ID]/test-plan.html` từ template `templates/html-artifact.html`:

- Inject `<ul class="checklist" data-storage-key="testplan-[TASK-ID]">` cho từng TC
- Mỗi `<li>` có `<input type="checkbox" data-id="TC-XXX">` + label = TC name
- Group theo type: Happy / Edge / Negative dùng `<details><summary>` mở rộng
- Header có `<input type="search" data-filter="...">` để filter TC theo từ khoá
- Pill `pill-ok|warn|err` cho priority High/Med/Low

QA tick checkbox khi chạy test, state lưu localStorage — không cần copy vào Markdown.
File HTML KHÔNG commit (đã có `.gitignore`). `test-plan.md` vẫn là source of truth commit vào repo.

```
✓ Đã sinh `docs/tasks/[TASK-ID]/test-plan.html`
  Mở bằng browser khi chạy test để tick checklist (state lưu localStorage).
```

### Bước 4 — Gate cuối

```
Test plan đã soạn xong với [N] test cases.

| # | Câu hỏi | Lựa chọn |
|---|---------|---------|
| 1 | Test case nào có vẻ thiếu? | A: Không thiếu / B: Thiếu — mô tả: ___ / C: Khác: ___ |
| 2 | Có edge case domain đặc thù tôi chưa cover? | A: Không / B: Có — edge case: ___ / C: Khác: ___ |
| 3 | Exit criteria có đủ chặt không? | A: Đủ rồi / B: Cần thêm điều kiện: ___ / C: Khác: ___ |
| 4 | Muốn tôi generate code test tự động từ test plan không? | A: Có / B: Không — sẽ viết tay / C: Khác: ___ |
```

### Bước 5 — (Optional) Spawn subagent: test-gen

Nếu user chọn "Có" ở câu 4, spawn test-gen để generate test code từ test plan đã approve:

```
Agent(
  description: "Generate test code from approved test plan",
  prompt: "Write test code per agents/test-gen.md spec.\n\nNEW CODE:\n[Files đã implement — chỉ pass files mới/changed]\n\nAC LIST:\n[AC list từ test plan]\n\nTEST FRAMEWORK:\n[Jest/JUnit/pytest/...]\n\nEXISTING TEST EXAMPLES:\n[1-2 file test hiện có]",
  model: "sonnet"
)
```