<!-- FILE SINH TỰ ĐỘNG từ custom/templates/shared/create-spec-workflow.md (các mục quy tắc câu hỏi).
     Không sửa trực tiếp: sửa workflow rồi chạy `node scripts/gen-agentic-rules.js`. -->

# Quy tắc câu hỏi của BA (create-spec)

> Nguồn: `custom/templates/shared/create-spec-workflow.md`. Dùng cho Light-out Agents (agent team, `ak capabilities`).
> Ở chế độ agent team: chỉ dẫn "hỏi BA trong chat", "chờ APPROVED", "chạy `ak …`" do orchestrator đảm nhận —
> agent ghi câu hỏi vào output có cấu trúc, không hỏi trong chat.


### Quy ước Blocking / Non-blocking & đánh dấu PENDING

> Áp dụng cho **cả 4 Gate** — dùng để quyết định câu hỏi nào bắt buộc phải Confirmed trước khi tiến gate tiếp theo, và câu nào được phép defer mà vẫn cho qua.

Mỗi Gap/Assumption/câu hỏi Q&A phải được gắn nhãn mức độ ảnh hưởng ngay khi phát hiện:

- **🔴 Blocking** — chưa trả lời thì KHÔNG thể tiến gate tiếp theo một cách đáng tin cậy. Gồm: ảnh hưởng cấu trúc dữ liệu (thêm/sửa field, quan hệ), luồng chính (happy path) của use case, phân quyền/bảo mật, hoặc quyết định kiến trúc khó đảo ngược sau khi đã code.
- **🟡 Non-blocking** — có thể tạm ghi Open (deferred) và vẫn đi tiếp. Gồm: chi tiết UI/text hiển thị, giá trị mặc định có thể chỉnh sau, alternative/exception flow hiếm gặp, câu hỏi cần chờ khách hàng xác nhận nhưng không chặn thiết kế các phần khác.

**Khi BA/khách hàng defer (chưa trả lời ngay) một câu hỏi:**

- 🟡 Non-blocking → đánh dấu **Open**, tiếp tục ngay sang câu hỏi kế tiếp hoặc gate kế tiếp — KHÔNG chặn.
- 🔴 Blocking → AI phải hiển thị cảnh báo rõ lý do đây là blocking + hệ quả nếu bỏ qua, rồi hỏi xác nhận BA có chắc muốn tiếp tục không. Nếu BA xác nhận đồng ý tiếp tục dù chưa trả lời → vẫn đánh dấu Open nhưng giữ nhãn 🔴 Blocking (không được hạ xuống Non-blocking) — mục "Điều kiện dừng chặn APPROVED" ở mỗi Gate dựa vào nhãn này.

**Đánh dấu PENDING trong tài liệu output:** bất kỳ nội dung nào phụ thuộc vào một câu hỏi còn Open (Blocking hoặc Non-blocking) phải ghi rõ marker tại đúng vị trí liên quan trong `Analysis_v(n).md` / `UI-Prototype` / `UC-Spec_v{N}.md`, thay vì tự suy diễn nội dung để lấp đầy:

```
⚠️ [PENDING - QA-0N] <mô tả ngắn nội dung còn thiếu>
```

### Quy tắc phụ thuộc câu hỏi & chống hỏi thừa

> Áp dụng cho **cả 4 Gate**. Mục tiêu: BA/khách hàng chỉ nhận đúng những câu hỏi mà câu trả lời **hiện tại** là khả thi và có giá trị — không bị hỏi tiếp các câu đã bị chặn bởi một câu còn Open.

**1. Dựng bản đồ phụ thuộc TRƯỚC khi hỏi.** Sau khi liệt kê xong danh sách Gap và trước khi hỏi câu đầu tiên, với mỗi câu hỏi phải điền trường `Phụ thuộc`:

