@educa-corp/sdd-framework 0.4.2 → 0.6.0

package/commands/propose-scenario.tmpl

@@ -54,7 +54,16 @@ Ghi vào `{paths.prd_change_requests_dir}/{UC-ID}-{slug}.md` (phân giải về
 
 **Requested behavior:** {description}
 **Suggested AC (draft cho PO):** "{draft AC text}"
-**Route to PO:** thêm/mở rộng một AC trong {prd_path} → `/refine-prd` → chạy lại `/generate-bdd` → dev `/generate-code`.
+**Route to PO:**
+1. Đặt `Status: accepted` trong file này nếu nhận yêu cầu.
+2. Chạy **`/extend-prd {prd_path}`** — nó tự nhặt request `accepted`, hỏi PO chốt AC/BR đúng
+   tầng, đánh số **nối tiếp** (không đụng ID cũ), bump version + ghi changelog nêu rõ scope,
+   rồi đóng dấu `incorporated` + chuyển file này sang `archived/`.
+3. `/refine-prd` → `/review-context` → PO đặt `approved` → `/generate-bdd` **chỉ cho UC MỚI**.
+
+⚠️ **KHÔNG dùng `/refine-prd` để thêm AC mới.** Nó chỉ áp findings từ review và có luật cấm
+   đụng section nào không được finding tham chiếu. **KHÔNG dùng `/generate-prd`** — nó từ chối
+   chạy trên PRD đã có (ghi đè sẽ mất changelog + đánh số lại BR).
 ```
 Rồi sang Step 5 (handoff áp dụng cho file này luôn). Skip Step 3–4 (không có BDD scenario cho Case B).
 
@@ -117,6 +126,14 @@ git push                      # → PO/Dev thấy nó ở lần /sync tiếp the
 
 {{include:steps/report-footer.md}}
 
+> **Hai khối report — chọn theo case đã chốt ở Step 2. In ĐÚNG MỘT khối.**
+> Case A và Case B tạo ra hai loại artifact khác nhau, ở hai thư mục khác nhau, và đi hai
+> đường xử lý khác nhau. In khối Case A cho một request Case B là báo cáo sai việc vừa làm:
+> nó chỉ sai thư mục, in một scenario không tồn tại, và bảo người dùng chờ `/generate-bdd`
+> nhặt — trong khi lệnh đó **không bao giờ** đọc `prd-change-requests/`.
+
+### Khối Case A — scenario proposal *(behavior nằm trong một AC có sẵn)*
+
 ```
 📝 Scenario proposal → {paths.bdd_proposals_dir}/{UC-ID}-{slug}.md
 
@@ -149,3 +166,37 @@ Status : ✅ Complete (read-only trên BDD canonical — chỉ proposal)
 Output Artifacts: created {paths.bdd_proposals_dir}/{UC-ID}-{slug}.md (pushed to shared spec repo)
 Next   : PO/Dev thấy nó ở lần /sync tiếp theo → review & promote
 ```
+
+### Khối Case B — PRD change request *(requirement mới, không AC nào phủ)*
+
+```
+📋 PRD change request → {paths.prd_change_requests_dir}/{UC-ID}-{slug}.md
+
+UC         : {UC-ID} ({active_platform})
+Loại       : requirement MỚI — không AC nào phủ  (KHÔNG phải coverage gap)
+PRD        : {prd_path} (v{prd_version})
+Source     : {BUG-ID nếu có | quan sát tester/QC}
+Behavior   : {description}
+Draft AC   : "{draft AC text}"   ← đề xuất cho PO cân nhắc, PO chốt lại
+
+⚠️  Lệnh này KHÔNG sinh BDD scenario nào — scenario chưa có AC để trace tới.
+    Nó chỉ xuất hiện SAU KHI PO đưa requirement vào PRD rồi chạy lại /generate-bdd.
+    Và vì chưa có AC, KHÔNG cờ trace nào bắt được thiếu sót này: theo mọi thước đo
+    coverage hiện tại thì hành vi bạn vừa phát hiện không tồn tại.
+
+Để PO xử lý:
+  [ ] Đọc request, quyết định nhận hay không
+  [ ] Nhận → đặt Status: accepted trong file request
+  [ ] /extend-prd {prd-file}   ← nhặt request, chốt AC/BR với PO, đánh số nối tiếp,
+                                 bump version + changelog, tự đóng dấu incorporated
+  [ ] /refine-prd → /review-context {prd-file}   ← soi + kiểm phần vừa thêm
+  [ ] PO đặt Status: approved  →  /generate-bdd {prd-file}  (CHỈ UC mới)  →  /generate-code
+
+Handoff : {✅ committed + pushed to spec repo | ⚠️ chạy git command ở trên / mở PR}
+
+---
+Status : ✅ Complete (không đụng BDD — đây là yêu cầu đổi tài liệu, không phải scenario)
+Output Artifacts: created {paths.prd_change_requests_dir}/{UC-ID}-{slug}.md (pushed to shared spec repo)
+Next   : PO thấy nó ở lần /sync tiếp theo. Nếu chưa xử, /validate-traces sẽ nhắc lại
+         (kèm số ngày chờ) mỗi lần chạy, chừng nào Status còn Open.
+```