spec-lite 1.4.5 → 1.4.7

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.7",
   "description": "Spec-driven development kit for Claude Code",
   "type": "module",
   "bin": {

package/skills/ado-config/SKILL.md

@@ -53,16 +53,19 @@ options:
     description: "Cập nhật danh sách PE / SE / DE"
   - label: "Epic ticket"
     description: "Tạo mới hoặc thay Epic ticket đang được lưu"
+  - label: "Area / Iteration path"
+    description: "Cập nhật area_path và iteration_path mặc định cho ticket"
   - label: "Môi trường"
     description: "Cập nhật danh sách environments (dev / stag / prod)"
 ```
 
 Tuỳ theo lựa chọn:
-- **"Toàn bộ từ đầu"** → chạy Bước 2 → 3 → 4 → 5 → 6 → 7
-- **"Thông tin project"** → chỉ chạy Bước 2, bỏ qua Bước 3, 4, 5, nhảy thẳng đến Bước 6 → 7 (giữ nguyên `team`, `epic`, `environments` từ file cũ)
-- **"Team members"** → chỉ chạy Bước 3, bỏ qua Bước 2, 4, 5, nhảy thẳng đến Bước 6 → 7 (giữ nguyên `organization/project`, `epic`, `environments` từ file cũ)
-- **"Epic ticket"** → chỉ chạy Bước 4, bỏ qua Bước 2, 3, 5, nhảy thẳng đến Bước 6 → 7 (giữ nguyên `organization/project`, `team`, `environments` từ file cũ)
-- **"Môi trường"** → chỉ chạy Bước 5, bỏ qua Bước 2, 3, 4, nhảy thẳng đến Bước 6 → 7 (giữ nguyên tất cả từ file cũ)
+- **"Toàn bộ từ đầu"** → chạy Bước 2 → 3 → 4 → 5 → 6 → 7 → 8
+- **"Thông tin project"** → chỉ chạy Bước 2, bỏ qua Bước 3, 4, 5, 6, nhảy thẳng đến Bước 7 → 8 (giữ nguyên `team`, `epic`, `area_path/iteration_path`, `environments` từ file cũ)
+- **"Team members"** → chỉ chạy Bước 3, bỏ qua Bước 2, 4, 5, 6, nhảy thẳng đến Bước 7 → 8 (giữ nguyên `organization/project`, `epic`, `area_path/iteration_path`, `environments` từ file cũ)
+- **"Epic ticket"** → chỉ chạy Bước 4, bỏ qua Bước 2, 3, 5, 6, nhảy thẳng đến Bước 7 → 8 (giữ nguyên `organization/project`, `team`, `area_path/iteration_path`, `environments` từ file cũ)
+- **"Area / Iteration path"** → chỉ chạy Bước 5, bỏ qua Bước 2, 3, 4, 6, nhảy thẳng đến Bước 7 → 8 (giữ nguyên tất cả còn lại từ file cũ)
+- **"Môi trường"** → chỉ chạy Bước 6, bỏ qua Bước 2, 3, 4, 5, nhảy thẳng đến Bước 7 → 8 (giữ nguyên tất cả từ file cũ)
 
 ---
 
@@ -238,7 +241,41 @@ https://dev.azure.com/{organization}/{project_name}/_workitems/edit/{id}
 
 ---
 
-### Bước 5: Cấu hình môi trường
+### Bước 5: Cấu hình Area & Iteration Path
+
+Area Path và Iteration Path mặc định sẽ được gán cho mọi Feature/User Story khi `/ado-create` tạo ticket. Cả hai đều **tùy chọn** — nếu bỏ trống, ADO dùng giá trị mặc định của team.
+
+Hỏi user bằng `AskUserQuestion`:
+
+```
+question: "Cấu hình Area / Iteration path mặc định cho ticket?"
+options:
+  - label: "Nhập area & iteration path"
+    description: "Gán area_path và iteration_path mặc định cho mọi ticket tạo qua /ado-create"
+  - label: "Bỏ qua"
+    description: "Không set — ADO dùng giá trị mặc định của team"
+```
+
+Nếu user chọn **"Nhập area & iteration path"** → hỏi lần lượt (cho phép Enter trống để bỏ từng field):
+
+```
+Area Path (ví dụ: Tickets\Clients\C-GAL\P-GCC):
+> Tickets\Clients\C-GAL\P-GCC
+
+Iteration Path (ví dụ: Tickets\Weekly Sprint):
+> Tickets\Weekly Sprint
+```
+
+Lưu ý khi thu thập:
+- Path dùng dấu backslash `\` phân cách như trên ADO. Chấp nhận cả khi user paste có khoảng trắng ở đầu/cuối → trim.
+- Nếu user nhập area path nhưng không chắc đúng → vẫn lưu nguyên văn, không tự validate qua MCP (tránh fail khi node chưa tồn tại). Validation thực tế sẽ xảy ra lúc `/ado-create` tạo ticket.
+- Field nào để trống → bỏ key tương ứng trong YAML, không ghi `area_path: null`.
+
+Nếu user chọn **"Bỏ qua"** → không thêm `area_path`/`iteration_path` vào config.
+
+---
+
+### Bước 6: Cấu hình môi trường
 
 **Bắt buộc** hỏi user bằng `AskUserQuestion` — không cho phép bỏ qua:
 
@@ -265,7 +302,7 @@ Nếu user chọn "Other" (nhập tay) → parse chuỗi nhập vào (phân các
 
 ---
 
-### Bước 6: Preview và xác nhận
+### Bước 7: Preview và xác nhận
 
 Hiển thị preview YAML sẽ được ghi — **chưa ghi file**:
 
@@ -287,6 +324,9 @@ team:
   DE:
     - d@atstechnology.vn
 
+area_path: 'Tickets\Clients\C-GAL\P-GCC'
+iteration_path: 'Tickets\Weekly Sprint'
+
 epic:
   id: 42
   title: "[GAL-GCC] Spec Lite Kit"
@@ -304,11 +344,13 @@ Nếu user yêu cầu chỉnh sửa → cập nhật preview → hỏi lại.
 
 Nếu user bỏ qua bước Epic (không muốn cấu hình ngay) → bỏ qua key `epic` trong YAML, không ghi `epic: null`.
 
-**Bước 5 (môi trường) là bắt buộc** — không cho phép bỏ qua. Nếu user chưa chọn, nhắc lại trước khi tiếp tục.
+Nếu user bỏ qua Area/Iteration (Bước 5) → bỏ qua key `area_path`/`iteration_path` tương ứng, không ghi giá trị `null`.
+
+**Bước 6 (môi trường) là bắt buộc** — không cho phép bỏ qua. Nếu user chưa chọn, nhắc lại trước khi tiếp tục.
 
 ---
 
-### Bước 7: Ghi file
+### Bước 8: Ghi file
 
 Ghi nội dung đã confirm vào `.claude/ado.yaml`.
 
@@ -345,5 +387,6 @@ Trước khi ghi file, kiểm tra:
 - [ ] `team.PE` có ít nhất 1 email — không được để trống
 - [ ] SE và DE có thể là array rỗng `[]`
 - [ ] Nếu có Epic: `epic.id` là số nguyên, `epic.title` có prefix `[{project_code}]`, `epic.url` là full URL dạng `https://dev.azure.com/{org}/{project_name}/_workitems/edit/{id}`
+- [ ] Nếu có `area_path` / `iteration_path`: là chuỗi đã trim, giữ nguyên dấu `\` (dùng YAML single-quote để tránh escape); bỏ qua key nếu user không nhập — không ghi `null`
 - [ ] `environments` là array ít nhất 1 phần tử (bắt buộc), mỗi phần tử là lowercase string không có khoảng trắng, luôn có `prod` ở cuối
 - [ ] User đã confirm preview trước khi ghi file

package/skills/ado-create/SKILL.md

@@ -14,6 +14,8 @@ description: Tạo Feature và User Story tickets trên ADO từ spec.md của m
 - `.claude/ado.yaml` phải tồn tại và có `epic.id` (chạy `/ado-config` nếu chưa có)
 - `frd.md` tương ứng phải tồn tại trong `.specs/main/features/` cho mỗi feature
 
+**Area / Iteration (tùy chọn):** Nếu `.claude/ado.yaml` có `area_path` và/hoặc `iteration_path`, mọi ticket (Feature + User Story) tạo ở Bước 5 và Bước 6 phải set `areaPath` / `iterationPath` tương ứng. Nếu không khai báo → để ADO dùng giá trị mặc định của team.
+
 ---
 
 ## Process
@@ -131,6 +133,8 @@ Gọi `mcp__azure-devops__wit_create_work_item` với:
 - `title`: `[{project_code}] [{feature_id}] {feature_name}` — ví dụ: `[SDLC-TEST] [F-001] Đăng ký / Đăng nhập`
 - `description`: toàn bộ nội dung `frd.md` (giữ nguyên format Markdown)
 - `assignedTo`: ADO identity ID của current user (nếu resolve thành công)
+- `areaPath`: giá trị `area_path` từ ado.yaml (nếu có)
+- `iterationPath`: giá trị `iteration_path` từ ado.yaml (nếu có)
 
 Sau khi tạo thành công → **ngay lập tức** link parent. Ưu tiên dùng `mcp__azure-devops__wit_add_child_work_items` (parent = Epic ID, child = Feature ticket ID). Nếu tool này không khả dụng, fallback sang `mcp__azure-devops__wit_work_items_link` với:
 - `sourceId`: Feature ticket ID vừa tạo
@@ -186,6 +190,8 @@ Gọi `mcp__azure-devops__wit_create_work_item` với:
 - `title`: `[{project_code}] [{feature_name}] - {US-code} — {story_title}` — ví dụ: `[SDLC-TEST] [Đăng ký / Đăng nhập] - US-F001-001 — Đăng ký`
 - `description`: description đã build ở 6.2
 - `assignedTo`: ADO identity ID của current user
+- `areaPath`: giá trị `area_path` từ ado.yaml (nếu có)
+- `iterationPath`: giá trị `iteration_path` từ ado.yaml (nếu có)
 
 Sau khi tạo thành công → **ngay lập tức** link parent. Ưu tiên dùng `mcp__azure-devops__wit_add_child_work_items` (parent = Feature ticket ID, child = User Story ticket ID). Nếu không khả dụng, fallback sang `mcp__azure-devops__wit_work_items_link` với:
 - `sourceId`: User Story ticket ID vừa tạo

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

@@ -18,7 +18,7 @@ Skill này là cặp greenfield đối xứng với `/spec-brownfield-feature` (
 2. **CREATE-only** — frd.md đã tồn tại → DỪNG, redirect `/spec-new` để phân tích delta + cascade + downstream (tech/test) (Bước 1c).
 
 **Phạm vi hẹp — chủ yếu frd.md:**
-- ✅ Author frd.md (7 sections) cho **một** feature **chưa có frd**.
+- ✅ Author frd.md (7 core sections + `Open Questions` tùy chọn) cho **một** feature **chưa có frd**.
 - ✅ *Reference* component frd phụ thuộc (Components Used) + ghi component cần-nhưng-chưa-có như **candidate**.
 - ✅ Nếu feature mục tiêu là feature mới chưa có trong Index → **register một row vào `prd.md > Features`** (side-effect hợp lệ lên prd).
 - ✅ **Cascade vocabulary lên `domain.md`** (Bước 4b — pha *mô tả hệ thống*/WHAT): glossary term + **định nghĩa entity đầy đủ** (attributes). `Owner` của entity để `TBD` cho `/spec-sad` điền ở pha *thiết kế hệ thống* (HOW). BA duyệt trước khi ghi. Đây là điểm khác với phiên bản trước (`/spec-frd` từng không đụng domain) — vocabulary sinh ra ở feature-authoring time nên seed luôn, thay vì để domain rỗng tới integration đầu tiên.
@@ -171,6 +171,8 @@ Hỏi tuần tự, từng phần — không hỏi tất cả cùng lúc. Nếu B
 
 Câu trả lời vague → hỏi lại để làm rõ (ngưỡng đo được, field cụ thể, nhánh xử lý).
 
+**Open Questions — gom trong lúc interview.** Điểm nào BA chưa chốt được ngay (chờ stakeholder, phụ thuộc quyết định khác, ngưỡng/nhánh chưa rõ) → KHÔNG đoán bừa vào AC/VR. Ghi lại thành một mục trong `## Open Questions` của draft (kèm ai trả lời / khi nào), rồi tiếp tục các phần còn lại. Section này gom cả component candidate (Bước 4) lẫn câu hỏi clarify từ interview; rỗng thì xóa khi save.
+
 ---
 
 ### Bước 4: Xử lý component (mức reference + candidate)
@@ -204,6 +206,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.
@@ -224,6 +227,7 @@ Dùng `.claude/templates/main/feature/frd-template.md` làm skeleton, điền n
 
 Hiển thị **toàn bộ draft** cho user — chưa ghi file. Kèm:
 - danh sách component candidate (nếu có) và VR còn `TBD`;
+- **Open Questions** còn mở (câu hỏi clarify + component candidate) để BA xác nhận hoặc giải quyết trước khi save;
 - **danh sách domain vocabulary đề xuất** (Bước 4b): glossary term mới + định nghĩa shared entity (`Owner: TBD`), để BA duyệt trước khi cascade lên `domain.md`.
 
 #### Verification Rules — quy ước sinh
@@ -287,7 +291,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 +301,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]`.
@@ -343,6 +347,7 @@ Bước tiếp theo:
 - frd dùng từ không đo được trong AC ("hoạt động đúng", "nhanh", "đẹp")
 - User Stories không có persona rõ hoặc không có AC
 - Verification Rules tự điền mà chưa hỏi BA
+- Đoán bừa vào AC/VR thay vì ghi điểm chưa chốt vào Open Questions
 - Tạo crd.md/cdd.md (vượt phạm vi — đó là integration time)
 - Component candidate không được surface cho architect
 - **Update frd đã tồn tại** thay vì redirect `/spec-new` (vi phạm CREATE-only)
@@ -354,7 +359,7 @@ Bước tiếp theo:
 - [ ] **Single-feature gate**: nguồn liên quan đúng 1 feature; nếu >1 đã DỪNG và mô tả rõ lý do tách + redirect `/spec-prd`
 - [ ] **Create-only gate**: frd.md của feature mục tiêu CHƯA tồn tại; nếu đã có đã redirect `/spec-new`
 - [ ] Feature mục tiêu có trong Index, HOẶC feature mới đơn lẻ đã được user đồng ý register (Bước 1b)
-- [ ] frd.md có đủ 7 sections (luôn create mới)
+- [ ] frd.md có đủ 7 core sections (luôn create mới); `Open Questions` chứa câu hỏi clarify + component candidate còn mở, hoặc đã xóa nếu rỗng
 - [ ] Mỗi User Story có persona + priority + ít nhất 1 AC Given/When/Then
 - [ ] Feature AC dùng ID `FAC-F{NNN}-{seq}` (counter độc lập với `AC-F{NNN}`), Then đo được
 - [ ] Verification Rules đã confirm với BA (không tự assert); không chứa regex/code/error message; semantic type

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/skills-overview.md

@@ -550,6 +550,7 @@ Tạo hoặc cập nhật `.claude/ado.yaml` — file config ADO dùng chung cho
 - Thông tin project
 - Team members
 - Epic ticket
+- Area / Iteration path
 - Môi trường
 
 **Bước 2 — Project:**
@@ -561,7 +562,9 @@ Tạo hoặc cập nhật `.claude/ado.yaml` — file config ADO dùng chung cho
 
 **Bước 4 — Epic Ticket:** Tạo Epic mới qua MCP (title được prefix `[{project_code}]`, assignee là PE đầu tiên) hoặc nhập ID ticket có sẵn (validate qua MCP: phải là type `Epic`). Lưu `id`, `title`, `url` vào config.
 
-**Bước 5 — Environments:** Collect danh sách môi trường (dev / stag / prod).
+**Bước 5 — Area / Iteration Path:** (tùy chọn) Collect `area_path` và `iteration_path` mặc định cho ticket. Bỏ qua nếu user không nhập → ADO dùng giá trị mặc định của team.
+
+**Bước 6 — Environments:** Collect danh sách môi trường (dev / stag / prod).
 
 **Cuối:** Ghi `.claude/ado.yaml`, đảm bảo file không bị ignore bởi `.gitignore` (thêm `!.claude/ado.yaml` nếu `.claude/` đang bị ignore).
 
@@ -581,7 +584,7 @@ Tạo hoặc cập nhật `.claude/ado.yaml` — file config ADO dùng chung cho
 
 **Bước 4 — Preview:** Hiển thị kế hoạch đầy đủ (Feature và User Story sẽ tạo, skip list) trước khi tạo bất kỳ ticket nào. Chờ user confirm.
 
-**Bước 5-6 — Tạo tickets:**
+**Bước 5-6 — Tạo tickets:** (set `areaPath`/`iterationPath` từ `ado.yaml` nếu có)
 - Feature ticket: type `Feature`, title `[{project_code}] [{feature_id}] {feature_name}`, description từ `frd.md`. Link parent → Epic ngay sau khi tạo.
 - User Story ticket: type `User Story`, title `[{project_code}] [{feature_name}] - {US-code} — {story_title}`, description gồm câu story + ACs. Link parent → Feature ngay sau khi tạo.
 - Nếu link parent fail → retry 1 lần → nếu vẫn fail: đánh dấu `orphan` (KHÔNG xóa ticket), báo cáo cuối.

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)*
 

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

@@ -155,6 +155,13 @@ Tham chiếu đến `.specs/main/component/{C-XXX}-...`.
 | --- | --- |
 | `{C-XXX}-{component-name}` | {component này phục vụ cái gì cho feature này} |
 
+## Open Questions
+
+<!-- Các câu hỏi cần làm rõ trong interview / với stakeholder trước khi proceed.
+     Cũng dùng để note component candidate chưa carve (xem skills/spec-frd). Xóa section nếu không còn câu hỏi nào. -->
+
+- [ ] {câu hỏi cần clarify} — {ai trả lời / khi nào}
+
 ## Change History
 
 Append-only log của các thay đổi cascade lên artifact này. Quy ước xem `conventions.md` §5.5.