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

package/skills/prd/SKILL.tmpl

@@ -1,79 +1,63 @@
 ---
-description: Generates a PRD from a product definition, or analyzes an existing PRD through 4 review lenses (QA, DEV, SA, PO) to find gaps and risks. Trigger when: "/generate-prd", "/refine-prd", "tạo PRD", "generate PRD", "phân tích PRD", "review PRD", "refine PRD", "PRD có vấn đề gì không", "check PRD quality".
+description: Sinh PRD từ một product definition, hoặc phân tích một PRD có sẵn qua 4 lăng kính review (QA, DEV, SA, PO) để tìm gap và rủi ro. Trigger when: "/generate-prd", "/refine-prd", "tạo PRD", "generate PRD", "phân tích PRD", "review PRD", "refine PRD", "PRD có vấn đề gì không", "check PRD quality".
 ---
 
 # PRD Skills — Generate & Refine
 
-This skill handles two commands: `/generate-prd` to create a PRD, and `/refine-prd` to analyze it for gaps.
+Skill này xử lý hai lệnh: `/generate-prd` để tạo PRD, và `/refine-prd` để phân tích PRD tìm gap.
 
 ---
 
-## /generate-prd — Generate Product Requirements Document
+## /generate-prd — Sinh Product Requirements Document
 
 ### Gate
 
-<!-- Directory: specs/product-definition/**/*.md -->
+<!-- Directory: {paths.product_definitions_dir}/**/*.md -->
 {{include:steps/gate.md}}
 
-### Generate
-
-Write `specs/{domain}/{prd-slug}/prd.md`:
-
-```markdown
-# PRD — {Feature Name}
-
-**Version**: 1.0
-**Status**: draft
-**Domain**: {domain}
-**Ticket**: {TICKET_PREFIX}-{N} (if available)
-**Date**: {date}
-
-## 1. Problem Statement
-{from product-definition}
-
-## 2. Goals & Non-Goals
+### Quy tắc nội dung — chống jargon kỹ thuật *(áp dụng cho mọi PRD sinh ra)*
 
-### Goals
-- {goal 1}
+**1. PRD platform-agnostic — chỉ mô tả WHAT (nghiệp vụ), KHÔNG mô tả HOW (kỹ thuật).**
+Viết AC / Business Rule / Business Logic theo *kết quả nghiệp vụ*, KHÔNG nhét chi tiết triển khai (API, JWT/token, endpoint, HTTP status, tên class/bảng/cột DB, query, spinner, animation…). Những thứ đó thuộc **Tech Docs** (kỹ thuật) hoặc **Design Spec** (giao diện).
 
-### Non-Goals
-- {non-goal 1}
+| ✅ Viết trong PRD (nghiệp vụ) | ❌ KHÔNG viết trong PRD |
+|---|---|
+| "Đăng nhập thành công → truy cập được tính năng" | "API trả về JWT token" ← Tech Docs |
+| "Sai mật khẩu 5 lần → khoá tài khoản 30 phút" | "Click button → hiện toast" ← Design Spec |
+| "Phiên hết hạn → yêu cầu xác thực lại" | "Hiển thị spinner khi loading" ← Design Spec |
 
-## 3. User Stories
+- Nếu PO đưa chi tiết UI (màu, layout, animation) → **nhắc**: *"Chi tiết UI này thuộc Design Spec, không thuộc PRD. Ghi nhận để tạo Design Spec sau."*
+- Enum/thuật ngữ kỹ thuật ĐÃ chuẩn hoá trong domain-knowledge (vd `userType`, `TYPE_1`) thì giữ nguyên gốc — đây là từ vựng nghiệp vụ, KHÔNG phải jargon triển khai.
 
-As a {persona}, I want to {action} so that {benefit}.
+**2. Terminology — bám từ điển dự án.**
+- Thay mọi **banned term** bằng canonical term (xem `business-dictionary.md` § Banned Terms); ghi chú việc thay ở mục **Giả định AI**.
+- Status/Enum → lấy đúng giá trị trong `core-entities.md` (Enum Registry).
+- **Thuật ngữ MỚI**: nếu input PO có từ chưa có trong `business-dictionary.md` và lặp ≥2 lần → **DỪNG, hỏi PO** (nghĩa là gì / canonical term / có thêm vào từ điển không) trước khi tiếp tục.
 
-## 4. Use Cases
+**3. Cross-reference bắt buộc.** Mọi chỗ nhắc TICKET-ID khác → inline link `[TICKET-ID](./file.md)` nếu file PRD tồn tại; không để plain text.
 
-| UC-ID | Name | Priority | Description |
-|-------|------|----------|-------------|
-| {DOMAIN}-UC1 | {name} | High | {description} |
-
-## 5. Business Rules
-
-| BR-ID | Rule | UC |
-|-------|------|----|
-| BR-1 | {rule} | UC1 |
-
-## 6. Acceptance Criteria
+### Generate
 
-### {DOMAIN}-UC1: {Name}
-- AC1: Given {context}, when {action}, then {result}
+Sinh PRD theo đúng cấu trúc chuẩn dưới đây (template canonical: `templates/prd.template.md`). Quy ước bắt buộc:
 
-## 7. Out of Scope
-{from product-definition}
+- **Ngôn ngữ:** heading + nội dung viết tiếng Việt (giữ thuật ngữ kỹ thuật/Enum nguyên gốc).
+- **Tiêu đề file:** `# {TICKET}-{N} {Feature Name}` — KHÔNG thêm tiền tố "PRD —".
+- **Tên file ghi ra:** `specs/{domain}/{prd-slug}/prd.md` (bố cục feature-package — mọi artifact của feature nằm chung folder này).
+- **Business Rule:** đặt BÊN TRONG từng Use Case (không gom thành mục phẳng), bảng 3 cột `ID | Business Rule | Business Logic`; ID theo dạng `{TICKET}-{N}-UC{n}-BR{m}` (đánh số BR liên tục xuyên suốt các UC, không reset mỗi UC).
+- **Acceptance Criteria:** danh sách phẳng `**AC{n}:**`, văn xuôi — KHÔNG ép Given/When/Then.
+- **Liên kết:** trỏ tới PRD/tài liệu liên quan bằng link tương đối; trỏ `core-entities` / `business-dictionary` ở mục Tài liệu tham khảo.
+- **Giả định AI:** nếu phát hiện độ vênh/giả định chưa được PO chốt → liệt kê thành `Q1…Qn` để PO xác nhận; nếu mọi thứ đã rõ từ product-definition → ghi "Không có — toàn bộ nội dung đã được PO xác nhận".
 
