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

package/core/commands/update-framework.md

@@ -1,30 +1,30 @@
-# /update-framework — Update the Spec-Driven Docs Framework
+# /update-framework — Cập nhật Spec-Driven Docs Framework
 
-Upgrades the **framework tooling** (`.agent/commands/`, `steps/`, `modules/`, `hooks/`, `rules/`, `templates/`, `skills/`) to the latest published version from npm.
+Nâng cấp **framework tooling** (`.agent/commands/`, `steps/`, `modules/`, `hooks/`, `rules/`, `templates/`, `skills/`) lên version mới nhất publish trên npm.
 
-> **Not the same as `/sync`.**
-> - `/sync` → pulls **project content** (submodule code/specs) + refreshes Living Docs. Run daily.
-> - `/update-framework` → upgrades the **framework command files themselves**. Run occasionally, when a new framework version ships.
+> **Không giống `/sync`.**
+> - `/sync` → pull **nội dung dự án** (code/specs submodule) + làm mới Living Docs. Chạy hằng ngày.
+> - `/update-framework` → nâng cấp **chính các file command của framework**. Chạy thỉnh thoảng, khi có version framework mới.
 
-This command wraps `npx @edupia-tutor/spec-driven-docs@latest --init`. It requires network + npm access.
+Lệnh này wrap `npx @edupia-tutor/spec-driven-docs@latest --init`. Cần network + npm access.
 
 ---
 
-## Step 0 — Detect Current State
+## Step 0 — Phát hiện trạng thái hiện tại
 
-1. Read `.agent/FRAMEWORK_VERSION` → current installed version.
-   - If missing → this project was not installed via `--init`. Stop:
+1. Đọc `.agent/FRAMEWORK_VERSION` → version đang cài.
+   - Nếu thiếu → dự án này không được cài qua `--init`. Dừng:
      ```
      ❌ .agent/FRAMEWORK_VERSION not found.
         This project was not set up with the framework installer.
         Run: npx @edupia-tutor/spec-driven-docs --init
      ```
 
-2. Read `.agent/project-context.yaml` → extract `setup.mode` (`umbrella` / absent = single) and `services`.
+2. Đọc `.agent/project-context.yaml` → trích `setup.mode` (`umbrella` / vắng = single) và `services`.
 
-3. List `.agent/modules/` → record installed module names (these must be re-passed on upgrade so they update too).
+3. Liệt kê `.agent/modules/` → ghi tên các module đã cài (phải truyền lại khi nâng cấp để chúng cũng update).
 
-Print:
+In:
 ```
 Current framework : v{current}
 Mode              : {umbrella | single-service}
@@ -33,28 +33,28 @@ Installed modules : {list or "none"}
 
 ---
 
-## Step 1 — Check Latest Version
+## Step 1 — Kiểm tra version mới nhất
 
-Run:
+Chạy:
 ```bash
 npm view @edupia-tutor/spec-driven-docs version
 ```
 
-Compare `current` vs `latest`:
+So `current` vs `latest`:
 
-| Result | Action |
+| Kết quả | Hành động |
 |--------|--------|
-| Network/registry unreachable | Warn `⚠️ Could not reach npm registry — check connection.` and stop |
-| `current == latest` | Print `✅ Already up to date (v{current}). Nothing to do.` and stop |
-| `latest > current` | Print `Update available: v{current} → v{latest}` and continue |
+| Network/registry không tới được | Cảnh báo `⚠️ Could not reach npm registry — check connection.` và dừng |
+| `current == latest` | In `✅ Already up to date (v{current}). Nothing to do.` và dừng |
+| `latest > current` | In `Update available: v{current} → v{latest}` và tiếp tục |
 
-Ask: `Proceed with upgrade? (Y/N)` — wait for `Y`.
+Hỏi: `Proceed with upgrade? (Y/N)` — chờ `Y`.
 
 ---
 
-## Step 2 — Umbrella Awareness *(umbrella mode only)*
+## Step 2 — Umbrella Awareness *(chỉ umbrella mode)*
 
-If `setup.mode == umbrella`, print this note before upgrading:
+Nếu `setup.mode == umbrella`, in note này trước khi nâng cấp:
 
 ```
 ℹ️ Umbrella mode — framework tooling lives ONLY at this umbrella root.
@@ -71,92 +71,92 @@ If `setup.mode == umbrella`, print this note before upgrading:
 
 ## Step 3 — Pre-flight Git Check
 
-Run `git status --short .agent/ .claude/commands/`.
+Chạy `git status --short .agent/ .claude/commands/`.
 
