@educa-corp/sdd-framework 0.4.2 → 0.6.0

package/commands/generate-prd.tmpl

@@ -1,6 +1,9 @@
 # /generate-prd — Sinh Product Requirements Document
 
 ## Gate
+
+*Checkpoint: **chặn CỨNG** — ghi đè PRD đã có → mất changelog, ĐÁNH SỐ LẠI BR, phá @trace.business_rules trong mọi .feature đã sinh. `--yes` KHÔNG bỏ qua được (gate Bước 3a).*
+
 {{include:steps/gate.md}}
 
 *Lưu ý: Với lệnh này, target file ở Bước 1 là một file product-definition trong `{paths.product_definitions_dir}/`. Phân giải từ `$ARGUMENTS` hoặc liệt kê thư mục và hỏi.*
@@ -141,6 +144,31 @@ Khi viết AC, nếu PO đề cập chi tiết visual (màu sắc, animation, la
 
 ---
 
+## Guard — PRD đã tồn tại *(chạy TRƯỚC khi ghi bất cứ gì)*
+
+Kiểm `{paths.specs_dir}/{domain}/{prd-slug}/{TICKET-ID}-{prd-slug}.md`.
+
+**Tồn tại → DỪNG. KHÔNG ghi, KHÔNG hỏi Y/N.** Đọc `| **Version** |`, `| **Status** |`, và số row `# Change Log` để in:
+
+```
+❌ PRD đã tồn tại: {path}
+   Hiện: v{version} · Status {status} · {n} row Change Log
+
+   /generate-prd chỉ sinh PRD MỚI. Ghi đè sẽ mất:
+     • toàn bộ # Change Log (và file changelog/ đã rollover)
+     • Version thật → về 1.0 · Status approved → về draft
+     • đánh số lại BR từ đầu → HỎNG mọi @trace.business_rules trong bdd/ đã sinh
+
+   Muốn THÊM yêu cầu vào PRD này   → /extend-prd {path}
+   Muốn sửa theo findings review    → /refine-prd {path}  rồi  --resume
+   Thật sự muốn làm lại từ đầu      → xoá/đổi tên file cũ rồi chạy lại (tự chịu trách nhiệm)
+```
+
+> **Vì sao DỪNG HẲN chứ không hỏi Y/N:** ghi đè một PRD đã ký duyệt không phải thứ nên nằm sau một phím bấm. Ba mất mát trên đều **không thể hoàn tác** từ trong lệnh, và cái thứ ba (BR ID churn) lan ra ngoài file — nó phá liên kết ở mọi `.feature` đã sinh, mà chính lệnh này đã dựng một guard riêng để chống ở thao tác *mở cột bảng BR*. Cùng thiệt hại, cùng phải chặn.
+> `rules/workflow.md` có luật chung *"Prefer editing existing files over replacing"*, nhưng đó là prose toàn cục — không phải guard trong lệnh, nên không chặn được ai.
+
+---
+
 ## Generate
 
 Ghi `{paths.specs_dir}/{domain}/{prd-slug}/{TICKET-ID}-{prd-slug}.md` theo cấu trúc dưới đây.