spec-lite 1.4.6 → 1.5.0

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)
@@ -221,10 +223,11 @@ Dùng `.claude/templates/main/feature/frd-template.md` làm skeleton, điền n
 
 **ID assignment** (luôn là create — frd mới): US `US-F{NNN}-001+`, Story AC `AC-F{NNN}-001+`, Feature AC `FAC-F{NNN}-001+` (counter độc lập với Story AC), VR `VR-F{NNN}-001+`. `NNN` = số của F-XXX. Flow đánh số từ 1.
 
-**Frontmatter** frd mới: theo template, `status: draft`, `owner: BA`, `feature_id: F-XXX`.
+**Frontmatter** frd mới: theo template, `status: draft`, `owner: BA`, `feature_id: F-XXX`, `template_version` copy từ `frd-template.md` (xem `conventions.md` §7 — chỉ set lúc CREATE; thay đổi sau qua `/spec-new` không đụng version).
 
 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
@@ -344,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)
@@ -355,7 +359,8 @@ 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
+- [ ] Frontmatter có `template_version` copy từ `frd-template.md`
 - [ ] 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

@@ -343,7 +343,7 @@ Chỉ tiến hành Bước 7 sau khi user confirm. Nếu user yêu cầu chỉnh
 
 Tạo thư mục `.specs/integrations/{NNN}-{slug}/` nếu chưa có.
 
-**[7.1] Ghi spec.md** với status `approved` (không phải `draft` — human đã confirm ở Bước 6 chính là approval). Frontmatter `features` và `components` phải được điền theo những gì đã nhận diện ở Bước 2.
+**[7.1] Ghi spec.md** với status `approved` (không phải `draft` — human đã confirm ở Bước 6 chính là approval). Frontmatter `features` và `components` phải được điền theo những gì đã nhận diện ở Bước 2; `template_version` lấy từ `spec-template.md` (xem `conventions.md` §7).
 
 **[7.2] Auto-apply mỗi Changes block** vào main artifact tương ứng. Thứ tự apply (để tránh forward reference): `prd.md` → `domain.md` → `sad.md` → `component/*/crd.md` → `feature/*/frd.md`.
 
@@ -352,7 +352,7 @@ Cho từng block:
 - **Operation=create:**
   - Tạo file mới tại path tương ứng
   - Nội dung = nội dung của Changes block (theo format của template gốc)
-  - Frontmatter của artifact mới: lấy từ template (status `draft` cho artifact mới — separate lifecycle với spec.md)
+  - Frontmatter của artifact mới: lấy từ template, gồm `template_version` (status `draft` cho artifact mới — separate lifecycle với spec.md). `template_version` chỉ stamp ở operation=create; **operation=update KHÔNG đụng** version của artifact hiện có.
 
 - **Operation=update:**
   - Đọc artifact hiện tại
@@ -443,3 +443,4 @@ Sau khi user confirm (Bước 7):
 - [ ] Auto-apply chạy theo thứ tự prd → domain → sad → crd → frd
 - [ ] Mỗi artifact bị touched có entry mới được append vào `## Change History` (xem `conventions.md` §5.5)
 - [ ] Fail-safe: nếu apply fail thì không ghi spec.md (rollback luôn Change History entries)
+- [ ] Artifact create (spec.md + frd/crd mới) có `template_version` copy từ template; artifact update giữ nguyên version cũ

package/skills/spec-prd/SKILL.md

@@ -279,6 +279,8 @@ Chỉ ghi file sau khi user confirm. Nếu user yêu cầu chỉnh sửa → c
 
 Nếu `domain.md` đã tồn tại với nội dung thực → không đụng tới.
 
