@edupia-tutor/spec-driven-docs 0.14.0 → 0.14.2

package/commands/generate-spec-manifest.tmpl

@@ -1,13 +1,13 @@
-# /generate-spec-manifest — Generate Spec Manifest for External Agents
+# /generate-spec-manifest — Sinh Spec Manifest cho External Agent
 
-Scans all spec files and writes a `spec-manifest.yaml` at the project root.
-This file is for **external agents only** (e.g. tester's agent) — it is not committed to git.
+Quét tất cả file spec và ghi một `spec-manifest.yaml` ở project root.
+File này dành cho **external agent** (vd agent của tester) — nó không commit vào git.
 
 ## Gate
 
 {{include:steps/gate.md}}
 
-*Note: For this command, there is no target file — it scans the entire project. Ignore `$ARGUMENTS` unless a domain filter is passed.*
+*Lưu ý: Với lệnh này, không có target file — nó quét cả dự án. Bỏ qua `$ARGUMENTS` trừ khi truyền domain filter.*
 
 ## Context
 
@@ -17,79 +17,79 @@ This file is for **external agents only** (e.g. tester's agent) — it is not co
 
 ## Process
 
-### Step 1 — Determine scan roots
+### Step 1 — Xác định scan root
 
-Read `project-context.yaml` to determine mode and paths:
+Đọc `project-context.yaml` để xác định mode và path:
 
 **Umbrella mode** (`setup.mode: umbrella`):
 ```
-spec_root      = {setup.spec_source}              ← PO's spec submodule
-prd_glob       = {spec_root}/specs/**/prd.md
+spec_root      = {setup.spec_source}              ← spec submodule của PO
+prd_glob       = {spec_root}/specs/*/*/*.md           ← file .md ở gốc feature folder = PRD ({TICKET-ID}-{prd-slug}.md)
 pdd_glob       = {spec_root}/specs/product-definition/**/*.md
-services       = {services}                        ← map of domain → paths
+services       = {services}                        ← map domain → paths
 ```
 
-**Single-service mode** (no `setup.mode`):
+**Single-service mode** (không có `setup.mode`):
 ```
 spec_root      = .
-prd_glob       = {paths.specs_dir}/**/prd.md
+prd_glob       = {paths.specs_dir}/*/*/*.md           ← file .md ở gốc feature folder = PRD ({TICKET-ID}-{prd-slug}.md)
 pdd_glob       = {paths.product_definitions_dir}/**/*.md
 services       = { default: { specs_dir: {paths.specs_dir}, tech_docs_dir: {paths.tech_docs_dir} } }
 ```
 
-If a domain filter was passed in `$ARGUMENTS` → only scan PRDs matching that domain.
+Nếu truyền domain filter trong `$ARGUMENTS` → chỉ quét PRD khớp domain đó.
 
 ---
 
-### Step 2 — Scan PRD files
+### Step 2 — Quét file PRD
 
-For each `.md` file matched by `prd_glob`:
+Với mỗi file `.md` khớp `prd_glob`:
 
-1. Read the file metadata table:
-   - `TICKET-ID` from `| **PRD ID** |`
-   - `domain` from `| **Domain** |`
-   - `status` from `| **Status** |`
-   - `version` from `| **Version** |`
-2. Also read frontmatter `@trace.domain` if present (use this over metadata table domain if both exist)
-3. Record: `{ ticket_id, domain, status, version, prd_path }` — path relative to manifest root
+1. Đọc bảng metadata của file:
+   - `TICKET-ID` từ `| **PRD ID** |`
+   - `domain` từ `| **Domain** |`
+   - `status` từ `| **Status** |`
+   - `version` từ `| **Version** |`
+2. Cũng đọc frontmatter `@trace.domain` nếu có (dùng cái này thay vì domain bảng metadata nếu cả hai tồn tại)
+3. Ghi: `{ ticket_id, domain, status, version, prd_path }` — path tương đối với manifest root
 
-Skip files where `TICKET-ID` cannot be determined.
+Skip file không xác định được `TICKET-ID`.
 
 ---
 
-### Step 3 — Match PDD files
+### Step 3 — Khớp file PDD
 
-For each TICKET-ID found in Step 2:
+Với mỗi TICKET-ID tìm thấy ở Step 2:
 
-Search `pdd_glob` for a file whose name contains the TICKET-ID (e.g. `FT-001-*.md`).
-- Found → record `pdd_path` (relative to manifest root)
-- Not found → record `pdd: null`
+Tìm `pdd_glob` một file có tên chứa TICKET-ID (vd `FT-001-*.md`).
+- Tìm thấy → ghi `pdd_path` (tương đối với manifest root)
+- Không thấy → ghi `pdd: null`
 
 ---
 
-### Step 4 — Match BDD and Tech-Doc files per service
+### Step 4 — Khớp file BDD và Tech-Doc theo từng service
 
-For each TICKET-ID, for each service in `services` map:
+Với mỗi TICKET-ID, với mỗi service trong map `services`:
 
 **BDD:**
 - Glob `{service.specs_dir}/**/{TICKET-ID}*.feature`
-- Also check files containing `@trace.prd: {TICKET-ID}` in frontmatter if glob returns nothing
-- Found → record path under `bdd.{service_key}`
-- Not found → omit key (do not write `null` for services with no BDD yet)
+- Cũng kiểm tra file chứa `@trace.prd: {TICKET-ID}` trong frontmatter nếu glob không trả gì
+- Tìm thấy → ghi path dưới `bdd.{service_key}`
+- Không thấy → bỏ key (đừng ghi `null` cho service chưa có BDD)
 
 **Tech-docs:**
 - Glob `{service.tech_docs_dir}/**/{TICKET-ID}*.md`
-- Also check files containing `@trace.prd: {TICKET-ID}` if glob returns nothing
-- Found → record path under `tech_docs.{service_key}`
-- Not found → omit key
+- Cũng kiểm tra file chứa `@trace.prd: {TICKET-ID}` nếu glob không trả gì
+- Tìm thấy → ghi path dưới `tech_docs.{service_key}`
+- Không thấy → bỏ key
 
-All paths relative to manifest root (umbrella root or project root).
+Mọi path tương đối với manifest root (umbrella root hoặc project root).
 
 ---
 
-### Step 5 — Write spec-manifest.yaml
+### Step 5 — Ghi spec-manifest.yaml
 
-Write to `{manifest_root}/spec-manifest.yaml` (overwrite if exists).
+Ghi vào `{manifest_root}/spec-manifest.yaml` (ghi đè nếu tồn tại).
 
 Format:
 
@@ -115,24 +115,24 @@ features:
       {service_key}: "{path}"       # only include services where file was found
 ```
 
-Sort features by TICKET-ID alphabetically.
-Omit `tech_docs` block entirely if no tech-doc found for any service.
-Omit `bdd` block entirely if no BDD found for any service.
+Sort features theo TICKET-ID alphabet.
+Bỏ hẳn block `tech_docs` nếu không tìm thấy tech-doc cho service nào.
+Bỏ hẳn block `bdd` nếu không tìm thấy BDD cho service nào.
 
 ---
 
-### Step 6 — Ensure .gitignore
+### Step 6 — Đảm bảo .gitignore
 
-Check `{manifest_root}/.gitignore`:
-- If `spec-manifest.yaml` is already listed → no action
-- If not → append the following to `.gitignore`:
+Kiểm tra `{manifest_root}/.gitignore`:
+- Nếu `spec-manifest.yaml` đã được liệt kê → không làm gì
+- Nếu chưa → append vào `.gitignore`:
 
 ```
 # Auto-generated — do not commit
 spec-manifest.yaml
 ```
 
-Print: `✅ spec-manifest.yaml added to .gitignore`
+In: `✅ spec-manifest.yaml added to .gitignore`
 
 ---
 
@@ -141,7 +141,7 @@ Print: `✅ spec-manifest.yaml added to .gitignore`
 {{include:steps/report-footer.md}}
 
 ```
-/generate-spec-manifest Complete
+/generate-spec-manifest Hoàn tất
 ---
 Status  : ✅ Complete
 Output  : spec-manifest.yaml  ({N} features)
@@ -149,16 +149,16 @@ Mode    : {umbrella | single}
 .gitignore : ✅ spec-manifest.yaml excluded
 
 Summary:
-  {N} PRDs scanned  ({A} approved, {D} draft)
-  {N} PDDs matched
-  {N} BDD files matched  (across {S} services)
-  {N} Tech-doc files matched  (across {S} services)
-
-  ⚠️  {N} PRDs with no matching BDD:
-    - {TICKET-ID} ({domain}) — run /generate-bdd first
-  ⚠️  {N} PRDs with no matching tech-docs:
-    - {TICKET-ID} ({domain}) — run /generate-tech-docs first
-
-Next   : Share spec-manifest.yaml path with tester agent
-         Regenerate anytime: /generate-spec-manifest
+  {N} PRD scanned  ({A} approved, {D} draft)
+  {N} PDD matched
+  {N} BDD file matched  (across {S} services)
+  {N} Tech-doc file matched  (across {S} services)
+
+  ⚠️  {N} PRD không có BDD khớp:
+    - {TICKET-ID} ({domain}) — chạy /generate-bdd trước
+  ⚠️  {N} PRD không có tech-docs khớp:
+    - {TICKET-ID} ({domain}) — chạy /generate-tech-docs trước
+
+Next   : Chia sẻ path spec-manifest.yaml với tester agent
+         Sinh lại bất cứ lúc nào: /generate-spec-manifest
 ```