@relipa/ai-flow-kit 0.2.0-beta.0 → 0.2.0-beta.2

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

@@ -3,7 +3,29 @@
 > **For:** `create-spec`
 > **Persona:** Business Analyst (BA)
 > **Goal:** Chuyển đổi yêu cầu thô (Jira / Backlog / file) thành tài liệu Đặc tả Use Case (UC Spec) hoàn chỉnh để bàn giao Dev/Test, tuân theo quy trình UCflow.
-> **Interaction Rules:** Hỏi ONE câu hỏi tại một thời điểm — đợi BA trả lời trước khi tiếp tục. KHÔNG hỏi nhiều câu cùng lúc.
+> **Interaction Rules:** Hỏi ONE câu hỏi tại một thời điểm — đợi BA trả lời trước khi tiếp tục. KHÔNG hỏi nhiều câu cùng lúc. Số lượng câu hỏi KHÔNG cố định — phải phản ánh đúng độ phức tạp thực tế của yêu cầu (xem chi tiết ở Gate 1 Bước 2).
+
+---
+
+### 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_v1.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>
+```
 
 ---
 
@@ -189,40 +211,48 @@ Nếu workspace mở dạng parent folder chứa cả `ak docs` lẫn source cod
 - Xem xét các khía cạnh: validate dữ liệu, định dạng nhập liệu, phân quyền, xử lý ngoại lệ, thông báo lỗi
 - Liệt kê **toàn bộ** Gap/Assumption tìm được — không chỉ những điểm "cốt yếu"
 
+> ❌ **KHÔNG** tự giới hạn số câu hỏi theo một số cố định (ví dụ luôn dừng ở 5-6 câu) bất kể độ phức tạp của input. Số câu hỏi phải phản ánh đúng số Gap/Assumption thực sự tồn tại: yêu cầu đơn giản (1 field, 1 luồng) có thể chỉ cần 2-3 câu; yêu cầu phức tạp (nhiều actor, nhiều luồng, tích hợp hệ thống khác) có thể cần 15-20+ câu. Nếu trong lúc hỏi/nghe trả lời phát hiện thêm Gap mới, bổ sung ngay câu hỏi mới vào cuối vòng lặp — không đóng vòng lặp sớm chỉ vì đã hỏi "đủ nhiều".
+
+**Phân loại mức ảnh hưởng:** trước khi hỏi, gắn nhãn mỗi Gap là 🔴 Blocking hoặc 🟡 Non-blocking theo [Quy ước Blocking / Non-blocking](#quy-ước-blocking--non-blocking--đánh-dấu-pending) ở đầu file.
+
 **Vòng lặp hỏi-đáp:** Với từng Gap/Assumption trong danh sách, hỏi **ONE câu một lúc**, đợi BA trả lời trước khi hỏi câu tiếp theo:
 
 - BA trả lời đủ rõ → đánh dấu **Confirmed**, tích hợp ngay vào bản phân tích đang xây dựng, chuyển sang câu hỏi tiếp theo
-- BA trả lời "chưa biết" / "để hỏi lại [stakeholder]" / "chưa chốt được ngay" → đánh dấu **Open** (deferred), ghi chú lý do, vẫn chuyển sang câu hỏi tiếp theo — KHÔNG chặn cả vòng lặp lại vì một câu chưa trả lời được
-- Lặp lại cho tới khi **mọi** Gap/Assumption trong danh sách đã được hỏi (mỗi câu ở trạng thái Confirmed hoặc Open tường minh)
+- BA trả lời "chưa biết" / "để hỏi lại [stakeholder]" / "chưa chốt được ngay":
+  - 🟡 Non-blocking → đánh dấu **Open** (deferred), ghi chú lý do, chuyển ngay sang câu hỏi tiếp theo — KHÔNG chặn
+  - 🔴 Blocking → hiển thị cảnh báo lý do đây là blocking + hệ quả nếu bỏ qua, hỏi BA xác nhận có chắc muốn tiếp tục không; BA xác nhận → đánh dấu **Open** nhưng giữ nhãn 🔴 Blocking, vẫn chuyển sang câu tiếp theo
+- Lặp lại cho tới khi **mọi** Gap/Assumption trong danh sách đã được hỏi (mỗi câu ở trạng thái Confirmed hoặc Open tường minh, kèm nhãn Blocking/Non-blocking)
 
-Chỉ sau khi vòng lặp này hoàn tất (không còn Gap nào **chưa được hỏi**) mới chuyển sang Bước 3. Số lượng câu hỏi Open còn lại sau vòng lặp này chính là input cho Gate 2.
+Chỉ sau khi vòng lặp này hoàn tất (không còn Gap nào **chưa được hỏi**) mới chuyển sang Bước 3. Số lượng câu hỏi Open còn lại (và nhãn Blocking/Non-blocking của chúng) chính là input cho Gate 2.
 
 #### Bước 3: Soạn thảo Kết quả phân tích sơ bộ
 - **READ template:** `.claude/skills/ba-skills/skill-ba-initial-analysis-template-v1.md`
 - Điền đầy đủ các mục theo template: Actors, Facts, Assumptions, Gap Analysis table — dùng câu trả lời **Confirmed** từ vòng lặp Bước 2 làm nội dung chính, không phải giả định của AI
-- Gap Analysis table chỉ còn liệt kê các Gap **Open** (deferred) từ vòng lặp Bước 2
+- Gap Analysis table chỉ còn liệt kê các Gap **Open** (deferred) từ vòng lặp Bước 2, kèm nhãn 🔴 Blocking / 🟡 Non-blocking
+- Với mỗi Gap Open, chèn marker `⚠️ [PENDING - QA-0N]` tại đúng vị trí nội dung liên quan (mục 3/4 của template) thay vì bỏ trống hoặc tự suy diễn
+- Nếu tài liệu còn ít nhất 1 Gap Open → thêm banner đầu tài liệu: `⚠️ TÀI LIỆU CHƯA ĐẦY ĐỦ — còn [N] câu hỏi Open ([X] Blocking, [Y] Non-blocking), xem QnA-Log_v1.md`
 - Lưu: `02.BA-Specs/01.Analysis/[functionId]/Analysis_v1.md`
 
 #### Bước 4: Soạn thảo danh sách Q&A
 
 - **READ skill:** `.claude/skills/ba-skills/skill-ba-qna-v1.md`
 - **READ template:** `.claude/skills/ba-skills/skill-ba-qna-template-v1.md`
-- Ghi lại **toàn bộ** câu hỏi đã hỏi ở vòng lặp Bước 2 dưới dạng log: mỗi câu kèm câu trả lời và trạng thái cuối cùng
+- Ghi lại **toàn bộ** câu hỏi đã hỏi ở vòng lặp Bước 2 dưới dạng log: mỗi câu kèm câu trả lời, nhãn Blocking/Non-blocking, và trạng thái cuối cùng
   - **Confirmed** — BA đã trả lời trong Bước 2, ghi kèm câu trả lời
-  - **Open** — BA đã xác nhận chưa trả lời được ngay (cần hỏi lại stakeholder khác), ghi kèm lý do deferred
+  - **Open** — BA đã xác nhận chưa trả lời được ngay (cần hỏi lại stakeholder khác), ghi kèm lý do deferred + nhãn 🔴 Blocking hoặc 🟡 Non-blocking
 - Không tạo câu hỏi mới ở bước này — đây là bản ghi (log) của vòng lặp đã chạy ở Bước 2, không phải một vòng hỏi mới
 - Lưu: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v1.md`
 
 #### Bước 5: Gate Review & Pause
 - **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-1-[functionId].md`
-- **Kiểm tra Q&A bắt buộc:** Đọc `QnA-Log_v1.md` — đếm số câu có trạng thái **Open**
+- **Kiểm tra Q&A bắt buộc:** Đọc `QnA-Log_v1.md` — đếm số câu **Open**, tách riêng theo nhãn 🔴 Blocking và 🟡 Non-blocking
 - Hiển thị gate pause message — chờ phản hồi từ BA
 
-**Nếu nhận được APPROVED mà QnA-Log_v1.md còn câu hỏi Open → từ chối ngay, hiển thị:**
+**Nếu còn câu Open 🔴 Blocking → từ chối APPROVED ngay, hiển thị:**
 
-⛔ GATE 1 BLOCKED — Còn [N] câu hỏi chưa được trả lời trong QnA-Log_v1.md.
+⛔ GATE 1 BLOCKED — Còn [N] câu hỏi Blocking chưa được trả lời trong QnA-Log_v1.md.
 
-| ID | Câu hỏi còn Open |
+| ID | Câu hỏi còn Open (Blocking) |
 |----|-----------------|
 | [Q_ID] | [nội dung câu hỏi] |
 
@@ -231,17 +261,26 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 → Option B: paste nội dung bảng Q&A đã điền vào chat
 → Option C: đặt file `QnA-Log_v1_response.md` vào thư mục `02.QnA/[functionId]/` rồi gõ NEXT
 
-❌ APPROVED không được chấp nhận cho đến khi 100% câu hỏi đã Confirmed.
+❌ APPROVED không được chấp nhận cho đến khi mọi câu hỏi **Blocking** đã Confirmed.
 
-**Khi APPROVED (chỉ sau khi tất cả câu hỏi trong QA(1).md đã Confirmed):**
+**Nếu chỉ còn câu Open 🟡 Non-blocking (không còn Blocking) → cho phép APPROVED, nhưng hiển thị cảnh báo ngay trong gate pause message trước khi BA gõ APPROVED:**
+
+⚠️ Còn [N] câu hỏi Non-blocking chưa Confirmed — có thể APPROVED để tiếp tục, tài liệu sẽ giữ marker `[PENDING - QA-0N]` tại các phần liên quan cho tới khi được bổ sung ở Gate 2.
+
+| ID | Câu hỏi còn Open (Non-blocking) |
+|----|-----------------|
+| [Q_ID] | [nội dung câu hỏi] |
+
+**Khi APPROVED (không còn câu Blocking Open — câu Non-blocking Open được phép tồn tại):**
 → **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` đã đượ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
