dw-kit 1.0.0

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

@@ -0,0 +1,98 @@
+---
+name: dw-research
+description: "Khảo sát và phân tích codebase trước khi lập kế hoạch. Tìm patterns, dependencies, và ảnh hưởng của thay đổi. Dùng khi cần hiểu code trước khi implement."
+argument-hint: "[task-name]"
+context: fork
+agent: researcher
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - "Bash(git log *)"
+  - "Bash(git diff *)"
+  - "Bash(git show *)"
+  - "Bash(git blame *)"
+  - "Bash(ls *)"
+  - "Bash(wc *)"
+---
+
+# Khảo Sát Codebase
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → lấy `paths.tasks` để biết output location.
+
+## Bước 1: Đọc yêu cầu
+
+- Đọc file `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md` nếu đã có mô tả yêu cầu
+- Hoặc lấy yêu cầu từ conversation context
+
+## Bước 2: Khảo sát
+
+Thực hiện các bước sau (không cần theo thứ tự cứng):
+
+1. **Tìm files liên quan**: Dùng Glob + Grep để tìm files theo keywords từ yêu cầu
+2. **Đọc code**: Đọc các files tìm được, hiểu logic hiện tại
+3. **Trace data flow**: Theo dõi luồng dữ liệu từ input → processing → output
+4. **Xác định dependencies**:
+   - Upstream: modules/APIs mà code hiện tại gọi đến
+   - Downstream: modules/APIs gọi đến code hiện tại
+5. **Tìm patterns**: Conventions, design patterns đang dùng trong project
+6. **Kiểm tra tests**: Đã có test coverage cho khu vực liên quan?
+7. **Git history**: Xem lịch sử thay đổi gần đây của files liên quan
+
+## Bước 3: Áp dụng tư duy phản biện
+
+Từ framework `.claude/skills/dw-thinking/THINKING.md`:
+- **Giả định**: Những gì đang giả định là đúng? Cần kiểm chứng?
+- **Dependencies**: Module nào bị ảnh hưởng nếu thay đổi?
+- **Edge cases**: Trường hợp biên nào cần xem xét?
+- **Rủi ro**: Rủi ro kỹ thuật, bảo mật, performance?
+
+## Bước 4: Ghi kết quả
+
+Ghi vào `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md` theo cấu trúc:
+
+```markdown
+# Context: [Task Name]
+
+## Ngày khảo sát: [date]
+
+## Yêu Cầu Gốc
+[Copy yêu cầu]
+
+## Files Liên Quan
+| File | Vai trò | Cần thay đổi? | Ghi chú |
+|------|---------|----------------|---------|
+
+## Kiến Trúc Hiện Tại
+[Mô tả luồng, diagram nếu cần]
+
+## Dependencies
+**Upstream**: ...
+**Downstream**: ...
+
+## Patterns & Conventions
+- [Pattern]: [mô tả]
+
+## Giả Định & Hạn Chế
+- Giả định: ...
+- Hạn chế: ...
+- Chưa rõ: ...
+
+## Test Coverage Hiện Tại
+[Có test không? Coverage ở đâu?]
+
+## Ghi Chú
+[Bất kỳ thông tin bổ sung]
+```
+
+## Bước 5: Tóm tắt
+
+Khi hoàn thành, trả về tóm tắt:
+- Số files khảo sát
+- Key findings (3-5 bullets)
+- Risks & unknowns
+- Gợi ý: "Tiếp theo chạy `/dw-plan $ARGUMENTS`"

package/.claude/skills/dw-research/template-research.md

@@ -0,0 +1,51 @@
+# Research: [Task Name]
+
+## Ngày: [date] | Agent: researcher
+
+---
+
+## Yêu Cầu
+
+[Mô tả ngắn gọn task / yêu cầu cần khảo sát]
+
+## Files Liên Quan
+
+| # | File | Vai trò | Cần thay đổi? |
+|---|------|---------|----------------|
+| 1 | | | Có / Không |
+
+## Kiến Trúc Hiện Tại
+
+```
+[Sơ đồ ASCII đơn giản hoặc mô tả luồng hiện tại]
+```
+
+## Dependencies
+
+**Upstream** (phụ thuộc vào):
+- [Module/API]
+
+**Downstream** (bị ảnh hưởng):
+- [Module/API]
+
+## Patterns Phát Hiện
+
+| Pattern | Mô tả | Ví dụ (file) |
+|---------|--------|--------------|
+| | | |
+
+## Test Coverage
+
+- Tests hiện có: [Có / Không / Partial]
+- Files test: [danh sách nếu có]
+- Gaps: [thiếu test ở đâu]
+
+## Giả Định & Hạn Chế
+
+- **Giả định**: [điều đang coi là đúng]
+- **Hạn chế**: [giới hạn đã biết]
+- **Chưa rõ**: [cần làm rõ thêm]
+
+## Ghi Chú
+
+[Bất kỳ context quan trọng: gotchas, tech debt, lịch sử thay đổi gần đây]

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

