dw-kit 1.2.0 → 1.3.0

package/.claude/skills/dw-test-plan/SKILL.md

@@ -1,113 +1,113 @@
----
-name: dw-test-plan
-description: "QC skill: Tạo test plan cho feature/task. Bao gồm test cases, edge cases, regression checklist. Dùng sau khi plan được approve."
-argument-hint: "[task-name | feature-name]"
-allowed-tools:
-  - Read
-  - Write
-  - Glob
-  - Grep
----
-
-# Tạo Test Plan
-
-Feature/Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
-Skill này dành cho depth: `standard` hoặc `thorough` (QC role).
-
-## Đọc Tài Liệu Liên Quan
-
-1. Đọc requirements: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md` (nếu có)
-2. Đọc plan: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
-3. Đọc context: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
-
-## Tạo Test Plan
-
-Ghi ra `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-test-plan.md`:
-
-```markdown
-# Test Plan: [Feature/Task Name]
-
-## Ngày: [date] | QC: [name] | Status: Draft
-
-## Scope
-**In scope**: [Những gì sẽ được test]
-**Out of scope**: [Những gì KHÔNG test]
-**Test environment**: [dev / staging]
-
-## Test Strategy
-- [ ] Unit testing (dev responsibility)
-- [ ] Integration testing
-- [ ] Manual functional testing (QC)
-- [ ] Regression testing
-- [ ] Performance testing (nếu cần)
-- [ ] Security testing (nếu cần)
-
----
-
-## Test Cases
-
-### TC-001: [Happy Path - Tên mô tả]
-- **Preconditions**: [Điều kiện trước]
-- **Steps**:
-  1. [Bước 1]
-  2. [Bước 2]
-- **Expected Result**: [Kết quả mong đợi]
-- **Priority**: P1 Critical / P2 High / P3 Medium / P4 Low
-- **Status**: Not Run / Pass / Fail / Blocked
-
-### TC-002: [Edge Case]
-...
-
-### TC-00N: [Negative Test]
-...
-
----
-
-## Regression Checklist
-
-Các tính năng hiện có có thể bị ảnh hưởng bởi thay đổi này:
-- [ ] [Feature A] — Test: [quick test steps]
-- [ ] [Feature B]
-
----
-
-## Performance Criteria (nếu applicable)
-| Metric | Target | Actual |
-|--------|--------|--------|
-| Page load | < 2s | |
-| API response | < 500ms | |
-
----
-
-## Bug Report Template
-
-```markdown
-**Bug**: [Tiêu đề ngắn gọn]
-**Severity**: Critical / High / Medium / Low
-**Steps to Reproduce**:
-1.
-**Expected**:
-**Actual**:
-**Environment**: [OS, Browser, Version]
-**Screenshot**: [đính kèm]
-```
-
----
-
-## Sign-off Criteria
-- [ ] Tất cả P1 test cases PASS
-- [ ] Không có open Critical/High bugs
-- [ ] Regression checklist clear
-- [ ] Performance criteria met
-```
-
-## Thông Báo
-
-Sau khi tạo:
-- "Test plan sẵn sàng: [path]"
-- Gợi ý cho dev: "Review test cases để đảm bảo unit tests cover các scenarios này"
-- Gợi ý cho TL: "Review có cần thêm test cases nào không"
+---
+name: dw:test-plan
+description: "QC skill: Tạo test plan cho feature/task. Bao gồm test cases, edge cases, regression checklist. Dùng sau khi plan được approve."
+argument-hint: "[task-name | feature-name]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+---
+
+# Tạo Test Plan
+
+Feature/Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+Skill này dành cho depth: `standard` hoặc `thorough` (QC role).
+
+## Đọc Tài Liệu Liên Quan
+
+1. Đọc requirements: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md` (nếu có)
+2. Đọc plan: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
+3. Đọc context: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
+
+## Tạo Test Plan
+
+Ghi ra `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-test-plan.md`:
+
+```markdown
+# Test Plan: [Feature/Task Name]
+
+## Ngày: [date] | QC: [name] | Status: Draft
+
+## Scope
+**In scope**: [Những gì sẽ được test]
+**Out of scope**: [Những gì KHÔNG test]
+**Test environment**: [dev / staging]
+
+## Test Strategy
+- [ ] Unit testing (dev responsibility)
+- [ ] Integration testing
+- [ ] Manual functional testing (QC)
+- [ ] Regression testing
+- [ ] Performance testing (nếu cần)
+- [ ] Security testing (nếu cần)
+
+---
+
+## Test Cases
+
+### TC-001: [Happy Path - Tên mô tả]
+- **Preconditions**: [Điều kiện trước]
+- **Steps**:
+  1. [Bước 1]
+  2. [Bước 2]
+- **Expected Result**: [Kết quả mong đợi]
+- **Priority**: P1 Critical / P2 High / P3 Medium / P4 Low
+- **Status**: Not Run / Pass / Fail / Blocked
+
+### TC-002: [Edge Case]
+...
+
+### TC-00N: [Negative Test]
+...
+
+---
+
+## Regression Checklist
+
+Các tính năng hiện có có thể bị ảnh hưởng bởi thay đổi này:
+- [ ] [Feature A] — Test: [quick test steps]
+- [ ] [Feature B]
+
+---
+
+## Performance Criteria (nếu applicable)
+| Metric | Target | Actual |
+|--------|--------|--------|
+| Page load | < 2s | |
+| API response | < 500ms | |
+
+---
+
+## Bug Report Template
+
+```markdown
+**Bug**: [Tiêu đề ngắn gọn]
+**Severity**: Critical / High / Medium / Low
+**Steps to Reproduce**:
+1.
+**Expected**:
+**Actual**:
+**Environment**: [OS, Browser, Version]
+**Screenshot**: [đính kèm]
+```
+
+---
+
+## Sign-off Criteria
+- [ ] Tất cả P1 test cases PASS
+- [ ] Không có open Critical/High bugs
+- [ ] Regression checklist clear
+- [ ] Performance criteria met
+```
+
+## Thông Báo
+
+Sau khi tạo:
+- "Test plan sẵn sàng: [path]"
+- Gợi ý cho dev: "Review test cases để đảm bảo unit tests cover các scenarios này"
+- Gợi ý cho TL: "Review có cần thêm test cases nào không"

