dw-kit 1.2.1 → 1.3.0

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

@@ -1,119 +1,119 @@
----
-name: dw-arch-review
-description: "TL skill: Review kiến trúc và technical feasibility của plan. Approve hoặc request changes trước khi dev execute."
-argument-hint: "[task-name]"
-context: fork
-agent: planner
-allowed-tools:
-  - Read
-  - Grep
-  - Glob
-  - "Bash(git log *)"
-  - "Bash(git diff *)"
----
-
-# Architecture Review
-
-Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
-Skill này dành cho depth: `thorough` (TL role). Với `standard`, tùy TL quyết định.
-
-## Role: Tech Lead
-
-Bạn đang thực hiện với vai trò **Tech Lead**. Đây là checkpoint quan trọng trước khi team bắt đầu implement.
-
-## Đọc Tài Liệu
-
-1. Đọc requirements (nếu có): `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md`
-2. Đọc plan: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
-3. Đọc context: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
-4. Đọc living docs (nếu có): `.dw/docs/ARCHITECTURE.md`, `.dw/docs/DECISIONS.md`
-
-## Review Checklist
-
-### Technical Feasibility
-- [ ] Approach có khả thi trong codebase hiện tại không?
-- [ ] Có tech debt nào block implementation không?
-- [ ] Dependencies ngoài (libs, services) có sẵn sàng không?
-
-### Architecture Alignment
-- [ ] Giải pháp có phù hợp với kiến trúc hiện tại không?
-- [ ] Có vi phạm principles (SOLID, DRY, separation of concerns) không?
-- [ ] API design có nhất quán với patterns hiện tại không?
-
-### Scale & Performance
-- [ ] Có performance implications không?
-- [ ] Query patterns có tối ưu không (N+1, missing index)?
-- [ ] Caching strategy phù hợp?
-
-### Security
-- [ ] Authentication & authorization đúng không?
-- [ ] Input validation đầy đủ chưa?
-- [ ] Sensitive data được handle đúng không?
-
-### Testing
-- [ ] Plan có unit test strategy không?
-- [ ] Integration test coverage đủ không?
-- [ ] Có cần E2E tests không?
-
-### Maintainability
-- [ ] Code sẽ dễ maintain không?
-- [ ] Có tạo tech debt không cần thiết không?
-- [ ] Documentation plan đủ không?
-
-### Subtask Breakdown
-- [ ] Subtasks có đủ nhỏ và độc lập không?
-- [ ] Dependency graph hợp lý không?
-- [ ] Estimate có realistic không?
-
-## Output — Architecture Decision
-
-```markdown
-# Architecture Review: [Task Name]
-
-## Reviewer: TL | Date: [date]
-
-## Quyết Định
-**✅ APPROVED** / **🔄 APPROVED WITH CHANGES** / **❌ NEEDS REWORK**
-
-## Technical Assessment
-
-### Strengths
-- [Điểm tốt của approach]
-
-### Concerns
-
-#### 🔴 Must Fix (trước khi execute)
-- [ ] **[Concern 1]**: [mô tả] → Proposed fix: [gợi ý]
-
-#### 🟡 Should Fix
-- [ ] **[Concern 2]**: [mô tả]
-
-#### 🔵 Nice to Have
-- [ ] **[Suggestion]**: [mô tả]
-
-## Architecture Decisions
-
-### Decision: [Tiêu đề]
-- **Context**: [tại sao cần quyết định]
-- **Decision**: [đã chọn gì]
-- **Consequences**: [ảnh hưởng]
-
-## Điều Chỉnh Plan
-
-[Nếu có thay đổi cần ghi vào plan]
-
-## Next Steps
-
-[Sau khi dev fix concerns] → có thể bắt đầu `/dw-execute $ARGUMENTS`
-```
-
-## Cập Nhật Plan
-
-Nếu có changes → ghi nhận vào plan file:
-- Thêm architectural decisions vào DECISIONS.md
-- Cập nhật subtasks nếu cần
-- Đổi trạng thái plan: Draft → Approved (hoặc ghi rõ cần rework gì)
+---
+name: dw:arch-review
+description: "TL skill: Review kiến trúc và technical feasibility của plan. Approve hoặc request changes trước khi dev execute."
+argument-hint: "[task-name]"
+context: fork
+agent: planner
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - "Bash(git log *)"
+  - "Bash(git diff *)"
+---
+
+# Architecture Review
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+Skill này dành cho depth: `thorough` (TL role). Với `standard`, tùy TL quyết định.
+
+## Role: Tech Lead
+
+Bạn đang thực hiện với vai trò **Tech Lead**. Đây là checkpoint quan trọng trước khi team bắt đầu implement.
+
+## Đọc Tài Liệu
+
+1. Đọc requirements (nếu có): `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md`
+2. Đọc plan: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
+3. Đọc context: `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
+4. Đọc living docs (nếu có): `.dw/docs/ARCHITECTURE.md`, `.dw/docs/DECISIONS.md`
+
+## Review Checklist
+
+### Technical Feasibility
+- [ ] Approach có khả thi trong codebase hiện tại không?
+- [ ] Có tech debt nào block implementation không?
+- [ ] Dependencies ngoài (libs, services) có sẵn sàng không?
+
+### Architecture Alignment
+- [ ] Giải pháp có phù hợp với kiến trúc hiện tại không?
+- [ ] Có vi phạm principles (SOLID, DRY, separation of concerns) không?
+- [ ] API design có nhất quán với patterns hiện tại không?
+
+### Scale & Performance
+- [ ] Có performance implications không?
+- [ ] Query patterns có tối ưu không (N+1, missing index)?
+- [ ] Caching strategy phù hợp?
+
+### Security
+- [ ] Authentication & authorization đúng không?
+- [ ] Input validation đầy đủ chưa?
+- [ ] Sensitive data được handle đúng không?
+
+### Testing
+- [ ] Plan có unit test strategy không?
+- [ ] Integration test coverage đủ không?
+- [ ] Có cần E2E tests không?
+
+### Maintainability
+- [ ] Code sẽ dễ maintain không?
+- [ ] Có tạo tech debt không cần thiết không?
+- [ ] Documentation plan đủ không?
+
+### Subtask Breakdown
+- [ ] Subtasks có đủ nhỏ và độc lập không?
+- [ ] Dependency graph hợp lý không?
+- [ ] Estimate có realistic không?
+
+## Output — Architecture Decision
+
+```markdown
+# Architecture Review: [Task Name]
+
+## Reviewer: TL | Date: [date]
+
+## Quyết Định
+**✅ APPROVED** / **🔄 APPROVED WITH CHANGES** / **❌ NEEDS REWORK**
+
+## Technical Assessment
+
+### Strengths
+- [Điểm tốt của approach]
+
+### Concerns
+
+#### 🔴 Must Fix (trước khi execute)
+- [ ] **[Concern 1]**: [mô tả] → Proposed fix: [gợi ý]
+
+#### 🟡 Should Fix
+- [ ] **[Concern 2]**: [mô tả]
+
+#### 🔵 Nice to Have
+- [ ] **[Suggestion]**: [mô tả]
+
+## Architecture Decisions
+
+### Decision: [Tiêu đề]
+- **Context**: [tại sao cần quyết định]
+- **Decision**: [đã chọn gì]
+- **Consequences**: [ảnh hưởng]
+
+## Điều Chỉnh Plan
+
+[Nếu có thay đổi cần ghi vào plan]
+
+## Next Steps
+
+[Sau khi dev fix concerns] → có thể bắt đầu `/dw:execute $ARGUMENTS`
+```
+
+## Cập Nhật Plan
+
+Nếu có changes → ghi nhận vào plan file:
+- Thêm architectural decisions vào DECISIONS.md
+- Cập nhật subtasks nếu cần
+- Đổi trạng thái plan: Draft → Approved (hoặc ghi rõ cần rework gì)

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

@@ -1,81 +1,81 @@
----
-name: dw-archive
-description: "Move task docs đã hoàn thành vào archive. Giữ .dw/tasks/ gọn gàng. Dùng sau khi task Done và đã merge PR."
-argument-hint: "[task-name | --all-done | --older-than-days N]"
----
-
-# Archive Tasks: $ARGUMENTS
-
-## Parse Arguments
-
-- `[task-name]` — archive 1 task cụ thể
-- `--all-done` — archive tất cả tasks có status Done
-- `--older-than-days N` — archive tasks Done đã N ngày
-
-## Bước 1: Đọc config
-
-`paths.tasks` → thư mục tasks.
-Archive destination: `{paths.tasks}/archive/`
-
-## Bước 2: Tìm tasks cần archive
-
-### Nếu `[task-name]`:
-Đọc `{paths.tasks}/[task-name]/[task-name]-progress.md` → kiểm tra status.
-Nếu status không phải Done → warn: "Task chưa Done. Archive anyway? (y/n)"
-
-### Nếu `--all-done`:
-```bash
-grep -r "^## Trạng thái: Done" {paths.tasks}/*/  # hoặc "Status: Done" (en)
-```
-Liệt kê tất cả tasks Done.
-
-### Nếu `--older-than-days N`:
-Kết hợp: tasks Done VÀ completion date > N ngày trước.
-
-## Bước 3: Preview và confirm
-
-```
-Tasks sẽ được archive:
-
-  [task-name-1]  — Done — [completion date]
-  [task-name-2]  — Done — [completion date]
-
-Destination: {paths.tasks}/archive/
-
-Tiếp tục? (y/n)
-```
-
-## Bước 4: Archive
-
-```bash
-mkdir -p {paths.tasks}/archive/[YYYY-MM]/
-mv {paths.tasks}/[task-name] {paths.tasks}/archive/[YYYY-MM]/
-```
-
-Tổ chức theo tháng hoàn thành để dễ tìm kiếm sau.
-
-## Bước 5: Cập nhật archive index
-
-Ghi/cập nhật `{paths.tasks}/archive/README.md`:
-
-```markdown
-# Task Archive
-
-| Task | Completion Date | Month | Summary |
-|------|----------------|-------|---------|
-| [task-name] | [date] | [YYYY-MM] | [1-line summary từ progress.md] |
-```
-
-## Bước 6: Thông báo
-
-```
-Archive hoàn tất.
-
-Đã archive X task(s):
-  ✓ [task-name-1] → archive/[YYYY-MM]/
-  ✓ [task-name-2] → archive/[YYYY-MM]/
-
-Index cập nhật: {paths.tasks}/archive/README.md
-
-.dw/tasks/ hiện còn: [N] active tasks
-```
+---
+name: dw:archive
+description: "Move task docs đã hoàn thành vào archive. Giữ .dw/tasks/ gọn gàng. Dùng sau khi task Done và đã merge PR."
+argument-hint: "[task-name | --all-done | --older-than-days N]"
+---
+
+# Archive Tasks: $ARGUMENTS
+
+## Parse Arguments
+
+- `[task-name]` — archive 1 task cụ thể
+- `--all-done` — archive tất cả tasks có status Done
+- `--older-than-days N` — archive tasks Done đã N ngày
+
+## Bước 1: Đọc config
+
+`paths.tasks` → thư mục tasks.
+Archive destination: `{paths.tasks}/archive/`
+
+## Bước 2: Tìm tasks cần archive
+
+### Nếu `[task-name]`:
+Đọc `{paths.tasks}/[task-name]/[task-name]-progress.md` → kiểm tra status.
+Nếu status không phải Done → warn: "Task chưa Done. Archive anyway? (y/n)"
+
+### Nếu `--all-done`:
+```bash
+grep -r "^## Trạng thái: Done" {paths.tasks}/*/  # hoặc "Status: Done" (en)
+```
+Liệt kê tất cả tasks Done.
+
+### Nếu `--older-than-days N`:
+Kết hợp: tasks Done VÀ completion date > N ngày trước.
+
+## Bước 3: Preview và confirm
+
+```
+Tasks sẽ được archive:
+
+  [task-name-1]  — Done — [completion date]
+  [task-name-2]  — Done — [completion date]
+
+Destination: {paths.tasks}/archive/
+
+Tiếp tục? (y/n)
+```
+
+## Bước 4: Archive
+
+```bash
+mkdir -p {paths.tasks}/archive/[YYYY-MM]/
+mv {paths.tasks}/[task-name] {paths.tasks}/archive/[YYYY-MM]/
+```
+
+Tổ chức theo tháng hoàn thành để dễ tìm kiếm sau.
+
+## Bước 5: Cập nhật archive index
+
+Ghi/cập nhật `{paths.tasks}/archive/README.md`:
+
+```markdown
+# Task Archive
+
+| Task | Completion Date | Month | Summary |
+|------|----------------|-------|---------|
+| [task-name] | [date] | [YYYY-MM] | [1-line summary từ progress.md] |
+```
+
+## Bước 6: Thông báo
+
+```
+Archive hoàn tất.
+
+Đã archive X task(s):
+  ✓ [task-name-1] → archive/[YYYY-MM]/
+  ✓ [task-name-2] → archive/[YYYY-MM]/
+
+Index cập nhật: {paths.tasks}/archive/README.md
+
+.dw/tasks/ hiện còn: [N] active tasks
+```

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

@@ -1,81 +1,81 @@
----
-name: dw-commit
-description: "Tạo commit thông minh với quality checks tùy theo config. Chạy tests/lint trước commit nếu flags bật."
-argument-hint: "[commit message]"
----
-
-# Smart Commit
-
-Message: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → lấy:
-- `quality.test_command` → lệnh chạy tests (bỏ qua nếu rỗng)
-- `quality.lint_command` → lệnh chạy linter (bỏ qua nếu rỗng)
-- `quality.block_on_fail` → block commit nếu fail
-- `workflow.default_depth` → `thorough` = gợi ý `/dw-docs-update` sau commit
-- `tracking.log_work` → ghi metrics effort
-
-## Quy Trình
-
-### 1. Kiểm tra trạng thái
-```bash
-git status
-git diff --staged --stat
-```
-Nếu không có changes → thông báo "Không có gì để commit."
-
-### 2. Quality Checks
-
-**Nếu `quality.test_command` không rỗng:**
-- Chạy: `quality.test_command` (hoặc tests liên quan đến files changed)
-- Nếu FAIL:
-  - `quality.block_on_fail = true` → **DỪNG**, báo lỗi, yêu cầu fix
-  - `quality.block_on_fail = false` → cảnh báo, hỏi user có muốn tiếp tục
-
-**Nếu `quality.lint_command` không rỗng:**
-- Chạy: `quality.lint_command`
-- Xử lý tương tự tests
-
-### 3. Kiểm tra sensitive files
-- Scan staged files cho: `.env`, passwords, tokens, API keys
-- Nếu phát hiện → **CẢNH BÁO** và hỏi user
-
-### 4. Kiểm tra leftover debug code
-- Grep staged files cho: `console.log`, `debugger`, `TODO:`, `FIXME:`
-- Nếu có → cảnh báo (không block)
-
-### 5. Tạo commit message
-
-Nếu có `$ARGUMENTS` → dùng làm mô tả:
-```
-<auto-detect-type>(<auto-detect-scope>): $ARGUMENTS
-
-Co-Authored-By: Claude <noreply@anthropic.com>
-```
-
-Nếu KHÔNG có `$ARGUMENTS` → phân tích diff và tạo message tự động:
-- Detect type từ loại thay đổi (feat/fix/refactor/test/docs/chore)
-- Detect scope từ files/directories changed
-- Viết mô tả ngắn gọn
-
-### 6. Thực hiện commit
-```bash
-git add [relevant files]
-git commit -m "<message>"
-```
-
-### 7. Post-commit
-
-**Nếu `workflow.default_depth = thorough`:**
-- Thông báo: "Living docs cần cập nhật. Chạy `/dw-docs-update`?"
-
-**Nếu `tracking.log_work = true`:**
-- Ghi commit vào `.dw/metrics/`: timestamp, type, scope, files changed
-
-### 8. Hiển thị kết quả
-- Commit hash
-- Files committed
-- Quality check results (nếu có)
-- Next steps
+---
+name: dw:commit
+description: "Tạo commit thông minh với quality checks tùy theo config. Chạy tests/lint trước commit nếu flags bật."
+argument-hint: "[commit message]"
+---
+
+# Smart Commit
+
+Message: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → lấy:
+- `quality.test_command` → lệnh chạy tests (bỏ qua nếu rỗng)
+- `quality.lint_command` → lệnh chạy linter (bỏ qua nếu rỗng)
+- `quality.block_on_fail` → block commit nếu fail
+- `workflow.default_depth` → `thorough` = gợi ý `/dw:docs-update` sau commit
+- `tracking.log_work` → ghi metrics effort
+
+## Quy Trình
+
+### 1. Kiểm tra trạng thái
+```bash
+git status
+git diff --staged --stat
+```
+Nếu không có changes → thông báo "Không có gì để commit."
+
+### 2. Quality Checks
+
+**Nếu `quality.test_command` không rỗng:**
+- Chạy: `quality.test_command` (hoặc tests liên quan đến files changed)
+- Nếu FAIL:
+  - `quality.block_on_fail = true` → **DỪNG**, báo lỗi, yêu cầu fix
+  - `quality.block_on_fail = false` → cảnh báo, hỏi user có muốn tiếp tục
+
+**Nếu `quality.lint_command` không rỗng:**
+- Chạy: `quality.lint_command`
+- Xử lý tương tự tests
+
+### 3. Kiểm tra sensitive files
+- Scan staged files cho: `.env`, passwords, tokens, API keys
+- Nếu phát hiện → **CẢNH BÁO** và hỏi user
+
+### 4. Kiểm tra leftover debug code
+- Grep staged files cho: `console.log`, `debugger`, `TODO:`, `FIXME:`
+- Nếu có → cảnh báo (không block)
+
+### 5. Tạo commit message
+
+Nếu có `$ARGUMENTS` → dùng làm mô tả:
+```
+<auto-detect-type>(<auto-detect-scope>): $ARGUMENTS
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+Nếu KHÔNG có `$ARGUMENTS` → phân tích diff và tạo message tự động:
+- Detect type từ loại thay đổi (feat/fix/refactor/test/docs/chore)
+- Detect scope từ files/directories changed
+- Viết mô tả ngắn gọn
+
+### 6. Thực hiện commit
+```bash
+git add [relevant files]
+git commit -m "<message>"
+```
+
+### 7. Post-commit
+
+**Nếu `workflow.default_depth = thorough`:**
+- Thông báo: "Living docs cần cập nhật. Chạy `/dw:docs-update`?"
+
+**Nếu `tracking.log_work = true`:**
+- Ghi commit vào `.dw/metrics/`: timestamp, type, scope, files changed
+
+### 8. Hiển thị kết quả
+- Commit hash
+- Files committed
+- Quality check results (nếu có)
+- Next steps