-- [ ] File `QnA-Log_v1.md` có ít nhất 1 câu hỏi cho mỗi Gap, tất cả trạng thái **Open**
+- [ ] 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
+- [ ] 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
 
 > **Telemetry:** Run `ak gate 1 start --ticket [functionId]` khi bắt đầu gate này.
@@ -270,8 +309,8 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 #### Bước 1: Tiếp nhận và đánh giá câu trả lời
 - Đối chiếu từng câu trả lời với câu hỏi trong `QnA-Log_v(m).md`
 - Phân loại:
-  - Đủ thông tin → cập nhật trạng thái: **Confirmed**
-  - Chưa rõ hoặc phát sinh nghiệp vụ mới → giữ trạng thái **Open**, bổ sung ghi chú
+  - Đủ thông tin → cập nhật trạng thái: **Confirmed**, xóa marker `[PENDING - QA-ID]` liên quan
+  - Chưa rõ hoặc phát sinh nghiệp vụ mới → giữ trạng thái **Open**, bổ sung ghi chú, giữ nguyên nhãn 🔴 Blocking / 🟡 Non-blocking đã gắn từ Gate 1 (hoặc gắn mới nếu là Gap phát sinh)
 
 #### Bước 2: Tích hợp thông tin vào tài liệu phân tích
 - Lấy thông tin từ các câu Confirmed → cập nhật vào `Analysis_v(n).md`
@@ -280,7 +319,7 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 
 #### Bước 3: Rẽ nhánh theo trạng thái Q&A
 