-## 8. Cross-Service Dependencies
-{from product-definition}
+Template (cấu trúc đầu ra — single-source từ `templates/prd.template.md`):
 
-## 9. Open Questions
-- [ ] {question requiring clarification}
-```
+````markdown
+{{include:templates/prd.template.md}}
+````
 
 ### Output
 
 ```
-✅ PRD created: specs/{domain}/{prd-slug}/prd.md
+✅ Đã tạo PRD: specs/{domain}/{prd-slug}/prd.md
 Status: draft
 ```
 
@@ -81,108 +65,13 @@ Status: draft
 
 ---
 
-## /refine-prd — Analyze PRD Through 4 Review Lenses
-
-Performs a structured multi-perspective analysis of a PRD and writes findings to a YAML file for human review.
+## /refine-prd — Phân tích PRD qua 4 lăng kính review
 
-### Gate
-
-<!-- Directory: specs/*/*/prd.md -->
-{{include:steps/gate.md}}
-
-### Analyze — 4 Lenses (run all four perspectives)
-
-#### QA Lens — Test Coverage & Edge Cases
-Evaluate:
-- Are all acceptance criteria testable and measurable?
-- Are edge cases and error scenarios specified?
-- Are boundary conditions defined?
-- Is there ambiguity in expected behavior?
-
-#### DEV Lens — Technical Clarity & Feasibility
-Evaluate:
-- Are API inputs/outputs clearly defined?
-- Are business rules unambiguous enough to implement?
-- Are there performance or scalability concerns?
-- Are cross-service dependencies fully described?
-- Is there anything technically infeasible or risky?
-
-#### SA Lens — Architecture & Design
-Evaluate:
-- Does this fit the existing architecture?
-- Are there design patterns or constraints to apply?
-- Is data modeling clear (entities, relationships)?
-- Are there security or auth implications?
-
-#### PO Lens — Business Value & Scope
-Evaluate:
-- Is scope clearly bounded?
-- Are priorities clear?
-- Are success metrics defined?
-- Are stakeholder needs fully captured?
-- Any scope creep risk?
-
-### Write Output
-
-Derive the output filename from the PRD slug:
-- PRD file: `specs/payment/create-invoice/prd.md` → output: `.agent/review/create-invoice-findings.yaml`
-- Rule: take the PRD's parent folder name (the `prd-slug`), append `-findings.yaml`
-
-Write findings to `.agent/review/{prd-slug}-findings.yaml`:
-
-```yaml
-# Generated by /refine-prd
-# Review each finding and mark: accepted / rejected / needs_discussion
-prd_source: "specs/{domain}/{prd-slug}/prd.md"
-generated_at: "{ISO datetime}"
-status: "pending_review"
-
-findings:
-  - id: "F001"
-    lens: "QA"           # QA | DEV | SA | PO
-    severity: "major"    # critical | major | minor
-    section: "§6. Acceptance Criteria"
-    finding: "{Clear description of the gap or issue}"
-    suggestion: "{Specific actionable improvement}"
-    status: "pending"    # pending | accepted | rejected | needs_discussion
-
-  - id: "F002"
-    lens: "DEV"
-    severity: "minor"
-    section: "§8. Cross-Service Dependencies"
-    finding: "{finding}"
-    suggestion: "{suggestion}"
-    status: "pending"
-
-summary:
-  total_findings: {N}
-  by_severity:
-    critical: {N}
-    major: {N}
-    minor: {N}
-  by_lens:
-    QA: {N}
-    DEV: {N}
-    SA: {N}
-    PO: {N}
-  recommendation: "APPROVED_WITH_MINOR_CHANGES | NEEDS_REVISION | BLOCKED"
-```
-
-### Report to User
+Lệnh này thực thi **y hệt** `commands/refine-prd.md` — không nhân bản logic ở đây để tránh lệch schema findings.
 
-```
-/refine-prd Complete — {PRD name}
-
-Findings: {total} total
-  🔴 Critical: {N}  🟡 Major: {N}  🟢 Minor: {N}
-
-Top issues:
-  [F001] QA/major — {brief description}
-  [F002] DEV/minor — {brief description}
+`commands/refine-prd.md` bao gồm:
+- Phân tích PRD bằng 4 lăng kính **fan-out đa sub-agent** (QA / DEV / SA / PO) + vòng completeness-critic (1 lần chạy ra đủ finding).
+- Ghi findings YAML với **schema đầy đủ** (`uc_id`, `quote`, `auto_fixable`) — bắt buộc cho source-jump và nút "Apply to PRD" của Review Board.
+- **Resume Mode** (`--resume`): áp dụng findings đã accept → bump version → ghi changelog → reset `draft`.
 
