dw-kit 1.9.0 → 1.9.2

package/.claude/templates/task-plan.md

@@ -1,79 +1,83 @@
-# Plan: [Task Name]
-
-## Ngày tạo: [date]
-## Trạng thái: Draft | Approved | In Progress | Done
-## Approved by: [tên / role]
-
----
-
-## Tóm Tắt Giải Pháp
-
-[1-2 đoạn mô tả mục tiêu và approach đã chọn]
-
-## Phương Án Đã Xem Xét
-
-| # | Phương án | Ưu điểm | Nhược điểm | Chọn? |
-|---|-----------|---------|------------|-------|
-| 1 | [Approach A] | | | **Chọn** |
-| 2 | [Approach B] | | | Loại — lý do: |
-
-## Subtasks
-
-### ST-1: [Tên subtask]
-- **Mô tả**: [Cụ thể, actionable]
-- **Files**: [Danh sách files cần thay đổi]
-- **Acceptance Criteria**:
-  - [ ] [Điều kiện 1]
-  - [ ] [Điều kiện 2]
-- **Dependencies**: none
-- **Estimate**: [effort — nếu estimation enabled]
-
-### ST-2: [Tên subtask]
-- **Mô tả**: ...
-- **Files**: ...
-- **Acceptance Criteria**:
-  - [ ] ...
-- **Dependencies**: ST-1
-- **Estimate**: ...
-
-<!-- Thêm subtasks theo nhu cầu -->
-
-## Rủi Ro & Giả Định
-
-| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
-|---|------|--------|----------|----------|------------|
-| 1 | Giả định | | | | Kiểm chứng bằng: |
-| 2 | Rủi ro | | Cao/TB/Thấp | Cao/TB/Thấp | |
-
-## Edge Cases
-
-- [ ] [Edge case 1 — khi nào xảy ra, xử lý thế nào]
-- [ ] [Edge case 2]
-
-## Tác Động Hệ Thống
-
-- **Modules bị ảnh hưởng**: [danh sách]
-- **API changes**: [endpoints mới/sửa/xóa]
-- **Database changes**: [migration cần thiết]
-- **Backward compatibility**: [Có/Không — chi tiết]
-- **Breaking changes**: [nếu có]
-
-## Góc Nhìn & Trade-offs
-
-| Quyết định | User impact | Developer impact | Security | Ops/Deploy |
-|-----------|-------------|------------------|----------|------------|
-| [Quyết định 1] | | | | |
-
-<!-- Section dưới chỉ hiển thị khi flags.estimation = true -->
-
-## Estimation Tổng
-
-| Phase | Estimate | Ghi chú |
-|-------|----------|---------|
-| Research | [done] | |
-| Planning | [done] | |
-| Coding | | |
-| Testing | | |
-| Review | | |
-| Documentation | | |
-| **Total** | **[sum]** | |
+<!-- ⚠️ LEGACY TEMPLATE — do not use for new tasks. -->
+<!-- Canonical task doc lineage = v3 (.dw/core/templates/v3/task.md), per ADR-0008 / ADR-0020. -->
+<!-- Kept only as reference for `dw task migrate` + reading legacy task docs. -->
+
+# Plan: [Task Name]
+
+## Ngày tạo: [date]
+## Trạng thái: Draft | Approved | In Progress | Done
+## Approved by: [tên / role]
+
+---
+
+## Tóm Tắt Giải Pháp
+
+[1-2 đoạn mô tả mục tiêu và approach đã chọn]
+
+## Phương Án Đã Xem Xét
+
+| # | Phương án | Ưu điểm | Nhược điểm | Chọn? |
+|---|-----------|---------|------------|-------|
+| 1 | [Approach A] | | | **Chọn** |
+| 2 | [Approach B] | | | Loại — lý do: |
+
+## Subtasks
+
+### ST-1: [Tên subtask]
+- **Mô tả**: [Cụ thể, actionable]
+- **Files**: [Danh sách files cần thay đổi]
+- **Acceptance Criteria**:
+  - [ ] [Điều kiện 1]
+  - [ ] [Điều kiện 2]
+- **Dependencies**: none
+- **Estimate**: [effort — nếu estimation enabled]
+
+### ST-2: [Tên subtask]
+- **Mô tả**: ...
+- **Files**: ...
+- **Acceptance Criteria**:
+  - [ ] ...
+- **Dependencies**: ST-1
+- **Estimate**: ...
+
+<!-- Thêm subtasks theo nhu cầu -->
+
+## Rủi Ro & Giả Định
+
+| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
+|---|------|--------|----------|----------|------------|
+| 1 | Giả định | | | | Kiểm chứng bằng: |
+| 2 | Rủi ro | | Cao/TB/Thấp | Cao/TB/Thấp | |
+
+## Edge Cases
+
+- [ ] [Edge case 1 — khi nào xảy ra, xử lý thế nào]
+- [ ] [Edge case 2]
+
+## Tác Động Hệ Thống
+
+- **Modules bị ảnh hưởng**: [danh sách]
+- **API changes**: [endpoints mới/sửa/xóa]
+- **Database changes**: [migration cần thiết]
+- **Backward compatibility**: [Có/Không — chi tiết]
+- **Breaking changes**: [nếu có]
+
+## Góc Nhìn & Trade-offs
+
+| Quyết định | User impact | Developer impact | Security | Ops/Deploy |
+|-----------|-------------|------------------|----------|------------|
+| [Quyết định 1] | | | | |
+
+<!-- Section dưới chỉ hiển thị khi flags.estimation = true -->
+
+## Estimation Tổng
+
+| Phase | Estimate | Ghi chú |
+|-------|----------|---------|
+| Research | [done] | |
+| Planning | [done] | |
+| Coding | | |
+| Testing | | |
+| Review | | |
+| Documentation | | |
+| **Total** | **[sum]** | |