- `Phụ thuộc: —` — câu hỏi độc lập, hỏi được ngay.
- `Phụ thuộc: QA-xx` — câu trả lời chỉ có nghĩa (hoặc chỉ xác định được tập lựa chọn) sau khi QA-xx đã Confirmed. Dấu hiệu nhận biết: câu hỏi chi tiết hoá một quyết định phạm vi/rule của QA-xx; các Option của nó thay đổi tuỳ theo QA-xx chọn gì; hoặc câu hỏi trở nên vô nghĩa với ít nhất một đáp án khả dĩ của QA-xx.

**2. Cascade defer — KHÔNG hỏi câu con khi câu cha còn Open.** Câu cha ở trạng thái Open (Blocking hay Non-blocking đều vậy) → mọi câu phụ thuộc nó:

- **KHÔNG** được hỏi trong vòng này — kể cả khi bản thân câu con được gắn 🔴 Blocking.
- Ghi trạng thái **`Blocked-by QA-xx`** trong `QnA-Log`, không phải `Open` độc lập và không phải câu hỏi mới.
- Dùng lại marker của câu cha `⚠️ [PENDING - QA-xx]` trong tài liệu output — không sinh thêm marker riêng cho câu con.
- Chỉ mở khoá (chuyển sang hỏi được) khi câu cha chuyển sang **Confirmed** — xem Gate 2 Bước 1.

**3. Thứ tự hỏi.** Hỏi theo topo của bản đồ phụ thuộc: câu cha trước câu con. Trong cùng một mức, hỏi 🔴 Blocking trước 🟡 Non-blocking.

**4. Kiểm tra trước mỗi câu hỏi (3 điều kiện, đủ cả 3 mới được hỏi).** Trước khi phát ra bất kỳ câu hỏi nào — Gate 1 Bước 2 hoặc vòng Q&A mới ở Gate 2:

