dw-kit 1.2.1 → 1.3.4

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

@@ -1,90 +1,90 @@
----
-name: dw-rollback
-description: "Revert task docs về trạng thái trước. Dùng khi plan sai, execute sai hướng, hoặc cần bắt đầu lại từ sau research."
-argument-hint: "[task-name] [checkpoint: after-research | after-plan | clean]"
----
-
-# Rollback Task Docs: $ARGUMENTS
-
-## Parse Arguments
-
-Từ `$ARGUMENTS`:
-- `task-name`: tên task cần rollback
-- `checkpoint` (optional): điểm muốn revert về
-  - `after-research` — giữ context.md, xóa plan.md và reset progress.md
-  - `after-plan` — giữ context.md + plan.md, reset progress.md về trạng thái ban đầu
-  - `clean` — xóa toàn bộ nội dung, giữ files trống (restart từ đầu)
-  - (không có) → hỏi user chọn
-
-## Bước 1: Đọc config
-
-`paths.tasks` → xác định thư mục task.
-
-## Bước 2: Kiểm tra task tồn tại
-
-```
-{paths.tasks}/[task-name]/
-├── [task-name]-context.md
-├── [task-name]-plan.md
-└── [task-name]-progress.md
-```
-
-Nếu không tìm thấy → thông báo và DỪNG.
-
-## Bước 3: Git checkpoint (an toàn)
-
-Kiểm tra uncommitted changes trong task docs:
-```bash
-git status {paths.tasks}/[task-name]/
-```
-
-Nếu có uncommitted changes → hỏi: "Có uncommitted changes trong task docs. Commit trước khi rollback? (y/n/skip)"
-
-## Bước 4: Hiển thị preview và confirm
-
-Hiển thị rõ sẽ làm gì:
-```
-Rollback [task-name] về checkpoint: [checkpoint]
-
-Sẽ GIỮ:
-  ✓ [task-name]-context.md  (research findings)
-
-Sẽ RESET:
-  ✗ [task-name]-plan.md     → xóa nội dung, giữ file trống
-  ✗ [task-name]-progress.md → reset về "Not Started"
-
-Tiếp tục? (y/n)
-```
-
-Chờ user confirm trước khi thực hiện.
-
-## Bước 5: Thực hiện rollback
-
-### checkpoint = "after-research"
-- Giữ `context.md` nguyên vẹn
-- Reset `plan.md` → file trống (chỉ giữ header)
-- Reset `progress.md` → status = "Not Started", xóa subtask rows
-
-### checkpoint = "after-plan"
-- Giữ `context.md` nguyên vẹn
-- Giữ `plan.md` nguyên vẹn
-- Reset `progress.md` → status = "Not Started", tất cả subtasks = Pending
-
-### checkpoint = "clean"
-- Reset tất cả 3 files về template trống
-- Điền lại [Task Name] và [date]
-
-## Bước 6: Thông báo
-
-```
-Rollback hoàn tất.
-
-Task: [task-name]
-Checkpoint: [checkpoint]
-Thời gian: [timestamp]
-
-Bước tiếp theo:
-- after-research → Chạy /dw-plan [task-name] để lập kế hoạch lại
-- after-plan     → Chạy /dw-execute [task-name] để implement lại
-- clean          → Chạy /dw-research [task-name] để bắt đầu từ đầu
-```
+---
+name: dw:rollback
+description: "Revert task docs về trạng thái trước. Dùng khi plan sai, execute sai hướng, hoặc cần bắt đầu lại từ sau research."
+argument-hint: "[task-name] [checkpoint: after-research | after-plan | clean]"
+---
+
+# Rollback Task Docs: $ARGUMENTS
+
+## Parse Arguments
+
+Từ `$ARGUMENTS`:
+- `task-name`: tên task cần rollback
+- `checkpoint` (optional): điểm muốn revert về
+  - `after-research` — giữ context.md, xóa plan.md và reset progress.md
+  - `after-plan` — giữ context.md + plan.md, reset progress.md về trạng thái ban đầu
+  - `clean` — xóa toàn bộ nội dung, giữ files trống (restart từ đầu)
+  - (không có) → hỏi user chọn
+
+## Bước 1: Đọc config
+
+`paths.tasks` → xác định thư mục task.
+
+## Bước 2: Kiểm tra task tồn tại
+
+```
+{paths.tasks}/[task-name]/
+├── [task-name]-context.md
+├── [task-name]-plan.md
+└── [task-name]-progress.md
+```
+
+Nếu không tìm thấy → thông báo và DỪNG.
+
+## Bước 3: Git checkpoint (an toàn)
+
+Kiểm tra uncommitted changes trong task docs:
+```bash
+git status {paths.tasks}/[task-name]/
+```
+
+Nếu có uncommitted changes → hỏi: "Có uncommitted changes trong task docs. Commit trước khi rollback? (y/n/skip)"
+
+## Bước 4: Hiển thị preview và confirm
+
+Hiển thị rõ sẽ làm gì:
+```
+Rollback [task-name] về checkpoint: [checkpoint]
+
+Sẽ GIỮ:
+  ✓ [task-name]-context.md  (research findings)
+
+Sẽ RESET:
+  ✗ [task-name]-plan.md     → xóa nội dung, giữ file trống
+  ✗ [task-name]-progress.md → reset về "Not Started"
+
+Tiếp tục? (y/n)
+```
+
+Chờ user confirm trước khi thực hiện.
+
+## Bước 5: Thực hiện rollback
+
+### checkpoint = "after-research"
+- Giữ `context.md` nguyên vẹn
+- Reset `plan.md` → file trống (chỉ giữ header)
+- Reset `progress.md` → status = "Not Started", xóa subtask rows
+
+### checkpoint = "after-plan"
+- Giữ `context.md` nguyên vẹn
+- Giữ `plan.md` nguyên vẹn
+- Reset `progress.md` → status = "Not Started", tất cả subtasks = Pending
+
+### checkpoint = "clean"
+- Reset tất cả 3 files về template trống
+- Điền lại [Task Name] và [date]
+
+## Bước 6: Thông báo
+
+```
+Rollback hoàn tất.
+
+Task: [task-name]
+Checkpoint: [checkpoint]
+Thời gian: [timestamp]
+
+Bước tiếp theo:
+- after-research → Chạy /dw:plan [task-name] để lập kế hoạch lại
+- after-plan     → Chạy /dw:execute [task-name] để implement lại
+- clean          → Chạy /dw:research [task-name] để bắt đầu từ đầu
+```