package/.claude/templates/task-progress.md

@@ -1,65 +1,69 @@
-# Progress: [Task Name]
-
-## Trạng thái: Not Started | In Progress | Blocked | Done
-## Branch: [branch-name]
-## Bắt đầu: [date]
-## Kết thúc: [date — khi done]
-
----
-
-## Subtask Progress
-
-| # | Subtask | Trạng thái | Commit | Người thực hiện | Ghi chú |
-|---|---------|-----------|--------|-----------------|---------|
-| ST-1 | | Pending | | | |
-| ST-2 | | Pending | | | |
-
-**Trạng thái**: Pending → In Progress → Done | Blocked | Skipped
-
-## Changelog
-
-Ghi lại mọi thay đổi so với plan gốc.
-
-### [date] — [mô tả thay đổi]
-- **Lý do**: [tại sao thay đổi]
-- **Ảnh hưởng**: [subtasks nào bị ảnh hưởng]
-- **Quyết định bởi**: [human / agent / cả hai]
-
-## Phát Hiện Mới
-
-Ghi lại khi phát hiện giả định sai, rủi ro mới, hoặc scope thay đổi.
-
-| # | Phát hiện | Ảnh hưởng | Hành động | Trạng thái |
-|---|-----------|-----------|-----------|-----------|
-| 1 | | | | Resolved / Open |
-
-## Blockers
-
-- [ ] [Blocker 1] — owner: [ai chịu trách nhiệm] — since: [date]
-
-<!-- Section dưới chỉ hiển thị khi flags.log_work = true -->
-
-## Effort Log
-
-| Ngày | Subtask | Loại công việc | Estimate | Actual | Ghi chú |
-|------|---------|---------------|----------|--------|---------|
-| | | coding/testing/review | | | |
-
-### Tổng kết Effort
-
-| Metric | Giá trị |
-|--------|---------|
-| Total Estimate | |
-| Total Actual | |
-| Variance | |
-| Accuracy | % |
-
-## Handoff Notes
-
-Ghi lại khi kết thúc session để người/agent tiếp theo hiểu context.
-
-### Session [date]
-- **Đang ở**: ST-[N] — [mô tả trạng thái]
-- **Context quan trọng**: [decisions, gotchas]
-- **Bước tiếp theo**: [việc cần làm ngay]
-- **Cẩn thận**: [warnings, edge cases đã gặp]
+<!-- ⚠️ LEGACY TEMPLATE — do not use for new tasks. -->
+<!-- Canonical task doc lineage = v3 (.dw/core/templates/v3/task.md), per ADR-0008 / ADR-0020. -->
+<!-- Kept only as reference for `dw task migrate` + reading legacy task docs. -->
+
+# Progress: [Task Name]
+
+## Trạng thái: Not Started | In Progress | Blocked | Done
+## Branch: [branch-name]
+## Bắt đầu: [date]
+## Kết thúc: [date — khi done]
+
+---
+
+## Subtask Progress
+
+| # | Subtask | Trạng thái | Commit | Người thực hiện | Ghi chú |
+|---|---------|-----------|--------|-----------------|---------|
+| ST-1 | | Pending | | | |
+| ST-2 | | Pending | | | |
+
+**Trạng thái**: Pending → In Progress → Done | Blocked | Skipped
+
+## Changelog
+
+Ghi lại mọi thay đổi so với plan gốc.
+
+### [date] — [mô tả thay đổi]
+- **Lý do**: [tại sao thay đổi]
+- **Ảnh hưởng**: [subtasks nào bị ảnh hưởng]
+- **Quyết định bởi**: [human / agent / cả hai]
+
+## Phát Hiện Mới
+
+Ghi lại khi phát hiện giả định sai, rủi ro mới, hoặc scope thay đổi.
+
+| # | Phát hiện | Ảnh hưởng | Hành động | Trạng thái |
+|---|-----------|-----------|-----------|-----------|
+| 1 | | | | Resolved / Open |
+
+## Blockers
+
+- [ ] [Blocker 1] — owner: [ai chịu trách nhiệm] — since: [date]
+
+<!-- Section dưới chỉ hiển thị khi flags.log_work = true -->
+
+## Effort Log
+
+| Ngày | Subtask | Loại công việc | Estimate | Actual | Ghi chú |
+|------|---------|---------------|----------|--------|---------|
+| | | coding/testing/review | | | |
+
+### Tổng kết Effort
+
+| Metric | Giá trị |
+|--------|---------|
+| Total Estimate | |
+| Total Actual | |
+| Variance | |
+| Accuracy | % |
+
+## Handoff Notes
+
+Ghi lại khi kết thúc session để người/agent tiếp theo hiểu context.
+
+### Session [date]
+- **Đang ở**: ST-[N] — [mô tả trạng thái]
+- **Context quan trọng**: [decisions, gotchas]
+- **Bước tiếp theo**: [việc cần làm ngay]
+- **Cẩn thận**: [warnings, edge cases đã gặp]

