dw-kit 1.2.1 → 1.3.0

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

@@ -1,201 +1,201 @@
----
-name: dw-onboard
-description: "Onboard dw-kit vào project đang chạy. Scan codebase, tạo project map và context docs cho các modules hiện có. Chạy một lần khi adopt dw vào existing project."
-argument-hint: ""
-allowed-tools:
-  - Read
-  - Grep
-  - Glob
-  - Write
-  - "Bash(git log *)"
-  - "Bash(git shortlog *)"
-  - "Bash(ls *)"
-  - "Bash(wc *)"
----
-
-# dw-onboard — Onboard Existing Project vào dw-kit
-
-> Dùng khi adopt dw-kit vào project đã chạy. Chạy **một lần**. Output là project map và context docs cho các modules hiện có — làm nền tảng cho AI trong các sessions sau.
-
----
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml`:
-- `paths.tasks` → base tasks path
-- `project.language` → ngôn ngữ output
-- `project.name` → tên project
-
-## Bước 1: Khám phá cấu trúc project
-
-Scan top-level structure của codebase:
-
-```
-Glob: src/**, app/**, lib/**, packages/**, services/**, modules/**
-Bash: ls -la (top level)
-```
-
-Xác định:
-- **Project type**: monorepo / single app / microservices / library
-- **Tech stack**: ngôn ngữ, framework chính (từ package.json, go.mod, requirements.txt, Cargo.toml, v.v.)
-- **Entry points**: main files, index files, routers
-- **Major directories**: mỗi dir là 1 potential module
-
-## Bước 2: Phân loại modules
-
-Với mỗi major directory/module, xác định:
-
-| Module | Type | Vai trò | Files | Phức tạp? |
-|--------|------|---------|-------|-----------|
-| [dir] | feature/service/util/infra | [mô tả 1 dòng] | [số files] | Cao/TB/Thấp |
-
-**Phức tạp = Cao** nếu: nhiều files (>10), có DB/API, business logic phức tạp.
-→ Modules phức tạp Cao: recommend `/dw-retroactive [module]` sau.
-
-## Bước 3: Phân tích nhanh từng module
-
-Với mỗi module (không cần đọc toàn bộ — chỉ đọc đủ để hiểu):
-
-1. **Entry file**: đọc file chính (index, main, router, controller)
-2. **Exports/Public API**: function/class/endpoint nào được expose?
-3. **Dependencies**: module này gọi đến module nào khác?
-4. **Git activity**: `git shortlog --since="6 months ago" -- [path]` → ai đang maintain?
-
-Ghi tóm tắt ngắn gọn (3-5 dòng) per module.
-
-## Bước 4: Check git history toàn project
-
-```bash
-git log --oneline --since="3 months ago" | head -30
-git shortlog -sn --since="3 months ago" | head -10
-```
-
-Xác định:
-- Modules nào đang active development
-- Modules nào stable / ít thay đổi
-- Contributors chính
-
-## Bước 5: Tạo output
-
-### 5a. Project Map
-
-Tạo `.dw/context/project-map.md`:
-
-```markdown
-# Project Map: [project.name]
-
-## Ngày tạo: [date]
-## Tạo bởi: dw-onboard
-
----
-
-## Tech Stack
-
-- **Ngôn ngữ**: [language]
-- **Framework**: [framework]
-- **Database**: [db nếu có]
-- **Infrastructure**: [docker, k8s, cloud nếu có]
-
-## Cấu Trúc Tổng Quan
-
-```
-[ASCII tree của top-level structure]
-```
-
-## Modules
-
-| Module | Type | Vai trò | Phức tạp | Active? | Deep-dive? |
-|--------|------|---------|----------|---------|------------|
-| [name] | [type] | [mô tả ngắn] | Cao/TB/Thấp | Có/Không | `/dw-retroactive [name]` |
-
-## Dependencies giữa Modules
-
-```
-[Module A] → [Module B] → [Module C]
-     ↓
-[Module D]
-```
-
-## Entry Points chính
-
-- [file/endpoint]: [mô tả]
-
-## Conventions phát hiện
-
-- [Convention 1]: [mô tả]
-- [Convention 2]
-
-## Git Activity (3 tháng gần nhất)
-
-- **Active modules**: [danh sách]
-- **Stable modules**: [danh sách]
-- **Top contributors**: [tên]
-
-## Gợi ý Deep-dive
-
-Các modules phức tạp nên chạy `/dw-retroactive` để AI có context đầy đủ:
-- [ ] `/dw-retroactive [module-a]` — [lý do: nhiều files, core business logic]
-- [ ] `/dw-retroactive [module-b]`
-```
-
-### 5b. Module context docs
-
-Với mỗi module **phức tạp Cao**: tạo `.dw/context/modules/[module-name].md`:
-
-```markdown
-# Module: [module-name]
-
-## Vai trò
-[1-2 câu mô tả]
-
-## Files chính
-| File | Vai trò |
-|------|---------|
-| [file] | [vai trò] |
-
-## Public API / Exports
-- [function/endpoint]: [mô tả]
-
-## Dependencies
-- Upstream: [modules gọi đến đây]
-- Downstream: [modules được đây gọi]
-
-## Conventions riêng
-- [Convention đặc thù của module này]
-
-## Lưu ý cho AI
-- [Gotchas, tech debt, context quan trọng]
-```
-
-Với modules **phức tạp TB/Thấp**: chỉ ghi entry trong project-map.md, không tạo file riêng.
-
-## Bước 6: Báo cáo kết quả
-
-```
-╔══════════════════════════════════════════════════════╗
-║  ✅ dw-onboard complete: [project.name]
-╠══════════════════════════════════════════════════════╣
-║  Modules discovered   : [N]
-║  Docs tạo             :
-║    .dw/context/project-map.md
-║    .dw/context/modules/[X files]
-║  Tech stack           : [summary]
-╠══════════════════════════════════════════════════════╣
-║  Gợi ý tiếp theo:
-║  Modules phức tạp cần deep-dive:
-║  → /dw-retroactive [module-a]
-║  → /dw-retroactive [module-b]
-║
-║  Khi bắt đầu task mới liên quan module đã có:
-║  → AI sẽ tự đọc .dw/context/ để có context
-╚══════════════════════════════════════════════════════╝
-```
-
----
-
-## Lưu ý
-
-- **Không tạo `.dw/tasks/`** — onboard output vào `.dw/context/`, tách khỏi task docs
-- **Không đọc toàn bộ code** — chỉ cần đủ để hiểu vai trò và interface của module
-- **Không analyze chi tiết logic** — đó là việc của `/dw-retroactive` khi cần deep-dive
-- Nếu project đã có `.dw/context/project-map.md` → hỏi user: "Đã có project map. Update hay skip?"
+---
+name: dw:onboard
+description: "Onboard dw-kit vào project đang chạy. Scan codebase, tạo project map và context docs cho các modules hiện có. Chạy một lần khi adopt dw vào existing project."
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+  - Write
+  - "Bash(git log *)"
+  - "Bash(git shortlog *)"
+  - "Bash(ls *)"
+  - "Bash(wc *)"
+---
+
+# dw-onboard — Onboard Existing Project vào dw-kit
+
+> Dùng khi adopt dw-kit vào project đã chạy. Chạy **một lần**. Output là project map và context docs cho các modules hiện có — làm nền tảng cho AI trong các sessions sau.
+
+---
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `paths.tasks` → base tasks path
+- `project.language` → ngôn ngữ output
+- `project.name` → tên project
+
+## Bước 1: Khám phá cấu trúc project
+
+Scan top-level structure của codebase:
+
+```
+Glob: src/**, app/**, lib/**, packages/**, services/**, modules/**
+Bash: ls -la (top level)
+```
+
+Xác định:
+- **Project type**: monorepo / single app / microservices / library
+- **Tech stack**: ngôn ngữ, framework chính (từ package.json, go.mod, requirements.txt, Cargo.toml, v.v.)
+- **Entry points**: main files, index files, routers
+- **Major directories**: mỗi dir là 1 potential module
+
+## Bước 2: Phân loại modules
+
+Với mỗi major directory/module, xác định:
+
+| Module | Type | Vai trò | Files | Phức tạp? |
+|--------|------|---------|-------|-----------|
+| [dir] | feature/service/util/infra | [mô tả 1 dòng] | [số files] | Cao/TB/Thấp |
+
+**Phức tạp = Cao** nếu: nhiều files (>10), có DB/API, business logic phức tạp.
+→ Modules phức tạp Cao: recommend `/dw:retroactive [module]` sau.
+
+## Bước 3: Phân tích nhanh từng module
+
+Với mỗi module (không cần đọc toàn bộ — chỉ đọc đủ để hiểu):
+
+1. **Entry file**: đọc file chính (index, main, router, controller)
+2. **Exports/Public API**: function/class/endpoint nào được expose?
+3. **Dependencies**: module này gọi đến module nào khác?
+4. **Git activity**: `git shortlog --since="6 months ago" -- [path]` → ai đang maintain?
+
+Ghi tóm tắt ngắn gọn (3-5 dòng) per module.
+
+## Bước 4: Check git history toàn project
+
+```bash
+git log --oneline --since="3 months ago" | head -30
+git shortlog -sn --since="3 months ago" | head -10
+```
+
+Xác định:
+- Modules nào đang active development
+- Modules nào stable / ít thay đổi
+- Contributors chính
+
+## Bước 5: Tạo output
+
+### 5a. Project Map
+
+Tạo `.dw/context/project-map.md`:
+
+```markdown
+# Project Map: [project.name]
+
+## Ngày tạo: [date]
+## Tạo bởi: dw-onboard
+
+---
+
+## Tech Stack
+
+- **Ngôn ngữ**: [language]
+- **Framework**: [framework]
+- **Database**: [db nếu có]
+- **Infrastructure**: [docker, k8s, cloud nếu có]
+
+## Cấu Trúc Tổng Quan
+
+```
+[ASCII tree của top-level structure]
+```
+
+## Modules
+
+| Module | Type | Vai trò | Phức tạp | Active? | Deep-dive? |
+|--------|------|---------|----------|---------|------------|
+| [name] | [type] | [mô tả ngắn] | Cao/TB/Thấp | Có/Không | `/dw:retroactive [name]` |
+
+## Dependencies giữa Modules
+
+```
+[Module A] → [Module B] → [Module C]
+     ↓
+[Module D]
+```
+
+## Entry Points chính
+
+- [file/endpoint]: [mô tả]
+
+## Conventions phát hiện
+
+- [Convention 1]: [mô tả]
+- [Convention 2]
+
+## Git Activity (3 tháng gần nhất)
+
+- **Active modules**: [danh sách]
+- **Stable modules**: [danh sách]
+- **Top contributors**: [tên]
+
+## Gợi ý Deep-dive
+
+Các modules phức tạp nên chạy `/dw:retroactive` để AI có context đầy đủ:
+- [ ] `/dw:retroactive [module-a]` — [lý do: nhiều files, core business logic]
+- [ ] `/dw:retroactive [module-b]`
+```
+
+### 5b. Module context docs
+
+Với mỗi module **phức tạp Cao**: tạo `.dw/context/modules/[module-name].md`:
+
+```markdown
+# Module: [module-name]
+
+## Vai trò
+[1-2 câu mô tả]
+
+## Files chính
+| File | Vai trò |
+|------|---------|
+| [file] | [vai trò] |
+
+## Public API / Exports
+- [function/endpoint]: [mô tả]
+
+## Dependencies
+- Upstream: [modules gọi đến đây]
+- Downstream: [modules được đây gọi]
+
+## Conventions riêng
+- [Convention đặc thù của module này]
+
+## Lưu ý cho AI
+- [Gotchas, tech debt, context quan trọng]
+```
+
+Với modules **phức tạp TB/Thấp**: chỉ ghi entry trong project-map.md, không tạo file riêng.
+
+## Bước 6: Báo cáo kết quả
+
+```
+╔══════════════════════════════════════════════════════╗
+║  ✅ dw-onboard complete: [project.name]
+╠══════════════════════════════════════════════════════╣
+║  Modules discovered   : [N]
+║  Docs tạo             :
+║    .dw/context/project-map.md
+║    .dw/context/modules/[X files]
+║  Tech stack           : [summary]
+╠══════════════════════════════════════════════════════╣
+║  Gợi ý tiếp theo:
+║  Modules phức tạp cần deep-dive:
+║  → /dw:retroactive [module-a]
+║  → /dw:retroactive [module-b]
+║
+║  Khi bắt đầu task mới liên quan module đã có:
+║  → AI sẽ tự đọc .dw/context/ để có context
+╚══════════════════════════════════════════════════════╝
+```
+
+---
+
+## Lưu ý
+
+- **Không tạo `.dw/tasks/`** — onboard output vào `.dw/context/`, tách khỏi task docs
+- **Không đọc toàn bộ code** — chỉ cần đủ để hiểu vai trò và interface của module
+- **Không analyze chi tiết logic** — đó là việc của `/dw:retroactive` khi cần deep-dive
+- Nếu project đã có `.dw/context/project-map.md` → hỏi user: "Đã có project map. Update hay skip?"

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

@@ -1,125 +1,125 @@
----
-name: dw-plan
-description: "Lập kế hoạch implementation chi tiết sau khi đã research. Thiết kế giải pháp, phân chia subtasks, xác định rủi ro. DỪNG để chờ approval trước khi execute."
-argument-hint: "[task-name]"
-allowed-tools:
-  - Read
-  - Grep
-  - Glob
----
-
-# Lập Kế Hoạch Implementation
-
-Task: **$ARGUMENTS**
-
-## Đọc Config
-
-Đọc `.dw/config/dw.config.yml` → lấy:
-- `paths.tasks` → location task docs
-- `tracking.estimation` → có include estimation trong plan không
-- `tracking.estimation_unit` → đơn vị (hours / story-points / t-shirt)
-- `team.roles` → ai cần approve (có `techlead` → plan cần TL review)
-- `workflow.default_depth` → `thorough` = cần arch-review trước execute
-
-## QUAN TRỌNG
-- KHÔNG implement bất cứ gì
-- KHÔNG sửa code
-- CHỈ đọc, phân tích, và viết plan
-- DỪNG LẠI cuối cùng để chờ user/TL approve
-
-## Bước 1: Đọc Context
-
-Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md` — file research đã tạo.
-Nếu chưa có → thông báo: "Cần chạy `/dw-research $ARGUMENTS` trước."
-
-## Bước 2: Thiết kế giải pháp
-
-### Xem xét phương án
-- Liệt kê ÍT NHẤT 2 phương án khả thi
-- So sánh trade-offs: complexity, performance, maintainability, timeline
-- Chọn phương án tối ưu và giải thích lý do
-
-### Áp dụng THINKING.md
-1. **Critical Thinking**: Giả định nào? Rủi ro gì? Edge cases?
-2. **Systems Thinking**: Tác động lên modules khác? Data flow thay đổi?
-3. **Multiple Perspectives**: User? Developer? Security? Ops?
-
-## Bước 3: Phân chia subtasks
-
-Mỗi subtask PHẢI có:
-- **Mô tả**: Cụ thể, actionable
-- **Files**: Danh sách files cần thay đổi
-- **Acceptance criteria**: Điều kiện hoàn thành rõ ràng
-- **Dependencies**: Subtask nào phải xong trước
-- **Estimate** (nếu `tracking.estimation = true`): Effort dự kiến theo `tracking.estimation_unit`
-
-Thứ tự subtasks theo dependency graph:
-1. Schema/data changes trước
-2. Service/business logic tiếp
-3. API/routes sau
-4. Tests song song hoặc trước (TDD)
-5. Docs cuối
-
-## Bước 4: Viết plan
-
-Ghi vào `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`:
-
-```markdown
-# Plan: [Task Name]
-
-## Ngày tạo: [date]
-## Trạng thái: Draft → cần approve
-
-## Tóm Tắt Giải Pháp
-[1-2 đoạn mô tả approach đã chọn]
-
-## Phương Án Đã Xem Xét
-| # | Phương án | Ưu điểm | Nhược điểm | Chọn? |
-|---|-----------|---------|------------|-------|
-
-## Subtasks
-### ST-1: [Tên subtask]
-- **Mô tả**: ...
-- **Files**: ...
-- **Criteria**: ...
-- **Dependencies**: none
-- **Estimate**: [nếu có]
-
-### ST-2: [Tên subtask]
-...
-
-## Rủi Ro & Giả Định
-| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
-|---|------|--------|----------|----------|------------|
-
-## Edge Cases
-- [ ] ...
-
-## Tác Động Hệ Thống
-- Modules ảnh hưởng: ...
-- API changes: ...
-- Migration: ...
-- Backward compatibility: ...
-
-## Góc Nhìn & Trade-offs
-| Quyết định | User | Dev | Security |
-|-----------|------|-----|----------|
-
-## Estimation Tổng (nếu enabled)
-- Research: [done]
-- Planning: [done]
-- Coding: [estimate]
-- Testing: [estimate]
-- Review: [estimate]
-- Total: [sum]
-```
-
-## Bước 5: DỪNG & Trình bày
-
-Trình bày plan cho user với:
-1. Tóm tắt approach (3-5 câu)
-2. Số subtasks và estimate tổng (nếu có)
-3. Top 2 risks
-4. Yêu cầu: "Approve plan này để tiếp tục `/dw-execute $ARGUMENTS`"
-
-Nếu team có TL: "Plan cần TL review trước khi execute."
+---
+name: dw:plan
+description: "Lập kế hoạch implementation chi tiết sau khi đã research. Thiết kế giải pháp, phân chia subtasks, xác định rủi ro. DỪNG để chờ approval trước khi execute."
+argument-hint: "[task-name]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+---
+
+# Lập Kế Hoạch Implementation
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → lấy:
+- `paths.tasks` → location task docs
+- `tracking.estimation` → có include estimation trong plan không
+- `tracking.estimation_unit` → đơn vị (hours / story-points / t-shirt)
+- `team.roles` → ai cần approve (có `techlead` → plan cần TL review)
+- `workflow.default_depth` → `thorough` = cần arch-review trước execute
+
+## QUAN TRỌNG
+- KHÔNG implement bất cứ gì
+- KHÔNG sửa code
+- CHỈ đọc, phân tích, và viết plan
+- DỪNG LẠI cuối cùng để chờ user/TL approve
+
+## Bước 1: Đọc Context
+
+Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md` — file research đã tạo.
+Nếu chưa có → thông báo: "Cần chạy `/dw:research $ARGUMENTS` trước."
+
+## Bước 2: Thiết kế giải pháp
+
+### Xem xét phương án
+- Liệt kê ÍT NHẤT 2 phương án khả thi
+- So sánh trade-offs: complexity, performance, maintainability, timeline
+- Chọn phương án tối ưu và giải thích lý do
+
+### Áp dụng THINKING.md
+1. **Critical Thinking**: Giả định nào? Rủi ro gì? Edge cases?
+2. **Systems Thinking**: Tác động lên modules khác? Data flow thay đổi?
+3. **Multiple Perspectives**: User? Developer? Security? Ops?
+
+## Bước 3: Phân chia subtasks
+
+Mỗi subtask PHẢI có:
+- **Mô tả**: Cụ thể, actionable
+- **Files**: Danh sách files cần thay đổi
+- **Acceptance criteria**: Điều kiện hoàn thành rõ ràng
+- **Dependencies**: Subtask nào phải xong trước
+- **Estimate** (nếu `tracking.estimation = true`): Effort dự kiến theo `tracking.estimation_unit`
+
+Thứ tự subtasks theo dependency graph:
+1. Schema/data changes trước
+2. Service/business logic tiếp
+3. API/routes sau
+4. Tests song song hoặc trước (TDD)
+5. Docs cuối
+
+## Bước 4: Viết plan
+
+Ghi vào `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`:
+
+```markdown
+# Plan: [Task Name]
+
+## Ngày tạo: [date]
+## Trạng thái: Draft → cần approve
+
+## Tóm Tắt Giải Pháp
+[1-2 đoạn mô tả approach đã chọn]
+
+## Phương Án Đã Xem Xét
+| # | Phương án | Ưu điểm | Nhược điểm | Chọn? |
+|---|-----------|---------|------------|-------|
+
+## Subtasks
+### ST-1: [Tên subtask]
+- **Mô tả**: ...
+- **Files**: ...
+- **Criteria**: ...
+- **Dependencies**: none
+- **Estimate**: [nếu có]
+
+### ST-2: [Tên subtask]
+...
+
+## Rủi Ro & Giả Định
+| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
+|---|------|--------|----------|----------|------------|
+
+## Edge Cases
+- [ ] ...
+
+## Tác Động Hệ Thống
+- Modules ảnh hưởng: ...
+- API changes: ...
+- Migration: ...
+- Backward compatibility: ...
+
+## Góc Nhìn & Trade-offs
+| Quyết định | User | Dev | Security |
+|-----------|------|-----|----------|
+
+## Estimation Tổng (nếu enabled)
+- Research: [done]
+- Planning: [done]
+- Coding: [estimate]
+- Testing: [estimate]
+- Review: [estimate]
+- Total: [sum]
+```
+
+## Bước 5: DỪNG & Trình bày
+
+Trình bày plan cho user với:
+1. Tóm tắt approach (3-5 câu)
+2. Số subtasks và estimate tổng (nếu có)
+3. Top 2 risks
+4. Yêu cầu: "Approve plan này để tiếp tục `/dw:execute $ARGUMENTS`"
+
+Nếu team có TL: "Plan cần TL review trước khi execute."