-If there are uncommitted changes in those paths:
+Nếu có thay đổi chưa commit trong các path đó:
 ```
 ⚠️ Uncommitted changes in .agent/ or .claude/commands/.
    The upgrade overwrites framework files. Commit or stash first so you can
    cleanly review the upgrade diff:
      git add .agent/ .claude/commands/ && git commit -m "wip"  (or git stash)
 ```
-Ask whether to continue anyway `(Y/N)`. Default to stopping.
+Hỏi có tiếp tục không `(Y/N)`. Mặc định dừng.
 
 ---
 
-## Step 4 — Run the Upgrade
+## Step 4 — Chạy nâng cấp
 
-Build the module flags from Step 0 (one `--module {name}` per installed module), then run:
+Dựng module flag từ Step 0 (một `--module {name}` cho mỗi module đã cài), rồi chạy:
 
 ```bash
 npx -y @edupia-tutor/spec-driven-docs@latest --init {--module X ...}
 ```
 
-This **overwrites** (refreshes to the new version):
+Cái này **ghi đè** (làm mới về version mới):
 - `.agent/commands/`, `.agent/steps/`, `.agent/hooks/`, `.agent/rules/`, `.agent/templates/`, `.agent/skills/`, `.agent/modules/{installed}/`
 - `.agent/FRAMEWORK_VERSION`
 - `.claude/commands/` shortcuts
 
-This **does NOT touch** (your content is safe):
+Cái này **KHÔNG đụng tới** (nội dung của bạn an toàn):
 - `.agent/project-context.yaml`
 - `CLAUDE.md`
 - `specs/domain-knowledge/` (business-dictionary, core-entities)
 - `.trace/`
 
-If the npx command exits non-zero → print the error and stop with `❌`.
+Nếu lệnh npx exit khác 0 → in lỗi và dừng với `❌`.
 
 ---
 
 ## Step 5 — Review Changes
 
-Run:
+Chạy:
 ```bash
 git diff --stat .agent/ .claude/commands/
 ```
 
-Summarize for the user:
-- **New commands** — `.md` files present now but not before
-- **Updated commands** — files with changed content
-- **Removed commands** — files deleted in the new version
+Tóm tắt cho người dùng:
+- **New commands** — file `.md` giờ có mà trước không
+- **Updated commands** — file có nội dung thay đổi
+- **Removed commands** — file bị xoá trong version mới
 
-If a new command appeared (e.g. a new slash command), call it out explicitly so the user knows it is now available.
+Nếu có command mới xuất hiện (vd một slash command mới), nêu rõ để user biết nó giờ đã có.
 
 ---
 
 ## Output
 
-# Report Footer — Standard Command Output Format
+# Report Footer — Định dạng output chuẩn cho mọi lệnh
 
-Every command report must end with this standard footer section.
+Mọi report của lệnh phải kết thúc bằng section footer chuẩn này.
 
 ## Status Badge
 
-Choose one based on outcome:
-- `✅ Complete` — all steps succeeded, no issues found
-- `❌ Failed` — command could not complete due to a blocking error
-- `⚠️ Warnings` — completed with non-blocking issues that should be reviewed
+Chọn một theo kết quả:
+- `✅ Complete` — mọi bước thành công, không có vấn đề
+- `❌ Failed` — lệnh không hoàn thành được do lỗi chặn
+- `⚠️ Warnings` — hoàn thành nhưng có vấn đề không chặn, nên review lại
 
 ## Output Artifacts
 
-List every file created or modified by this command:
+Liệt kê mọi file được tạo hoặc sửa bởi lệnh này:
 ```
 Output Artifacts:
-  {created|updated} {file-path} ({brief description})
-  {created|updated} {file-path} ({brief description})
+  {created|updated} {file-path} ({mô tả ngắn})
+  {created|updated} {file-path} ({mô tả ngắn})
 ```
 
-If no files were written (e.g., review or analysis commands) → write `Output Artifacts: none (read-only)`.
+Nếu không ghi file nào (vd: lệnh review hoặc phân tích) → ghi `Output Artifacts: none (read-only)`.
 
 ## Pipeline Position
 
-Print a one-line map of the pipeline with the CURRENT command's phase marked `◀ bạn ở đây`,
-so the user always sees where this command sits in the end-to-end flow:
+In một sơ đồ pipeline một dòng, đánh dấu phase của lệnh HIỆN TẠI bằng `◀ bạn ở đây`,
+để người dùng luôn thấy lệnh này nằm ở đâu trong luồng end-to-end:
 
 ```
 Discovery → PRD → [Design Spec] → BDD → Tech Design → Code → Dev Self-Check → QC → Trace Audit
 ```
 