package/.dw/adapters/claude-cli/extensions/README.md

@@ -1,36 +1,36 @@
-# .dw/adapters/claude-cli/extensions/
-
-> **NET-NEW TEAM SKILLS — Không conflict với generated, không bị overwrite.**
-
-## Mục đích
-
-Thêm skills hoàn toàn mới mà không có trong dw-kit core.
-
-## Cách dùng
-
-```
-extensions/
-└── dw-deploy/
-    ├── SKILL.md        ← skill definition
-    └── README.md       ← optional: mô tả skill
-```
-
-`dw upgrade` copy tất cả skills trong thư mục này vào `.claude/skills/` (extensions không ghi đè skills đã customize).
-
-## Ví dụ Skills Phù Hợp
-
-- `/dw-deploy` — deployment workflow cho team
-- `/dw-migration` — database migration helper
-- `/dw-release` — release checklist
-- `/dw-notify` — team notification integration
-
-## Convention
-
-- Tên folder = tên skill (kebab-case)
-- SKILL.md theo format chuẩn (xem `.claude/skills/` cho examples)
-- Tên skill nên bắt đầu bằng `dw-` để nhất quán
-
-## Đóng góp cho community
-
-Nếu skill hữu ích cho mọi team, submit PR vào toolkit repo.
-Xem `docs/custom-skills.md` để biết hướng dẫn.
+# .dw/adapters/claude-cli/extensions/
+
+> **NET-NEW TEAM SKILLS — Không conflict với generated, không bị overwrite.**
+
+## Mục đích
+
+Thêm skills hoàn toàn mới mà không có trong dw-kit core.
+
+## Cách dùng
+
+```
+extensions/
+└── dw-deploy/
+    ├── SKILL.md        ← skill definition
+    └── README.md       ← optional: mô tả skill
+```
+
+`dw upgrade` copy tất cả skills trong thư mục này vào `.claude/skills/` (extensions không ghi đè skills đã customize).
+
+## Ví dụ Skills Phù Hợp
+
+- `/dw-deploy` — deployment workflow cho team
+- `/dw-migration` — database migration helper
+- `/dw-release` — release checklist
+- `/dw-notify` — team notification integration
+
+## Convention
+
+- Tên folder = tên skill (kebab-case)
+- SKILL.md theo format chuẩn (xem `.claude/skills/` cho examples)
+- Tên skill nên bắt đầu bằng `dw-` để nhất quán
+
+## Đóng góp cho community
+
+Nếu skill hữu ích cho mọi team, submit PR vào toolkit repo.
+Xem `docs/custom-skills.md` để biết hướng dẫn.

package/.dw/adapters/claude-cli/generated/README.md

