spec-lite 1.1.4 → 1.1.5

package/package.json

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

package/skills/spec-brownfield-feature/SKILL.md

@@ -95,7 +95,16 @@ Sau khi confirm, assign F-XXX IDs theo thứ tự tăng dần.
 
 ### Bước 4: Scan sâu từng feature
 
-**4a. User stories — infer từ:**
+**4a. User flows — infer từ:**
+- Test file chains nhiều request liên tiếp → detect luồng thao tác có thứ tự
+- Navigation / router config trong UI code (`steps`, `wizard`, `onNext`) → detect bước chuyển màn
+- State machine hoặc status enum (`pending → processing → done`) → detect nhánh edge case
+- Error handling branches trong use case → detect luồng thất bại
+
+Đánh dấu source: `(inferred from tests)` hoặc `(inferred from UI navigation)`.
+Nếu không detect được → User Flows section sẽ là NEEDS_CLARIFY.
+
+**4b. User stories — infer từ:**
 - Use case class names và public methods → action descriptions
 - Route names + HTTP methods → "As a user, I want to POST /auth/register..."
 - Test `describe` / `it` blocks → `it('should register a new user', ...)` → user story
@@ -149,11 +158,13 @@ Với mỗi feature, generate 2 files dùng templates tương ứng:
 
 **`frd.md`** — WHAT (dùng `.claude/templates/main/feature/frd-template.md`):
 - Description và business goal (infer từ feature name + use case, NEEDS_CLARIFY nếu không rõ)
+- User flows: Mermaid flowchart cho happy case và edge cases (infer từ test chains / UI navigation, NEEDS_CLARIFY nếu không detect được)
 - User stories (đánh dấu source)
 - Acceptance criteria (extract từ tests nếu có, NEEDS_CLARIFY nếu không)
 - Scope: In scope từ detected routes/actions; Out of scope → NEEDS_CLARIFY
-- Components consumed: list C-XXX từ Component Index
-- Dependencies: feature-to-feature dependencies nếu detect được
+- Dependencies:
+  - Feature Dependencies: feature-to-feature dependencies nếu detect được
+  - Components Used: list C-XXX từ Component Index (infer từ import statements)
 
 **`fdd.md`** — HOW / inter-component (dùng `.claude/templates/main/feature/fdd-template.md`):
 - Inter-component data flow: sequence diagram từ detected call chain (Mermaid hoặc ASCII)

package/skills/spec-new/SKILL.md

@@ -65,10 +65,11 @@ frd.md — F-001 Authentication đã tồn tại.
 Sections hiện có:
 
   [1] Overview
-  [2] Feature-level Acceptance Criteria
-  [3] User Stories
-  [4] Scope (In Scope / Out of Scope)
-  [5] Dependencies
+  [2] User Flows
+  [3] Feature-level Acceptance Criteria
+  [4] User Stories
+  [5] Scope (In Scope / Out of Scope)
+  [6] Dependencies (Feature Dependencies + Components Used)
   [A] All — viết lại toàn bộ từ đầu
   [S] Lên spec từ frd.md hiện tại — frd.md đã đầy đủ, không cần chỉnh
 
@@ -223,11 +224,11 @@ frd.md — F-001 Authentication đã tồn tại.
 Sections hiện có:
 
   [1] Overview
-  [2] Components Consumed
+  [2] User Flows
   [3] Feature-level Acceptance Criteria
   [4] User Stories
   [5] Scope (In Scope / Out of Scope)
-  [6] Dependencies
+  [6] Dependencies (Feature Dependencies + Components Used)
   [A] All — viết lại toàn bộ từ đầu
 
 Chọn section cần cập nhật (có thể chọn nhiều, ví dụ: 2 3):

package/templates/main/feature/frd-template.md

@@ -15,13 +15,29 @@ referenced_by:
 
 {Mô tả feature này giải quyết vấn đề gì cho user nào, trong 2-3 câu.}
 
-## Components Consumed
+## User Flows
 
-Các component mà feature này dùng — tham chiếu đến `specs/main/component/{C-XXX}-...`.
+{Mô tả các luồng thao tác của user để hoàn thành mục tiêu của feature này.}
+{Mỗi flow là một Mermaid flowchart riêng, bao gồm happy case và tất cả edge cases quan trọng.}
 
-| Component | Vai trò trong feature |
-| --- | --- |
-| `{C-XXX}-{component-name}` | {component này phục vụ cái gì cho feature này} |
+### Flow 1: {Tên luồng chính}
+
+```mermaid
+flowchart TD
+    A([{Điểm bắt đầu}]) --> B[{Bước 1}]
+    B --> C{Điều kiện?}
+    C -- Happy case --> D[{Bước 2 — thành công}]
+    C -- Edge case --> E[{Xử lý lỗi / nhánh phụ}]
+    D --> F([{Kết thúc thành công}])
+    E --> G([{Kết thúc thất bại / fallback}])
+```
+
+### Flow 2: {Tên luồng phụ / edge case lớn} *(nếu có)*
+
+```mermaid
+flowchart TD
+    A([{Điểm bắt đầu}]) --> B[{...}]
+```
 
 ## Feature-level Acceptance Criteria
 
@@ -83,6 +99,16 @@ US ID format: `US-F{NNN}-{seq}` — đánh số tăng dần toàn feature.
 
 ## Dependencies
 
+### Feature Dependencies
+
 | Feature | Loại | Ghi chú |
 | --- | --- | --- |
 | {feature-name} | required before / parallel | {lý do} |
+
+### Components Used
+
+Tham chiếu đến `specs/main/component/{C-XXX}-...`.
+
+| Component | Vai trò trong feature |
+| --- | --- |
+| `{C-XXX}-{component-name}` | {component này phục vụ cái gì cho feature này} |