-**Kịch bản A — Vẫn còn câu hỏi Open:**
+**Kịch bản A — Còn câu hỏi Open 🔴 Blocking:**
 1. Kiểm tra `Analysis_v(n+1).md` có phát sinh Gap mới không
 2. Tạo: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md` — chỉ giữ câu Open và câu mới phát sinh
 3. **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-2-[functionId]-round-[m+1].md`
@@ -289,7 +328,8 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ⏸️  GATE 2 — VÒNG Q&A [m+1]
 
-Câu hỏi còn Open: [N]
+Câu hỏi còn Open (🔴 Blocking): [N]
+Câu hỏi còn Open (🟡 Non-blocking): [M]
 File Q&A mới:     [02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md](02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md)
 File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md)
 
@@ -299,23 +339,40 @@ File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02
 
 5. Lặp lại Bước 1 khi nhận phản hồi mới
 
-**Nếu BA gõ APPROVED khi đang ở Kịch bản A (còn câu hỏi Open) → từ chối ngay:**
+**Nếu BA gõ APPROVED khi đang ở Kịch bản A (còn câu hỏi Open 🔴 Blocking) → từ chối ngay:**
 
-⛔ GATE 2 BLOCKED — Còn [N] câu hỏi chưa Confirmed.
+⛔ GATE 2 BLOCKED — Còn [N] câu hỏi Blocking chưa Confirmed.
 
-| ID | Câu hỏi còn Open |
+| ID | Câu hỏi còn Open (Blocking) |
 |----|-----------------|
 | [Q_ID] | [nội dung câu hỏi] |
 
 → Cung cấp câu trả lời (Option A/B/C) rồi gõ NEXT để AI xử lý tiếp.
-❌ APPROVED chỉ được chấp nhận khi 100% câu hỏi đã Confirmed.
+❌ APPROVED chỉ được chấp nhận khi mọi câu hỏi **Blocking** đã Confirmed.
+
+**Kịch bản B — Chỉ còn câu hỏi Open 🟡 Non-blocking (không còn Blocking):**
+
+1. Tạo `QnA-Log_v(m+1).md` như Kịch bản A (giữ câu Non-blocking Open + câu mới phát sinh)
+2. Hiển thị cho BA 2 lựa chọn, không tự chọn thay:
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⏸️  GATE 2 — CÒN [M] CÂU HỎI NON-BLOCKING CHƯA CONFIRMED
+
+Các câu hỏi này không chặn thiết kế Gate 3/4, nhưng output sẽ giữ marker `[PENDING - QA-ID]` tại các phần liên quan cho tới khi được bổ sung.
+
+→ Cách 1: cung cấp câu trả lời (Option A/B/C) rồi gõ NEXT để xử lý tiếp
+→ Cách 2: gõ APPROVED để chấp nhận tiếp tục dù output chưa đầy đủ ở các mục này
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+1. BA gõ NEXT với phản hồi mới → lặp lại Bước 1
+2. BA gõ APPROVED → coi là đã xác nhận chấp nhận output chưa đầy đủ, chuyển sang xử lý APPROVED bên dưới
 
-**Kịch bản B — Tất cả đã Confirmed:**
+**Kịch bản C — Tất cả đã Confirmed:**
 1. Chốt tài liệu phân tích (phiên bản cuối cùng là đầu vào Gate 3)
 2. **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-2-[functionId].md`
 3. Hiển thị gate pause message — đợi **APPROVED**
 
-**Khi APPROVED (chỉ áp dụng Kịch bản B):**
+**Khi APPROVED (Kịch bản B hoặc C — không còn câu Blocking Open):**
 → **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
@@ -323,7 +380,8 @@ File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02
 **Definition of Done:**
 - [ ] Mọi câu trả lời đều được phân tích và phân loại trạng thái
 - [ ] 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 nào ở trạng thái **Open** trước khi tiến Gate 3
+- [ ] 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]`
 
 > **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.
@@ -334,7 +392,7 @@ File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02
 
 **Mục tiêu:** Dựa trên tài liệu phân tích đã chốt, thiết kế bản mẫu giao diện (Prototype) độc lập bằng HTML/CSS để trực quan hóa các thành phần và luồng tương tác.
 