@@ -1,23 +1,23 @@
-# .dw/adapters/claude-cli/generated/
-
-> **AUTO-GENERATED — Không edit tay.**
-> Thư mục này được overwrite khi nâng cấp toolkit trong quá trình build/generation nội bộ.
-
-## Nội dung
-
-Chứa Claude Code-specific files được generate từ `core/` + `.dw/config/dw.config.yml`:
-
-```
-generated/
-├── skills/          # Skill shell files (.claude/skills/ → populated từ đây)
-├── agents/          # Agent files (.claude/agents/ → populated từ đây)
-└── settings.json    # settings.json base template
-```
-
-## Cách hoạt động
-
-`dw init`/`dw upgrade` → populate `.claude/`, áp dụng overrides từ `overrides/` (override thắng).
-
-## Nếu muốn customize
-
-Đặt file override vào `.dw/adapters/claude-cli/overrides/` — không edit tay ở đây.
+# .dw/adapters/claude-cli/generated/
+
+> **AUTO-GENERATED — Không edit tay.**
+> Thư mục này được overwrite khi nâng cấp toolkit trong quá trình build/generation nội bộ.
+
+## Nội dung
+
+Chứa Claude Code-specific files được generate từ `core/` + `.dw/config/dw.config.yml`:
+
+```
+generated/
+├── skills/          # Skill shell files (.claude/skills/ → populated từ đây)
+├── agents/          # Agent files (.claude/agents/ → populated từ đây)
+└── settings.json    # settings.json base template
+```
+
+## Cách hoạt động
+
+`dw init`/`dw upgrade` → populate `.claude/`, áp dụng overrides từ `overrides/` (override thắng).
+
+## Nếu muốn customize
+
+Đặt file override vào `.dw/adapters/claude-cli/overrides/` — không edit tay ở đây.

package/.dw/adapters/claude-cli/overrides/README.md

@@ -1,37 +1,37 @@
-# .dw/adapters/claude-cli/overrides/
-
-> **TEAM CUSTOMIZATIONS — KHÔNG BAO GIỜ bị overwrite khi upgrade.**
-
-## Mục đích
-
-Đặt file override vào đây khi team muốn customize skill hoặc agent mà không mất khi upgrade toolkit.
-
-## Cách dùng
-
-Tạo file với đường dẫn tương tự `generated/`:
-
-```
-overrides/
-├── skills/
-│   └── plan/
-│       └── SKILL.md      ← override generated/skills/plan/SKILL.md
-└── agents/
-    └── reviewer.md       ← override generated/agents/reviewer.md
-```
-
-Khi chạy `dw upgrade`, luồng sẽ:
-1. Update `generated/` từ toolkit mới
-2. Apply overrides từ thư mục này (overrides thắng generated)
-3. Copy kết quả vào `.claude/`
-
-Trong v1, luồng chuẩn là `dw upgrade`: nó tôn trọng overrides khi cập nhật `.claude/`.
-
-## Khi nào nên override?
-
-- Team có domain-specific review rules
-- Team muốn thêm instruction vào planning workflow
-- Team cần custom output format
-
-## Khi nào dùng extensions/ thay vì overrides/?
-
-Dùng `extensions/` cho skills net-new (không override gì trong generated).
+# .dw/adapters/claude-cli/overrides/
+
+> **TEAM CUSTOMIZATIONS — KHÔNG BAO GIỜ bị overwrite khi upgrade.**
+
+## Mục đích
+
+Đặt file override vào đây khi team muốn customize skill hoặc agent mà không mất khi upgrade toolkit.
+
+## Cách dùng
+
+Tạo file với đường dẫn tương tự `generated/`:
+
+```
+overrides/
+├── skills/
+│   └── plan/
+│       └── SKILL.md      ← override generated/skills/plan/SKILL.md
+└── agents/
+    └── reviewer.md       ← override generated/agents/reviewer.md
+```
+
+Khi chạy `dw upgrade`, luồng sẽ:
+1. Update `generated/` từ toolkit mới
+2. Apply overrides từ thư mục này (overrides thắng generated)
+3. Copy kết quả vào `.claude/`
+
+Trong v1, luồng chuẩn là `dw upgrade`: nó tôn trọng overrides khi cập nhật `.claude/`.
+
+## Khi nào nên override?
+
+- Team có domain-specific review rules
+- Team muốn thêm instruction vào planning workflow
+- Team cần custom output format
+
+## Khi nào dùng extensions/ thay vì overrides/?
+
+Dùng `extensions/` cho skills net-new (không override gì trong generated).

package/.dw/adapters/generic/README.md