package/.claude/skills/dw-sprint-review/SKILL.md

@@ -1,99 +1,99 @@
----
-name: dw-sprint-review
-description: "Tổng kết sprint: tasks hoàn thành, metrics, lessons learned, items cho sprint tiếp theo. Dành cho team retrospective cuối sprint."
-argument-hint: "[sprint-name hoặc period: e.g. sprint-3, 2026-03]"
----
-
-# Sprint Review: $ARGUMENTS
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml`:
-- `paths.tasks` → tìm task docs
-- `.dw/metrics` → tìm effort data
-- `tracking.estimation`, `tracking.log_work` → biết có data nào
-
-## Bước 1: Thu thập dữ liệu
-
-### Tasks trong sprint
-Scan `{paths.tasks}/` tìm tasks có status Done hoặc In Progress trong kỳ sprint.
-Đọc `*-progress.md` của mỗi task để lấy:
-- Trạng thái cuối
-- Effort estimate vs actual
-- Blockers gặp phải
-- Commits liên quan
-
-### Git history
-```bash
-git log --oneline --since="[sprint-start]" --until="[sprint-end]"
-```
-
-## Bước 2: Tạo báo cáo sprint
-
-Ghi vào `{paths.reports}/sprint-review-$ARGUMENTS.md`:
-
-```markdown
-# Sprint Review: [Sprint Name]
-
-**Kỳ**: [start] → [end]
-**Team**: [roles từ config]
-**Ngày tạo**: [date]
-
----
-
-## Tóm Tắt
-
-| Metric | Giá trị |
-|--------|---------|
-| Tasks hoàn thành | X/Y |
-| Estimate tổng | Xh |
-| Actual tổng | Xh |
-| Accuracy | X% |
-| Commits | X |
-
-## Tasks Hoàn Thành
-
-| Task | Estimate | Actual | Variance | Ghi chú |
-|------|----------|--------|----------|---------|
-| [task-name] | | | | |
-
-## Tasks Chưa Hoàn Thành / Carry-over
-
-| Task | Lý do | Hành động |
-|------|-------|-----------|
-| | | |
-
-## Blockers Gặp Phải
-
-[Danh sách blockers, đã giải quyết hay chưa]
-
-## Lessons Learned
-
-### Làm tốt (Keep)
-- [Điều gì hiệu quả trong sprint này]
-
-### Cần cải thiện (Improve)
-- [Điều gì cần làm khác đi]
-
-### Thử nghiệm (Try)
-- [Điều gì muốn thử trong sprint sau]
-
-## Items Cho Sprint Tiếp Theo
-
-- [ ] [Action item 1] — owner: [role]
-- [ ] [Action item 2]
-
-## DORA Metrics (nếu có data)
-
-| Metric | Giá trị | Target |
-|--------|---------|--------|
-| Deployment frequency | | |
-| Lead time for changes | | |
-| Change failure rate | | |
-| MTTR | | |
-```
-
-## Bước 3: Thông báo
-
-Hiển thị summary và path đến file báo cáo.
-Gợi ý: "PM có thể chạy `/dw-dashboard` để xem báo cáo đầy đủ hơn."
+---
+name: dw:sprint-review
+description: "Tổng kết sprint: tasks hoàn thành, metrics, lessons learned, items cho sprint tiếp theo. Dành cho team retrospective cuối sprint."
+argument-hint: "[sprint-name hoặc period: e.g. sprint-3, 2026-03]"
+---
+
+# Sprint Review: $ARGUMENTS
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `paths.tasks` → tìm task docs
+- `.dw/metrics` → tìm effort data
+- `tracking.estimation`, `tracking.log_work` → biết có data nào
+
+## Bước 1: Thu thập dữ liệu
+
+### Tasks trong sprint
+Scan `{paths.tasks}/` tìm tasks có status Done hoặc In Progress trong kỳ sprint.
+Đọc `*-progress.md` của mỗi task để lấy:
+- Trạng thái cuối
+- Effort estimate vs actual
+- Blockers gặp phải
+- Commits liên quan
+
+### Git history
+```bash
+git log --oneline --since="[sprint-start]" --until="[sprint-end]"
+```
+
+## Bước 2: Tạo báo cáo sprint
+
+Ghi vào `{paths.reports}/sprint-review-$ARGUMENTS.md`:
+
+```markdown
+# Sprint Review: [Sprint Name]
+
+**Kỳ**: [start] → [end]
+**Team**: [roles từ config]
+**Ngày tạo**: [date]
+
+---
+
+## Tóm Tắt
+
+| Metric | Giá trị |
+|--------|---------|
+| Tasks hoàn thành | X/Y |
+| Estimate tổng | Xh |
+| Actual tổng | Xh |
+| Accuracy | X% |
+| Commits | X |
+
+## Tasks Hoàn Thành
+
+| Task | Estimate | Actual | Variance | Ghi chú |
+|------|----------|--------|----------|---------|
+| [task-name] | | | | |
+
+## Tasks Chưa Hoàn Thành / Carry-over
+
+| Task | Lý do | Hành động |
+|------|-------|-----------|
+| | | |
+
+## Blockers Gặp Phải
+
+[Danh sách blockers, đã giải quyết hay chưa]
+
+## Lessons Learned
+
+### Làm tốt (Keep)
+- [Điều gì hiệu quả trong sprint này]
+
+### Cần cải thiện (Improve)
+- [Điều gì cần làm khác đi]
+
+### Thử nghiệm (Try)
+- [Điều gì muốn thử trong sprint sau]
+
+## Items Cho Sprint Tiếp Theo
+
+- [ ] [Action item 1] — owner: [role]
+- [ ] [Action item 2]
+
+## DORA Metrics (nếu có data)
+
+| Metric | Giá trị | Target |
+|--------|---------|--------|
+| Deployment frequency | | |
+| Lead time for changes | | |
+| Change failure rate | | |
+| MTTR | | |
+```
+
+## Bước 3: Thông báo
+
+Hiển thị summary và path đến file báo cáo.
+Gợi ý: "PM có thể chạy `/dw:dashboard` để xem báo cáo đầy đủ hơn."

package/.claude/skills/dw-task-init/SKILL.md

@@ -1,59 +1,71 @@
----
-name: dw-task-init
-description: "Khởi tạo bộ documentation cho task mới. Tạo thư mục và 3 template files (context, plan, progress)."
-argument-hint: "[task-name]"
----
-
-# Khởi Tạo Task: $ARGUMENTS
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` để lấy:
-- `paths.tasks` → thư mục chứa task docs (mặc định: `.dw/tasks`)
-- `workflow.default_depth` → `quick | standard | thorough`
-- `tracking.estimation` → có tạo section estimation không
-- `tracking.log_work` → có tạo section effort log không
-- `team.roles` → hiển thị workflow phù hợp
-- `project.language` → chọn template ngôn ngữ
-
-## Tạo Thư Mục & Files
-
-```
-{paths.tasks}/$ARGUMENTS/
-├── $ARGUMENTS-context.md    # Research findings & codebase analysis
-├── $ARGUMENTS-plan.md       # Implementation plan & design
-└── $ARGUMENTS-progress.md   # Progress tracking, effort log, changelog
-```
-
-### File context.md
-Đọc `project.language` từ config để chọn template:
-- `language: "vi"` → dùng `.claude/templates/task-context.md`
-- `language: "en"` → dùng `.claude/templates/en/task-context.md`
-
-Điền vào template:
-- `[Task Name]` = `$ARGUMENTS`
-- `[date]` = ngày hiện tại
-
-### File plan.md
-Chọn template theo `project.language` (`.claude/templates/[lang]/task-plan.md`).
-- Nếu `tracking.estimation = true`: giữ nguyên section Estimation
-- Nếu `tracking.estimation = false`: xóa section Estimation
-
-### File progress.md
-Chọn template theo `project.language` (`.claude/templates/[lang]/task-progress.md`).
-- Điền `[Task Name]` = `$ARGUMENTS`
-- Điền `[date]` = ngày hiện tại
-- Nếu `tracking.log_work = true`: giữ section Effort Log
-- Nếu `tracking.log_work = false`: xóa section Effort Log
-
-## Sau Khi Tạo
-
-Hiển thị cho user:
-1. Danh sách files đã tạo
-2. Workflow tiếp theo dựa trên `workflow.default_depth`:
-
-**quick**: "Tiếp theo: Code ngay hoặc `/dw-research $ARGUMENTS` nếu cần khảo sát"
-**standard**: "Tiếp theo: `/dw-research $ARGUMENTS` → `/dw-plan $ARGUMENTS` → approve → `/dw-execute $ARGUMENTS`"
-**thorough**: "Tiếp theo: `/dw-requirements $ARGUMENTS` → `/dw-research $ARGUMENTS` → `/dw-estimate $ARGUMENTS` → `/dw-plan $ARGUMENTS`"
-
-Nếu team có BA: "Gợi ý: BA có thể chạy `/dw-requirements $ARGUMENTS` trước để chuẩn bị yêu cầu"
+---
+name: dw:task-init
+description: "Khởi tạo bộ documentation cho task mới. Tạo thư mục và 2 files v2 (spec.md + tracking.md)."
+argument-hint: "[task-name]"
+---
+
+# Khởi Tạo Task: $ARGUMENTS
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `paths.tasks` → thư mục chứa task docs (mặc định: `.dw/tasks`)
+- `workflow.default_depth` → `quick | standard | thorough`
+- `project.language` → ngôn ngữ note thêm (templates hiện tại là vi/en-agnostic)
+
+## Tạo Thư Mục & Files (v2 format)
+
+```
+{paths.tasks}/$ARGUMENTS/
+├── spec.md      # Intent + subtasks + success criteria (stable after approve)
+└── tracking.md  # Progress + changelog + handoff (mutable)
+```
+
+### 1. Tạo spec.md
+
+Đọc template từ `.dw/core/templates/v2/spec.md`, điền vào:
+- `{task-name}` → `$ARGUMENTS`
+- `{YYYY-MM-DD}` (created) → ngày hiện tại
+- `status` → `Draft`
+- `depth` → giá trị `workflow.default_depth` từ config
+- `owner` → để trống (user tự điền)
+- `related_adr` → `none`
+- `target_ship` → `none`
+
+Ghi vào `{paths.tasks}/$ARGUMENTS/spec.md`.
+
+### 2. Tạo tracking.md
+
+Đọc template từ `.dw/core/templates/v2/tracking.md`, điền vào:
+- `{task-name}` → `$ARGUMENTS`
+- `{YYYY-MM-DD}` (started & last_updated) → ngày hiện tại
+- `status` → `Not Started`
+- `current_phase` → `Init`
+- `blockers` → `none`
+
+Ghi vào `{paths.tasks}/$ARGUMENTS/tracking.md`.
+
+### 3. Cập nhật ACTIVE.md
+
+Sau khi tạo xong 2 files, chạy `dw active` (hoặc invoke `writeActiveIndex`) để regenerate `{paths.tasks}/ACTIVE.md` — team index sẽ thấy task mới.
+
+## Sau Khi Tạo
+
+Hiển thị cho user:
+
+1. Danh sách files đã tạo:
+   - `{paths.tasks}/$ARGUMENTS/spec.md`
+   - `{paths.tasks}/$ARGUMENTS/tracking.md`
+
+2. Workflow tiếp theo theo `workflow.default_depth`:
+   - **quick**: "Code ngay hoặc `/dw:research $ARGUMENTS` nếu cần khảo sát."
+   - **standard**: "`/dw:research $ARGUMENTS` → `/dw:plan $ARGUMENTS` → approve → `/dw:execute $ARGUMENTS`"
+   - **thorough**: "`/dw:requirements $ARGUMENTS` → `/dw:research $ARGUMENTS` → `/dw:estimate $ARGUMENTS` → `/dw:plan $ARGUMENTS`"
+
+3. Nếu team có BA role: "BA có thể chạy `/dw:requirements $ARGUMENTS` trước để chuẩn bị yêu cầu."
+
+## Lưu ý v2 format
+
+- `spec.md` ổn định sau khi approve — subtasks + success criteria không thay đổi mà không có lý do.
+- `tracking.md` mutable — cập nhật mỗi session (Subtask Progress table, Changelog, Friction Journal).
+- Legacy 3-file format (`context + plan + progress`) vẫn được đọc bởi các skill khác để backward compat, nhưng **không tạo mới** cho task mới.