+**5b'. Stamp `template_version`:** frontmatter `prd.md` (lúc create) và `domain.md` (lúc scaffold) lấy `template_version` từ template tương ứng (xem `conventions.md` §7 Template Versioning). Lần chạy sau update `prd.md` → giữ nguyên `template_version` hiện có, KHÔNG đụng.
+
 **5c. Append Change History entry** vào mỗi artifact vừa ghi/scaffold (theo `conventions.md` §5.5):
 
 ```markdown
@@ -323,7 +325,7 @@ Bước tiếp theo:
 
 Trước khi kết thúc, kiểm tra:
 
-- [ ] Frontmatter đầy đủ và đúng schema (id, type, version, status, owner, project_name)
+- [ ] Frontmatter đầy đủ và đúng schema (id, type, status, owner, project_name, `template_version`) — `template_version` copy từ template lúc create, update không đụng
 - [ ] Problem Statement từ góc nhìn business, không mention tech stack
 - [ ] Mỗi persona có: tên vai trò, mục tiêu, pain point
 - [ ] Out of Scope có ít nhất 1 item với lý do

package/skills/spec-sad/SKILL.md

@@ -191,7 +191,7 @@ Chỉ ghi file sau khi user confirm. Nếu user yêu cầu chỉnh sửa → c
 
 ### Bước 5: Save
 
-Ghi nội dung đã được confirm vào `.specs/main/sad.md`.
+Ghi nội dung đã được confirm vào `.specs/main/sad.md`. Frontmatter lấy `template_version` từ `sad-template.md` lúc create (xem `conventions.md` §7); lần chạy update sau giữ nguyên, không đụng.
 
 **Change History:** Append entry vào section `## Change History` cuối `sad.md` (theo `conventions.md` §5.5):
 
@@ -246,7 +246,7 @@ Bước tiếp theo:
 
 Trước khi kết thúc, kiểm tra:
 
-- [ ] Frontmatter đầy đủ và đúng schema
+- [ ] Frontmatter đầy đủ và đúng schema (gồm `template_version` copy từ template lúc create; update không đụng)
 - [ ] Architectural Style có lý do gắn với NFRs hoặc constraints
 - [ ] System Overview có diagram + Components table; danh sách C-XXX khớp với `prd.md > Components` (hoặc cả hai cùng rỗng nếu Component Index chưa được điền)
 - [ ] Mỗi tech stack item có lý do chọn rõ ràng

package/skills/spec-tech/SKILL.md

@@ -216,7 +216,7 @@ Chỉ ghi file sau khi user confirm. Nếu user yêu cầu chỉnh sửa → c
 
 ### Bước 6: Save + Auto-cascade
 
-**[6.1] Ghi `.specs/integrations/{slug}/tech.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` và `components` mirror từ `spec.md`.
+**[6.1] Ghi `.specs/integrations/{slug}/tech.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` và `components` mirror từ `spec.md`; `template_version` lấy từ `tech-template.md` (xem `conventions.md` §7).
 
 **[6.2] Auto-apply mỗi Changes block** vào main artifact tương ứng. Thứ tự apply (để tránh forward reference): `sad.md` → `domain.md` → `component/*/cdd.md` → `feature/*/fdd.md`.
 
@@ -225,7 +225,7 @@ Cho từng block:
 - **Operation=create:**
   - Tạo file mới tại path tương ứng
   - Nội dung = nội dung của Changes block (theo format của template gốc — `cdd-template.md` hoặc `fdd-template.md`)
-  - Frontmatter: lấy từ template (status `draft` cho artifact mới — separate lifecycle với tech.md)
+  - Frontmatter: lấy từ template, gồm `template_version` (status `draft` cho artifact mới — separate lifecycle với tech.md). `template_version` chỉ stamp ở operation=create; **operation=update KHÔNG đụng** `template_version` của artifact hiện có.
 
 - **Operation=update:**
   - Đọc artifact hiện tại
@@ -315,3 +315,4 @@ Sau khi user confirm (Bước 6):
 - [ ] Auto-apply chạy theo thứ tự sad → domain → cdd → fdd
 - [ ] Mỗi artifact bị touched có entry mới được append vào `## Change History` (conventions §5.5)
 - [ ] Fail-safe: nếu apply fail thì không ghi tech.md (rollback luôn Change History entries)
+- [ ] Artifact create (tech.md + cdd/fdd mới) có `template_version` copy từ template; artifact update giữ nguyên version cũ

package/skills/spec-test/SKILL.md

@@ -284,7 +284,7 @@ Chỉ tiến hành Bước 6 sau khi QC confirm.
 
 ### Bước 6: Save + Auto-cascade
 
-**[6.1] Ghi `.specs/integrations/{slug}/test.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` mirror từ `spec.md`.
+**[6.1] Ghi `.specs/integrations/{slug}/test.md`** với status `approved` (không phải `draft` — human đã confirm ở Bước 5 chính là approval). Frontmatter `features` mirror từ `spec.md`; `template_version` lấy từ `test-template.md` (xem `conventions.md` §7).
 
 **[6.2] Auto-apply mỗi Changes block** vào `feature/{F-XXX}/tsd.md` tương ứng. Thứ tự apply: theo thứ tự xuất hiện trong frontmatter `features` (deterministic, không có forward reference giữa các feature tsd.md). Bỏ qua feature có operation `no-op` trong Cascade Summary.
 
