spec-lite 1.4.5 → 1.4.6

package/README.md

@@ -7,7 +7,7 @@ Bộ skills spec-driven development cho Claude Code — phỏng vấn có cấu
 ## Cài đặt
 
 ```bash
-npx spec-lite install
+npx spec-lite@latest install
 ```
 
 Lệnh này copy `skills/` và `templates/` vào thư mục `.claude/` của project.

package/package.json

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

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

@@ -191,14 +191,14 @@ Các entities sau được dùng bởi nhiều components.
 Apply cascade proposals vào domain.md? [y/n/edit]
 ```
 
-Nếu `y` → update `.specs/main/domain.md` Shared Entities section, đồng thời append entry vào `## Change History` của domain.md (theo `conventions.md` §5.5):
+Nếu `y` → update `.specs/main/domain.md` Shared Entities section — mỗi entity [NEW] dùng heading `### E-XXX {Entity Name}`, cấp ID tuần tự theo quy ước `domain-template.md` (max E-XXX đã từng cấp trong `domain.md` + 1, quét cả heading lẫn Change History; ID không tái sử dụng) — đồng thời append entry vào `## Change History` của domain.md (theo `conventions.md` §5.5):
 
 ```markdown
 ### {YYYY-MM-DD} — manual — update
 
 - **Shared Entities**:
-  - [NEW] Order — owner C-003-payment, used by inventory (detected từ /spec-brownfield-component scan)
-  - [NEW] User — owner C-001-auth, used by user/notification
+  - [NEW] E-001 Order — owner C-003-payment, used by inventory (detected từ /spec-brownfield-component scan)
+  - [NEW] E-002 User — owner C-001-auth, used by user/notification
 ```
 
 Nếu `edit` → hỏi chỉnh sửa từng entity trước khi apply.

package/skills/spec-frd/SKILL.md

@@ -204,6 +204,7 @@ Cấm: định nghĩa mơ hồ, hoặc nhét term thực ra là tên feature/com
 - **Entity *nằm ở component nào* (`Owner`) là *thiết kế hệ thống* (HOW)** → thuộc architect, điền ở `/spec-sad` (hoặc `/spec-new` khi carve). `/spec-frd` **không carve component** nên **không** quyết `Owner`.
 
 Vì vậy khi seed entity vào domain Shared Entities:
+- **Cấp Entity ID `E-XXX`** theo quy ước của `domain-template.md`: ID tiếp theo = max ID đã từng cấp trong `domain.md` + 1 (quét cả heading hiện có lẫn Change History — ID của entity đã remove không tái sử dụng). Heading entity: `### E-XXX {Entity Name}`.
 - Điền đầy đủ definition + attributes từ frd.
 - Để **`Owner: TBD (điền ở /spec-sad — design time)`** và **`Used by: TBD`**. Không phải vì entity "chưa chắc có thật", mà vì ownership là quyết định thiết kế chưa tới lượt.
 - Entity rõ ràng chỉ là cấu trúc dữ liệu kỹ thuật nội bộ (không phải vocabulary nghiệp vụ) → không thuộc domain; bỏ qua, để lộ ra ở `crd.md` lúc carve.
@@ -287,7 +288,7 @@ Và append Change History entry vào prd.md (theo `conventions.md` §5.5):
 **7b''. (Chỉ khi Bước 4b/6 BA đã confirm vocabulary)** Cascade lên `.specs/main/domain.md`:
 
 - **Glossary** → append row `[NEW]` cho mỗi term đã confirm: `| {term} | {định nghĩa} | {example/context} |`.
-- **Shared Entities** → cho mỗi entity đã confirm, thêm một entry mới theo template với definition + attributes đầy đủ, để `**Owner:** TBD (điền ở /spec-sad — design time)` và `**Used by:** TBD`.
+- **Shared Entities** → cho mỗi entity đã confirm, thêm một entry mới theo template với heading `### E-XXX {Entity Name}` (ID cấp ở Bước 4b — tuần tự, không tái sử dụng), definition + attributes đầy đủ, để `**Owner:** TBD (điền ở /spec-sad — design time)` và `**Used by:** TBD`. Trong frd, reference entity theo dạng `E-XXX {Entity Name}` để trace về domain.md.
 
 Append **một** Change History entry vào `domain.md`, operation = `manual` (author trực tiếp ngoài integration — cùng quy ước với 7b, theo `conventions.md` §5.5):
 