package/.claude/skills/dw-thinking/SKILL.md

@@ -1,70 +1,70 @@
----
-name: dw-thinking
-description: "Áp dụng framework tư duy phản biện, hệ thống và đa góc nhìn vào vấn đề. Auto-load khi planning hoặc khi cần phân tích sâu. Dùng proactively."
-argument-hint: "[vấn đề cần phân tích]"
-user-invocable: true
----
-
-# Framework Tư Duy — Áp Dụng Vào Task
-
-Vấn đề: **$ARGUMENTS**
-
-## Nạp Framework
-
-@THINKING.md
-
----
-
-## Áp Dụng Vào Task Hiện Tại
-
-Sau khi đọc framework trên, áp dụng vào vấn đề `$ARGUMENTS`:
-
-### 1. Tư Duy Phản Biện
-
-**Giả định đang dùng:**
-- [ ] [Giả định 1] — Cách kiểm chứng: ...
-- [ ] [Giả định 2]
-
-**Rủi ro chính (top 3):**
-1. [Rủi ro] — Xác suất: Cao/TB/Thấp — Tác động: ...
-2. ...
-3. ...
-
-**Phương án thay thế đã loại:**
-- [Phương án A] — Loại vì: ...
-
-**Edge cases cần xử lý:**
-- [ ] [Edge case 1]
-
-### 2. Tư Duy Hệ Thống
-
-**Dependencies:**
-- Upstream: [ai/module gì phụ thuộc vào]
-- Downstream: [bị ảnh hưởng bởi thay đổi này]
-
-**Tác động cascade:**
-- Nếu thay đổi X → Y bị ảnh hưởng → Z cần cập nhật
-
-**Failure modes:**
-- [Nếu phần A fail → hệ thống phản ứng thế nào]
-
-### 3. Đa Góc Nhìn
-
-| Góc nhìn | Câu hỏi | Đánh giá |
-|----------|---------|----------|
-| User | [Ảnh hưởng UX?] | [OK / Concern] |
-| Developer | [Maintainable?] | |
-| Security | [Expose gì?] | |
-| Ops | [Deploy issues?] | |
-| Business | [Giá trị delivered?] | |
-
-### 4. Kết Luận
-
-**Quyết định:**
-[Approach được chọn và lý do]
-
-**Trade-offs chấp nhận:**
-[Điểm yếu nào của approach này được chấp nhận]
-
-**Điểm cần monitor:**
-[Theo dõi gì sau khi implement]
+---
+name: dw:thinking
+description: "Áp dụng framework tư duy phản biện, hệ thống và đa góc nhìn vào vấn đề. Auto-load khi planning hoặc khi cần phân tích sâu. Dùng proactively."
+argument-hint: "[vấn đề cần phân tích]"
+user-invocable: true
+---
+
+# Framework Tư Duy — Áp Dụng Vào Task
+
+Vấn đề: **$ARGUMENTS**
+
+## Nạp Framework
+
+@THINKING.md
+
+---
+
+## Áp Dụng Vào Task Hiện Tại
+
+Sau khi đọc framework trên, áp dụng vào vấn đề `$ARGUMENTS`:
+
+### 1. Tư Duy Phản Biện
+
+**Giả định đang dùng:**
+- [ ] [Giả định 1] — Cách kiểm chứng: ...
+- [ ] [Giả định 2]
+
+**Rủi ro chính (top 3):**
+1. [Rủi ro] — Xác suất: Cao/TB/Thấp — Tác động: ...
+2. ...
+3. ...
+
+**Phương án thay thế đã loại:**
+- [Phương án A] — Loại vì: ...
+
+**Edge cases cần xử lý:**
+- [ ] [Edge case 1]
+
+### 2. Tư Duy Hệ Thống
+
+**Dependencies:**
+- Upstream: [ai/module gì phụ thuộc vào]
+- Downstream: [bị ảnh hưởng bởi thay đổi này]
+
+**Tác động cascade:**
+- Nếu thay đổi X → Y bị ảnh hưởng → Z cần cập nhật
+
+**Failure modes:**
+- [Nếu phần A fail → hệ thống phản ứng thế nào]
+
+### 3. Đa Góc Nhìn
+
+| Góc nhìn | Câu hỏi | Đánh giá |
+|----------|---------|----------|
+| User | [Ảnh hưởng UX?] | [OK / Concern] |
+| Developer | [Maintainable?] | |
+| Security | [Expose gì?] | |
+| Ops | [Deploy issues?] | |
+| Business | [Giá trị delivered?] | |
+
+### 4. Kết Luận
+
+**Quyết định:**
+[Approach được chọn và lý do]
+
+**Trade-offs chấp nhận:**
+[Điểm yếu nào của approach này được chấp nhận]
+
+**Điểm cần monitor:**
+[Theo dõi gì sau khi implement]