@@ -293,7 +293,7 @@ Cho từng block:
 - **Operation=create:**
   - Tạo file `.specs/main/feature/{F-XXX}-{slug}/tsd.md`
   - Nội dung = nội dung của Changes block (theo format `templates/main/feature/tsd-template.md`)
-  - Frontmatter của tsd.md mới: status `draft` (separate lifecycle với integration test.md)
+  - Frontmatter của tsd.md mới: status `draft` + `template_version` copy từ `tsd-template.md` (separate lifecycle với integration test.md). Chỉ stamp ở operation=create; **operation=update KHÔNG đụng** version của tsd.md hiện có.
 
 - **Operation=update:**
   - Đọc tsd.md hiện tại
@@ -381,3 +381,4 @@ Sau khi QC confirm (Bước 6):
 - [ ] Mỗi tsd.md bị touched có entry mới trong `## Change History` (conventions §5.5)
 - [ ] Fail-safe: nếu apply fail thì không ghi integration test.md (rollback luôn Change History entries)
 - [ ] Mỗi feature tsd.md mới có status `draft` (separate lifecycle)
+- [ ] test.md + tsd.md create có `template_version` copy từ template; tsd.md update giữ nguyên version cũ

package/skills/spec-tsd/SKILL.md

@@ -183,7 +183,7 @@ Hiển thị draft đầy đủ — chưa ghi file.
 
 ### Bước 6: Save
 
-Ghi `.specs/main/feature/{F-XXX}-{slug}/tsd.md` với status `draft` (feature-level artifact có lifecycle riêng, không phải `approved` — QC còn fill placeholders nên status `draft` cho đến khi đầy đủ).
+Ghi `.specs/main/feature/{F-XXX}-{slug}/tsd.md` với status `draft` (feature-level artifact có lifecycle riêng, không phải `approved` — QC còn fill placeholders nên status `draft` cho đến khi đầy đủ). Frontmatter lấy `template_version` từ `tsd-template.md` (xem `conventions.md` §7).
 
 Nếu overwrite — file backup `tsd.md.bak.{timestamp}` đã tạo ở Bước 2.
 
@@ -238,3 +238,4 @@ Trước khi ghi file:
 - [ ] Priority deterministic theo bảng 4.3
 - [ ] Nếu overwrite: tsd.md.bak.{timestamp} đã được tạo
 - [ ] QC đã confirm draft
+- [ ] Frontmatter có `template_version` copy từ `tsd-template.md`

package/skills-overview.md

@@ -220,34 +220,35 @@ Nhóm skill dọn dẹp / migrate artifacts hiện có sau khi template được
 
 | Command | Reads | Writes |
 | --- | --- | --- |
-| `/spec-frd-update` | `feature/*/frd.md`, `frd-template.md` | `feature/*/frd.md`, cascade: `fdd.md`, `tsd.md`, `integrations/*/spec.md`, `tech.md`, `test.md` |
+| `/artifact-audit [type]` | `.specs/**` artifacts, `.claude/templates/*-template.md` | *(báo cáo; + stamp `template_version` cho artifact legacy conform)* |
+| `/artifact-migrate [path]` | `.specs/**` artifacts, `.claude/templates/*-template.md` (block `migrations`) | artifact được migrate (structure + `template_version`) |
 
-### `/spec-frd-update`
+### `/artifact-audit [type]`
 
-Migrate frd.md hiện có lên format mới nhất của `templates/main/feature/frd-template.md`. Dùng cho repo đã chạy `/spec-brownfield-feature` hoặc `/spec-new` từ trước, frd.md sinh ra theo template cũ.
+Phát hiện artifact lỗi thời so với template (xem `conventions.md` §7 Template Versioning). So `template_version` của artifact với `template_version` đọc thẳng từ template tại `.claude/templates/` — không manifest, không cache.
 
-**8 migration vectors** detect tự động:
+**Scope:** argument là 1 type (`/artifact-audit frd`) hoặc list (`frd,spec`); không có arg → audit mọi type. Type resolve theo **filename** (integration artifact không có field `type`).
 