@@ -297,7 +298,7 @@ Append **một** Change History entry vào `domain.md`, operation = `manual` (au
 - **Glossary**:
   - [NEW] {term} — {mô tả ngắn} (qua /spec-frd F-XXX)
 - **Shared Entities**:
-  - [NEW] {Entity} — định nghĩa + attributes; Owner TBD chờ /spec-sad (qua /spec-frd F-XXX)
+  - [NEW] E-XXX {Entity} — định nghĩa + attributes; Owner TBD chờ /spec-sad (qua /spec-frd F-XXX)
 ```
 
 (Nếu domain.md đang là skeleton create lần đầu thì entry vẫn `manual`/`update` — file đã được `/spec-prd` scaffold với operation `create` từ trước.) Atomic với 7a: domain cascade fail → rollback cả frd. `Owner` của entity do `/spec-sad`/`/spec-new` cascade bổ sung sau (HOW phase) qua `[MODIFY Owner]`.

package/skills/spec-new/SKILL.md

@@ -258,9 +258,10 @@ Tạo block nếu integration:
 
 Tạo block nếu integration:
 - Giới thiệu glossary term mới → row [NEW] trong Glossary
-- Giới thiệu shared entity mới (entity sẽ được dùng bởi 2+ component) → entity [NEW] với `Owner: C-XXX` (component đã carve trong integration này); component chưa carve → `Owner: TBD`, `/spec-sad` gán sau (xem two-phase cascade `conventions.md` §5.5)
-- Gán owner cho entity còn `Owner: TBD` (do pha mô tả seed) → entity [MODIFY Owner] `TBD → C-XXX`
-- Sửa định nghĩa entity hiện có → entity [MODIFY ...]
+- Giới thiệu shared entity mới (entity sẽ được dùng bởi 2+ component) → entity [NEW] với heading `### E-XXX {Entity Name}` (auto-pick `E-XXX` next available — quy ước `domain-template.md`: max ID đã từng cấp trong `domain.md` + 1, quét cả heading lẫn Change History; ID không tái sử dụng) và `Owner: C-XXX` (component đã carve trong integration này); component chưa carve → `Owner: TBD`, `/spec-sad` gán sau (xem two-phase cascade `conventions.md` §5.5)
+- Gán owner cho entity còn `Owner: TBD` (do pha mô tả seed) → entity [MODIFY Owner] `TBD → C-XXX` (giữ nguyên `E-XXX`)
+- Sửa định nghĩa entity hiện có → entity [MODIFY ...] (giữ nguyên `E-XXX`)
+- Remove entity → [REMOVE] kèm lý do — ID của entity đã remove vẫn giữ chỗ, không cấp lại
 
 **`sad.md`**
 

package/skills/spec-remove/SKILL.md

@@ -428,7 +428,7 @@ Component shared (vẫn còn feature khác dùng):
 - {term} [REMOVE] — unique to F-XXX, no other reference
 
 #### Shared Entities
-- {Entity} [REMOVE] — orphan after F-XXX removal, no other component owns
+- E-XXX {Entity} [REMOVE] — orphan after F-XXX removal, no other component owns. ID `E-XXX` của entity đã remove **vẫn giữ chỗ** (ghi trong Change History) — không bao giờ cấp lại cho entity mới (quy ước `domain-template.md`)
 
 ## Out of Scope
 - {Migration của reverse-dep features tới alternative — separate integration nếu có}

package/skills/spec-tech/SKILL.md

@@ -154,8 +154,8 @@ Tổng hợp và viết draft `tech.md`:
 ### domain.md
 
 Đề xuất cập nhật nếu integration này:
-- Thay đổi shared entity (entity được dùng bởi 2+ component)
-- Thêm shared entity mới phát sinh từ thiết kế kỹ thuật
+- Thay đổi shared entity (entity được dùng bởi 2+ component) — giữ nguyên `E-XXX` đã cấp
+- Thêm shared entity mới phát sinh từ thiết kế kỹ thuật — heading `### E-XXX {Entity Name}`, cấp ID theo quy ước `domain-template.md`: max E-XXX đã từng cấp trong `domain.md` + 1 (quét cả heading lẫn Change History); ID không tái sử dụng
 
 ### component/{C-XXX}-{component-name}/cdd.md
 

package/templates/integrations/spec-template.md

@@ -119,7 +119,7 @@ Thường là update — thêm glossary term, thêm shared entity, sửa entity
 - Row [NEW]: `Refund — số tiền hoàn lại cho user sau khi order bị hủy`
 
 #### Shared Entities
-- Entity [NEW]: `Refund (Owner: C-005-refund-processor)` — { fields, relationships }
+- Entity [NEW]: `E-XXX Refund (Owner: C-005-refund-processor)` — { fields, relationships } — E-XXX = next available trong domain.md (tuần tự theo thứ tự seed, không tái sử dụng — xem domain-template.md)
 -->
 
 ### sad.md *(bỏ nếu không có thay đổi)*

package/templates/main/domain-template.md

@@ -34,7 +34,12 @@ Entity ở mức vocabulary nghiệp vụ chung. Hai phần thông tin tới t
 
 Entity rõ ràng nội bộ một component (không phải vocabulary chung) không vào đây — chúng nằm trong `crd.md` của component đó.
 
-### {Entity Name}
+**Entity ID (`E-XXX`):** mỗi shared entity được cấp một ID tuần tự khi seed lần đầu, theo thứ tự được thêm vào file này.
+- ID tiếp theo = **max ID đã từng cấp + 1** — quét cả heading hiện có **và** Change History (entity đã `[REMOVE]` vẫn giữ chỗ ID của nó).
+- ID **không bao giờ tái sử dụng** và **không đánh lại** khi entity bị remove hoặc đổi tên.
+- Reference từ artifact khác (frd/crd/spec/tech) dùng dạng `E-XXX {Entity Name}`.
+
+### E-XXX {Entity Name}
 
 **Owner:** `{C-XXX}-{component-name}` *(component sở hữu canonical definition; `TBD` nếu chưa carve — `/spec-sad` điền)*