spec-lite 1.1.3 → 1.1.5

package/package.json

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

package/skills/build/SKILL.md

@@ -38,7 +38,25 @@ Chọn số integration:
   - Nếu chỉ có 1 integration có task pending → chọn luôn, không hỏi
   - Nếu tất cả đều done → thông báo: "Tất cả integration đã hoàn thành."
 
-### Bước 0b: Chọn chế độ worktree (tùy chọn)
+### Bước 0b: Tạo branch và chọn chế độ worktree
+
+**Tạo branch (bắt buộc):**
+
+Luôn tạo branch `build/{integration-slug}` trước khi build, bất kể có dùng worktree hay không. Điều này đảm bảo `/review` luôn có base để diff chính xác.
+
+```bash
+git checkout -b feat/{slug}
+```
+
+Nếu branch đã tồn tại → checkout branch cũ:
+
+```bash
+git checkout feat/{slug}
+```
+
+---
+
+**Chọn worktree (tùy chọn):**
 
 Hỏi user:
 
@@ -46,18 +64,16 @@ Hỏi user:
 Bạn muốn build trong worktree riêng cho integration này không? (y/n)
 ```
 
-**Nếu chọn "n":** Tiếp tục build trong working directory hiện tại.
+**Nếu chọn "n":** Tiếp tục build trong working directory hiện tại trên branch vừa tạo.
 
 **Nếu chọn "y":**
 
-1. **Tạo worktree mới**
-   - Tên branch: `build/{integration-slug}` (ví dụ: `build/002-implement-todo`)
+1. **Tạo worktree mới** từ branch vừa tạo
    - Đường dẫn worktree: `../{repo-name}-{integration-slug}` (ví dụ: `../myapp-002-implement-todo`)
    - Lệnh:
      ```bash
-     git worktree add -b build/{slug} ../{repo}-{slug}
+     git worktree add ../{repo}-{slug} feat/{slug}
      ```
-   - Nếu branch đã tồn tại, dùng `--force` hoặc checkout branch cũ.
 
 2. **Detect package manager**
    - Kiểm tra theo thứ tự: `pnpm-lock.yaml` → `yarn.lock` → `package-lock.json` → `package.json`
@@ -152,3 +168,13 @@ Invoke `debugging-and-error-recovery`:
 - [ ] Mỗi task có atomic commit riêng
 - [ ] Tất cả task đánh dấu `[x]` trong `todo.md`
 - [ ] Không còn uncommitted changes
+
+## Sau khi hoàn thành
+
+Khi tất cả task trong session này đã done, thông báo:
+
+```
+Tất cả task đã hoàn thành. Bước tiếp theo: chạy /review để kiểm tra toàn bộ implementation trước khi merge.
+```
+
+Không tự động invoke `/review` — để user chủ động gọi.

package/skills/review/SKILL.md

@@ -16,7 +16,12 @@ Trước khi bắt đầu review, load context từ working integration:
 3. `specs/integrations/{slug}/plan.md` — task breakdown và acceptance criteria chi tiết
 4. `specs/integrations/{slug}/todo.md` — task nào đã được implement (`[x]`)
 
-Chạy `git diff main...HEAD` để lấy thay đổi cần review.
+Chạy lệnh sau để lấy thay đổi cần review — diff từ điểm branch tách ra, không phải từ tip của base branch:
+
+```bash
+BASE=$(git rev-parse --abbrev-ref @{upstream} 2>/dev/null | sed 's|origin/||' || echo main)
+git diff $(git merge-base HEAD $BASE)...HEAD
+```
 
 ## Xác định integration
 

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