-| Vector | Action | Risk |
-|---|---|---|
-| V1 | Fix Mermaid syntax `[{...}]` → `["..."]` | None |
-| V2 | Insert "Flow numbering stable" note | None |
-| V3 | Rename `Feature-level AC` → `Feature AC` + 4 nhóm chuẩn | Low |
-| V4 | Rename `AC-F{NNN}-` (Feature AC) → `FAC-F{NNN}-` (counter riêng) + cascade refs | **HIGH** |
-| V5 | Insert US/AC stability notes | None |
-| V6 | Propose Verification Rules từ User Stories → user approve → insert | Medium |
-| V7 | Move `Components Consumed` → `Dependencies > Components Used` | Low |
-| V8 | Derive Mermaid flows từ User Stories → propose → user approve → insert | Medium |
+**Phân loại mỗi artifact:**
+- Có `template_version` → `==`: **up-to-date**; `!=`: **out-dated** `(vX → vY)` → migrate.
+- Thiếu version (legacy) → presence-check (đủ required `##` + không còn section `migrations.remove`): conform → **stamp** `template_version` (có confirm); lệch → **out-dated** + tóm tắt phần thiếu.
 
-**Workflow:** Pre-flight git clean check → discover & classify → per-FRD context load → apply mechanical vectors (V1/V2/V3/V5/V7) → V4 dry-run preview với cascade impact → confirm → V6 propose VR → confirm → V8 propose Flows → confirm → validate → report.
+**Ranh giới:** chỉ phát hiện + stamp legacy conform. **KHÔNG migrate** — đổi structure là việc của `/artifact-migrate`. Bỏ qua `.specs/archive/` và `.specs/removed/`.
 
-**Cảnh báo:**
-- V4 mặc định dry-run, in remap table + cascade diff trước khi ghi.
-- V6 luôn propose-then-approve, không auto-apply (model dễ bịa rule).
-- V8 luôn propose-then-approve — model derive flow từ US journey grouping, BA phải review để catch glue step bịa hoặc grouping sai.
-- KHÔNG tạo file `.bak` — rollback dùng `git checkout -- {file}`. Pre-flight yêu cầu working tree clean.
+### `/artifact-migrate [path]`
 
-**No-op safe:** nếu mọi FRD đã clean, skill báo và dừng — không ghi gì.
+Migrate artifact lỗi thời lên structure template mới nhất, generic cho mọi type (vế **fix** đối xứng với `/artifact-audit` vế **detect**).
+
+**Scope:** arg = 1 artifact (path) → migrate riêng nó; không arg → quét toàn bộ, migrate từng cái có confirm + skip.
+
+**Quy trình:** pre-flight git clean → **tự chạy `/artifact-audit` classify-only (scoped)** để phát hiện out-dated (up-to-date → no-op sớm) → đọc block `migrations` của template lấy delta `add`/`remove`/`update` → dry-run + confirm → apply (set `template_version` = current; main artifact thêm Change History `manual`/migrate).
+
+**Quy tắc:**
+- **ADD** = required `##` thiếu (skeleton từ body template); section nội dung mới → interview hoặc `NEEDS_CLARIFY`, **KHÔNG bịa**.
+- **REMOVE** = section trong `migrations.remove` còn sót (có confirm); giữ content tác giả khác (superset).
+- **UPDATE** = section trong `migrations.update` — giữ section + ngữ nghĩa, chỉ đổi **format/cách thể hiện** (vd ASCII → Mermaid); show cũ + đề xuất mới, confirm; KHÔNG thêm/bớt thông tin. (Không presence-check được → chỉ bắt qua version compare.)
+- Rename (remove+add) → hỏi carry-over nội dung.
+- **Single-artifact, KHÔNG cascade.** ID remap (hiếm) → ghi ở `note`, sửa tay. Rollback dùng git (không `.bak`).
 
 ---
 
@@ -550,6 +551,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 +563,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 +585,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/plan-template.md

@@ -6,6 +6,10 @@ features: []
 components: []
 status: draft
 created: {YYYY-MM-DD}
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 4. Integration Artifacts > 4.5 plan.md > Cấu trúc
   - skills/plan/SKILL.md > Output Format > plan.md

package/templates/integrations/spec-template.md

