<!-- FILE SINH TỰ ĐỘNG từ custom/templates/shared/create-spec-workflow.md (các khối Definition of Done).
     Không sửa trực tiếp: sửa workflow rồi chạy `node scripts/gen-agentic-rules.js`. -->

# Definition of Done của create-spec (từng gate)

> 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.


## GATE 1 — Phân tích yêu cầu ban đầu & Tạo Q&A (auto-start)

- [ ] `functionId` đã được xác định và thư mục đầu ra đã sẵn sàng
- [ ] File `Analysis_v1.md` tạo đúng vị trí, cấu trúc đúng template, có bảng Gap Analysis, số Gap phản ánh đúng độ phức tạp thực tế (không bị gò về một số cố định)
- [ ] File `QnA-Log_v1.md` có ít nhất 1 câu hỏi cho mỗi Gap, mỗi câu có nhãn Blocking/Non-blocking rõ ràng
- [ ] `QnA-Log_v1.md` đã chia nhóm theo role (hoặc theo màn hình/module nếu hệ thống chỉ có một role), ID liên tục toàn file
- [ ] Không còn mục "Vì sao cần hỏi" ở bất kỳ đâu; phần đó đã gộp vào mục `Bối cảnh`
- [ ] Danh sách câu hỏi ở dạng khối `Q{n}` có tiêu đề `[Màn hình/Chức năng] Về {chủ đề}`, không phải bảng
- [ ] Tiêu đề viết thành cụm danh từ, không phải câu hỏi
- [ ] Mục `Vấn đề` và `Ví dụ minh họa` không có nội dung thì đã bỏ hẳn, không để tên mục rỗng
- [ ] `QnA-Log` trình bày đúng mục 1 của Quy tắc chất lượng câu hỏi: tên mục in đậm có `:`, không đánh số; nội dung thụt 4 dấu cách; không bullet `・`; hai dòng thông tin viết thành câu; không ghi công số; `Người trả lời` / `Ngày trả lời` / `Nguồn` ngang cấp với `Câu trả lời:`
- [ ] Mọi option và ví dụ minh hoạ đều truy được về yêu cầu / `AK-Docs/` / mã nguồn; option mô tả chức năng chưa có đã ghi `(chưa có, cần làm mới)`
- [ ] `AK-Docs/00.Project-Overview/Glossary.md` đã được đọc (hoặc đã hỏi BA xác nhận tạo mới), và mọi thuật ngữ BA cung cấp trong gate này đã ghi ngược vào file đó
- [ ] Thuật ngữ khớp Glossary (`custom/rules/domain-terminology.md`): không từ tự dịch / tự đặt (grep `cửa hàng|khách hàng|người mua|nhà cung cấp|trang quản trị|cổng|nhóm|sản phẩm|giỏ hàng` — mỗi hit phải có trong cột `Viết trong tài liệu`), không chữ tiếng Nhật đứng một mình trong câu
- [ ] Động từ thao tác UI và thuật ngữ IT theo `custom/rules/ui-action-wording.md`: grep `bấm|nhấn nút|ấn nút|tích chọn|bỏ tích|chọn tay|gõ vào|điền vào|ô nhập|hộp xác nhận|thông báo góc|khung lỗi|rời ô|kéo thả|di chuột|máy chủ|bộ nhớ đệm|chuyển hướng` trên Analysis và QnA-Log — 0 hit ngoài chữ gốc trích nguyên văn
- [ ] Không còn câu hỏi 🔴 Blocking ở trạng thái Open
- [ ] Không có giả định nào được tự ý chốt thành Spec mà không đưa vào Q&A

## GATE 2 — Cập nhật phản hồi Q&A (lặp đến khi tất cả Confirmed)