- (a) **Chưa được trả lời ở đâu khác và không suy ra được** — không có câu trả lời Confirmed nào trong `QnA-Log` các version trước, trong `Analysis_v(n).md`, hoặc trong chính câu trả lời BA vừa đưa ở câu trước đã bao phủ nội dung này; và không suy ra được từ bảng "Quyết định đã chốt + hệ quả suy ra" (xem [Quy tắc chống hỏi trùng](#quy-tắc-chống-hỏi-trùng--suy-ra-từ-quyết-định-đã-chốt)).
- (b) **Không bị chặn** — trường `Phụ thuộc` trống, hoặc mọi câu cha đã Confirmed.
- (c) **Câu trả lời làm thay đổi output** — biết đáp án thì nội dung Analysis / UI Prototype / UC Spec / test case thay đổi. Nếu đáp án chỉ đổi câu chữ hiển thị hoặc một giá trị mặc định có thể chỉnh sau khi code mà không đổi cấu trúc → **không hỏi**, ghi thành Assumption kèm marker `[PENDING]` và để BA phản hồi sau.

Câu nào trượt một trong ba điều kiện → bỏ qua, ghi lý do vào `QnA-Log` (`Đã trả lời tại QA-xx` / `Suy ra từ QA-xx` / `Blocked-by QA-xx` / `Assumption — không hỏi`), chuyển sang câu tiếp theo.

Câu nào qua đủ ba điều kiện → soạn theo [Quy tắc chất lượng câu hỏi](#quy-tắc-chất-lượng-câu-hỏi--dễ-hiểu-cho-người-không-chuyên-kỹ-thuật) (bối cảnh, vì sao hỏi, một ý, options kèm hệ quả, giải nghĩa viết tắt, ví dụ minh hoạ nếu phức tạp) trước khi gửi.

**5. Điểm dừng kiểm tra tải câu hỏi.** Sau mỗi **10 câu hỏi** đã phát ra trong một vòng, dừng lại và hiển thị:

```
Đã hỏi [N] câu, còn [M] câu trong danh sách ([X] 🔴 Blocking, [Y] 🟡 Non-blocking).
→ Tiếp tục: gõ NEXT
→ Defer toàn bộ câu 🟡 Non-blocking còn lại (đánh Open + marker PENDING, đi tiếp): gõ DEFER-NB
```

Tôn trọng lựa chọn của BA — `DEFER-NB` không áp dụng cho câu 🔴 Blocking (những câu này vẫn phải hỏi, hoặc Open kèm cảnh báo theo quy ước trên).

**6. Không lách luật.** Không được tách một câu bị chặn thành nhiều câu nhỏ để "hỏi lách" quanh câu cha còn Open. Không hạ nhãn 🔴 Blocking của câu con để né quy tắc cascade.

**7. Tự tìm hiểu trước khi hỏi — chỉ hỏi thứ không quan sát được.** Trước khi đưa một Gap thành câu hỏi, phải quét repo/config/tài liệu `AK-Docs/`/ticket để xem câu trả lời có sẵn không. Thứ **quan sát được** (quy ước dự án, môi trường, ngôn ngữ giao diện, thư viện/kiểu triển khai hiện tại, dữ liệu mẫu đang có) → **tự điền kèm nguồn, không hỏi**; không tìm thấy thì dùng mặc định hợp lý và ghi `[mặc định]` vào Assumption. Chỉ hỏi khi đó là **chính sách/đánh đổi** của dự án hoặc **mâu thuẫn/thiếu trong nghiệp vụ**. Muốn chắc về giá trị đã suy ra → viết khẳng định `Tôi dùng <giá trị> (nguồn: <bằng chứng>) — sai thì báo tôi sửa.` rồi đi tiếp, không dừng chờ. Nhiều mục thiết lập cùng loại → gộp vào **một** bảng xác nhận trả lời một lần, không rải thành chuỗi câu hỏi.

### Quy tắc chất lượng câu hỏi — dễ hiểu cho người không chuyên kỹ thuật

> Áp dụng cho **mọi câu hỏi** phát ra ở cả 4 Gate. Người đọc mặc định là khách hàng/PO **không** đọc code, không biết tên bảng/field/API của hệ thống.

**1. Mỗi câu hỏi là một khối tự đứng một mình được.** Người đọc chỉ nhìn đúng khối đó (không đọc lại tài liệu, không nhớ 20 câu trước) vẫn hiểu và trả lời được.

**Cấm trình bày danh sách câu hỏi dưới dạng bảng.** Bảng nhiều cột buộc người đọc quét ngang mới ghép được nghĩa một câu hỏi, và cột nào cũng hẹp nên chữ xuống dòng vụn.

Khối gồm tiêu đề, hai dòng thông tin, rồi các mục có tên in đậm (không đánh số):

```text
## Q{n}. [Màn hình/Chức năng] Về {chủ đề}
QA-0N ・ 🔴 Blocking ・ Đang chờ trả lời (Open)
Cần PM / Khách hàng trả lời. Chưa đặt hạn, không phụ thuộc câu hỏi nào khác.

**Hiện trạng:**
    <hệ thống hiện đang làm gì; tính năng mới thì ghi "Chưa có (tính năng mới)">

**Bối cảnh:**
    <yêu cầu nào dẫn tới câu hỏi. Chưa chốt thì ảnh hưởng gì.>

**Vấn đề:**                      ← bỏ hẳn mục nếu không có
    <điểm chưa rõ, mâu thuẫn, hoặc rủi ro>

**Câu hỏi:**
    <một câu, một chủ đề, ưu tiên câu hỏi đóng>

**Lựa chọn và đề xuất:**
    A: <option>
    B: <option>
    C: Khác (khách tự mô tả) / Chưa quyết định, cần thời gian.
    Đề xuất của Relipa: A. Lý do: <lý do>

**Ví dụ minh họa:**              ← bỏ hẳn mục nếu không có
    <tình huống bám dữ liệu/màn hình thật>
    Nếu chọn A: <kết quả>. Nếu chọn B: <kết quả>.

**Câu trả lời:**
    <nội dung trả lời; câu còn Open ghi "Chưa trả lời.", kèm lý do nếu có>

**Người trả lời:** —
**Ngày trả lời:** —
**Nguồn:** —
```

Quy tắc trình bày khi ghi file — mục tiêu là đọc như người viết tay, không như bản AI xuất ra:
- **Tên mục in đậm, kết thúc bằng dấu `:`, không đánh số.** Mỗi mục cách mục sau **đúng 1 dòng trống**. Không có dòng trống giữa tên mục và nội dung.
- **Nội dung mục thụt vào 4 dấu cách**, mọi dòng nội dung đều thụt. Không dùng bullet `・` hay `-`. Mỗi ý xuống dòng riêng.
- **Hai dòng thông tin ngay dưới tiêu đề, viết như người nói:**
  - Dòng 1: `<Mã> ・ <Mức độ> ・ <Trạng thái>`. Trạng thái ghi tiếng Việt, giữ từ khoá gốc trong ngoặc để tra cứu: `Đang chờ trả lời (Open)`, `Đã chốt (Confirmed)`, `Chờ QA-xx chốt trước (Blocked-by QA-xx)`.
  - Dòng 2: một câu nói ai cần trả lời, hạn, và phụ thuộc. Có hạn → `Cần PM / Khách hàng trả lời trước 15/10.`; chưa có hạn → `Chưa đặt hạn`. Không phụ thuộc → `không phụ thuộc câu hỏi nào khác`; có câu cha → `Chỉ trả lời được sau khi QA-xx được chốt.` Không viết dấu `—` cho trường trống.
- **Lựa chọn:** A, B… rồi chữ cái kế tiếp luôn là `Khác (khách tự mô tả) / Chưa quyết định, cần thời gian.` Dòng `Đề xuất của Relipa: <chữ cái>. Lý do: <lý do>` đặt **sau** dòng Khác, lý do viết thành câu, không để trong ngoặc. **Không ghi công số** (cao/thấp/số ngày) trong file. Hệ quả nghiệp vụ của option vẫn ghi (ví dụ `phát sinh chi phí tin nhắn`, `(chưa có, cần làm mới)`).
- **Ví dụ minh họa:** dòng tình huống, rồi kết quả theo từng option viết `Nếu chọn A: … Nếu chọn B: …`.
- **Câu trả lời:** chỉ chứa nội dung trả lời. `Người trả lời`, `Ngày trả lời`, `Nguồn` là ba dòng riêng **ngang cấp** với `Câu trả lời:` (tên in đậm, giá trị cùng dòng, không thụt, ba dòng liền nhau). Câu còn Open thì ba dòng này ghi `—`.
- **Ngắt dòng khi render markdown:** mọi dòng trong cùng một khối (hai dòng thông tin; tên mục và các dòng nội dung; ba dòng Người trả lời / Ngày / Nguồn), **trừ dòng cuối của khối**, kết thúc bằng **2 dấu cách** (hard line break). Thiếu 2 dấu cách thì khi xem dạng render (GitLab, Backlog, VS Code preview) các dòng bị gộp thành một đoạn. Không chèn dòng trống giữa tên mục và nội dung thụt lề: dòng thụt 4 dấu cách đứng sau dòng trống bị render thành code block.

- **Tiêu đề là cụm danh từ, không phải câu hỏi.** Viết `Về phạm vi sản phẩm hiển thị cho buyer chưa thuộc group nào`, không viết `Buyer chưa thuộc group thì thấy gì?`. Câu hỏi nằm ở mục `Câu hỏi`; tiêu đề để người đọc lướt qua là biết câu này nói về việc gì.
- **Hiện trạng và Bối cảnh tách riêng.** Hiện trạng là sự thật hệ thống đang có; Bối cảnh là lý do bây giờ phải hỏi. Viết lẫn thì khách nhầm giữa cái đang có với cái sắp làm.
- **Mốc sự kiện trong Bối cảnh phải cụ thể.** Cấm nói tắt kiểu "khi bật `group`", "sau khi có tính năng X" — không tương ứng với thao tác hay mốc nào có thật, người đọc không phân biệt được lúc phát hành mã nguồn, lúc dữ liệu được gán xong, hay lúc có công tắc cấu hình. Viết thẳng: "sau khi phát hành chức năng quản lý `group`", "khi `admin` tạo `group` đầu tiên".
- **Câu hỏi** đúng **một ý**. Có 2 ý → tách thành 2 câu hỏi.
- **Options** nói rõ mỗi option dẫn tới kết quả gì cho người dùng, không chỉ đặt tên option. Thêm dòng `Đề xuất của Relipa` kèm lý do — nội dung Relipa tự đề xuất phải ghi rõ là đề xuất, không viết như yêu cầu đã có. Luôn có dòng `Khác (khách tự mô tả) / Chưa quyết định, cần thời gian`.
- **Mục `Vấn đề` và `Ví dụ minh họa` bỏ hẳn khi không có nội dung** — không để tên mục rỗng hay dấu `—`.

**1b. Hai dạng trình bày: dạng gọn khi hỏi trong chat, dạng đầy đủ khi ghi file.** Khối đầy đủ ở trên là dạng ghi vào `QnA-Log_v(m).md` — người đọc là khách hàng, đọc lại sau nhiều ngày, nên mỗi khối phải tự đứng được. Khi hỏi BA **trực tiếp trong hội thoại** (Gate 1 Bước 2), BA đang có sẵn ngữ cảnh ticket và trả lời ngay, nên dùng dạng **gọn** dưới đây. Phản hồi thật khi thấy khối đầy đủ trong chat: một câu hỏi chiếm khoảng 25 dòng, cần trình bày ngắn gọn hơn mà vẫn đủ ý.

```text
**Q{n}/{tổng} · 🔴 Blocking · QA-0N** — [Màn hình/Chức năng] {chủ đề}
Phụ thuộc: QA-xx đã chốt "<quyết định>"          ← chỉ in khi có câu cha

**Hiện tại:** <sự thật hệ thống đang có; tính năng mới thì ghi "Chưa có (tính năng mới)">
**Thay đổi:** <yêu cầu dẫn tới câu hỏi, nêu mốc sự kiện cụ thể>

❓ <một câu hỏi, một ý>

- **A.** <option>. <ảnh hưởng phạm vi/công số>. ⭐ Relipa đề xuất: <lý do một vế>
- **B.** <option>. <ảnh hưởng phạm vi/công số>.
- **Khác / chưa quyết** → ghi Open vào QnA-Log.

VD: <tình huống thật> → A: <kết quả người dùng thấy> · B: <kết quả>   ← chỉ câu phức tạp

↳ Trả lời: `A` / `B` / `Khác: …` / `Open` · gõ `chi tiết` để xem bản đầy đủ
```

Quy tắc rút gọn — **gọn về cách trình bày, không bớt nội dung cần để ra quyết định**:
- **Dòng đầu** gộp tiêu đề và dòng thông tin: chỉ giữ số thứ tự / tổng số câu hiện tại (được phép tăng khi phát sinh Gap mới), `Mức độ`, `Mã`, chủ đề. `Hạn trả lời`, `Người cần trả lời`, `Trạng thái` mang giá trị mặc định nên không in trong chat — vẫn ghi đủ vào file. `Phụ thuộc` chỉ in khi có câu cha, kèm quyết định đã chốt của câu cha.
- **`Hiện tại:` / `Thay đổi:`** thay cho mục `Hiện trạng` và `Bối cảnh`, mỗi dòng **tối đa 2 câu**. Vẫn giữ tách biệt cái đang có với cái sắp làm, vẫn áp dụng quy tắc mốc sự kiện cụ thể. Ý "chưa chốt thì ảnh hưởng gì" chỉ viết vào `Thay đổi:` khi các option chưa thể hiện được ảnh hưởng đó.
- **Mục `Vấn đề`** không thành dòng riêng — gộp vào `Thay đổi:` hoặc vào câu hỏi.
- **Options** mỗi option **một dòng**, kèm ảnh hưởng phạm vi/công số. Đề xuất của Relipa đánh dấu `⭐` ngay trên dòng option được đề xuất, lý do một vế — không tách dòng riêng. Option chưa có trong hệ thống vẫn ghi `(chưa có, cần làm mới)`. Dòng cuối luôn là `Khác / chưa quyết`.
- **Ví dụ** một dòng, chỉ cho câu phức tạp (xem mục 3), nêu kết quả theo từng option.
- **Bỏ** các câu dẫn kiểu "hệ quả này sẽ hỏi riêng ở câu sau" — thứ tự câu hỏi đã do bản đồ phụ thuộc quyết định.
- Độ dài mục tiêu: **khoảng 12 dòng** một câu. Vượt nhiều → câu hỏi đang gộp nhiều ý, tách theo mục 4.
- Mọi quy tắc khác giữ nguyên ở dạng gọn: thuật ngữ theo Glossary, giải nghĩa viết tắt, nguồn thật cho option/ví dụ (mục 3bis), self-check (mục 5).
- BA gõ **`chi tiết`** → in lại khối đầy đủ của câu đang hỏi, đúng format ghi file ở mục 1 (ví dụ để chụp gửi khách), rồi chờ trả lời như bình thường.
- Khi ghi `QnA-Log` (Gate 1 Bước 4), mỗi câu đã hỏi ở dạng gọn được **mở rộng về khối đầy đủ** theo quy tắc trình bày ở mục 1: cùng câu hỏi, cùng options, cùng đề xuất — chỉ triển khai câu chữ, không thêm option hay sự thật mới so với lúc hỏi BA. Ghi chú công số của dạng gọn **không** chép sang file.

> ❌ **KHÔNG** viết mục "Vì sao cần hỏi" thành một mục riêng — không trong câu hỏi gửi ra, không trong câu hỏi hỏi trực tiếp trong hội thoại, không trong `QnA-Log`. Phần đó **gộp vào mục `Bối cảnh`** dưới dạng một ý "chưa chốt thì ảnh hưởng gì". Khách hàng cần biết mình phải quyết điều gì và mỗi lựa chọn dẫn tới đâu — một mục riêng kể lại lý do BA cần thông tin chỉ làm câu hỏi dài gấp đôi. Phản hồi thật từ PM khi đọc câu hỏi có mục này trong chat: "nội dung khá rườm rà". (Self-check "đáp án đổi mục nào trong output" ở §5 vẫn chạy — chỉ là **không viết vào tài liệu**.)

**2. Ngôn ngữ.**
- Viết cho người không technical: không dùng tên bảng, tên cột, tên API, tên biến, tên file trong phần Bối cảnh/Câu hỏi/Options. Cần thiết lắm thì để trong ngoặc phụ chú ở cuối, sau phần diễn đạt nghiệp vụ.
- **Thuật ngữ nghiệp vụ dùng nguyên từ dự án đang dùng, cấm tự dịch.** Dự án eccore gọi là `group` thì viết `group`, không viết "nhóm"; `buyer` không viết "cửa hàng"; `import` không viết "nhập". Nguồn từ vựng bắt buộc là `AK-Docs/00.Project-Overview/Glossary.md` (xem [Bước 0.6](#bước-06-glossary-dự-án--đọc-trước-khi-soạn-câu-hỏi-đầu-tiên) và `custom/rules/domain-terminology.md`). Không tìm được từ dự án dùng cho một khái niệm → **hỏi user**, không tự đặt từ, rồi ghi câu trả lời ngược vào `Glossary.md` ngay.
- **Thuật ngữ tiếng Nhật không đứng một mình trong câu tiếng Việt/tiếng Anh.** Viết tên gọi theo cột `Viết trong tài liệu` của Glossary, kèm chữ gốc trong ngoặc ở lần đầu trong mỗi khối câu hỏi: "nhà cung cấp (サプライヤー)", "danh sách `buyer` (得意先一覧)". Glossary chưa có tên gọi → đề xuất một tên để BA xác nhận rồi ghi vào Glossary, không tự dịch rồi dùng luôn. Chi tiết: `custom/rules/domain-terminology.md`, mục "Thuật ngữ tiếng Nhật".
- **Mọi từ viết tắt và thuật ngữ nội bộ phải được giải nghĩa ngay lần xuất hiện đầu tiên trong câu hỏi**, dạng `<viết tắt> (<nghĩa đầy đủ, 3–10 từ>)`. Không giả định người đọc biết từ viết tắt chỉ vì nó có trong ticket.
- Không dùng ký hiệu nội bộ của AI/quy trình trong nội dung câu hỏi (ID nội bộ, tên pattern đánh số) mà chưa nói pattern đó là gì.

**3. Câu hỏi phức tạp phải có ví dụ minh hoạ.** Câu hỏi được coi là phức tạp khi: có từ 2 điều kiện trở lên, ảnh hưởng nhiều màn hình/nhiều luồng, hoặc nói về thứ tự/ưu tiên/thời điểm. Khi đó bắt buộc thêm khối:

```
Ví dụ minh hoạ: <một tình huống cụ thể, dùng màn hình/trường có thật, số liệu/ngày giờ cụ thể>
→ Nếu chọn A: <kết quả người dùng nhìn thấy>
→ Nếu chọn B: <kết quả người dùng nhìn thấy>
```

**3bis. Ví dụ và Options phải bám sát hệ thống thực tế — cấm giả định ngoài mô tả.** Một option hay ví dụ mô tả chức năng hệ thống không có làm khách hàng tưởng thứ đó đã sẵn sàng rồi chốt theo nó; sai lầm này chỉ lộ ra ở Gate 4 hoặc khi Dev code. Với **từng** option và **từng** ví dụ, phải chỉ ra được nguồn thì mới giữ lại:

| Nguồn hợp lệ | Ví dụ |
| :--- | :--- |
| Mô tả yêu cầu / ticket / acceptance criteria | "ticket nói nút import nhận file CSV" |
| Tài liệu trong `AK-Docs/` — UC Spec, QnA-Log version trước, biên bản họp | "UC Spec v2 mục 4.3 đã mô tả màn hình xác nhận" |
| Màn hình, nhãn nút, thông báo thật trong mã nguồn frontend | "màn hình quản lý group có nút `import`" |
| Hành vi thật trong mã nguồn backend (validate, trạng thái, quyền) | "hệ thống đang khoá tài khoản sau 5 lần sai" |

- Không chỉ ra được nguồn → **bỏ option/ví dụ đó**. Cần nêu một hướng xử lý chưa có trong hệ thống → gộp vào option `Khác — mô tả ngắn`, không dựng nó thành một option nghe như đã có sẵn.
- Option mô tả hành vi hệ thống **chưa có** nhưng cần đưa ra để khách hàng chọn → ghi `(chưa có, cần làm mới)` ngay trong option.
- Tên màn hình, vai trò, trạng thái, nút trong ví dụ phải **đúng như hệ thống đang gọi** (theo Glossary), không đặt tên mới cho dễ đọc.
- Số liệu, ngày giờ, tên người trong ví dụ được phép là dữ liệu minh hoạ. **Trường, màn hình, bước chứa chúng thì không** — không bịa thêm một trường "Ghi chú" hay một màn hình "Xác nhận" chỉ để ví dụ chạy trôi.

**4. Độ dài và tách câu.** Bối cảnh không quá 3 câu. Nếu không tóm được trong 3 câu → câu hỏi đang gộp nhiều vấn đề, phải tách nhỏ (và điền `Phụ thuộc` giữa các câu vừa tách).

**5. Self-check bắt buộc trước khi gửi mỗi câu hỏi.** Trả lời được cả 3 ý sau thì mới gửi:
- Đáp án sẽ làm thay đổi **cụ thể mục nào** trong tài liệu output? (không nêu được → không hỏi). Đây là kiểm tra nội bộ — **không** viết câu trả lời này vào tài liệu.
- Người không technical đọc câu này có hiểu ngay không? (không → viết lại, không gửi kèm lời xin lỗi "câu này hơi kỹ thuật")
- Mỗi option và mỗi ví dụ trong câu này chỉ ra được nguồn thật chưa? (xem mục 3bis — không có nguồn → bỏ hoặc gộp vào "Khác")
- Mọi thuật ngữ nghiệp vụ trong câu đã lấy từ `Glossary.md` chưa, có từ nào bị tự dịch không? Còn chữ tiếng Nhật nào đứng một mình, chưa có tên gọi đi kèm không?
- Câu này đã được trả lời hoặc suy ra được từ quyết định đã chốt chưa? (xem [Quy tắc chống hỏi trùng](#quy-tắc-chống-hỏi-trùng--suy-ra-từ-quyết-định-đã-chốt))

### Quy tắc chống hỏi trùng — suy ra từ quyết định đã chốt

> Số lượng câu hỏi **không phải** thước đo chất lượng phân tích. Hỏi thừa làm người trả lời mất thời gian và giảm niềm tin vào cả bộ câu hỏi. Chủ động hỏi để làm rõ điểm mơ hồ là bắt buộc; hỏi lại điều đã chốt là lỗi.

**1. Duy trì bảng "Quyết định đã chốt + hệ quả suy ra".** Sau **mỗi** câu trả lời Confirmed, ghi ngay vào bản nháp phân tích:

| Quyết định (từ QA-xx) | Hệ quả suy ra trực tiếp (không cần hỏi lại) |
|---|---|
| Không retry khi gửi thất bại | Không có số lần retry; không có khoảng cách giữa các lần retry; không retry cho các kênh khác trong cùng luồng gửi (email, push, SMS); không có màn hình/log theo dõi retry; lỗi gửi chỉ ghi nhận 1 lần |

Hệ quả suy ra là **một phần của câu trả lời**, không phải câu hỏi mới.

**2. So khớp theo ý định nghiệp vụ, không theo chữ.** Trước khi gửi bất kỳ câu hỏi nào, đối chiếu ý định của nó với bảng trên. Cấm hỏi lại cùng một quyết định bằng cách diễn đạt khác hoặc từ đồng nghĩa — ví dụ `retry` = `gửi lại` = `thử lại` = `re-send` = `chạy lại`; `khoá tài khoản` = `tạm ngưng đăng nhập`. Trùng ý định → **không hỏi**, ghi vào QnA-Log dòng `Suy ra từ QA-xx: <nội dung suy ra>` với trạng thái **Confirmed**.

**3. Khi không chắc đáp án cũ có bao phủ hay không.** Không soạn một câu hỏi mới đầy đủ. Hỏi **đúng một câu xác nhận yes/no**, nêu rõ suy luận:

```
Xác nhận nhanh: theo QA-xx đã chốt "<quyết định>", suy ra "<hệ quả áp dụng cho trường hợp đang xét>". Đúng không? (Có / Không — nếu Không, mô tả điểm khác biệt)
```

Chỉ hỏi xác nhận **một lần** cho mỗi suy luận. Người trả lời xác nhận "Có" → đóng luôn, không mở câu hỏi chi tiết tiếp theo về cùng quyết định đó.

**4. Cấm hỏi lấy số lượng.** Không thêm câu hỏi chỉ để danh sách trông đầy đủ, để "phòng hờ", hoặc để chứng minh đã phân tích kỹ. Câu hỏi không làm đổi nội dung output → ghi thành Assumption kèm marker `[PENDING]`, không hỏi.

**5. Khi người trả lời hỏi ngược "câu này có cần thiết không?".** Đây là tín hiệu quy tắc trên đã bị vi phạm. Xử lý: trả lời thẳng câu đó có cần hay không kèm lý do; nếu không cần → rút câu hỏi, ghi `Rút — suy ra từ QA-xx` vào QnA-Log; và **rà lại toàn bộ các câu chưa hỏi còn lại** bằng mục 2 trước khi hỏi tiếp câu kế.