@@ -0,0 +1,66 @@
+---
+name: dw-review
+description: "Review code thay đổi gần đây hoặc cả task. Kiểm tra correctness, security, conventions, test coverage. Tạo báo cáo phân loại Critical/Warning/Suggestion."
+argument-hint: "[task-name | branch | file]"
+context: fork
+agent: reviewer
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - "Bash(git diff *)"
+  - "Bash(git log *)"
+  - "Bash(git show *)"
+---
+
+# Code Review
+
+Target: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+
+## Xác Định Scope
+
+- Nếu có argument = task-name: review tất cả commits liên quan đến task
+- Nếu có argument = branch: `git diff main...$ARGUMENTS`
+- Nếu không có argument: `git diff HEAD~1` (commit gần nhất)
+
+## Quy Trình
+
+### 1. Lấy diff
+```bash
+git diff [scope] --name-only   # danh sách files changed
+git diff [scope]                # nội dung thay đổi
+```
+
+### 2. Đọc files liên quan
+Đọc toàn bộ files đã changed để hiểu full context (không chỉ diff).
+
+### 3. Review theo reviewer agent
+
+Agent `reviewer` sẽ kiểm tra:
+- **Correctness**: Logic, edge cases, error handling
+- **Security**: Input validation, auth, data exposure
+- **Performance**: N+1, unnecessary calls, complexity
+- **Tests**: Coverage, test quality
+- **Conventions**: Naming, structure, code style (`.claude/rules/code-style.md`)
+
+### 4. Kiểm tra checklist cụ thể
+
+Nếu có plan file (`{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`):
+- Đối chiếu acceptance criteria từng subtask
+- Kiểm tra scope có vượt plan không
+
+### 5. Output
+
+Tạo báo cáo đầy đủ theo format của reviewer agent.
+
+## Sau Review
+
+- Nếu có Critical issues: "Cần fix trước khi merge"
+- Nếu chỉ có Warnings: "Khuyến khích fix, nhưng có thể proceed"
+- Nếu pass: "Approved — có thể chạy `/dw-commit`"
+
+Nếu team có TL: "Gợi ý gửi báo cáo này cho TL để final approve."

package/.claude/skills/dw-review/checklist.md

@@ -0,0 +1,88 @@
+# Code Review Checklist
+
+Dùng checklist này khi review code. Phân loại mỗi issue tìm được.
+
+---
+
+## 🔴 Critical — Phải sửa trước khi merge
+
+### Correctness
+- [ ] Logic có đúng với requirements không?
+- [ ] Có lỗi off-by-one, null pointer, type mismatch?
+- [ ] Race conditions hoặc concurrency issues?
+- [ ] Data loss scenarios (delete không có confirm, overwrite không safe)?
+
+### Security
+- [ ] Input validation đầy đủ (SQL injection, XSS, path traversal)?
+- [ ] Authentication & authorization đúng ở mọi endpoint?
+- [ ] Sensitive data không bị log, expose qua API, hoặc lưu plain text?
+- [ ] Secrets/credentials không hardcode trong code?
+- [ ] CORS, rate limiting, CSRF được xử lý đúng?
+
+### Data Integrity
+- [ ] Database transactions dùng đúng chỗ?
+- [ ] Foreign key constraints được tôn trọng?
+- [ ] Migration có rollback plan?
+
+---
+
+## 🟡 Warning — Nên sửa
+
+### Performance
+- [ ] Có N+1 query problem không? (loop gọi DB từng item)
+- [ ] Index database cho các query thường xuyên?
+- [ ] Tải file/data lớn có streaming/pagination?
+- [ ] Cache được dùng hợp lý (không over-cache, không under-cache)?
+
+### Error Handling
+- [ ] Mọi error đều được catch và xử lý?
+- [ ] Error messages có đủ context để debug không?
+- [ ] API trả về đúng HTTP status code?
+- [ ] Không có empty catch blocks?
+
+### Code Quality
+- [ ] Functions quá dài (>50 lines) hoặc làm nhiều hơn 1 việc?
+- [ ] Code duplication đáng kể (>3 lần) không có abstraction?
+- [ ] Magic numbers/strings chưa được đặt tên?
+- [ ] Dead code, commented-out code còn sót?
+
+### Testing
+- [ ] Happy path được test?
+- [ ] Edge cases được test (empty, null, max value)?
+- [ ] Error paths được test?
+- [ ] Test có mock internal implementation không? (nên tránh)
+
+---
+
+## 🔵 Suggestion — Cân nhắc
+
+### Readability
+- [ ] Naming rõ ràng, tự giải thích?
+- [ ] Complex logic có comment giải thích WHY?
+- [ ] Imports được organize (external → internal → relative)?
+
+### Maintainability
+- [ ] Có thể test được (testability)?
+- [ ] Dependencies được inject thay vì hardcode?
+- [ ] Breaking changes được document?
+
+### Conventions
+- [ ] Tuân thủ `.claude/rules/code-style.md`?
+- [ ] File structure nhất quán với phần còn lại của project?
+- [ ] Commit message đúng format?
+
+---
+
+## ✅ Điểm Tốt Cần Ghi Nhận
+
+[Ghi lại những pattern tốt, approaches thông minh, hoặc improvements đáng khen]
+
+---
+
+## Severity Scale
+
+| Level | Mô tả | Action |
+|-------|--------|--------|
+| 🔴 Critical | Security issue, data loss, logic sai | Phải fix trước merge |
+| 🟡 Warning | Performance, maintainability, error handling | Nên fix, có thể negotiate |
+| 🔵 Suggestion | Style, readability, nice-to-have | Cân nhắc, không bắt buộc |

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

@@ -0,0 +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
+```

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

@@ -0,0 +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."

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

@@ -0,0 +1,59 @@
+---
+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"

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

@@ -0,0 +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"