- [ ] Mọi câu trả lời đều được phân tích và phân loại trạng thái
- [ ] Không có câu hỏi nào được phát ra khi câu cha của nó còn Open (mọi câu con đúng trạng thái `Blocked-by QA-xx`)
- [ ] Mọi câu `Blocked-by` có câu cha vừa Confirmed đã được soát lại: đóng thành Confirmed nếu đã được bao phủ, hoặc mở sang Open
- [ ] Tài liệu phân tích phiên bản mới tích hợp đầy đủ thông tin nghiệp vụ mới nhất
- [ ] Không còn câu hỏi 🔴 Blocking ở trạng thái Open trước khi tiến Gate 3
- [ ] Nếu còn câu 🟡 Non-blocking Open, BA đã xác nhận rõ ràng (gõ APPROVED sau khi thấy cảnh báo) và các mục liên quan trong Analysis đã có marker `[PENDING - QA-ID]`
- [ ] `QnA-Log_v(m+1).md` giữ đúng cấu trúc nhóm theo role, ID liên tục toàn file, không có mục "Vì sao cần hỏi", trình bày đúng format ghi file ở mục 1 của Quy tắc chất lượng câu hỏi
- [ ] Thuật ngữ nghiệp vụ mới xuất hiện trong câu trả lời vòng này đã được ghi vào `Glossary.md`
- [ ] Thuật ngữ khớp Glossary (`custom/rules/domain-terminology.md`): không từ tự dịch / tự đặt (grep `cửa hàng|khách hàng|người mua|nhà cung cấp|trang quản trị|cổng|nhóm|sản phẩm|giỏ hàng` — mỗi hit phải có trong cột `Viết trong tài liệu`), không chữ tiếng Nhật đứng một mình trong câu
- [ ] Động từ thao tác UI và thuật ngữ IT theo `custom/rules/ui-action-wording.md`: grep `bấm|nhấn nút|ấn nút|tích chọn|bỏ tích|chọn tay|gõ vào|điền vào|ô nhập|hộp xác nhận|thông báo góc|khung lỗi|rời ô|kéo thả|di chuột|máy chủ|bộ nhớ đệm|chuyển hướng` trên `Analysis_v(n+1)` và `QnA-Log_v(m+1)` — 0 hit ngoài chữ gốc trích nguyên văn

## GATE 3 — Thiết kế giao diện Prototype HTML/CSS

- [ ] File `UI-Prototype_v1.html` tạo đúng vị trí
- [ ] Giao diện hiển thị đủ tất cả thành phần nghiệp vụ
- [ ] 100% thẻ tương tác có `id` duy nhất
- [ ] CSS tự chứa trong file HTML

## GATE 4 — Viết đặc tả Use Case Spec hoàn chỉnh

- [ ] File `UC-Spec_v{N}.md` đúng vị trí và cấu trúc template, có `UC-Spec-Version` header đúng `N`
- [ ] Section "Mô tả màn hình" có link Markdown click được tới file HTML prototype (đường dẫn tương đối `../../03.UI-Prototypes/...`), kèm ảnh PNG đã chụp hoặc ghi chú để BA tự chụp; không chứa mã HTML/CSS của prototype
- [ ] 100% element HTML được mô tả trong bảng UI Components (id, loại, ràng buộc)
- [ ] Mã Mermaid hợp lệ, thể hiện đủ Main/Alternative/Exception Flow
- [ ] Business Rules đầy đủ với mã `[BR-NNN]` và thông báo lỗi chính xác
- [ ] Không còn giả định ngầm chưa Confirm bị viết như thể đã chốt; mọi nội dung Non-blocking Open còn lại đã có marker `[PENDING - QA-ID]` rõ ràng tại đúng vị trí (không phải ghi chú mơ hồ chung)
- [ ] Hành văn tự nhiên — chạy `grep -nE "Cố |Cố gắng|Thử (mở|nhập|bấm|click)|Tiến hành|thực hiện việc"` trên UC Spec, 0 hit (`custom/rules/document-wording.md` mục 1)
- [ ] Thuật ngữ khớp `QnA-Log` / `Analysis` và Glossary (`custom/rules/domain-terminology.md`): grep `cửa hàng|khách hàng|người mua|nhà cung cấp|trang quản trị|cổng|nhóm|sản phẩm|giỏ hàng` trên UC Spec — mỗi hit phải có trong cột `Viết trong tài liệu` của Glossary; không còn chữ tiếng Nhật đứng một mình trong câu
- [ ] Động từ thao tác UI và thuật ngữ IT theo `custom/rules/ui-action-wording.md`: grep `bấm|nhấn nút|ấn nút|tích chọn|bỏ tích|chọn tay|gõ vào|điền vào|ô nhập|hộp xác nhận|thông báo góc|khung lỗi|rời ô|kéo thả|di chuột|máy chủ|bộ nhớ đệm|chuyển hướng` trên UC Spec — 0 hit ngoài chữ gốc trích nguyên văn
- [ ] Mỗi Flow step / Business Rule đọc độc lập là hiểu — không có tham chiếu trần kiểu "như mục trên", "theo BR2.10" không kèm mô tả nội dung (`custom/rules/document-wording.md` mục 2)
