spec-lite 1.3.2 → 1.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-lite",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Spec-driven development kit for Claude Code",
   "type": "module",
   "bin": {

package/skills/spec-frd-update/SKILL.md

@@ -52,7 +52,7 @@ Skill detect từng frd hiện tại thuộc "era" nào và apply vectors tươn
 | **V5 US/AC stability notes** | Section User Stories thiếu chuỗi "ID stable" | Insert 2 dòng note | None |
 | **V6 VR section** | Không có heading `## Verification Rules` | Propose VR table từ User Stories → user approve → insert | Medium |
 | **V7 Components Used location** | Section `## Components Consumed` đứng riêng (era pre-84d7303) | Move xuống `## Dependencies` thành subsection `### Components Used` | Low |
-| **V8 User Flows missing** | Không có heading `## User Flows` (era pre-84d7303) | Derive Mermaid flows từ User Stories → propose → user approve → insert. 1 flow / nhóm US liên quan theo journey logic. | Medium |
+| **V8 User Flows missing** | Không có heading `## User Flows` (era pre-84d7303) | Derive Mermaid flows từ User Stories → propose → user approve → insert. 1 flow / nhóm US liên quan theo journey logic. **Bắt buộc — không có option skip; FRD migration không hoàn tất nếu thiếu User Flows.** | Medium |
 
 ---
 
@@ -260,7 +260,7 @@ Apply? (yes / edit / skip-vr)
 
 ### Bước 6: V8 — Derive User Flows section
 
-**Run nếu V8 detected.** Propose-then-approve giống V6 — model derive draft, user duyệt trước khi ghi.
+**Run nếu V8 detected. Bắt buộc — không có option skip.** Propose-then-approve giống V6 nhưng loop cho tới khi user approve: model derive draft, user duyệt (yes) hoặc trả phản hồi (edit) → model regenerate. FRD migration chỉ hoàn tất khi `## User Flows` đã insert.
 
 #### 6.1 Load minimal context
 - Section `## Overview` của FRD (framing scope + actors).
@@ -305,10 +305,11 @@ Flow 2: Login
   ...
   ```
 
-Apply? (yes / edit / skip-flows)
-  yes         → insert vào frd.md
-  edit        → user góp ý flow nào cần sửa (vd: "Flow 1 thiếu nhánh email đã tồn tại")
-  skip-flows  → giữ FRD không có User Flows section
+Apply? (yes / edit)
+  yes   → insert vào frd.md
+  edit  → user góp ý flow nào cần sửa (vd: "Flow 1 thiếu nhánh email đã tồn tại") → regenerate draft, loop lại
+
+User Flows là **bắt buộc** — không có option skip. Nếu user muốn dừng toàn bộ migration cho feature này, dùng "skip-feature" ở Bước 4 hoặc abort skill (Ctrl-C) trước khi V8 chạy.
 ```
 
 #### 6.4 Insert
@@ -326,6 +327,7 @@ Sau khi apply hết vectors cho một FRD, chạy check:
 - [ ] Story AC vẫn dùng `AC-F{NNN}-` (không bị remap nhầm)
 - [ ] Mermaid blocks không còn pattern `[{...}]`
 - [ ] Có heading `## Verification Rules` (nếu V6 applied)
+- [ ] Có heading `## User Flows` với ít nhất 1 Mermaid flowchart (bắt buộc — nếu V8 detected mà section vẫn vắng thì migration chưa hoàn tất)
 - [ ] VR Rule column không chứa keyword UI copy: "error message", "vui lòng", "hint", "tooltip"
 - [ ] Frontmatter `referenced_by` trỏ tới `3.3 Feature level` (không phải `3.2`)
 
@@ -371,6 +373,7 @@ Append vào [changelogs.md](../../changelogs.md) `## [Unreleased]`:
 - VR Rule column chứa regex `^[a-z]+$` hoặc tech type `varchar(255)` — đó là HOW, sai vị trí.
 - V8 flows auto-apply không qua propose-then-approve → model có thể bịa glue step / sai journey grouping mà BA không kịp catch.
 - V8 flow chứa step không trace được lên US nào (model bịa) → BA reject draft và yêu cầu regenerate.
+- Để FRD không có `## User Flows` sau migration vì "draft chưa ổn" → sai. V8 bắt buộc; nếu draft chưa ổn, dùng `edit` loop cho tới khi approve. FRD không có User Flows = migration chưa hoàn tất.
 - V8 Mermaid block dùng syntax `[{...}]` thay vì `["..."]` — vi phạm V1 convention.
 - Validate fail nhưng skip rollback → file ở trạng thái nửa migrate, khó debug sau.
 - Load conventions.md hoặc source code "for safety" → contamination, tốn context, không cải thiện output.
@@ -378,7 +381,7 @@ Append vào [changelogs.md](../../changelogs.md) `## [Unreleased]`:
 ## Verification
 
 Trước khi mark feature done:
-- [ ] Tất cả vectors detected đã apply (hoặc skip có log lý do)
+- [ ] Tất cả vectors detected đã apply (hoặc skip có log lý do — riêng V8 KHÔNG được skip)
 - [ ] Validate Bước 6 pass
 - [ ] Working tree clean trước khi skill chạy (git status verified) — rollback dùng git, không có file backup
 - [ ] Cascade ID đã re-grep và confirm 0 false-positive