-Find the current command in this phase legend and mark **its** phase in the map above:
+Tìm lệnh hiện tại trong bảng phase dưới đây và đánh dấu **phase của nó** trong sơ đồ trên:
 
 | Phase | Commands |
 |-------|----------|
@@ -170,61 +170,61 @@ Find the current command in this phase legend and mark **its** phase in the map
 | QC | `/qc-analyze` · `/qc-plan` · `/qc-design-test` · `/qc-review` · `/qc-run-test` · `/qc-report` |
 | Trace Audit | `/validate-traces` |
 
-For a **review command**, also append the 3-step review loop with the current step marked, e.g.:
+Với **lệnh review**, thêm vòng review 3 bước và đánh dấu bước hiện tại, vd:
 `Vòng review: [① phân tích ◀] → ② Review Board → ③ --resume`.
 
-**Cross-cutting commands** (`/sync`, `/update-framework`, `/fix-bug`, `/debug`, `/learn`,
-`/report-bug`, `/propose-scenario`, `/generate-spec-manifest`) sit outside the linear pipeline —
-**omit the Pipeline line entirely** for these (do not force-fit them onto the map).
+**Lệnh xuyên suốt** (`/sync`, `/update-framework`, `/fix-bug`, `/debug`, `/learn`,
+`/report-bug`, `/propose-scenario`, `/generate-spec-manifest`) nằm ngoài pipeline tuyến tính —
+**bỏ hẳn dòng Pipeline** cho các lệnh này (đừng cố nhét chúng vào sơ đồ).
 
-## Next Command Suggestion
+## Gợi ý lệnh tiếp theo
 
-Suggest the logical next command based on workflow phase:
+Gợi ý lệnh kế tiếp hợp lý theo phase của workflow:
 
-| Current command         | Suggest next                                  |
+| Lệnh hiện tại           | Gợi ý lệnh tiếp theo                          |
 |-------------------------|-----------------------------------------------|
-| /setup-ai-first         | `/define-product` to start your first feature |
+| /setup-ai-first         | `/define-product` để bắt đầu feature đầu tiên |
 | /define-product         | `/generate-prd {product-definition-file}`     |
-| /generate-prd           | `/refine-prd {prd-file}` then `/review-context {prd-file}` |
-| /refine-prd             | Open Review Board → update PRD → `/review-context {prd-file}` |
-| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (then BDD after sign-off); BE: `/generate-bdd {prd-file}` directly; fix PRD if NEEDS_FIX |
-| /generate-design-spec   | Designer review → Figma links confirmed → PO + Designer sign-off → `/generate-bdd {prd-file}` |
-| /generate-bdd           | `/review-context {feature-file}` to verify coverage |
-| /review-context (BDD)   | `/generate-tech-docs {UC-ID}` if APPROVED; regenerate if NEEDS_FIX |
-| /qc-analyze             | `/qc-plan {UC-ID}` (resolve 🔴 blocker gaps first) |
+| /generate-prd           | `/refine-prd {prd-file}` rồi `/review-context {prd-file}` |
+| /refine-prd             | Mở Review Board → cập nhật PRD → `/review-context {prd-file}` |
+| /review-context (PRD)   | FE/App: `/generate-design-spec {prd-file}` (rồi BDD sau khi sign-off); BE: `/generate-bdd {prd-file}` trực tiếp; sửa PRD nếu NEEDS_FIX |
+| /generate-design-spec   | Designer review → xác nhận link Figma → PO + Designer sign-off → `/generate-bdd {prd-file}` |
+| /generate-bdd           | `/review-context {feature-file}` để kiểm tra độ phủ |
+| /review-context (BDD)   | `/generate-tech-docs {UC-ID}` nếu APPROVED; sinh lại nếu NEEDS_FIX |
+| /qc-analyze             | `/qc-plan {UC-ID}` (xử lý các gap blocker 🔴 trước) |
 | /qc-plan                | `/qc-design-test {UC-ID}`                     |