-Review file: .agent/review/{prd-slug}-findings.yaml
-→ Open with Review Board extension (right-click file) to accept/reject each finding
-→ After review: update PRD and run /generate-bdd
-```
-
-{{include:steps/report-footer.md}}
+→ **Đọc và tuân theo `commands/refine-prd.md`** với cùng `$ARGUMENTS`.

package/skills/setup-ai-first/SKILL.md

@@ -1,22 +1,22 @@
 ---
-description: Sets up the Spec-Driven Development framework in any backend project from scratch. Trigger when: "/setup-ai-first", "setup spec-driven workflow", "initialize ai-first framework", "cài đặt framework", "khởi tạo spec-driven", "set up this workflow", "how do I start using this framework".
+description: Cài đặt framework Spec-Driven Development trong bất kỳ backend project nào từ đầu. Trigger when: "/setup-ai-first", "setup spec-driven workflow", "initialize ai-first framework", "cài đặt framework", "khởi tạo spec-driven", "set up this workflow", "how do I start using this framework".
 ---
 
 # /setup-ai-first — Initialize Spec-Driven Docs in a Project
 
-Walk the user through a one-time setup that creates all required directories, installs CLAUDE.md, and verifies the environment.
+Dẫn người dùng qua một setup một-lần tạo mọi thư mục cần thiết, cài CLAUDE.md, và verify môi trường.
 
 ## Precondition Check
 
-First, ask: "Bạn đang ở project nào? Cho tôi đường dẫn root của project."
+Trước tiên, hỏi: "Bạn đang ở project nào? Cho tôi đường dẫn root của project."
 
-Check if already set up:
-- If `.claude/commands/` exists with `.md` files → report "Already set up. Run `/validate-traces` to check status."
-- If `specs/` exists → offer to re-initialize or skip
+Kiểm tra đã setup chưa:
+- Nếu `.claude/commands/` tồn tại với file `.md` → báo "Đã setup. Chạy `/validate-traces` để kiểm tra trạng thái."
+- Nếu `specs/` tồn tại → đề nghị re-initialize hoặc skip
 
-## Step 1 — Create Directory Structure
+## Step 1 — Tạo cấu trúc thư mục
 
-Create the following directories (skip if already exist):
+Tạo các thư mục sau (skip nếu đã tồn tại):
 
 ```
 {project-root}/
