spec-lite 1.4.7 → 1.5.0

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`).
 
 ---
 

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
@@ -158,7 +162,8 @@ Tham chiếu đến `.specs/main/component/{C-XXX}-...`.
 ## 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ũ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}
 

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

package/skills/spec-frd-update/SKILL.md

@@ -1,398 +0,0 @@
----
-name: spec-frd-update
-description: Migrate frd.md hiện có lên cấu trúc template mới nhất — fix Mermaid syntax, rename Feature AC → FAC (counter riêng), thêm Verification Rules section, cascade ID remap qua fdd/tsd/test/spec/tech. Dùng cho repo đã onboard SDD từ trước khi template thay đổi.
----
-
-# spec-frd-update
-
-## Overview
-
-Migrate các file `.specs/main/feature/{F-XXX}-{slug}/frd.md` hiện có sang **format mới nhất** của [templates/main/feature/frd-template.md](../../templates/main/feature/frd-template.md).
-
-Skill này **chỉ làm migration mechanical + propose** — không phải BA interview. Mọi quyết định nội dung mới (Verification Rules content) đều cần user approve trước khi ghi.
-
-## When to Use
-
-- Repo đã chạy `/spec-brownfield-feature` hoặc `/spec-new` từ lâu, frd.md sinh ra theo template cũ — giờ template đã update.
-- Sau khi `git pull` kit mới và phát hiện frd.md hiện tại thiếu section so với template mới.
-- Audit định kỳ để đảm bảo mọi frd.md tuân thủ cùng format.
-
-## When NOT to Use
-
-- frd.md chưa tồn tại → dùng `/spec-brownfield-feature` (brownfield) hoặc `/spec-new` (greenfield).
-- Muốn thay đổi **nội dung** frd (thêm US, đổi AC text) → edit thủ công hoặc qua integration changeset.
-- Template chưa thay đổi gì so với khi frd.md được tạo → skill này sẽ no-op, không có gì để làm.
-
----
-
-## Cảnh báo về ID cascade
-
-Skill này có thể **rename Feature AC ID** từ `AC-F{NNN}-{seq}` sang `FAC-F{NNN}-{seq}` (counter riêng, reset từ 001). Các file sau có thể reference những ID này và cần cascade:
-
-- `feature/{F-XXX}/fdd.md` — section Verification Implementation
-- `feature/{F-XXX}/tsd.md` — Traceability Matrix, Test Cases
-- `integrations/*/spec.md` — Cascade Proposals, Changes blocks
-- `integrations/*/tech.md` — Changes blocks
-- `integrations/*/test.md` — Coverage table
-
-**Mặc định dry-run** — skill in toàn bộ ID remap + diff trước khi ghi, user xác nhận từng feature một.
-
----
-
-## Migration vectors
-
-Skill detect từng frd hiện tại thuộc "era" nào và apply vectors tương ứng:
-
-| Vector | Detect bằng | Action | Risk |
-|---|---|---|---|
-| **V1 Mermaid syntax** | Có pattern `\[\{.+?\}\]` trong code block mermaid | Rewrite `[{X}]` → `["X"]` | None |
-| **V2 Flow stability note** | Section `## User Flows` thiếu chuỗi "Flow numbering" | Insert dòng note sau intro | None |
-| **V3 Section rename** | Có heading `## Feature-level Acceptance Criteria` | Rename → `## Feature Acceptance Criteria` + insert 4-group block + Out-of-scope note | Low |
-| **V4 FAC ID renumber** | Trong section Feature AC, IDs dùng prefix `AC-F` (chứ không phải `FAC-F`) | Remap → `FAC-F{NNN}-001..N` + cascade references trong repo | **HIGH** |
-| **V5 US/AC stability notes** | Section User Stories thiếu chuỗi "ID stable" | Insert 2 dòng note | None |
-| **V6 VR section** | Không có heading `## Verification Rules` | Propose VR table từ User Stories → user approve → insert | Medium |
-| **V7 Components Used location** | Section `## Components Consumed` đứng riêng (era pre-84d7303) | Move xuống `## Dependencies` thành subsection `### Components Used` | Low |
-| **V8 User Flows missing** | Không có heading `## User Flows` (era pre-84d7303) | Derive Mermaid flows từ User Stories → propose → user approve → insert. 1 flow / nhóm US liên quan theo journey logic. **Bắt buộc — không có option skip; FRD migration không hoàn tất nếu thiếu User Flows.** | Medium |
-
----
-
-## Process
-
-### Bước 0: Pre-flight — working tree clean
-
-Chạy `git status --porcelain`. Nếu output không rỗng (có file modified / untracked / staged):
-
-```
-⛔ Working tree không clean. Skill không tạo file backup `.bak` — rollback dựa vào git.
-Hãy commit hoặc stash thay đổi hiện tại trước khi chạy `/spec-frd-update`, rồi chạy lại.
-
-Files dirty:
-  M .specs/main/feature/F-001-auth/frd.md
-  ?? notes.md
-```
-
-Dừng hoàn toàn. Skill chỉ proceed khi `git status` clean — đảm bảo mọi change sau đó đều thuộc migration, dễ revert bằng `git checkout -- {path}` hoặc `git restore`.
-
-Nếu repo không phải git repo → cảnh báo và yêu cầu confirm:
-> ⚠ Thư mục này không phải git repo. Skill không tạo file backup. Nếu apply sai, không thể rollback. Tiếp tục? (yes / no — default no)
-
----
-
-### Bước 1: Discover & classify
-
-Quét `.specs/main/feature/*/frd.md`. Với mỗi file:
-
-1. Parse headings và frontmatter.
-2. Run detection cho V1–V8.
-3. Build classification table.
-
-Display kết quả:
-
-```
-Detected FRDs:
-
-  [1] F-001 — auth          | Era: 2026-04 | Vectors needed: V1, V3, V4 (3 IDs), V5, V6
-  [2] F-002 — checkout      | Era: 2026-05 | Vectors needed: V5, V6
-  [3] F-003 — refund        | Era: current | Vectors needed: — (đã clean)
-  [4] F-004 — admin-panel   | Era: pre-flows | Vectors needed: V1, V3, V4 (2 IDs), V5, V6, V7, V8
-
-Tổng: 4 FRDs · 3 cần migration · 1 đã sạch.
-```
-
-Hỏi user scope:
-
-```
-Migrate FRDs nào?
-  [A] Tất cả cần migration (3 files)
-  [1] Chỉ F-001
-  [2] Chỉ F-002
-  ...
-  [N] Chọn subset (nhập danh sách số, vd: "1 4")
-  [X] Hủy
-
-Lựa chọn:
-```
-
-Nếu không có FRD nào cần migration → thông báo `Tất cả frd.md đã clean. No-op.` rồi dừng.
-
----
-
-### Bước 2: Load context per FRD
-
-Với mỗi FRD đã chọn, load các file sau (chỉ những gì cần thiết — KHÔNG load conventions.md, KHÔNG load source code):
-
-| File | Bắt buộc | Mục đích |
-|---|---|---|
-| `.specs/main/feature/{F-XXX}-{slug}/frd.md` | ✓ | File cần migrate |
-| [templates/main/feature/frd-template.md](../../templates/main/feature/frd-template.md) | ✓ | Target structure — copy text cho V2/V3/V5 |
-| `.specs/main/feature/{F-XXX}-{slug}/fdd.md` | nếu tồn tại | Cascade target cho V4 (AC→FAC rename) |
-| `.specs/main/feature/{F-XXX}-{slug}/tsd.md` | nếu tồn tại | Cascade target cho V4 |
-| `.specs/main/domain.md` (Shared Entities block) | optional | Cho V6 — match field name với entity glossary để pick semantic type consistent |
-
-**KHÔNG load:**
-- `conventions.md` — template đã self-contained, load là thừa
-- Source code — frd là WHAT, derive VR từ US/AC chứ không phải implementation
-- `tech.md`/`cdd.md` — có thể contaminate VR bằng tech detail (regex, varchar(255)…)
-
----
-
-### Bước 3: Apply mechanical vectors (V1, V2, V3, V5, V7)
-
-Đây là các vector **không cần model reasoning** — pure text manipulation. Apply tuần tự, không hỏi user.
-
-#### V1 — Mermaid syntax fix
-- Regex trong mỗi code block ```mermaid: `\[\{([^}]+)\}\]` → `["$1"]`
-- Edge case: keep escaped braces nguyên vẹn, chỉ replace pattern `[{...}]` ở edge label / node label.
-
-#### V2 — Flow stability note
-- Sau bullet intro của `## User Flows` (dòng `{Mỗi flow là một Mermaid…}`), insert:
-  > Flow numbering **stable** — không renumber khi xóa flow. Nếu xóa Flow 1, Flow 2 giữ nguyên số (không tái sử dụng số 1).
-
-#### V3 — Section rename + structure
-- Rename heading `## Feature-level Acceptance Criteria` → `## Feature Acceptance Criteria`.
-- Replace block intro (dòng "Criteria áp dụng cho toàn bộ feature — không gắn với story…") bằng full block từ template (4 nhóm + Out-of-scope + Format note). Copy nguyên văn từ frd-template.md.
-
-#### V5 — US/AC stability notes
-- Sau dòng `US ID format: ...` trong User Stories section, đảm bảo có 2 dòng:
-  > US ID format: `US-F{NNN}-{seq}` — đánh số tăng dần toàn feature. ID **stable** — không tái sử dụng seq khi xóa, không renumber.
-  >
-  > Story AC ID format: `AC-F{NNN}-{seq}` — đánh số tăng dần toàn feature (không reset giữa các story). ID **stable** — không tái sử dụng seq khi xóa, không renumber.
-
-#### V7 — Components Used relocation
-- Detect `## Components Consumed` section.
-- Cắt nội dung bảng, xóa heading.
-- Trong `## Dependencies`, ensure có 2 subsections: `### Feature Dependencies` (giữ bảng cũ nếu có) và `### Components Used` (chèn bảng vừa cắt).
-
----
-
-### Bước 4: V4 — AC → FAC renumber với cascade
-
-**Đây là vector cao risk nhất.** Mỗi feature làm tuần tự, không batch.
-
-#### 4.1 Parse Feature AC IDs
-- Trong section `## Feature Acceptance Criteria` (đã rename ở V3), extract tất cả ID dạng `AC-F{NNN}-{seq}`.
-- List: `[AC-F001-002, AC-F001-005, AC-F001-007]` (gap OK).
-
-#### 4.2 Build remap table
-- Cũ → mới: reset counter từ 001, giữ thứ tự xuất hiện.
-- Ví dụ:
-  ```
-  AC-F001-002  →  FAC-F001-001
-  AC-F001-005  →  FAC-F001-002
-  AC-F001-007  →  FAC-F001-003
-  ```
-
-#### 4.3 Scan cascade references
-- Grep toàn `.specs/` cho từng ID cũ.
-- **CRITICAL**: chỉ remap những match THUỘC Feature AC (Bước 4.1 list). KHÔNG đụng Story AC trùng namespace `AC-F{NNN}-{seq}` — đây là string overlap nhưng khác counter.
-- Tạo bảng impact:
-  ```
-  Cascade impact for F-001:
-    feature/F-001-auth/fdd.md          3 refs
-    feature/F-001-auth/tsd.md          5 refs
-    integrations/003-otp-flow/spec.md  1 ref
-    integrations/003-otp-flow/test.md  2 refs
-  ```
-
-#### 4.4 Dry-run preview
-Hiển thị:
-- Full remap table
-- Per-file diff snippet (3 dòng context mỗi ref)
-- Confirm prompt:
-
-```
-Apply remap cho F-001? (yes / no / skip-feature)
-  yes          → apply tất cả changes (frd.md + cascade files)
-  no           → hủy V4 cho feature này, vẫn giữ AC-F prefix
-  skip-feature → bỏ qua toàn bộ migration cho F-001
-```
-
-#### 4.5 Apply
-- Edit `frd.md`: rewrite IDs trong section Feature AC.
-- Edit từng cascade file: replace exact ID strings (sử dụng Edit với context dòng để tránh false-positive).
-- Validate: re-grep ID cũ, phải về 0 trong Feature AC scope; Story AC giữ nguyên.
-
----
-
-### Bước 5: V6 — Generate Verification Rules section
-
-**Vector tiêu tốn LLM nhất.** Run nếu V6 detected.
-
-#### 5.1 Load minimal context
-- Section `## User Stories` của FRD đó (đã chứa AC).
-- Optional: `domain.md > Shared Entities` block (nếu có field match entity name).
-
-**KHÔNG load:** code, fdd.md, tech.md. Mục đích: tránh contamination bằng HOW.
-
-#### 5.2 Derive rules
-Quét từng AC trong User Stories:
-- Identify input action ("nhập email", "submit form", "chọn date", "upload file"…).
-- Extract field name + implicit constraint.
-- Output bảng VR theo format template:
-  - **Type**: semantic (`string`, `email`, `enum<A|B|C>`, …) — không bao giờ concrete tech type.
-  - **Rule**: human-readable diễn đạt, không regex.
-  - **Refs**: trỏ tới US/AC source.
-- Sub-rule phức tạp (vd: password = letter + digit + symbol) → tách flat thành nhiều ID.
-
-#### 5.3 Propose & approve
-Hiển thị bảng VR đề xuất:
-
-```
-Proposed Verification Rules for F-001:
-
-| ID | Field | Type | Required | Rule | Refs |
-|----|-------|------|----------|------|------|
-| VR-F001-001 | email | email | yes | định dạng email hợp lệ | US-F001-001 |
-| VR-F001-002 | password | string | yes | tối thiểu 8 ký tự | US-F001-001 |
-...
-
-Apply? (yes / edit / skip-vr)
-  yes      → insert vào frd.md
-  edit     → user trả lời text-edit rules nào cần sửa
-  skip-vr  → giữ FRD không có VR section
-```
-
-#### 5.4 Insert
-- Insert `## Verification Rules` section ngay trước `## Scope` (theo thứ tự template).
-- Copy nguyên block intro + quy ước từ template, chỉ replace bảng bằng nội dung derived.
-
----
-
-### Bước 6: V8 — Derive User Flows section
-
-**Run nếu V8 detected. Bắt buộc — không có option skip.** Propose-then-approve giống V6 nhưng loop cho tới khi user approve: model derive draft, user duyệt (yes) hoặc trả phản hồi (edit) → model regenerate. FRD migration chỉ hoàn tất khi `## User Flows` đã insert.
-
-#### 6.1 Load minimal context
-- Section `## Overview` của FRD (framing scope + actors).
-- Section `## User Stories` (đã chứa AC — source của journey steps).
-
-**KHÔNG load:** code, fdd.md, tech.md, sequence diagrams hiện có. Mục đích: flow ở frd là **user-facing journey** (WHAT), không phải implementation sequence (HOW thuộc fdd).
-
-#### 6.2 Derive flows
-Nhóm User Stories theo journey logic, mỗi journey → 1 Mermaid flowchart:
-
-- **Grouping rule:** US chia sẻ chung trigger / actor / postcondition → cùng 1 flow. Vd `US-001 Đăng ký` + `US-002 Xác thực email` → 1 flow "Onboarding"; còn `US-003 Reset password` là journey riêng.
-- **Mermaid structure:**
-  - Start node = trigger (user action mở đầu, từ Given của AC đầu tiên).
-  - Decision nodes = branch từ AC (happy / error paths).
-  - End node = postcondition (từ Then của AC cuối).
-  - Edge label = user action hoặc system response (từ When / Then).
-- **Naming:** `Flow {N}: {tên ngắn}` — N đánh số từ 1 theo thứ tự xuất hiện trong frd.
-- **Mermaid syntax:** dùng `["..."]` chứ KHÔNG `[{...}]` (V1 convention).
-
-#### 6.3 Propose & approve
-
-Hiển thị draft full mermaid blocks (chưa ghi file):
-
-```
-Proposed User Flows for F-001:
-
-Flow 1: Onboarding (đăng ký + xác thực email)
-  Spans: US-F001-001, US-F001-002
-  ```mermaid
-  flowchart TD
-    A["User mở trang Sign up"] --> B["Nhập email + password"]
-    B --> C{"Validation pass?"}
-    C -->|yes| D["Gửi email xác thực"]
-    C -->|no| E["Hiển thị lỗi"]
-    D --> F["User click link trong email"]
-    F --> G["Account active"]
-  ```
-
-Flow 2: Login
-  Spans: US-F001-003
-  ```mermaid
-  ...
-  ```
-
-Apply? (yes / edit)
-  yes   → insert vào frd.md
-  edit  → user góp ý flow nào cần sửa (vd: "Flow 1 thiếu nhánh email đã tồn tại") → regenerate draft, loop lại
-
-User Flows là **bắt buộc** — không có option skip. Nếu user muốn dừng toàn bộ migration cho feature này, dùng "skip-feature" ở Bước 4 hoặc abort skill (Ctrl-C) trước khi V8 chạy.
-```
-
-#### 6.4 Insert
-- Insert section `## User Flows` ngay sau `## Overview` (theo thứ tự template).
-- Copy intro + **Flow numbering stable** note (V2 convention) từ template, sau đó list các Mermaid blocks theo flow numbering.
-
----
-
-### Bước 7: Validate
-
-Sau khi apply hết vectors cho một FRD, chạy check:
-
-- [ ] `## Feature Acceptance Criteria` (không phải Feature-**level**)
-- [ ] Không còn ID `AC-F{NNN}-` trong scope Feature AC (chỉ có `FAC-F{NNN}-`)
-- [ ] Story AC vẫn dùng `AC-F{NNN}-` (không bị remap nhầm)
-- [ ] Mermaid blocks không còn pattern `[{...}]`
-- [ ] Có heading `## Verification Rules` (nếu V6 applied)
-- [ ] Có heading `## User Flows` với ít nhất 1 Mermaid flowchart (bắt buộc — nếu V8 detected mà section vẫn vắng thì migration chưa hoàn tất)
-- [ ] VR Rule column không chứa keyword UI copy: "error message", "vui lòng", "hint", "tooltip"
-- [ ] Frontmatter `referenced_by` trỏ tới `3.3 Feature level` (không phải `3.2`)
-
-Nếu check fail → rollback bằng `git checkout -- {file}` (skill không tạo backup vật lý vì git history đã đảm nhận vai trò này). Yêu cầu working tree clean trước khi chạy skill — nếu dirty, skill báo lỗi và dừng để tránh trộn lẫn change của user với change của migration.
-
----
-
-### Bước 8: Report + changelog
-
-Cho mỗi FRD đã migrate:
-
-```
-✓ F-001 — auth
-  Vectors applied: V1, V3, V4 (3 IDs remapped), V5, V6 (8 VRs added), V8 (2 flows added)
-  Cascade: fdd.md (3 refs), tsd.md (5 refs), integrations/003 (3 refs)
-
-✓ F-002 — checkout
-  Vectors applied: V5, V6 (5 VRs added)
-```
-
-**Change History append:** Cho mỗi FRD vừa migrate (và mỗi cascade target `fdd.md`/`tsd.md` bị touched), append entry vào section `## Change History` theo `conventions.md` §5.5:
-
-```markdown
-### {YYYY-MM-DD} — manual — update
-
-- **Migration**: applied vectors V1, V3, V4 (3 IDs remapped: AC-F001-001→FAC-F001-001, ...), V5, V6 (8 VRs added), V8 (2 flows added) qua /spec-frd-update
-```
-
-Nếu artifact chưa có section `## Change History` (vì template cũ) → tạo section mới ở cuối file rồi append entry. Đây cũng là một migration vector ngầm — đảm bảo mọi main artifact sau migration đều có Change History section.
-
-Rollback (nếu user phát hiện sai sau khi skill xong): `git checkout -- .specs/main/feature/{F-XXX}-{slug}/` để revert toàn bộ feature dir, hoặc `git restore -p` để revert per-hunk.
-
-Append vào [changelogs.md](../../changelogs.md) `## [Unreleased]`:
-
-```
-- chore: migrate frd.md format cho {N} features (vectors: ...)
-```
-
----
-
-## Common Rationalizations
-
-| Rationalization | Reality |
-|---|---|
-| "Format mới optional, frd cũ vẫn dùng được" | Đúng cho đọc thủ công. Nhưng `/spec-test` và `/spec-tsd` derive TC theo IDs FAC/VR — frd thiếu sẽ break derivation, fallback bằng placeholder không trace được. |
-| "Tự sinh VR an toàn, model giỏi infer constraint" | Model dễ bịa rule không có trong AC ("password tối thiểu 12 ký tự" khi AC chỉ nói "password hợp lệ"). Luôn propose-then-approve, không auto-apply. |
-| "Skip cascade, chỉ rename trong frd thôi" | Sẽ break tsd.md Traceability Matrix và test.md Coverage. Hoặc cascade full, hoặc skip V4 toàn bộ. |
-| "Migrate batch tất cả cùng lúc cho nhanh" | V4 cascade dễ break — user cần xem diff per-feature. Batch mode chỉ áp dụng cho V1, V2, V3, V5, V7 (mechanical, low risk). V6 và V8 phải propose-then-approve. |
-
-## Red Flags
-
-- Apply V4 không có dry-run preview → user không kịp catch cascade reference sai.
-- VR Rule column chứa regex `^[a-z]+$` hoặc tech type `varchar(255)` — đó là HOW, sai vị trí.
-- V8 flows auto-apply không qua propose-then-approve → model có thể bịa glue step / sai journey grouping mà BA không kịp catch.
-- V8 flow chứa step không trace được lên US nào (model bịa) → BA reject draft và yêu cầu regenerate.
-- Để FRD không có `## User Flows` sau migration vì "draft chưa ổn" → sai. V8 bắt buộc; nếu draft chưa ổn, dùng `edit` loop cho tới khi approve. FRD không có User Flows = migration chưa hoàn tất.
-- V8 Mermaid block dùng syntax `[{...}]` thay vì `["..."]` — vi phạm V1 convention.
-- Validate fail nhưng skip rollback → file ở trạng thái nửa migrate, khó debug sau.
-- Load conventions.md hoặc source code "for safety" → contamination, tốn context, không cải thiện output.
-
-## Verification
-
-Trước khi mark feature done:
-- [ ] Tất cả vectors detected đã apply (hoặc skip có log lý do — riêng V8 KHÔNG được skip)
-- [ ] Validate Bước 6 pass
-- [ ] Working tree clean trước khi skill chạy (git status verified) — rollback dùng git, không có file backup
-- [ ] Cascade ID đã re-grep và confirm 0 false-positive
-- [ ] User confirm VR proposal nếu V6 applied