-**Điều kiện vào Gate 3:** Tất cả Q&A đã **Confirmed** và Gate 2 đã **APPROVED**.
+**Điều kiện vào Gate 3:** Không còn câu hỏi 🔴 Blocking Open và Gate 2 đã **APPROVED** (câu 🟡 Non-blocking Open, nếu còn, mang marker `[PENDING - QA-ID]` sang cùng Analysis).
 
 **Đầu vào (Inputs):**
 - `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản cuối
@@ -349,6 +407,7 @@ File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02
 #### Bước 1: Liệt kê thành phần giao diện
 - Đọc tài liệu phân tích đã chốt
 - Xác định: ô nhập liệu, nút bấm, liên kết, vùng hiển thị lỗi, vùng hiển thị dữ liệu
+- Nếu Analysis còn marker `[PENDING - QA-ID]` liên quan đến thành phần giao diện nào → giữ nguyên placeholder trực quan cho thành phần đó (không tự bịa nội dung/behavior để lấp đầy) và ghi chú `<!-- PENDING - QA-ID -->` cạnh phần tử HTML tương ứng
 
 #### Bước 2: Thiết kế và viết code HTML/CSS
 - **READ skill:** `.claude/skills/ba-skills/skill-ba-prototype-v1.md` và làm theo
@@ -406,6 +465,7 @@ File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02
 - **READ skill:** `.claude/skills/ba-skills/skill-ba-write-uc-spec-v1.md`
 - Tạo: `02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v1.md`
 - Điền General Information: Use Case ID, Title, Version, Actors, Preconditions, Postconditions
+- Nếu Analysis/Prototype đầu vào còn marker `[PENDING - QA-ID]` (câu Non-blocking chưa Confirmed) → giữ nguyên marker tại đúng vị trí liên quan (Business Rule, UI Component, Flow step) trong UC Spec, không tự bịa nội dung để lấp đầy; thêm banner đầu tài liệu: `⚠️ UC SPEC CHƯA ĐẦY ĐỦ — còn [N] mục PENDING, xem QnA-Log_v(m).md`
 
 #### Bước 2: Mô tả luồng sự kiện (Flow of Events)
 - **Main Flow** — happy path
@@ -450,7 +510,7 @@ File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02
 - [ ] 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
-- [ ] Tài liệu không chứa ghi chú mơ hồ hoặc câu hỏi chưa giải quyết
+- [ ] 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)
 
 > **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.
@@ -497,9 +557,11 @@ Sau khi Gate 4 đã APPROVED (UC Spec hoàn thành):
 - ❌ **KHÔNG** bỏ qua thứ tự Gate — luôn đi từ Gate 1 → 2 → 3 → 4
 - ❌ **KHÔNG** tự chốt giả định nghiệp vụ mà không đưa vào Q&A
 - ❌ **KHÔNG** dùng `superpowers:brainstorming` ở Gate 1 — terminal state của skill đó invoke `writing-plans`, bypass cấu trúc BA workflow
-- ✅ **BẮT BUỘC** ở Gate 1 Bước 2: hỏi hết **toàn bộ** Gap/Assumption xác định được, từng câu một, ngay trong hội thoại — không giới hạn ở "điểm mơ hồ cốt yếu". Chỉ được ghi Open (deferred sang QnA-Log) khi BA xác nhận rõ ràng là chưa trả lời được ngay
-- ❌ **KHÔNG** tiến Gate 3 khi vẫn còn câu hỏi Open
-- ❌ **KHÔNG chấp nhận APPROVED** ở Gate 1 hoặc Gate 2 khi còn bất kỳ câu hỏi nào trạng thái **Open** — từ chối và hiển thị danh sách câu hỏi cần trả lời
+- ✅ **BẮT BUỘC** ở Gate 1 Bước 2: hỏi hết **toàn bộ** Gap/Assumption xác định được, từng câu một, ngay trong hội thoại — không giới hạn ở "điểm mơ hồ cốt yếu" và **không giới hạn theo một số câu hỏi cố định** bất kể độ phức tạp input. Chỉ được ghi Open (deferred sang QnA-Log) khi BA xác nhận rõ ràng là chưa trả lời được ngay
+- ✅ **BẮT BUỘC** gắn nhãn 🔴 Blocking / 🟡 Non-blocking cho mỗi Gap/câu hỏi ngay khi phát hiện (xem [Quy ước Blocking / Non-blocking](#quy-ước-blocking--non-blocking--đánh-dấu-pending))
+- ❌ **KHÔNG** tiến Gate 3 khi vẫn còn câu hỏi 🔴 Blocking ở trạng thái Open
+- ❌ **KHÔNG chấp nhận APPROVED** ở Gate 1 hoặc Gate 2 khi còn bất kỳ câu hỏi 🔴 **Blocking** nào ở trạng thái **Open** — từ chối và hiển thị danh sách câu hỏi cần trả lời
+- ✅ **ĐƯỢC PHÉP chấp nhận APPROVED** ở Gate 1/2/4 khi chỉ còn câu hỏi 🟡 **Non-blocking** Open, với điều kiện: đã hiển thị cảnh báo rõ ràng cho BA trước khi nhận APPROVED, và mọi nội dung phụ thuộc câu hỏi đó được đánh dấu `[PENDING - QA-ID]` tại đúng vị trí trong output — không được tự suy diễn nội dung để lấp đầy
 - ✅ **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** chạy Bước 0.5 ở Gate 1 — đảm bảo AK-Docs đang ở branch `feature/[functionId]/[taskId]` trước khi ghi file đầu tiên
 - ✅ **BẮT BUỘC** đọc skill từ `.claude/skills/ba-skills/` — không suy luận từ bộ nhớ

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

@@ -90,7 +90,7 @@ Ví dụ: `functionId = AD06` → thư mục gốc là `03.Testing/`
 ```
 (AI-Artifacts/ = 03.Testing/07.AI-Artifacts/ — viết tắt cho ngắn gọn)
 
-[Input: SRS / Jira / Backlog / Spec file] → Pre-flight: BẮT BUỘC xác định functionId
+[Input: UC Spec + System Requirement (bắt buộc, cảnh báo nếu thiếu) / SRS / Jira / Backlog / Spec file] → Pre-flight: BẮT BUỘC xác định functionId
     ↓
 Gate 1: Phân tích yêu cầu & Đánh giá rủi ro  → AI-Artifacts/[functionId]/
     ↓ APPROVED
@@ -169,8 +169,37 @@ Trước khi ghi bất kỳ file nào vào `03.Testing/`, đảm bảo AK-Docs
 
 > ❌ Không tự thêm `--yes` khi chưa thấy QA gõ xác nhận rõ ràng trong hội thoại.
 
