@educa-corp/sdd-framework 0.5.0 → 0.6.0

package/commands/learn.tmpl

@@ -3,8 +3,10 @@
 Bắt một lỗi mà AI cứ lặp lại để nó **không bị lặp nữa**. Lesson được lưu trong file
 lessons của dự án này và nạp vào context ở đầu mỗi lệnh.
 
-Usage: `/learn {free-text}` — lý tưởng diễn đạt kiểu "AI làm X, nên làm Y".
-Ví dụ: `/learn AI cứ gọi repository trực tiếp từ controller — nó phải đi qua service layer`
+Usage:
+- `/learn {free-text}` — ghi lesson mới. Lý tưởng diễn đạt kiểu "AI làm X, nên làm Y".
+  Ví dụ: `/learn AI cứ gọi repository trực tiếp từ controller — nó phải đi qua service layer`
+- **`/learn --review`** — rà lại lesson đang có, đề nghị retire cái đã hết đúng.
 
 > Đây là **bộ nhớ dự án**, không phải fine-tune model. Lesson trở thành guardrail đang hoạt động nhờ
 > được inject vào context mỗi lần chạy (xem context-loader Bước 6.7).
@@ -19,6 +21,53 @@ Ví dụ: `/learn AI cứ gọi repository trực tiếp từ controller — nó
 
 ---
 
+## Step 0 — Chế độ `--review` *(nếu `$ARGUMENTS` chứa `--review`)*
+
+*Chạy nhánh này rồi DỪNG — không đi tiếp Step 1/2.*
+
+Đọc `lessons_path` (đã phân giải ở context-loader Bước 6.7), parse **mọi** lesson kể cả
+`Status: retired`. Với mỗi lesson `active`, phân loại:
+
+**🔴 Đề nghị retire — kiểm được bằng máy.** `Scope` là một **file glob** (vd `*ServiceImpl.java`)
+mà glob đó **không còn khớp file nào** trong repo → code lesson canh đã không còn tồn tại.
+
+**⚠️ Rà lại — không tự kiểm được.** `Scope` là `all` hoặc một domain (không phải glob file), **và**
+`Date` cũ hơn 6 tháng. Không suy ra được nó còn đúng hay không — chỉ liệt kê theo tuổi để người quyết.
+
+**✅ Còn sống.** Scope là glob và còn khớp ≥1 file.
+
+In:
+
+```
+/learn --review — {tổng} lesson ({n_active} active · {n_retired} retired)
+
+🔴 Đề nghị retire — Scope không còn khớp file nào:
+   L-003  [code-gen]  *RestTemplate*.java   · ghi 2026-08 · 0 file khớp
+          Rule: Luôn dùng WebClient thay RestTemplate
+   L-011  [tests]     *LegacyApiTest.java   · ghi 2026-11 · 0 file khớp
+
+⚠️ Rà lại — scope rộng, không tự kiểm được:
+   L-002  [general]   scope: all            · ghi 2026-07 (13 tháng)
+
+✅ {n} lesson còn sống, scope vẫn khớp
+
+Retire cái nào? (nhập id cách nhau bởi dấu phẩy, hoặc Enter để bỏ qua)
+```
+
+Người dùng nhập id → với mỗi id, **đổi `Status: active` → `retired`** và **chèn** dòng
+`- **Retired**: {hôm nay} — {lý do ngắn}` ngay dưới. **KHÔNG xoá dòng nào** (xem
+`capture-lesson.md` §Retire — lesson retired ở lại làm lịch sử).
+
+Không có lesson nào → in `Chưa có lesson nào được ghi nhận.` rồi dừng.
+
+> **Vì sao lệnh này tồn tại (GAPS-v3 G46):** trước nó, file lessons **chỉ có đường vào** —
+> `/learn`, `/review-code`, `/fix-bug`, `/debug` đều ghi thêm được, không gì gỡ ra. Mỗi lesson
+> được nạp làm *"ràng buộc cứng, cùng mức ưu tiên với CLAUDE.md"*, **vĩnh viễn**, kể cả khi code
+> nó canh đã bị xoá. Nhóm 🔴 ở trên là **cơ học, không phải phỏng đoán**: glob không khớp file
+> nào thì lesson đó đã chết, không cần tranh luận.
+
+---
+
 ## Step 1 — Parse Lesson
 
 Đọc `$ARGUMENTS` như một mô tả free-text.
@@ -53,7 +102,7 @@ Hiện lesson đã parse và hỏi `Lưu lesson này? (Y/N)` trước khi ghi.
    Scope : {scope}
    File  : {lessons_path}
 
-Guardrail này giờ được nạp ở đầu mỗi lệnh.
+Guardrail này giờ được nạp ở đầu mỗi lệnh có category khớp (+ general).
 Commit {lessons_path} để team dùng chung.
 
 ---
@@ -61,3 +110,21 @@ Status : ✅ Complete
 Output Artifacts: updated {lessons_path}
 Next   : tiếp tục làm việc — AI sẽ tôn trọng lesson này từ giờ
 ```
+
+**Chế độ `--review`** dùng report riêng:
+
+```
+/learn --review — {n} lesson đã retire
+
+🔻 L-003 [code-gen] active → retired
+      lý do: Scope *RestTemplate*.java không còn khớp file nào
+🔻 L-011 [tests]    active → retired
+
+Chúng vẫn ở lại trong {lessons_path} làm lịch sử — chỉ thôi được nạp làm ràng buộc.
+Còn lại {n_active} guardrail đang hoạt động.
+
+---
+Status : ✅ Complete
+Output Artifacts: updated {lessons_path}
+Next   : commit {lessons_path}
+```