@@ -28,22 +28,22 @@ Create the following directories (skip if already exist):
     └── review/               # Output of /refine-prd ({prd-slug}-findings.yaml)
 ```
 
-**Feature-package layout** — per-feature artifacts are NOT pre-created here; each command
-creates its own folder on demand under `specs/{domain}/{prd-slug}/`:
+**Bố cục feature-package** — artifact theo từng feature KHÔNG được tạo trước ở đây; mỗi lệnh
+tự tạo folder của nó on demand dưới `specs/{domain}/{prd-slug}/`:
 
 ```
 specs/{domain}/{prd-slug}/
 ├── prd.md                    # /generate-prd
-├── bdd/                      # /generate-bdd (.feature files)
+├── bdd/                      # /generate-bdd (file .feature)
 ├── tech-docs/                # /generate-tech-docs
-└── design-spec/              # /generate-design-spec (FE/App only)
+└── design-spec/              # /generate-design-spec (chỉ FE/App)
 ```
 
-Report each directory created or already existing.
+Report mỗi thư mục được tạo hoặc đã tồn tại.
 
 ## Step 2 — Copy Slash Commands
 
-Tell the user:
+Nói với người dùng:
 
 > "Framework này đã cài slash commands vào Claude tự động qua skill system.
 > Nếu bạn muốn dùng commands trực tiếp trong Claude Code project (`.claude/commands/`), chạy lệnh sau:"
@@ -54,21 +54,21 @@ mkdir -p {project-root}/.claude/commands
 cp {plugin-dir}/commands/*.md {project-root}/.claude/commands/
 ```
 
-Note: The `.claude/commands/` copies are optional. Skills in this framework work without them.
+Lưu ý: Bản copy `.claude/commands/` là tuỳ chọn. Skill trong framework này hoạt động không cần chúng.
 
-## Step 3 — Create CLAUDE.md
+## Step 3 — Tạo CLAUDE.md
 
-Check if `{project-root}/CLAUDE.md` exists:
-- If yes: ask "CLAUDE.md đã tồn tại. Merge template vào hay bỏ qua?"
-- If no: create from template in `templates/architecture.template.md`
+Kiểm tra `{project-root}/CLAUDE.md` tồn tại chưa:
+- Nếu có: hỏi "CLAUDE.md đã tồn tại. Merge template vào hay bỏ qua?"
+- Nếu không: tạo từ template trong `templates/architecture.template.md`
 
-After creating, instruct:
+Sau khi tạo, hướng dẫn:
 > "Mở CLAUDE.md và điền vào các placeholder `{{...}}` với thông tin dự án của bạn.
 > Đặc biệt quan trọng: §1 (project overview) và §3 (coding standards)."
 
-## Step 4 — Create project-context.yaml
+## Step 4 — Tạo project-context.yaml
 
-Create `{project-root}/.agent/project-context.yaml`:
+Tạo `{project-root}/.agent/project-context.yaml`:
 
 ```yaml
 # Project context for AI-First workflow
@@ -97,11 +97,11 @@ domains: []  # List your business domains, e.g. [rental, payment, user]
 
 ## Step 5 — Verify Setup
 
-Run a quick check:
-- [ ] `specs/` directory exists
-- [ ] `.trace/` directory exists
-- [ ] `.agent/project-context.yaml` exists
-- [ ] `CLAUDE.md` exists
+Chạy check nhanh:
+- [ ] Thư mục `specs/` tồn tại
+- [ ] Thư mục `.trace/` tồn tại
+- [ ] `.agent/project-context.yaml` tồn tại
+- [ ] `CLAUDE.md` tồn tại
 
 Report:
 ```
@@ -113,38 +113,38 @@ Files created:
   ✅ .agent/project-context.yaml (needs customization)
 ```
 
-# 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 |
 |-------|----------|
@@ -158,59 +158,59 @@ 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.)*
 

package/skills/setup-ai-first/SKILL.tmpl

@@ -1,22 +1,22 @@
 ---
-description: Sets up the Spec-Driven Development framework in any backend project from scratch. Trigger when: "/setup-ai-first", "setup spec-driven workflow", "initialize ai-first framework", "cài đặt framework", "khởi tạo spec-driven", "set up this workflow", "how do I start using this framework".
+description: Cài đặt framework Spec-Driven Development trong bất kỳ backend project nào từ đầu. Trigger when: "/setup-ai-first", "setup spec-driven workflow", "initialize ai-first framework", "cài đặt framework", "khởi tạo spec-driven", "set up this workflow", "how do I start using this framework".
 ---
 
 # /setup-ai-first — Initialize Spec-Driven Docs in a Project
 
-Walk the user through a one-time setup that creates all required directories, installs CLAUDE.md, and verifies the environment.
+Dẫn người dùng qua một setup một-lần tạo mọi thư mục cần thiết, cài CLAUDE.md, và verify môi trường.
 
 ## Precondition Check
 
-First, ask: "Bạn đang ở project nào? Cho tôi đường dẫn root của project."
+Trước tiên, hỏi: "Bạn đang ở project nào? Cho tôi đường dẫn root của project."
 
-Check if already set up:
-- If `.claude/commands/` exists with `.md` files → report "Already set up. Run `/validate-traces` to check status."
-- If `specs/` exists → offer to re-initialize or skip
+Kiểm tra đã setup chưa:
+- Nếu `.claude/commands/` tồn tại với file `.md` → báo "Đã setup. Chạy `/validate-traces` để kiểm tra trạng thái."
+- Nếu `specs/` tồn tại → đề nghị re-initialize hoặc skip
 
-## Step 1 — Create Directory Structure
+## Step 1 — Tạo cấu trúc thư mục
 
-Create the following directories (skip if already exist):
+Tạo các thư mục sau (skip nếu đã tồn tại):
 
 ```
 {project-root}/
