@edupia-tutor/spec-driven-docs 0.14.5 → 0.14.7

package/docs/02-guides/developer/bdd-and-trace.md

@@ -57,11 +57,11 @@ Framework dùng metadata `@trace.*` để liên kết PRD → BDD → Code. (Chi
 
 | Field | Vị trí | Ý nghĩa |
 |---|---|---|
-| `@trace.domain` | PRD frontmatter | Domain của feature (auth, payment, ...) — dùng để route vào đúng service submodule |
+| `Domain` | bảng Metadata PRD | Domain của feature (auth, payment, ...) — dùng để route vào đúng service submodule |
 | `@trace.module` | BDD / Tech Doc header | Module trong codebase sẽ implement |
 | `@trace.prd` | BDD / Tech Doc header | Link về PRD gốc |
 | `@trace.bdd` | Code comment / test | Link về BDD scenario |
-| `@trace.status` | PRD frontmatter | `draft` / `approved` — chỉ code khi `approved` |
+| `Status` | bảng Metadata PRD | `draft` / `approved` — chỉ code khi `approved` |
 | `dev_selftest` | Trace TSV | `pass` / `fail` / `not_run` — kết quả dev self-check, set bởi `/dev-run-test`. Surfaced trong Living Docs để QC biết dev đã chạy self-check — **KHÔNG phải coverage chính thức** |
 | `dev_selftest_at` | Trace TSV | Timestamp lần chạy `/dev-run-test` gần nhất |
 | `qc_status` | Trace TSV | `pass` / `fail` / `skip` / `not_run` — kết quả **QC chính thức**, set bởi `/qc-run-test` (do QC chạy, KHÔNG phải dev). Orthogonal với `dev_selftest` và với coverage `status` |
@@ -70,7 +70,7 @@ Framework dùng metadata `@trace.*` để liên kết PRD → BDD → Code. (Chi
 ### Ví dụ trace chain hoàn chỉnh
 
 ```
-specs/auth/login/{TICKET-ID}-login.md                              ← @trace.domain: auth, @trace.status: approved
+specs/auth/login/{TICKET-ID}-login.md                              ← Metadata: Domain: auth, Status: approved
     ↓
 specs/auth/login/bdd/system/FT-001-UC1-login.feature ← @trace.prd: FT-001 · web/app/system riêng (system tổng hợp từ web+app)
     ↓

package/docs/02-guides/developer/scenarios.md

@@ -21,7 +21,7 @@
    (lấy PRD + BDD mới nhất từ PO)
 
 2. /review-context my-project-specs/specs/payment/checkout/{TICKET-ID}-checkout.md
-   → Kiểm tra @trace.status = approved (không code khi còn draft)
+   → Kiểm tra Status = approved (bảng Metadata PRD; không code khi còn draft)
    → Đọc kỹ AC, UC, BR
 
 3. Đọc BDD tương ứng theo platform của mình:
@@ -343,7 +343,7 @@ code .   ← hoặc claude .
 # → sync Living Docs panel
 
 # 4. Framework tự detect umbrella mode từ project-context.yaml
-# Khi chạy /review-context với PRD có @trace.domain: be
+# Khi chạy /review-context với PRD có Domain: be (bảng Metadata)
 # → CODE route tới mass-product-be/  ·  BDD đọc từ spec repo mass-product-spec/specs/{domain}/{prd-slug}/bdd/ (spec_source set)
 ```
 

package/docs/02-guides/developer/workflow.md

@@ -45,7 +45,7 @@ Nhận thông báo PRD + BDD mới từ PO
         │
         ▼
 /review-context {prd-file}
-→ Kiểm tra @trace.domain, @trace.status = approved
+→ Kiểm tra Domain, Status = approved (bảng Metadata PRD)
 → Đọc hiểu AC, UC, BR trong PRD
 → Đọc BDD tương ứng trong specs/{domain}/{prd-slug}/bdd/{platform}/
 → Nếu có gì không rõ: hỏi PO TRƯỚC khi tiếp tục

package/docs/02-guides/product-owner/README.md

@@ -32,8 +32,8 @@ PO/BA                     Dev team
 
 **PO/BA chịu trách nhiệm:**
 - Đảm bảo PRD platform-agnostic (không chứa UI details hay API specs)
-- Đặt `@trace.domain` đúng để dev team routing hoạt động
-- Cập nhật `@trace.status: approved` trước khi handoff
+- Đặt row `Domain` (bảng Metadata) đúng để dev team routing hoạt động
+- Cập nhật `Status: approved` (bảng Metadata) trước khi handoff
 - **Generate BDD cho tất cả platforms** theo thứ tự **outside-in: web → app → system** — System BDD được **tổng hợp từ web+app BDD** (project chỉ-BE thì system gen thẳng từ PRD). Xem [scenarios](scenarios.md).
 - Thông báo dev team khi có PRD hoặc BDD mới/update
 

package/docs/02-guides/product-owner/handoff-checklist.md

@@ -5,10 +5,10 @@
 Trước khi thông báo dev team bắt đầu, kiểm tra:
 
 **Metadata:**
-- [ ] `@trace.id` có và đúng format (vd: FEAT-01)
-- [ ] `@trace.domain` có và khớp với domain names đã thống nhất với dev team
-- [ ] `@trace.status: approved` (không phải draft/in-review)
-- [ ] `@trace.version` có (vd: 1.0)
+- [ ] Row `Ticket` (bảng Metadata) có và đúng format (vd: FEAT-01)
+- [ ] Row `Domain` có và khớp với domain names đã thống nhất với dev team
+- [ ] Row `Status` = `approved` (không phải draft)
+- [ ] Row `Version` có (vd: 1.0)
 
 **Nội dung PRD:**
 - [ ] Tất cả `{{PLACEHOLDER}}` đã được điền
@@ -23,7 +23,7 @@ Trước khi thông báo dev team bắt đầu, kiểm tra:
 - [ ] Không có P3 conflict với PRD khác trong cùng domain
 
 **Cho FE/App thêm:**
-- [ ] Design Spec đã tạo và `@trace.status: approved` (không còn `draft`)
+- [ ] Design Spec đã tạo và `Status: approved` trong Metadata (không còn `draft`)
 - [ ] Mỗi screen có Figma link node-level (`?node-id=`) — không screen nào bị flag ❌ Missing
 - [ ] Designer đã sign-off (gate này bị BLOCKED nếu còn screen thiếu node-id link)
 

package/docs/02-guides/product-owner/scenarios.md

@@ -40,13 +40,13 @@ Mở findings file, xem xét từng finding: `accepted` → apply · `modified`
 ```
 /review-context specs/auth/FEAT-01-login/FEAT-01-login.md
 ```
-Kiểm tra: `@trace.status`, `@trace.domain`, completeness.
+Kiểm tra: `Status`, `Domain` (bảng Metadata), completeness.
 
 **Bước 5 — Approve PRD:**
 ```yaml
-# Trong file PRD, cập nhật:
-@trace.status: approved
-@trace.version: 1.0
+# Trong bảng Metadata của PRD, cập nhật:
+#   | **Status**  | approved |
+#   | **Version** | 1.0      |
 ```
 
 **Bước 6 — Tạo Design Spec (FE/App):**
@@ -55,7 +55,7 @@ Kiểm tra: `@trace.status`, `@trace.domain`, completeness.
 ```
 Agent hỏi platform (web / app). PO phải cung cấp **Figma link node-level** (URL chứa `?node-id=`, lấy bằng right-click vào frame → "Copy link to selection") cho **mỗi screen**. Screen nào thiếu link → bị flag ❌ Missing, Status giữ `draft`, `/generate-bdd` bị BLOCKED cho đến khi đủ link.
 
-Sau khi Designer review + confirm đủ Figma node-id links → `@trace.status: approved`.
+Sau khi Designer review + confirm đủ Figma node-id links → đặt `Status: approved` trong Metadata Design Spec.
 
 **Bước 7 — Generate BDD:**
 ```
@@ -84,7 +84,7 @@ git push
 
 ```
 /define-product         → product definition
-/generate-prd           → PRD với @trace.domain: auth
+/generate-prd           → PRD với Domain: auth (bảng Metadata)
 /review-context --fix   → auto-fix
 /generate-design-spec   → design spec cho FE (nếu có designer)
 /generate-bdd → web     → specs/auth/FEAT-01-login/bdd/web/
@@ -115,7 +115,7 @@ git push
 ```
 Output: `specs/auth/FEAT-01-login/design-spec/FEAT-01-design-spec-web.md`
 
-Mỗi screen cần Figma link node-id. Screen thiếu → flag ❌ Missing, BLOCKED. Sau khi Designer review → `@trace.status: approved`.
+Mỗi screen cần Figma link node-id. Screen thiếu → flag ❌ Missing, BLOCKED. Sau khi Designer review → đặt `Status: approved` trong Metadata Design Spec.
 
 **Bước 2 — Generate BDD:**
 ```
@@ -162,7 +162,8 @@ Lặp lại cho đến khi `recommendation: APPROVED`.
 
 **Bước 1 — Đổi status về draft:**
 ```yaml
-@trace.status: draft
+# Trong bảng Metadata PRD:
+#   | **Status** | draft |
 ```
 
 **Bước 2 — Sửa nội dung:**
@@ -178,9 +179,9 @@ Lặp lại cho đến khi `recommendation: APPROVED`.
 
 **Bước 4 — Approve và thông báo:**
 ```yaml
-@trace.status: approved
-@trace.version: 1.1     # minor bump vì chỉ thêm AC
-                         # major bump (2.0) nếu thay đổi cơ bản
+# Trong bảng Metadata PRD:
+#   | **Status**  | approved |
+#   | **Version** | 1.1      |   # minor bump (chỉ thêm AC); major (2.0) nếu thay đổi cơ bản
 ```
 ```bash
 git add specs/auth/FEAT-01-login/FEAT-01-login.md
@@ -225,7 +226,7 @@ services:
     specs_dir: "loyalty-service/specs/bdd"
 ```
 
-**Bước 3 — Viết PRD bình thường với `@trace.domain: loyalty`.**
+**Bước 3 — Viết PRD bình thường với `Domain: loyalty` (bảng Metadata).**
 
 > **Lưu ý:** Nếu dev team chưa cập nhật services config → `/review-context` P0 check sẽ cảnh báo domain không match.
 
@@ -281,7 +282,7 @@ specs/
 
 ```bash
 # Xem nhanh tất cả PRDs và status:
-grep -r "@trace.status" specs/ --include="*.md"
+grep -rn "\*\*Status\*\*" specs/ --include="*.md"
 ```
 
 ---
@@ -290,10 +291,11 @@ grep -r "@trace.status" specs/ --include="*.md"
 
 **Checklist trước khi thông báo:**
 ```yaml
-@trace.id: FEAT-01          ✅ có
-@trace.domain: auth         ✅ khớp với services keys của dev team
-@trace.status: approved     ✅ đã approved
-@trace.version: 1.0         ✅ có version number
+# Bảng Metadata PRD:
+#   | **Ticket**  | FEAT-01  |   ✅ có (đúng format)
+#   | **Domain**  | auth     |   ✅ khớp services keys của dev team
+#   | **Status**  | approved |   ✅ đã approved
+#   | **Version** | 1.0      |   ✅ có version number
 ```
 
 ```

package/docs/03-concepts/traceability.md

@@ -22,7 +22,7 @@ Mỗi artifact mang `@trace.*` metadata liên kết về artifact trước nó:
 
 ```
 product-definition.md
-  └─► PRD.md (@trace.domain, @trace.status; Service/Module trong metadata)
+  └─► PRD.md (Domain, Status, Service/Module — đều trong bảng Metadata)
         └─► specs/{domain}/{prd-slug}/bdd/{web|app|system}/{UC-ID}.feature (@trace.prd_version, @trace.module)
               └─► specs/{domain}/{prd-slug}/tech-docs/{UC-ID}-tech-design*.md (@trace.bdd_version)
                     └─► src/ code — service submodule (@trace.implements)
@@ -34,8 +34,8 @@ product-definition.md
 
 | Field | Vị trí | Ý nghĩa |
 |-------|--------|---------|
-| `@trace.domain` | PRD frontmatter | Domain của feature (auth, payment, …) — route vào đúng service submodule |
-| `@trace.status` | PRD frontmatter | `draft` / `approved` — dev team chỉ code khi `approved` |
+| `Domain` | bảng Metadata PRD | Domain của feature (auth, payment, …) — route vào đúng service submodule |
+| `Status` | bảng Metadata PRD | `draft` / `approved` — dev team chỉ code khi `approved` |
 | `@trace.service` / `@trace.module` | BDD / Tech Doc header | Service + module sẽ implement |
 | `@trace.prd_version` / `@trace.bdd_version` | BDD / code / test | Version của spec mà artifact được sinh từ — base cho drift detection |
 | `@trace.implements` | Code comment | Scenario mà code này implement: `={UC-ID}-SC{N}` |

package/docs/04-operations/sync-and-update.md

@@ -256,7 +256,7 @@ Topology giả định cho mọi ví dụ dưới đây:
 **① PO — 1 tầng (spec repo)**
 ```bash
 cd my-project-specs && git pull
-# /generate-prd · /generate-design-spec · /generate-bdd (web/app/system) · set @trace.status: approved
+# /generate-prd · /generate-design-spec · /generate-bdd (web/app/system) · set Status: approved (bảng Metadata)
 git add specs/payment/checkout/{TICKET-ID}-checkout.md \
         specs/payment/checkout/design-spec/FT-042-checkout-design.md \
         specs/payment/checkout/bdd/system/FT-042-UC1-checkout-system.feature \
@@ -400,7 +400,7 @@ git pull
 /refine-prd {prd-file}                   # review 4 lens: QA/DEV/SA/PO
 /review-context {prd-file}               # chất lượng + P0 check
 /review-context --fix {prd-file}         # auto-fix vấn đề nhỏ
-# → update @trace.status: approved khi PRD sẵn sàng
+# → update Status: approved (bảng Metadata) khi PRD sẵn sàng
 /generate-design-spec {prd-file}         # FE/App
 /generate-bdd {prd-file}                 # outside-in: web → app → system (System BDD tổng hợp từ web+app)
 
@@ -417,7 +417,7 @@ cd my-project-web
 git add my-project-specs && git commit -m "chore: sync specs" && git push
 
 /review-context my-project-specs/specs/{domain}/{prd-slug}/{TICKET-ID}-{prd-slug}.md
-# → P0: @trace.domain khớp services config? @trace.status: approved?
+# → P0: Domain (bảng Metadata) khớp services config? Status: approved?
 # Đọc Web BDD do PO generate (KHÔNG tự generate BDD):
 #   my-project-specs/specs/{domain}/{prd-slug}/bdd/web/{TICKET-ID}-UC*.feature
 

package/docs/05-reference/command-cheatsheet.md

@@ -63,7 +63,7 @@ Có **4 lệnh review** cho **4 loại artifact khác nhau**. Đây là điểm
 | Tôi muốn review… | Cách dùng (ví dụ) | Nó kiểm cái gì | Ai chạy |
 |---|---|---|---|
 | **PRD — nội dung & độ đầy đủ** | `/refine-prd specs/auth/login/{TICKET-ID}-login.md` | 4 lens QA·DEV·SA·PO: AC có test được? edge case? scope rõ? | PO |
-| **PRD — chất lượng trước khi approve** | `/review-context specs/auth/login/{TICKET-ID}-login.md` | P-checks: banned term, mơ hồ, mâu thuẫn PRD khác, thiếu section, routing `@trace.domain` | PO |
+| **PRD — chất lượng trước khi approve** | `/review-context specs/auth/login/{TICKET-ID}-login.md` | P-checks: banned term, mơ hồ, mâu thuẫn PRD khác, thiếu section, routing theo `Domain` (bảng Metadata) | PO |
 | **BDD `.feature`** | `/review-context specs/auth/login/bdd/system/FEAT-01-UC1-login.feature` | B-checks: mỗi AC/BR → có ≥1 scenario? Gherkin R1–R10, compliance C1–C5 | SA/Dev |
 | **Tech design** | `/review-tech-docs specs/auth/login/tech-docs/FEAT-01-UC1-tech-design.md` | T-checks: đúng layer/architecture, entity, trace BDD, cross-team API sign-off | Dev/SA |
 | **Code** | `/review-code FEAT-01-UC1` | 4 lens: Security · Performance · Architecture · Test coverage | Dev |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@edupia-tutor/spec-driven-docs",
-  "version": "0.14.5",
+  "version": "0.14.7",
   "description": "AI-First Spec-Driven Development workflow framework for Claude Code",
   "bin": {
     "spec-driven-docs": "./bin/index.js"

package/skills/code/SKILL.md

@@ -572,7 +572,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -730,7 +730,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/skills/debug/SKILL.md

@@ -503,7 +503,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -687,7 +687,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -828,7 +828,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/skills/design-spec/SKILL.md

@@ -539,7 +539,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/skills/prd/SKILL.md

@@ -424,7 +424,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/skills/setup-ai-first/SKILL.md

@@ -175,7 +175,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/skills/spec/SKILL.md

@@ -244,7 +244,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -421,7 +421,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/skills/test/SKILL.md

@@ -287,7 +287,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -763,7 +763,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
@@ -1257,7 +1257,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/steps/report-footer.md

@@ -60,7 +60,7 @@ Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 | /define-product         | `/generate-prd {product-definition-file}`     |
 | /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
 | /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /review-context (PRD)   | Khi 0 critical → PO đặt `Status: approved`, rồi FE/App: `/generate-design-spec {prd-file}` (→ design sign-off → BDD); BE: `/generate-bdd {prd-file}`. Còn critical/NEEDS_FIX → sửa PRD (giữ draft) |
 | /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
 | /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
 | /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |

package/templates/project-context.yaml

@@ -14,7 +14,7 @@
 # 3. When a workflow says "→ key.subkey", look up that key
 #    and use the resolved value as the actual path
 # 4. All paths are RELATIVE to workspace root
-# 5. For "{domain}", substitute from spec's @trace.domain
+# 5. For "{domain}", substitute the feature's domain (PRD: row `Domain` in Metadata / folder path; .feature: @trace.domain)
 # =============================================================
 
 project:
@@ -132,7 +132,7 @@ domains:
 # With spec_source set, only ONE override is needed instead of four separate dir vars.
 #
 # services:                                   # domain → service submodule routing
-#   {{DOMAIN_1}}:                             # must match @trace.domain in PRD files
+#   {{DOMAIN_1}}:                             # must match the PRD's `Domain` (Metadata row) / folder path segment
 #     path: "{{SERVICE_SUBMODULE_DIR}}"       # relative path to service submodule (code + .trace/)
 #     module: "{{STACK_MODULE}}"              # e.g., java-spring, nextjs, flutter
 #     # NOTE: with spec_source set, BDD + tech-docs are cross-team and live in the spec repo —