@@ -6,6 +6,10 @@ features: []
 components: []
 status: draft
 created: {YYYY-MM-DD}
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 4. Integration Artifacts > 4.3 spec.md > Cấu trúc
   - skills/spec-new/SKILL.md > Process > Bước 5: Write — sinh draft

package/templates/integrations/tech-template.md

@@ -6,6 +6,10 @@ features: []
 components: []
 status: draft
 created: {YYYY-MM-DD}
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 4. Integration Artifacts > 4.4 tech.md > Cấu trúc
   - skills/spec-tech/SKILL.md > Process > Bước 4: Write — sinh draft

package/templates/integrations/techdebt-template.md

@@ -1,6 +1,10 @@
 ---
 slug: "{slug}"
 created: {YYYY-MM-DD}
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - skills/review-integration/SKILL.md > Bước 2 — Luôn ghi findings vào techdebt.md
 ---

package/templates/integrations/test-template.md

@@ -5,6 +5,10 @@ title: "{title}"
 features: []
 status: draft
 created: {YYYY-MM-DD}
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 4. Integration Artifacts > 4.7 test.md > Cấu trúc
   - skills/spec-test/SKILL.md > Process > Bước 4: Write — sinh draft

package/templates/integrations/todo-template.md

@@ -5,6 +5,10 @@ title: "{title}"
 features: []
 components: []
 created: {YYYY-MM-DD}
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 4. Integration Artifacts > 4.6 todo.md > Cấu trúc
   - skills/plan/SKILL.md > Output Format > todo.md

package/templates/main/component/cdd-template.md

@@ -4,6 +4,10 @@ type: cdd
 status: draft
 owner: "{Tech Lead / Senior Dev}"
 component_id: "{Component ID, ví dụ C-001}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.2 Component level > cdd.md > Cấu trúc
   - skills/spec-tech/SKILL.md > Process > Cascade Proposals > component cdd.md

package/templates/main/component/crd-template.md

@@ -4,6 +4,10 @@ type: crd
 status: draft
 owner: "{BA / Tech Lead}"
 component_id: "{Component ID từ PRD Component Index, ví dụ C-001}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.2 Component level > crd.md > Cấu trúc
   - skills/spec-new/SKILL.md > Process > Bước 5: Write — sinh draft > component/{C-XXX}/crd.md

package/templates/main/domain-template.md

@@ -3,6 +3,10 @@ id: domain
 type: domain
 status: draft
 owner: "{BA/Domain Expert}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.1 Product level > domain.md > Cấu trúc
   - skills/spec-prd/SKILL.md > Process > Bước 5: Save (scaffold domain.md skeleton)

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

@@ -4,6 +4,10 @@ type: fdd
 status: draft
 owner: "{Tech Lead / Senior Dev}"
 feature_id: "{Feature ID}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.3 Feature level > fdd.md > Cấu trúc
   - skills/spec-tech/SKILL.md > Process > Bước 4: Write — sinh draft > Cascade Proposals > fdd.md

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

@@ -4,6 +4,10 @@ type: frd
 status: draft
 owner: "{BA}"
 feature_id: "{Feature ID từ PRD Feature Index}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.3 Feature level > frd.md > Cấu trúc
   - skills/spec-frd/SKILL.md > Process > Bước 5: Write — sinh draft
@@ -155,6 +159,14 @@ 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).
+     Section required-emptyable: GIỮ heading; để trống (không có bullet) 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.

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

@@ -5,6 +5,10 @@ status: draft
 owner: "{QC}"
 feature_id: "{Feature ID — match frd.md}"
 frd_ref: "feature/{F-XXX}-{slug}/frd.md"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.3 Feature level > tsd.md > Cấu trúc
 ---

package/templates/main/prd-template.md

@@ -4,6 +4,10 @@ type: prd
 status: draft
 owner: "{PM/BA}"
 project_name: "{tên dự án}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.1 Product level > prd.md > Cấu trúc
   - skills/spec-prd/SKILL.md > Process > Bước 1: Kiểm tra preconditions

package/templates/main/sad-template.md

@@ -3,6 +3,10 @@ id: sad
 type: sad
 status: draft
 owner: "{Tech Lead / Architect}"
+template_version: 1
+migrations:
+  - to: 1
+    note: "baseline"
 referenced_by:
   - conventions.md > 3. Main Artifacts > 3.1 Product level > sad.md > Cấu trúc
   - skills/spec-sad/SKILL.md > Process > Bước 1: Kiểm tra preconditions