@@ -28,22 +28,22 @@ Create the following directories (skip if already exist):
     └── review/               # Output of /refine-prd ({prd-slug}-findings.yaml)
 ```
 
-**Feature-package layout** — per-feature artifacts are NOT pre-created here; each command
-creates its own folder on demand under `specs/{domain}/{prd-slug}/`:
+**Bố cục feature-package** — artifact theo từng feature KHÔNG được tạo trước ở đây; mỗi lệnh
+tự tạo folder của nó on demand dưới `specs/{domain}/{prd-slug}/`:
 
 ```
 specs/{domain}/{prd-slug}/
 ├── prd.md                    # /generate-prd
-├── bdd/                      # /generate-bdd (.feature files)
+├── bdd/                      # /generate-bdd (file .feature)
 ├── tech-docs/                # /generate-tech-docs
-└── design-spec/              # /generate-design-spec (FE/App only)
+└── design-spec/              # /generate-design-spec (chỉ FE/App)
 ```
 
-Report each directory created or already existing.
+Report mỗi thư mục được tạo hoặc đã tồn tại.
 
 ## Step 2 — Copy Slash Commands
 
-Tell the user:
+Nói với người dùng:
 
 > "Framework này đã cài slash commands vào Claude tự động qua skill system.
 > Nếu bạn muốn dùng commands trực tiếp trong Claude Code project (`.claude/commands/`), chạy lệnh sau:"
@@ -54,21 +54,21 @@ mkdir -p {project-root}/.claude/commands
 cp {plugin-dir}/commands/*.md {project-root}/.claude/commands/
 ```
 
-Note: The `.claude/commands/` copies are optional. Skills in this framework work without them.
+Lưu ý: Bản copy `.claude/commands/` là tuỳ chọn. Skill trong framework này hoạt động không cần chúng.
 
-## Step 3 — Create CLAUDE.md
+## Step 3 — Tạo CLAUDE.md
 
-Check if `{project-root}/CLAUDE.md` exists:
-- If yes: ask "CLAUDE.md đã tồn tại. Merge template vào hay bỏ qua?"
-- If no: create from template in `templates/architecture.template.md`
+Kiểm tra `{project-root}/CLAUDE.md` tồn tại chưa:
+- Nếu có: hỏi "CLAUDE.md đã tồn tại. Merge template vào hay bỏ qua?"
+- Nếu không: tạo từ template trong `templates/architecture.template.md`
 
-After creating, instruct:
+Sau khi tạo, hướng dẫn:
 > "Mở CLAUDE.md và điền vào các placeholder `{{...}}` với thông tin dự án của bạn.
 > Đặc biệt quan trọng: §1 (project overview) và §3 (coding standards)."
 
-## Step 4 — Create project-context.yaml
+## Step 4 — Tạo project-context.yaml
 
-Create `{project-root}/.agent/project-context.yaml`:
+Tạo `{project-root}/.agent/project-context.yaml`:
 
 ```yaml
 # Project context for AI-First workflow
@@ -97,11 +97,11 @@ domains: []  # List your business domains, e.g. [rental, payment, user]
 
 ## Step 5 — Verify Setup
 
-Run a quick check:
-- [ ] `specs/` directory exists
-- [ ] `.trace/` directory exists
-- [ ] `.agent/project-context.yaml` exists
-- [ ] `CLAUDE.md` exists
+Chạy check nhanh:
+- [ ] Thư mục `specs/` tồn tại
+- [ ] Thư mục `.trace/` tồn tại
+- [ ] `.agent/project-context.yaml` tồn tại
+- [ ] `CLAUDE.md` tồn tại
 
 Report:
 ```