package/.claude/skills/dw-upgrade/SKILL.md

@@ -1,72 +1,72 @@
----
-name: dw-upgrade
-description: "Upgrade dv-workflow-kit lên version mới. So sánh toolkit files, báo cáo thay đổi, cho phép selective update mà không overwrite customizations."
-argument-hint: ""
----
-
-# Upgrade dv-workflow-kit
-
-## Điều Kiện tiên quyết
-
-Toolkit được cài theo luồng chuẩn v1 trong project hiện tại (thường là `npm install -g dw-kit` + `dw init`).
-Các tùy chỉnh của team được đặt tại:
-- overrides: `.dw/adapters/claude-cli/overrides/`
-- extensions (skills mới): `.dw/adapters/claude-cli/extensions/`
-
-## Bước 1: Preview upgrade (khuyến nghị)
-
-```bash
-dw upgrade --check
-dw upgrade --dry-run
-```
-
-## Bước 2: Backup config (tùy chọn nhưng nên làm)
-
-```bash
-cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
-```
-
-## Bước 3: Chạy upgrade
-
-```bash
-dw upgrade
-```
-
-`dw upgrade` sẽ update toolkit files theo version mới và **tôn trọng overrides** của team (không ghi đè override).
-
-## Bước 4: Validate & health check
-
-```bash
-dw validate
-dw doctor
-```
-
-## Bước 5: Báo cáo kết quả
-
-```
-=== Upgrade Report ===
-
-Từ: [old version/commit]
-Đến: [new version/commit]
-
-Files mới (đã copy):
-  + .claude/skills/dw-[new-skill]/SKILL.md
-  + .claude/templates/en/task-context.md
-
-Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
-  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .claude/skills/dw-task-init/SKILL.md
-  ~ .claude/agents/planner.md
-
-Files của bạn (giữ nguyên):
-  = .dw/config/dw.config.yml  (backup tại .backup-[date])
-
-Lưu ý:
-  - Review các files "đã thay đổi" và merge thủ công nếu cần
-  - Xem CHANGELOG của release (nếu cần) để biết breaking changes
-  - Chạy /dw-config-validate sau khi upgrade để kiểm tra config
-```
-
-## Cleanup backup (tùy chọn)
-
-Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
-Nếu y: `rm .dw/config/dw.config.yml.backup-*`
+---
+name: dw:upgrade
+description: "Upgrade dv-workflow-kit lên version mới. So sánh toolkit files, báo cáo thay đổi, cho phép selective update mà không overwrite customizations."
+argument-hint: ""
+---
+
+# Upgrade dv-workflow-kit
+
+## Điều Kiện tiên quyết
+
+Toolkit được cài theo luồng chuẩn v1 trong project hiện tại (thường là `npm install -g dw-kit` + `dw init`).
+Các tùy chỉnh của team được đặt tại:
+- overrides: `.dw/adapters/claude-cli/overrides/`
+- extensions (skills mới): `.dw/adapters/claude-cli/extensions/`
+
+## Bước 1: Preview upgrade (khuyến nghị)
+
+```bash
+dw upgrade --check
+dw upgrade --dry-run
+```
+
+## Bước 2: Backup config (tùy chọn nhưng nên làm)
+
+```bash
+cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
+```
+
+## Bước 3: Chạy upgrade
+
+```bash
+dw upgrade
+```
+
+`dw upgrade` sẽ update toolkit files theo version mới và **tôn trọng overrides** của team (không ghi đè override).
+
+## Bước 4: Validate & health check
+
+```bash
+dw validate
+dw doctor
+```
+
+## Bước 5: Báo cáo kết quả
+
+```
+=== Upgrade Report ===
+
+Từ: [old version/commit]
+Đến: [new version/commit]
+
+Files mới (đã copy):
+  + .claude/skills/dw-[new-skill]/SKILL.md
+  + .claude/templates/en/task-context.md
+
+Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
+  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .claude/skills/dw-task-init/SKILL.md
+  ~ .claude/agents/planner.md
+
+Files của bạn (giữ nguyên):
+  = .dw/config/dw.config.yml  (backup tại .backup-[date])
+
+Lưu ý:
+  - Review các files "đã thay đổi" và merge thủ công nếu cần
+  - Xem CHANGELOG của release (nếu cần) để biết breaking changes
+  - Chạy /dw:config-validate sau khi upgrade để kiểm tra config
+```
+
+## Cleanup backup (tùy chọn)
+
+Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
+Nếu y: `rm .dw/config/dw.config.yml.backup-*`