+#### Bước 0.6: Kiểm tra UC Spec & System Requirement (input bắt buộc, cảnh báo non-blocking)
+
+**Mục tiêu:** Test Case phải được thiết kế dựa trên cả UC Spec (yêu cầu nghiệp vụ do BA chốt) **và** System Requirement (bản dịch kỹ thuật cho Dev — Validation Rule, Exception/Error Handling, Acceptance Test) — thiếu một trong hai, TC dễ bỏ sót case mà Dev đã implement hoặc case BA đã đặc tả.
+
+1. Tìm UC Spec: `AK-Docs/02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v{N}.md` (version cao nhất, không phải bản archive).
+2. Tìm System Requirement: `AK-Docs/02.BA-Specs/00.Requirements/[functionId]/System-Requirement_v*.md` (version cao nhất).
+3. Nếu tìm thấy System Requirement, đọc 2 header của nó: `UC-Spec-Version` (phải khớp version UC Spec tìm được ở bước 1) và `Status` (phải là `✅ Approved`).
+
+Nếu **bất kỳ** điều kiện sau không thỏa mãn → hiển thị cảnh báo tương ứng, **không dừng/không cancel Gate 1** — vẫn tiếp tục với dữ liệu hiện có:
+
+| Tình huống | Cảnh báo hiển thị |
+|---|---|
+| Không tìm thấy UC Spec | `⚠️ CẢNH BÁO: Không tìm thấy UC Spec cho [functionId] — Test Case sẽ chỉ dựa trên System Requirement (nếu có) + input khác, thiếu ngữ cảnh nghiệp vụ gốc.` |
+| Không tìm thấy System Requirement | `⚠️ CẢNH BÁO: Không tìm thấy System Requirement cho [functionId] — Test Case sẽ chỉ dựa trên UC Spec, có thể thiếu Validation Rule/Exception Handling/Acceptance Test mà Dev đã chốt riêng.` |
+| Có System Requirement nhưng `UC-Spec-Version` không khớp UC Spec hiện tại | `⚠️ CẢNH BÁO: System Requirement đang trace theo UC Spec v[X], nhưng UC Spec hiện tại là v[Y] — nội dung có thể lỗi thời.` |
+| Có System Requirement, khớp version, nhưng `Status` ≠ `✅ Approved` | `⚠️ CẢNH BÁO: System Requirement cho [functionId] chưa Approved (Status: [giá trị hiện tại]) — nội dung có thể còn thay đổi.` |
+
+→ Với mọi cảnh báo trên: ghi lại tình huống này vào `[functionId]_01_Requirement_Analysis_QA.md` (mục Assumptions, Bước 4) để QA/Dev biết rõ giới hạn của phân tích — không chỉ hiển thị rồi bỏ qua.
+
+Nếu tất cả điều kiện thỏa mãn → thông báo ngắn rồi tiếp tục:
+
+```
+✓ UC Spec: v[N]
+✓ System Requirement: v[N] (✅ Approved, khớp UC Spec v[N])
+→ Tiếp tục 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
+- Đọc `UC-Spec_v{N}.md` (tìm thấy ở Bước 0.6) — yêu cầu nghiệp vụ gốc: Main/Alternative/Exception Flow, Business Rules (BR-NNN), UI Components
+- Nếu tìm thấy `System-Requirement_v{N}.md` ở Bước 0.6 → đọc toàn bộ, dùng làm input kỹ thuật bổ sung cho Bước 2 (Phân tích yêu cầu): đối chiếu Functional/Non-Functional Requirements (`FR-*`, `NFR-*`), Validation Rules (`VR-*`), Exception & Error Handling (`ER-*`), Acceptance Test Scenarios (`AT-*`) — TC ở Gate 3 phải bao phủ cả các `AT-*`/`ER-*` này, không chỉ Business Rules trong UC Spec
 - 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 đó
@@ -227,6 +256,7 @@ Trước khi ghi bất kỳ file nào vào `03.Testing/`, đảm bảo AK-Docs
 
 **Definition of Done:**
 - [ ] `functionId` đã được xác định, thư mục đầu ra đã sẵn sàng
+- [ ] Đã chạy Bước 0.6 (kiểm tra UC Spec + System Requirement); nếu có cảnh báo, đã ghi vào `01_Requirement_Analysis_QA.md`
 - [ ] File `01_Requirement_Analysis_Result.md` có đủ 16 mục + Risk Matrix + Test Scope
 - [ ] Toàn bộ Critical/Major đã được hỏi trực tiếp (từng câu một) và có câu trả lời từ QA — không còn nghi vấn bỏ ngỏ
 - [ ] File `01_Requirement_Analysis_QA.md` đã tạo nếu có issue, ghi lại đầy đủ câu hỏi + câu trả lời (Bước 2b)
@@ -530,6 +560,7 @@ Sau khi Gate 4 đã APPROVED (bộ Test Case hoàn thành):
 - ❌ **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** chạy Bước 0.5 ở Gate 1 — đảm bảo AK-Docs đang ở branch `feature/[functionId]/[taskId]` trước khi ghi file đầu tiên
+- ✅ **BẮT BUỘC** chạy Bước 0.6 ở Gate 1 — kiểm tra UC Spec + System Requirement (tồn tại, khớp version, Approved); thiếu/lệch → cảnh báo yellow **không chặn Gate**, ghi vào QA artifact
 - ✅ **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% `testcase-template.md` ở Gate 3 và Gate 4

package/custom/templates/shared/gate-workflow.md

@@ -719,3 +719,18 @@ Bugs logged: [N] | Skipped: [N]
 7. Display: `GATE 2 DONE: Entry ghi vào AK-Docs/01.QnA/[file] — MR: [url hoặc "tạo thủ công"]`
 
 > **Telemetry:** Run `ak gate 2 start --ticket [ticket-id]` when starting. Run `ak gate 2 approved --ticket [ticket-id]` when Gate 2 completes.
+
+### GATE 3 — Sinh Task & Tạo Ticket (auto, chạy ngay sau Gate 2 xong)
+
+> Implements "Vấn đề 5" trong `docs/internal/PM Workflow_v1.0.md`. **Không chờ APPROVED để bắt đầu** — chạy tự động ngay sau Gate 2 Bước 7, không cần lệnh riêng và không cần chờ PM merge MR (merge là việc độc lập của PM). `INVOKE`: `ingest-data` skill § 5 cho toàn bộ logic phân tích/đề xuất — mục này chỉ nêu gate mechanics.
+
+1. Đọc lại entry vừa ghi + điều tra source/docs liên quan (skill § 5.1).
+2. Quyết định content này có cần task không (skill § 5.2). Nếu KHÔNG cần task → hiển thị thông báo tương ứng, chạy `ak gate 3 skip --ticket [ticket-id] --reason "<1 câu lý do>"` (không chạy `ak gate 3 start`), và **kết thúc luôn, không có Gate 3 Display**. `skip` vẫn đóng gate đúng cách (advance `currentGate` giống `approved`) — task hiện đúng "done" trên dashboard, không treo ở trạng thái "sẵn sàng chạy Gate 3" mãi.
+3. Nếu CẦN task → chạy `ak gate 3 start --ticket [ticket-id]`, rồi đề xuất danh sách task (skill § 5.3), cho PM sửa/thêm/xoá (skill § 5.4), lặp tới khi PM hài lòng.
+4. Điểm dừng xác nhận trước khi tạo ticket (skill § 5.5) — ❌ không tự thêm `--yes`, phải có xác nhận rõ ràng trong hội thoại.
+5. Xác định project đích trên Backlog/Jira (skill § 5.6, dùng `ak backlog-projects`/`ak jira-projects` + `ak backlog-set-default-project`/`ak jira-set-default-project`).
+6. Tạo ticket bằng `ak tasks create-tickets <file>.json --json` (skill § 5.7). Nếu thiếu WRITE credentials, hỏi PM nhập ngay trong chat rồi `ak credentials set <field> "<value>"` và thử lại đúng 1 lần.
+7. Ghi ngược link ticket vào entry gốc + hiển thị tổng kết (skill § 5.8).
+8. Run: `ak gate 3 approved --ticket [ticket-id]` để đóng task.
+
+> **Telemetry:** Run `ak gate 3 start --ticket [ticket-id]` chỉ khi Bước 2 kết luận CẦN task. Run `ak gate 3 approved --ticket [ticket-id]` khi Gate 3 hoàn tất, hoặc `ak gate 3 skip --ticket [ticket-id] --reason "..."` khi Bước 2 kết luận KHÔNG cần task.

package/docs/common/CHANGELOG.md

@@ -7,6 +7,29 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [0.2.2] - 2026-08-06
+
+### Added
+
+- **`ak gate <n> skip --ticket <id> [--reason <text>]`** — a gate can now close as "skipped" (legitimately produced no deliverable) instead of only `start`/`approved`. First consumer: `ingest-data` Gate 3, when the AI decides the ingested content is reference-only and no task list is needed — it now runs `ak gate 3 skip` instead of leaving the gate untouched. `scripts/task.js`'s `updateTaskGateState()` gained a `skip` branch that records `skippedGates[gate] = {at, reason}` in `task-state.json` and advances `currentGate` exactly like `approved` does, so every existing "is this task done" check (which only ever inspects `currentGate`) keeps working with zero changes. Prompted by an impact assessment for the `ai-flow-ex` VS Code extension's dashboard, which was showing skipped-Gate-3 ingest-data tasks stuck as "ready to run Gate 3" forever — see `docs/superpowers/specs/2026-08-06-ingest-data-gate3-skipped-state-design.md` in `ai-flow-ex` for the paired UI-side change (reads `skippedGates` to render a distinct "⏭ Skipped" badge instead of the generic "✓ Approved").
+
+### Fixed
+
+- **`ak task next` treated `ingest-data` as a 2-gate flow** — a stale assumption left over from before Gate 3 (task creation & ticket generation) was added to `ingest-data` earlier in the same release cycle. `scripts/task.js` grouped it with `gen-doc`/`create-system-requirement` (`maxGate = 2`), so pausing via `ak task next` on Gate 2 would prematurely mark the task `status: 'done'` and `gateLabel(3, 'ingest-data')` returned `'Done'` instead of `'Sinh Task & Tạo Ticket'`. Split into its own 3-gate branch (`maxGate = 3`); `gen-doc`/`create-system-requirement` are unaffected.
+
+## [0.2.1] - 2026-08-05
+
+### Added
+
+- **`ingest-data` gained Gate 3 — auto-triggered task proposal & real ticket creation on Backlog/Jira, closing the gap after Gate 2 where the flow used to just stop once an entry landed in `AK-Docs/01.QnA/`.** Implements "Vấn đề 5" in `docs/internal/PM Workflow_v1.0.md`, decided to run **automatically** right after Gate 2 (not on-demand as the doc's earlier tentative proposal had it):
+  - AI re-reads the entry just ingested plus related source code/docs to judge impact, then decides whether it needs a task at all — pure-reference content (FYI, status update) ends the gate with no task proposed, no ticket created.
+  - When action is needed, proposes a task list (`type`: spec/coding/test/other, `title`, `track`, `description` built from the PM Workflow §6.1 template — spec-type tasks additionally require a PM-supplied "Nguồn tham chiếu" link, never inferred). The user can add/edit/remove tasks directly during review — not just approve/reject the whole list — before the single explicit confirmation point ("Danh sách task như trên — đồng ý tạo trên Backlog/Jira?", never auto-`--yes`'d).
+  - New `scripts/ticket-writer.js` — `ak tasks create-tickets <file>.json [--json]` posts the approved list as real Backlog/Jira issues. `scripts/link-resolver.js` gained the write-side API calls it needed (`createBacklogIssue`, `createJiraIssue`, `fetchBacklogIssueTypes`, `fetchBacklogPriorities`) plus a generic `httpsPost` helper (form-encoded for Backlog, JSON for Jira) — the existing `httpsGet`-only file had no POST capability before this.
+  - **Deliberately separate WRITE credentials** (`BACKLOG_API_KEY_WRITE` / `JIRA_API_TOKEN_WRITE`) from the read-only keys `ak fetch-links`/`ak use` already rely on, per the PM Workflow doc's policy of never letting the read key create tickets. When missing, `ak tasks create-tickets` returns a structured `{"error":"missing-write-credentials", field, message}` instead of failing silently — the AI surfaces this in chat, asks the user to paste the key, saves it via the new `ak credentials set <key> <value>` (allowlisted to the keys this feature introduced — dedicated adapter credentials still go through `ak init --adapter`), and retries once.
+  - Project-id resolution reuses the existing `BACKLOG_DEFAULT_PROJECT_ID`/`ak backlog-projects`/`ak backlog-set-default-project` pattern; added the Jira equivalents (`ak jira-projects`, `ak jira-set-default-project`, `fetchJiraProjects` in `scripts/use.js`) so both adapters check local config before ever prompting.
+  - Approved tickets get their link written back into the originating `Meetings-Log`/`QnA-Log`/`Confirmations-Log` entry (`→ Tasks created: TICKET-101 (coding), ...`), keeping the traceability chain from PM Workflow §6 intact end-to-end.
+  - **Still open, tracked in the PM Workflow doc's Vấn đề 5 implementation note:** no fixed feedback→task-type rule table (AI still judges per-context); new tickets don't auto-attach `functionId`/labels (Dev/BA/QA still assign on `ak use TICKET-XXX`); Backlog issueType/priority default to the project's first issueType and a "Normal"-named priority unless overridden explicitly in the task JSON.
+
 ## [0.2.0] - 2026-08-04
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@relipa/ai-flow-kit",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.2",
   "description": "All-in-one AI Flow Kit for team development with Claude AI - skills, templates, and MCP adapters",
   "author": "Example Team",
   "publishConfig": {

package/scripts/create-score-excel.js

@@ -24,25 +24,6 @@ function norm(cmd) {
   return ALIAS_MAP[c] || c;
 }
 
-// ── Version helpers ─────────────────────────────────────────────────────────
-const CURRENT_VERSION = '0.1.6';
-
-function parseVersion(v) {
-  if (!v || v === '-' || v === '' || v.toLowerCase() === 'unknown') return null;
-  const core = v.split('-')[0]; // strip prerelease suffix, e.g. 0.1.5-beta.1 -> 0.1.5
-  const parts = core.split('.').map(n => parseInt(n, 10));
-  if (parts.some(n => Number.isNaN(n))) return null;
-  return parts;
-}
-
-function compareVersion(a, b) {
-  for (let i = 0; i < Math.max(a.length, b.length); i++) {
-    const diff = (a[i] || 0) - (b[i] || 0);
-    if (diff !== 0) return diff;
-  }
-  return 0;
-}
-
 // ── Parse log file ─────────────────────────────────────────────────────────
 function parseLog(filePath) {
   const lines = fs.readFileSync(filePath, 'utf-8').split(/\r?\n/);
@@ -58,19 +39,17 @@ function parseLog(filePath) {
     if (!user || user === '-' || user === '') continue;
 
     const timestamp = cols[0] || '';
-    const version = cols[5] || '';
     const command = cols[6] || '';
     const ticket = cols[9] || '';
 
     const date = timestamp.split(' ')[0]; // dd/MM/yyyy
 
     if (!users[user]) {
-      users[user] = { email: user, days: new Set(), events: 0, rawCmds: new Set(), gateCmds: [], versions: new Set() };
+      users[user] = { email: user, days: new Set(), events: 0, rawCmds: new Set(), gateCmds: [] };
     }
     const u = users[user];
     u.events++;
     if (date) u.days.add(date);
-    if (version.trim()) u.versions.add(version.trim());
 
     const cmd = norm(command);
     if (cmd) u.rawCmds.add(cmd);
@@ -151,19 +130,6 @@ const SCORE_LABELS = [
   'Sử dụng thường xuyên workflow',
 ];
 
-// ── Version status for a user ──────────────────────────────────────────────
-function getVersionStatus(u) {
-  const all = [...u.versions];
-  const parsed = all.map(v => ({ raw: v, parts: parseVersion(v) })).filter(v => v.parts);
-  if (parsed.length === 0) {
-    return { status: all.length ? 'unknown' : 'none', latest: null, all };
-  }
-  parsed.sort((a, b) => compareVersion(a.parts, b.parts));
-  const latest = parsed[parsed.length - 1];
-  const isOutdated = compareVersion(latest.parts, parseVersion(CURRENT_VERSION)) < 0;
-  return { status: isOutdated ? 'outdated' : 'ok', latest: latest.raw, all };
-}
-
 // ── Build summary row for each user ───────────────────────────────────────
 function buildRow(email, u) {
   const { events, days, rawCmds, gateCmds } = u;
@@ -232,7 +198,6 @@ function buildRow(email, u) {
     impactLabel: '',
     totalScore: score,
     notes,
-    versionStatus: getVersionStatus(u),
   };
 }
 
@@ -331,78 +296,11 @@ function writeExcel(rows, workbook, sheetLabel, fromLabel, toLabel) {
   return sheet;
 }
 
-// ── Version warning sheet ───────────────────────────────────────────────────
-function writeVersionSheet(workbook, rows) {
-  const sheet = workbook.addWorksheet('Version Warning');
-  sheet.columns = [
-    { key: 'no', width: 5 },
-    { key: 'email', width: 30 },
-    { key: 'status', width: 16 },
-    { key: 'latest', width: 16 },
-    { key: 'allVersions', width: 30 },
-    { key: 'note', width: 50 },
-  ];
-
-  const border = {
-    top: { style: 'thin' }, left: { style: 'thin' },
-    bottom: { style: 'thin' }, right: { style: 'thin' },
-  };
-
-  sheet.addRow([`Cảnh báo phiên bản — Yêu cầu phiên bản hiện tại: ${CURRENT_VERSION}`]);
-  sheet.mergeCells('A1:F1');
-  const title = sheet.getCell('A1');
-  title.font = { bold: true, size: 13, color: { argb: 'FF1F3864' } };
-  title.alignment = { vertical: 'middle', horizontal: 'center' };
-  title.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFD6DCE4' } };
-  sheet.getRow(1).height = 28;
-
-  const HEADERS = ['#', 'Email', 'Trạng thái', 'Phiên bản mới nhất', 'Các phiên bản dùng trong tuần', 'Ghi chú'];
-  const hRow = sheet.addRow(HEADERS);
-  hRow.height = 20;
-  hRow.eachCell(cell => {
-    cell.fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4F81BD' } };
-    cell.font = { bold: true, color: { argb: 'FFFFFFFF' }, size: 11 };
-    cell.alignment = { vertical: 'middle', horizontal: 'center', wrapText: true };
-    cell.border = border;
-  });
-
-  const warnings = rows.filter(row => row.versionStatus.status === 'outdated' || row.versionStatus.status === 'unknown');
-
-  const STATUS_LABEL = { outdated: 'CŨ HƠN', unknown: 'KHÔNG XÁC ĐỊNH', ok: 'OK', none: 'Không có dữ liệu' };
-  const STATUS_COLOR = { outdated: 'FFFFC7CE', unknown: 'FFFFEB9C' };
-
-  warnings.forEach((row, idx) => {
-    const vs = row.versionStatus;
-    const note = vs.status === 'outdated'
-      ? `Đang dùng ${vs.latest}, chưa cập nhật lên ${CURRENT_VERSION}`
-      : 'Không đọc được phiên bản (giá trị "-" hoặc "unknown") — cần kiểm tra lại';
-    const r = sheet.addRow([
-      idx + 1, row.email, STATUS_LABEL[vs.status], vs.latest || '-', vs.all.join(', ') || '-', note,
-    ]);
-    r.height = 20;
-    const fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: STATUS_COLOR[vs.status] || 'FFFFFFFF' } };
-    r.eachCell({ includeEmpty: true }, (cell, col) => {
-      cell.border = border;
-      cell.fill = fill;
-      cell.alignment = (col <= 4)
-        ? { vertical: 'middle', horizontal: 'center' }
-        : { vertical: 'middle', horizontal: 'left', wrapText: false };
-    });
-  });
-
-  sheet.views = [{ state: 'frozen', ySplit: 2 }];
-  sheet.autoFilter = { from: 'A2', to: 'F2' };
-
-  return warnings;
-}
-
 async function writeExcelFile(rows, outputPath, sheetLabel, fromLabel, toLabel) {
   const workbook = new ExcelJS.Workbook();
   writeExcel(rows, workbook, sheetLabel, fromLabel, toLabel);
-  const warnings = writeVersionSheet(workbook, rows);
   await workbook.xlsx.writeFile(outputPath);
-  console.log(`Written: ${outputPath} (${rows.length} users, ${warnings.length} version warning(s))`);
-  return warnings;
+  console.log(`Written: ${outputPath} (${rows.length} users)`);
 }
 
 // ── Canonical user list (fixed order) ─────────────────────────────────────
@@ -437,7 +335,7 @@ const LOG_EMAIL_ALIAS = {
 };
 
 const EMPTY_USER = (email) => ({
-  email, events: 0, days: new Set(), rawCmds: new Set(), gateCmds: [], versions: new Set(),
+  email, events: 0, days: new Set(), rawCmds: new Set(), gateCmds: [],
 });
 
 // ── Main ───────────────────────────────────────────────────────────────────
@@ -471,7 +369,6 @@ const EMPTY_USER = (email) => ({
       u.events += data.events;
       data.days.forEach(d => u.days.add(d));
       data.rawCmds.forEach(c => u.rawCmds.add(c));
-      data.versions.forEach(v => u.versions.add(v));
       u.gateCmds.push(...data.gateCmds);
     }
   }
@@ -482,9 +379,5 @@ const EMPTY_USER = (email) => ({
     return buildRow(email, u);
   });
 
-  const warnings = await writeExcelFile(rows, outputFile, sheetLabel, fromLabel, toLabel);
-  if (warnings.length) {
-    console.log(`\n⚠️  Version warnings (< ${CURRENT_VERSION} or unknown):`);
-    warnings.forEach(w => console.log(`  - ${w.email}: ${w.versionStatus.latest || 'unknown'} (${w.versionStatus.status})`));
-  }
+  await writeExcelFile(rows, outputFile, sheetLabel, fromLabel, toLabel);
 })();

package/scripts/init.js

@@ -2,7 +2,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const os = require('os');
 const chalk = require('chalk');
-const { input, checkbox, confirm } = require('@inquirer/prompts');
+const { input, checkbox, confirm, select } = require('@inquirer/prompts');
 const { syncDocsRepos } = require('./docs-repo');
 const memoryStore = require('./memory-store');
 
@@ -937,6 +937,29 @@ async function setupAdapter(projectDir, adapter) {
         console.log(chalk.green(`✓ Credentials verified successfully`));
     }
 
+    // Backlog: let the user pick a default project for tasks created manually (no ticket to
+    // derive one from otherwise) — kept for later use, e.g. syncing a local task up to Backlog.
+    if (adapter === 'backlog' && verifyResult.ok) {
+        const spaceKey = credentials.BACKLOG_SPACE_KEY;
+        const domain = spaceKey.includes('.') ? spaceKey : `${spaceKey}.backlog.com`;
+        try {
+            const { fetchBacklogProjects } = require('./use');
+            const projects = await fetchBacklogProjects(domain, credentials.BACKLOG_API_KEY);
+            if (projects.length > 0) {
+                const projectId = await select({
+                    message: 'Default Backlog project for tasks created manually (no ticket):',
+                    choices: projects.map((p) => ({ name: `${p.projectKey}  ${p.name}`, value: p.id })),
+                });
+                const picked = projects.find((p) => p.id === projectId);
+                credentials.BACKLOG_DEFAULT_PROJECT_ID = picked.id;
+                credentials.BACKLOG_DEFAULT_PROJECT_KEY = picked.projectKey;
+                console.log(chalk.green(`✓ Default project set to ${picked.projectKey}.`));
+            }
+        } catch (err) {
+            console.log(chalk.gray(`  (Could not fetch Backlog projects to pick a default: ${err.message} — skipping.)`));
+        }
+    }
+
     const claudeConfigDir = path.join(
         process.env.APPDATA ||
         (process.platform === 'darwin'