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

package/core/steps/capture-lesson.md

@@ -1,71 +1,71 @@
-# Capture Lesson — Record a Recurring Mistake as a Guardrail
+# Capture Lesson — Ghi lại lỗi lặp lại thành một Guardrail
 
-Reusable procedure to persist a "lesson" so the AI does not repeat a mistake in this project.
-Used by `/learn` (manual) and offered by `/review-code`, `/fix-bug`, `/debug` (auto).
+Quy trình tái sử dụng để lưu một "lesson" nhằm tránh AI lặp lại lỗi trong dự án này.
+Dùng bởi `/learn` (thủ công) và được đề xuất bởi `/review-code`, `/fix-bug`, `/debug` (tự động).
 
-> **Project memory, not model training.** A lesson is plain text injected into context at the
-> start of every command (context-loader Step 6.7). Functionally this stops the repeat — the AI
-> sees the guardrail before it generates. No model weights change.
+> **Bộ nhớ dự án, không phải huấn luyện model.** Một lesson là văn bản thuần được inject vào context ở
+> đầu mỗi lệnh (context-loader Bước 6.7). Về mặt chức năng, điều này chặn việc lặp lại — AI thấy
+> guardrail trước khi sinh nội dung. Không có trọng số model nào thay đổi.
 
-## L1 — Resolve the lessons file
+## L1 — Phân giải file lessons
 
-Resolve `lessons_path` in this order:
-1. `paths.lessons_file` from loaded context (may be service-overridden in umbrella mode, Step 1.6)
-2. Default `specs/domain-knowledge/lessons-learned.md` (single-service)
-3. In umbrella/service mode (when `service_root` is set) default `{service_root}/.agent/project-lessons.md`
+Phân giải `lessons_path` theo thứ tự sau:
+1. `paths.lessons_file` từ context đã nạp (có thể bị service override ở chế độ umbrella, Bước 1.6)
+2. Mặc định `specs/domain-knowledge/lessons-learned.md` (single-service)
+3. Ở chế độ umbrella/service (khi `service_root` được set) mặc định `{service_root}/.agent/project-lessons.md`
 
-## L2 — Build the lesson
+## L2 — Dựng lesson
 
-Gather these fields — from `$ARGUMENTS` (for `/learn`) or from the calling command's findings
-(for `/review-code`, `/fix-bug`, `/debug`):
+Thu thập các field sau — từ `$ARGUMENTS` (cho `/learn`) hoặc từ findings của lệnh gọi
+(cho `/review-code`, `/fix-bug`, `/debug`):
 
-| Field | Meaning |
+| Field | Ý nghĩa |
 |-------|---------|
-| `category` | one of: `code-gen` \| `bdd` \| `tech-docs` \| `tests` \| `prd` \| `general` |
-| `title` | short phrase naming the mistake |
-| `mistake` | concretely, what the AI did wrong |
-| `rule` | imperative correction — "Always …" / "Never …" — testable, not vague |
-| `scope` | where it applies: a domain, a file glob (e.g. `*Controller.*`), or `all` |
-| `source` | how captured: `/learn` \| `/review-code {UC-ID}` \| `/fix-bug {TICKET}` \| `/debug` |
+| `category` | một trong: `code-gen` \| `bdd` \| `tech-docs` \| `tests` \| `prd` \| `general` |
+| `title` | cụm từ ngắn đặt tên cho lỗi |
+| `mistake` | cụ thể, AI đã làm sai điều gì |
+| `rule` | câu sửa mệnh lệnh — "Luôn …" / "Không bao giờ …" — testable, không mơ hồ |
+| `scope` | phạm vi áp dụng: một domain, một file glob (vd `*Controller.*`), hoặc `all` |
+| `source` | cách ghi nhận: `/learn` \| `/review-code {UC-ID}` \| `/fix-bug {TICKET}` \| `/debug` |
 
-If `rule` is vague (e.g. "be careful"), rewrite it into a concrete, checkable instruction before saving.
+Nếu `rule` mơ hồ (vd "cẩn thận"), viết lại thành chỉ dẫn cụ thể, kiểm tra được trước khi lưu.
 
-## L3 — De-duplicate
+## L3 — Khử trùng lặp
 
-Read existing lessons in `lessons_path`. If one already covers the same mistake:
-- **Refine** that entry (tighten the Rule, widen/narrow Scope, bump Date, append the new Source) — do NOT add a duplicate.
+Đọc các lesson hiện có trong `lessons_path`. Nếu đã có một lesson cùng lỗi:
+- **Tinh chỉnh** entry đó (siết chặt Rule, mở rộng/thu hẹp Scope, cập nhật Date, thêm Source mới) — KHÔNG thêm bản trùng.
 
-Otherwise assign the next id `L-{NNN}` = (highest existing number + 1), zero-padded to 3 digits.
+Nếu không, gán id kế tiếp `L-{NNN}` = (số lớn nhất hiện có + 1), pad 0 đủ 3 chữ số.
 
-## L4 — Write
+## L4 — Ghi
 
-If `lessons_path` does not exist, create it with this header first:
+Nếu `lessons_path` chưa tồn tại, tạo file với header sau trước:
 
 ```markdown
 # Project Lessons — Learned Guardrails
 
-> Mistakes the AI must NOT repeat in this project. Loaded by context-loader at the start of
-> every command and treated as hard constraints (same priority as CLAUDE.md coding standards).
-> Add with /learn, or accept the prompt during /review-code, /fix-bug, /debug.
-> Commit this file so the whole team shares the guardrails.
+> Các lỗi AI KHÔNG được lặp lại trong dự án này. Được nạp bởi context-loader ở đầu
+> mỗi lệnh và coi như ràng buộc cứng (cùng mức ưu tiên với coding standards trong CLAUDE.md).
+> Thêm bằng /learn, hoặc chấp nhận prompt trong /review-code, /fix-bug, /debug.
+> Commit file này để cả team dùng chung guardrail.
 
-| Category | Applies to |
+| Category | Áp dụng cho |
 |----------|-----------|
-| code-gen | /generate-code output |
-| bdd | /generate-bdd output |
-| tech-docs | /generate-tech-docs output |
-| tests | /dev-gen-test output |
-| prd | /generate-prd, /refine-prd output |
-| general | every command |
+| code-gen | output của /generate-code |
+| bdd | output của /generate-bdd |
+| tech-docs | output của /generate-tech-docs |
+| tests | output của /dev-gen-test |
+| prd | output của /generate-prd, /refine-prd |
+| general | mọi lệnh |
 
 ---
 ```
 
-Insert the new lesson directly under the `---` separator (**newest first**), in this exact shape:
+Chèn lesson mới ngay dưới dấu phân cách `---` (**mới nhất lên đầu**), theo đúng dạng:
 
 ```markdown
 ### L-{NNN} — [{category}] {title}
-- **Date**: {today YYYY-MM-DD}
+- **Date**: {hôm nay YYYY-MM-DD}
 - **Scope**: {scope}
 - **Mistake**: {mistake}
 - **Rule**: {rule}
@@ -73,7 +73,7 @@ Insert the new lesson directly under the `---` separator (**newest first**), in
 
 ```
 
-## L5 — Confirm
+## L5 — Xác nhận
 
-Print: `📝 Lesson {id} recorded → {lessons_path}  ([{category}] {title})`
-Then remind: `Commit {lessons_path} so the team shares this guardrail.`
+In: `📝 Đã ghi lesson {id} → {lessons_path}  ([{category}] {title})`
+Rồi nhắc: `Commit {lessons_path} để cả team dùng chung guardrail này.`