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

package/commands/learn.tmpl

@@ -1,39 +1,39 @@
-# /learn — Record a Project Lesson (Guardrail)
+# /learn — Ghi một Project Lesson (Guardrail)
 
-Capture a mistake the AI keeps making so it is **not repeated**. The lesson is stored in this
-project's lessons file and loaded into context at the start of every command.
+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}` — ideally phrased as "AI does X, should do Y".
-Example: `/learn AI keeps calling the repository directly from controllers — it must go through the service layer`
+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`
 
-> This is **project memory**, not model fine-tuning. The lesson becomes an active guardrail by
-> being injected into context on every run (see context-loader Step 6.7).
+> Đâ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).
 
 ## Gate
 {{include:steps/gate.md}}
 
-*Note: For this command — skip Gate Step 1 (no target file). The "target" is the lesson text in `$ARGUMENTS`. Run the model check and context loading, then proceed.*
+*Lưu ý: Với lệnh này — bỏ qua Gate Bước 1 (không có target file). "Target" là text lesson trong `$ARGUMENTS`. Chạy model check và context loading, rồi tiếp tục.*
 
 ## Context
 {{include:steps/context-loader.md}}
 
 ---
 
-## Step 1 — Parse the Lesson
+## Step 1 — Parse Lesson
 
-Read `$ARGUMENTS` as a free-text description.
+Đọc `$ARGUMENTS` như một mô tả free-text.
 
-Split it into a **mistake** (what the AI did wrong) and a **rule** (the imperative correction).
-- If `$ARGUMENTS` is empty or too vague to split, ask the user briefly:
+Tách thành một **mistake** (AI làm sai gì) và một **rule** (câu sửa mệnh lệnh).
+- Nếu `$ARGUMENTS` rỗng hoặc quá mơ hồ để tách, hỏi người dùng ngắn gọn:
   ```
-  Record a project lesson. Answer 2 things:
-    1. What did the AI get wrong?  (the mistake)
-    2. What is the correct rule?   (imperative — "Always…/Never…")
+  Ghi một project lesson. Trả lời 2 điều:
+    1. AI làm sai gì?  (the mistake)
+    2. Quy tắc đúng là gì?   (mệnh lệnh — "Luôn…/Không bao giờ…")
   ```
-- Infer `category` (code-gen | bdd | tech-docs | tests | prd | general) and `scope` (domain / file glob / all)
-  from the description. If ambiguous, confirm with the user in one line.
+- Suy ra `category` (code-gen | bdd | tech-docs | tests | prd | general) và `scope` (domain / file glob / all)
+  từ mô tả. Nếu mơ hồ, xác nhận với người dùng trong một dòng.
 
-Show the parsed lesson and ask `Save this lesson? (Y/N)` before writing.
+Hiện lesson đã parse và hỏi `Lưu lesson này? (Y/N)` trước khi ghi.
 
 ## Step 2 — Capture
 
@@ -46,18 +46,18 @@ Show the parsed lesson and ask `Save this lesson? (Y/N)` before writing.
 {{include:steps/report-footer.md}}
 
 ```
-/learn — lesson recorded
+/learn — lesson đã ghi
 
 📝 {id} — [{category}] {title}
    Rule  : {rule}
    Scope : {scope}
    File  : {lessons_path}
 
-This guardrail is now loaded at the start of every command.
-Commit {lessons_path} so your team shares it.
+Guardrail này giờ được nạp ở đầu mỗi lệnh.
+Commit {lessons_path} để team dùng chung.
 
 ---
 Status : ✅ Complete
 Output Artifacts: updated {lessons_path}
-Next   : continue working — the AI will respect this lesson from now on
+Next   : tiếp tục làm việc — AI sẽ tôn trọng lesson này từ giờ
 ```