package/.dw/config/dw.config.yml

@@ -1,82 +1,82 @@
-# ============================================================================
-# dw-kit Configuration — v1
-# ============================================================================
-# Copy file này vào project và tùy chỉnh theo nhu cầu.
-# Toolkit đọc file này để điều chỉnh behavior per project.
-# ============================================================================
-
-# --- Project Info -----------------------------------------------------------
-project:
-  name: "my-project"
-  language: "vi"               # vi | en
-
-# --- Workflow ----------------------------------------------------------------
-workflow:
-  default_depth: "standard"   # quick | standard | thorough
-  # AI assesses per-task và có thể recommend depth khác nhau:
-  #   quick    : ≤2 files, hotfix, familiar module
-  #   standard : 3-5 files, module mới, unfamiliar code
-  #   thorough : 6+ files, API contract changes, DB schema, security
-
-# --- Team -------------------------------------------------------------------
-team:
-  roles:
-    - dev              # luôn có
-    - techlead         # architecture review, plan approval
-    # - ba             # requirements, user stories
-    # - qc             # test plans, QA sign-off
-    # - pm             # dashboard, reports
-
-# --- Quality Gates ----------------------------------------------------------
-quality:
-  test_command: ""     # ví dụ: "npm test" | "pytest" | "go test ./..."
-  lint_command: ""     # ví dụ: "npm run lint" | "ruff check ." | "golangci-lint run"
-  block_on_fail: false # true = block commit nếu test/lint fail
-
-# --- Tracking ---------------------------------------------------------------
-tracking:
-  estimation: false
-  log_work: false
-  estimation_unit: "hours"    # hours | story-points | t-shirt
-
-# --- Paths ------------------------------------------------------------------
-paths:
-  tasks: ".dw/tasks"
-  docs: ".dw/docs"
-
-# --- Claude Capabilities (Layer 2) ------------------------------------------
-# Tính năng đặc thù của Claude Code.
-claude:
-  # Model per phase — để trống = dùng model mặc định từ Claude Code settings
-  models:
-    plan: ""           # ví dụ: "claude-opus-4-6" cho complex planning
-    execute: ""        # ví dụ: "claude-sonnet-4-6"
-    review: ""
-
-  # Structured JSON output từ reviewer và estimate skills
-  structured_output: true
-
-  # Isolate execution trong git worktree (cho risky refactors)
-  worktree_execution: false
-
-  # MCP servers — Claude Code sẽ load các servers này
-  mcp: []
-  # Ví dụ:
-  # mcp:
-  #   - name: "github"
-  #     command: "npx @modelcontextprotocol/server-github"
-  #     env:
-  #       GITHUB_TOKEN: "${GITHUB_TOKEN}"
-  #   - name: "jira"
-  #     command: "npx @anthropic/mcp-server-jira"
-  #     env:
-  #       JIRA_URL: "${JIRA_URL}"
-  #       JIRA_TOKEN: "${JIRA_TOKEN}"
-
-# --- Toolkit Version (do not edit manually) ---------------------------------
-_toolkit:
-  core_version: "1.0"
-  platform_version: "1.0"
-  capability_version: "1.0"
-  installed: "2026-03-23"
-  last_upgrade: "2026-03-23"
+# ============================================================================
+# dw-kit Configuration — v1
+# ============================================================================
+# Copy file này vào project và tùy chỉnh theo nhu cầu.
+# Toolkit đọc file này để điều chỉnh behavior per project.
+# ============================================================================
+
+# --- Project Info -----------------------------------------------------------
+project:
+  name: "my-project"
+  language: "vi"               # vi | en
+
+# --- Workflow ----------------------------------------------------------------
+workflow:
+  default_depth: "standard"   # quick | standard | thorough
+  # AI assesses per-task và có thể recommend depth khác nhau:
+  #   quick    : ≤2 files, hotfix, familiar module
+  #   standard : 3-5 files, module mới, unfamiliar code
+  #   thorough : 6+ files, API contract changes, DB schema, security
+
+# --- Team -------------------------------------------------------------------
+team:
+  roles:
+    - dev              # luôn có
+    - techlead         # architecture review, plan approval
+    # - ba             # requirements, user stories
+    # - qc             # test plans, QA sign-off
+    # - pm             # dashboard, reports
+
+# --- Quality Gates ----------------------------------------------------------
+quality:
+  test_command: ""     # ví dụ: "npm test" | "pytest" | "go test ./..."
+  lint_command: ""     # ví dụ: "npm run lint" | "ruff check ." | "golangci-lint run"
+  block_on_fail: false # true = block commit nếu test/lint fail
+
+# --- Tracking ---------------------------------------------------------------
+tracking:
+  estimation: false
+  log_work: false
+  estimation_unit: "hours"    # hours | story-points | t-shirt
+
+# --- Paths ------------------------------------------------------------------
+paths:
+  tasks: ".dw/tasks"
+  docs: ".dw/docs"
+
+# --- Claude Capabilities (Layer 2) ------------------------------------------
+# Tính năng đặc thù của Claude Code.
+claude:
+  # Model per phase — để trống = dùng model mặc định từ Claude Code settings
+  models:
+    plan: ""           # ví dụ: "claude-opus-4-6" cho complex planning
+    execute: ""        # ví dụ: "claude-sonnet-4-6"
+    review: ""
+
+  # Structured JSON output từ reviewer và estimate skills
+  structured_output: true
+
+  # Isolate execution trong git worktree (cho risky refactors)
+  worktree_execution: false
+
+  # MCP servers — Claude Code sẽ load các servers này
+  mcp: []
+  # Ví dụ:
+  # mcp:
+  #   - name: "github"
+  #     command: "npx @modelcontextprotocol/server-github"
+  #     env:
+  #       GITHUB_TOKEN: "${GITHUB_TOKEN}"
+  #   - name: "jira"
+  #     command: "npx @anthropic/mcp-server-jira"
+  #     env:
+  #       JIRA_URL: "${JIRA_URL}"
+  #       JIRA_TOKEN: "${JIRA_TOKEN}"
+
+# --- Toolkit Version (do not edit manually) ---------------------------------
+_toolkit:
+  core_version: "1.2"
+  platform_version: "1.2"
+  capability_version: "1.0"
+  installed: "2026-03-23"
+  last_upgrade: "2026-04-15"