@@ -1,21 +1,21 @@
-# Generic Adapter
-
-Dành cho bất kỳ AI coding assistant nào (Cursor, Windsurf, Copilot, etc.).
-
-## Cách dùng
-
-1. Copy `AGENT.md` vào project root
-2. Copy `.dw/config/dw.config.yml` và điền settings
-3. Tạo `.dw/tasks/` directory
-
-## Limitations
-
-Generic adapter cung cấp **methodology** (what to do), không phải **execution** (how Claude Code does it).
-
-Không có:
-- Agent delegation với tool constraints
-- Pre-commit hooks (safety-guard, quality gates)
-- MCP server integration
-- Automatic context management
-
-Muốn full capabilities → dùng Claude Code với Claude CLI adapter.
+# Generic Adapter
+
+Dành cho bất kỳ AI coding assistant nào (Cursor, Windsurf, Copilot, etc.).
+
+## Cách dùng
+
+1. Copy `AGENT.md` vào project root
+2. Copy `.dw/config/dw.config.yml` và điền settings
+3. Tạo `.dw/tasks/` directory
+
+## Limitations
+
+Generic adapter cung cấp **methodology** (what to do), không phải **execution** (how Claude Code does it).
+
+Không có:
+- Agent delegation với tool constraints
+- Pre-commit hooks (safety-guard, quality gates)
+- MCP server integration
+- Automatic context management
+
+Muốn full capabilities → dùng Claude Code với Claude CLI adapter.

package/.dw/config/presets/enterprise.yml

@@ -1,52 +1,52 @@
-# dw-kit Preset: Enterprise — Full Workflow
-# Dùng cho: 5+ devs, full team roles, metrics tracking
-# Kế thừa từ: config/dw.config.yml (copy và modify)
-
-project:
-  name: "my-project"
-  language: "vi"
-
-workflow:
-  default_depth: "thorough"
-
-team:
-  roles:
-    - dev
-    - techlead
-    - ba
-    - qc
-    - pm
-
-quality:
-  test_command: ""     # BẮT BUỘC điền: "npm test" | "pytest" | ...
-  lint_command: ""     # BẮT BUỘC điền: "npm run lint" | ...
-  block_on_fail: true  # Block commit nếu fail
-
-tracking:
-  estimation: true
-  log_work: true
-  estimation_unit: "story-points"
-
-paths:
-  tasks: ".dw/tasks"
-  docs: ".dw/docs"
-
-claude:
-  models:
-    plan: "claude-opus-4-6"     # Dùng model mạnh nhất cho planning
-    execute: "claude-sonnet-4-6"
-    review: "claude-sonnet-4-6"
-  structured_output: true
-  worktree_execution: true      # Isolate risky refactors
-  mcp: []
-  # Uncomment và điền env vars để enable external integrations:
-  # mcp:
-  #   - name: "github"
-  #     command: "npx @modelcontextprotocol/server-github"
-  #     env:
-  #       GITHUB_TOKEN: "${GITHUB_TOKEN}"
-
-_toolkit:
-  core_version: "1.0"
-  platform_version: "1.0"
-  capability_version: "1.0"
+# dw-kit Preset: Enterprise — Full Workflow
+# Dùng cho: 5+ devs, full team roles, metrics tracking
+# Kế thừa từ: config/dw.config.yml (copy và modify)
+
+project:
+  name: "my-project"
+  language: "vi"
+
+workflow:
+  default_depth: "thorough"
+
+team:
+  roles:
+    - dev
+    - techlead
+    - ba
+    - qc
+    - pm
+
+quality:
+  test_command: ""     # BẮT BUỘC điền: "npm test" | "pytest" | ...
+  lint_command: ""     # BẮT BUỘC điền: "npm run lint" | ...
+  block_on_fail: true  # Block commit nếu fail
+
+tracking:
+  estimation: true
+  log_work: true
+  estimation_unit: "story-points"
+
+paths:
+  tasks: ".dw/tasks"
+  docs: ".dw/docs"
+
+claude:
+  models:
+    plan: "claude-opus-4-6"     # Dùng model mạnh nhất cho planning
+    execute: "claude-sonnet-4-6"
+    review: "claude-sonnet-4-6"
+  structured_output: true
+  worktree_execution: true      # Isolate risky refactors
+  mcp: []
+  # Uncomment và điền env vars để enable external integrations:
+  # mcp:
+  #   - name: "github"
+  #     command: "npx @modelcontextprotocol/server-github"
+  #     env:
+  #       GITHUB_TOKEN: "${GITHUB_TOKEN}"
+
+_toolkit:
+  core_version: "1.0"
+  platform_version: "1.0"
+  capability_version: "1.0"