-| /qc-design-test         | `/qc-review {UC-ID}` (test-case review)       |
-| /qc-review (test-case)  | `/qc-run-test {UC-ID}` if APPROVED; fix TCs if NEEDS_FIX |
-| /qc-run-test            | `/qc-report {UC-ID}` then `/qc-review {UC-ID}` (script review) |
-| /qc-review (script)     | `/qc-report {UC-ID}` then create PR if APPROVED |
-| /qc-report              | `/validate-traces {UC-ID}` to refresh Living Docs (qc_status) |
+| /qc-design-test         | `/qc-review {UC-ID}` (review test-case)       |
+| /qc-review (test-case)  | `/qc-run-test {UC-ID}` nếu APPROVED; sửa TC nếu NEEDS_FIX |
+| /qc-run-test            | `/qc-report {UC-ID}` rồi `/qc-review {UC-ID}` (review script) |
+| /qc-review (script)     | `/qc-report {UC-ID}` rồi tạo PR nếu APPROVED |
+| /qc-report              | `/validate-traces {UC-ID}` để làm mới Living Docs (qc_status) |
 | /generate-tech-docs     | `/review-tech-docs {tech-design-file}`        |
-| /review-tech-docs       | `/generate-code {feature-file}` if APPROVED; fix doc if NEEDS_FIX |
-| /generate-code          | First gen → `/review-code {UC-ID}`; re-gen → `/dev-gen-test {UC-ID}` |
+| /review-tech-docs       | `/generate-code {feature-file}` nếu APPROVED; sửa doc nếu NEEDS_FIX |
+| /generate-code          | Lần gen đầu → `/review-code {UC-ID}`; gen lại → `/dev-gen-test {UC-ID}` |
 | /dev-gen-test         | `/dev-run-test {UC-ID}`                          |
 | /dev-run-test (passing)    | `/review-code {UC-ID}`                        |
-| /dev-run-test (failing)    | `/fix-bug {ticket-id}` or `/debug {error}`    |
-| /review-code            | `/dev-smoke-test {UC-ID}` or create PR            |
-| /dev-smoke-test             | Create PR and link to ticket                  |
-| /validate-traces        | DRIFT/UNTRACKED → `/generate-code {UC-ID}`; GAP → `/dev-gen-test {UC-ID}`; all OK → create PR |
-| /fix-bug                | Create PR and link to ticket                  |
-| /debug                  | `/fix-bug {ticket-id}` if fix needed          |
-| /report-bug             | Send to dev (`/fix-bug {BUG-ID}`); if coverage gap → `/propose-scenario {UC-ID}` |
-| /propose-scenario       | Notify PO/Dev to review the proposal in `feedback/bdd-proposals/` |
-| /learn                  | Continue working — lesson applies on next command |
-| /sync                   | `/validate-traces` for full coverage; act on any `📥 tester feedback` surfaced |
-| /update-framework       | Review `git diff .agent/`, commit; `/sync` for project content |
-
-Format the footer as:
+| /dev-run-test (failing)    | `/fix-bug {ticket-id}` hoặc `/debug {error}`    |
+| /review-code            | `/dev-smoke-test {UC-ID}` hoặc tạo PR            |
+| /dev-smoke-test             | Tạo PR và link tới ticket                  |
+| /validate-traces        | DRIFT/UNTRACKED → `/generate-code {UC-ID}`; GAP → `/dev-gen-test {UC-ID}`; tất cả OK → tạo PR |
+| /fix-bug                | Tạo PR và link tới ticket                  |
+| /debug                  | `/fix-bug {ticket-id}` nếu cần sửa          |
+| /report-bug             | Gửi cho dev (`/fix-bug {BUG-ID}`); nếu thiếu coverage → `/propose-scenario {UC-ID}` |
+| /propose-scenario       | Báo PO/Dev review proposal trong `feedback/bdd-proposals/` |
+| /learn                  | Tiếp tục làm việc — lesson áp dụng ở lệnh kế tiếp |
+| /sync                   | `/validate-traces` để xem độ phủ đầy đủ; xử lý mọi `📥 tester feedback` được nêu |
+| /update-framework       | Review `git diff .agent/`, commit; `/sync` để đồng bộ nội dung dự án |
+
+Định dạng footer như sau:
 ```
 ---
 Status   : {badge}
-{Output Artifacts block}
+{khối Output Artifacts}
 Pipeline : Discovery → PRD → [BDD ◀ bạn ở đây] → Tech Design → Code → Dev Self-Check → QC → Trace Audit
-           (review cmd) Vòng review: [① phân tích ◀] → ② Review Board → ③ --resume
-Next     : {suggested command with example arguments}
+           (lệnh review) Vòng review: [① phân tích ◀] → ② Review Board → ③ --resume
+Next     : {lệnh gợi ý kèm ví dụ tham số}
 ```
-*(Omit the `Pipeline` line for cross-cutting commands listed above.)*
+*(Bỏ dòng `Pipeline` cho các lệnh xuyên suốt liệt kê ở trên.)*
 
 
 ```