dw-kit 1.2.1 → 1.3.0

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

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

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

@@ -1,70 +1,70 @@
----
-name: dw-thinking
-description: "Áp dụng framework tư duy phản biện, hệ thống và đa góc nhìn vào vấn đề. Auto-load khi planning hoặc khi cần phân tích sâu. Dùng proactively."
-argument-hint: "[vấn đề cần phân tích]"
-user-invocable: true
----
-
-# Framework Tư Duy — Áp Dụng Vào Task
-
-Vấn đề: **$ARGUMENTS**
-
-## Nạp Framework
-
-@THINKING.md
-
----
-
-## Áp Dụng Vào Task Hiện Tại
-
-Sau khi đọc framework trên, áp dụng vào vấn đề `$ARGUMENTS`:
-
-### 1. Tư Duy Phản Biện
-
-**Giả định đang dùng:**
-- [ ] [Giả định 1] — Cách kiểm chứng: ...
-- [ ] [Giả định 2]
-
-**Rủi ro chính (top 3):**
-1. [Rủi ro] — Xác suất: Cao/TB/Thấp — Tác động: ...
-2. ...
-3. ...
-
-**Phương án thay thế đã loại:**
-- [Phương án A] — Loại vì: ...
-
-**Edge cases cần xử lý:**
-- [ ] [Edge case 1]
-
-### 2. Tư Duy Hệ Thống
-
-**Dependencies:**
-- Upstream: [ai/module gì phụ thuộc vào]
-- Downstream: [bị ảnh hưởng bởi thay đổi này]
-
-**Tác động cascade:**
-- Nếu thay đổi X → Y bị ảnh hưởng → Z cần cập nhật
-
-**Failure modes:**
-- [Nếu phần A fail → hệ thống phản ứng thế nào]
-
-### 3. Đa Góc Nhìn
-
-| Góc nhìn | Câu hỏi | Đánh giá |
-|----------|---------|----------|
-| User | [Ảnh hưởng UX?] | [OK / Concern] |
-| Developer | [Maintainable?] | |
-| Security | [Expose gì?] | |
-| Ops | [Deploy issues?] | |
-| Business | [Giá trị delivered?] | |
-
-### 4. Kết Luận
-
-**Quyết định:**
-[Approach được chọn và lý do]
-
-**Trade-offs chấp nhận:**
-[Điểm yếu nào của approach này được chấp nhận]
-
-**Điểm cần monitor:**
-[Theo dõi gì sau khi implement]
+---
+name: dw:thinking
+description: "Áp dụng framework tư duy phản biện, hệ thống và đa góc nhìn vào vấn đề. Auto-load khi planning hoặc khi cần phân tích sâu. Dùng proactively."
+argument-hint: "[vấn đề cần phân tích]"
+user-invocable: true
+---
+
+# Framework Tư Duy — Áp Dụng Vào Task
+
+Vấn đề: **$ARGUMENTS**
+
+## Nạp Framework
+
+@THINKING.md
+
+---
+
+## Áp Dụng Vào Task Hiện Tại
+
+Sau khi đọc framework trên, áp dụng vào vấn đề `$ARGUMENTS`:
+
+### 1. Tư Duy Phản Biện
+
+**Giả định đang dùng:**
+- [ ] [Giả định 1] — Cách kiểm chứng: ...
+- [ ] [Giả định 2]
+
+**Rủi ro chính (top 3):**
+1. [Rủi ro] — Xác suất: Cao/TB/Thấp — Tác động: ...
+2. ...
+3. ...
+
+**Phương án thay thế đã loại:**
+- [Phương án A] — Loại vì: ...
+
+**Edge cases cần xử lý:**
+- [ ] [Edge case 1]
+
+### 2. Tư Duy Hệ Thống
+
+**Dependencies:**
+- Upstream: [ai/module gì phụ thuộc vào]
+- Downstream: [bị ảnh hưởng bởi thay đổi này]
+
+**Tác động cascade:**
+- Nếu thay đổi X → Y bị ảnh hưởng → Z cần cập nhật
+
+**Failure modes:**
+- [Nếu phần A fail → hệ thống phản ứng thế nào]
+
+### 3. Đa Góc Nhìn
+
+| Góc nhìn | Câu hỏi | Đánh giá |
+|----------|---------|----------|
+| User | [Ảnh hưởng UX?] | [OK / Concern] |
+| Developer | [Maintainable?] | |
+| Security | [Expose gì?] | |
+| Ops | [Deploy issues?] | |
+| Business | [Giá trị delivered?] | |
+
+### 4. Kết Luận
+
+**Quyết định:**
+[Approach được chọn và lý do]
+
+**Trade-offs chấp nhận:**
+[Điểm yếu nào của approach này được chấp nhận]
+
+**Điểm cần monitor:**
+[Theo dõi gì sau khi implement]

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

@@ -1,72 +1,72 @@
----
-name: dw-upgrade
-description: "Upgrade dv-workflow-kit lên version mới. So sánh toolkit files, báo cáo thay đổi, cho phép selective update mà không overwrite customizations."
-argument-hint: ""
----
-
-# Upgrade dv-workflow-kit
-
-## Điều Kiện tiên quyết
-
-Toolkit được cài theo luồng chuẩn v1 trong project hiện tại (thường là `npm install -g dw-kit` + `dw init`).
-Các tùy chỉnh của team được đặt tại:
-- overrides: `.dw/adapters/claude-cli/overrides/`
-- extensions (skills mới): `.dw/adapters/claude-cli/extensions/`
-
-## Bước 1: Preview upgrade (khuyến nghị)
-
-```bash
-dw upgrade --check
-dw upgrade --dry-run
-```
-
-## Bước 2: Backup config (tùy chọn nhưng nên làm)
-
-```bash
-cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
-```
-
-## Bước 3: Chạy upgrade
-
-```bash
-dw upgrade
-```
-
-`dw upgrade` sẽ update toolkit files theo version mới và **tôn trọng overrides** của team (không ghi đè override).
-
-## Bước 4: Validate & health check
-
-```bash
-dw validate
-dw doctor
-```
-
-## Bước 5: Báo cáo kết quả
-
-```
-=== Upgrade Report ===
-
-Từ: [old version/commit]
-Đến: [new version/commit]
-
-Files mới (đã copy):
-  + .claude/skills/dw-[new-skill]/SKILL.md
-  + .claude/templates/en/task-context.md
-
-Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
-  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .claude/skills/dw-task-init/SKILL.md
-  ~ .claude/agents/planner.md
-
-Files của bạn (giữ nguyên):
-  = .dw/config/dw.config.yml  (backup tại .backup-[date])
-
-Lưu ý:
-  - Review các files "đã thay đổi" và merge thủ công nếu cần
-  - Xem CHANGELOG của release (nếu cần) để biết breaking changes
-  - Chạy /dw-config-validate sau khi upgrade để kiểm tra config
-```
-
-## Cleanup backup (tùy chọn)
-
-Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
-Nếu y: `rm .dw/config/dw.config.yml.backup-*`
+---
+name: dw:upgrade
+description: "Upgrade dv-workflow-kit lên version mới. So sánh toolkit files, báo cáo thay đổi, cho phép selective update mà không overwrite customizations."
+argument-hint: ""
+---
+
+# Upgrade dv-workflow-kit
+
+## Điều Kiện tiên quyết
+
+Toolkit được cài theo luồng chuẩn v1 trong project hiện tại (thường là `npm install -g dw-kit` + `dw init`).
+Các tùy chỉnh của team được đặt tại:
+- overrides: `.dw/adapters/claude-cli/overrides/`
+- extensions (skills mới): `.dw/adapters/claude-cli/extensions/`
+
+## Bước 1: Preview upgrade (khuyến nghị)
+
+```bash
+dw upgrade --check
+dw upgrade --dry-run
+```
+
+## Bước 2: Backup config (tùy chọn nhưng nên làm)
+
+```bash
+cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
+```
+
+## Bước 3: Chạy upgrade
+
+```bash
+dw upgrade
+```
+
+`dw upgrade` sẽ update toolkit files theo version mới và **tôn trọng overrides** của team (không ghi đè override).
+
+## Bước 4: Validate & health check
+
+```bash
+dw validate
+dw doctor
+```
+
+## Bước 5: Báo cáo kết quả
+
+```
+=== Upgrade Report ===
+
+Từ: [old version/commit]
+Đến: [new version/commit]
+
+Files mới (đã copy):
+  + .claude/skills/dw-[new-skill]/SKILL.md
+  + .claude/templates/en/task-context.md
+
+Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
+  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .claude/skills/dw-task-init/SKILL.md
+  ~ .claude/agents/planner.md
+
+Files của bạn (giữ nguyên):
+  = .dw/config/dw.config.yml  (backup tại .backup-[date])
+
+Lưu ý:
+  - Review các files "đã thay đổi" và merge thủ công nếu cần
+  - Xem CHANGELOG của release (nếu cần) để biết breaking changes
+  - Chạy /dw:config-validate sau khi upgrade để kiểm tra config
+```
+
+## Cleanup backup (tùy chọn)
+
+Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
+Nếu y: `rm .dw/config/dw.config.yml.backup-*`

package/.dw/core/PILLARS.md

@@ -0,0 +1,122 @@
+# dw-kit v2.0 — 5 Pillar Architecture
+
+dw-kit v2.0 positions itself as a **Context-First SDLC Governance Layer** — not a prescriptive workflow engine. AI drives execution; dw-kit provides guardrails, context, and decision trail.
+
+**Framing inversion:** `prescriptive workflow → descriptive governance`. Moat is organizational memory compounding over time — something IDE tools (Cursor, Copilot) structurally cannot own because they are session-scoped.
+
+---
+
+## Pillar 1: GUARDS — Block unsafe actions
+
+**Role:** Non-negotiable safety boundaries. Enforced by hooks, zero discretion.
+
+**Components:**
+- `.claude/hooks/privacy-block.sh` — Prevent reading `.env*`, `credentials*`, `*.pem`, key files
+- `.claude/hooks/pre-commit-gate.sh` — Quality checks + sensitive data scan before commits
+
+**Obsolescence test:** AI gets smarter → safety becomes MORE important (velocity × risk). These hooks never obsolete.
+
+**Team impact:** Prevents accidents at individual dev level, reduces incident count team-wide.
+
+---
+
+## Pillar 2: SURFACES — Make state visible
+
+**Role:** Shared team context. Human and AI both read.
+
+**Components:**
+- `.dw/tasks/ACTIVE.md` — Auto-generated index of active tasks (TechLead cat to see team state)
+- `.dw/context/project-map.md` — Module structure and boundaries
+- `.dw/context/modules/*.md` — Per-module documentation
+- `CLAUDE.md` + `.claude/rules/dw.md` — Auto-injected conventions
+
+**Obsolescence test:** AI gets smarter → teams coordinate more ambitiously → surfaces become MORE load-bearing.
+
+**Team impact:** New dev onboards from surfaces alone. TechLead audits without asking devs "what are you doing?"
+
+---
+
+## Pillar 3: RECORDS — Capture decisions
+
+**Role:** Organizational memory. The WHY behind architectural choices.
+
+**Components:**
+- `.dw/decisions/{NNNN}-{title}.md` — ADRs with structured YAML header
+- `/dw:decision` skill — Interactive ADR wizard
+- Status tracking: `Proposed | Accepted | Deprecated | Superseded by ADR-{NNNN}`
+
+**Obsolescence test:** AI gets smarter → needs WHY context to avoid technically-correct but strategically-wrong decisions. ADRs become MORE valuable.
+
+**Team impact:** Replaces scattered Slack threads. 6-month-old devs find decision trail. New hires understand architecture fast.
+
+**Unique moat:** IDE tools (Cursor, Copilot) structurally can't own this — they're session-scoped, ADRs are cross-session artifacts.
+
+---
+
+## Pillar 4: BRIDGES — Connect across sessions
+
+**Role:** Continuity over time. Handle the "long chat → no handoff → team lost context" problem.
+
+**Components:**
+- `.dw/tasks/{task}/tracking.md` — Mutable progress log with friction journal
+- Stop hook auto-handoff — Appends session summary to tracking.md on uncommitted changes
+- (v2.0+) Living docs detection — Flag when code diverges from docs
+
+**Obsolescence test:** AI sessions remain ephemeral regardless of capability. Bridges always needed.
+
+**Team impact:** Pick-up-where-left-off works across devs and across sessions. TechLead sees real velocity from actual logs, not status meeting summaries.
+
+---
+
+## Pillar 5: TUNES — Behavioral knobs
+
+**Role:** Team/solo customization. Governs how Pillars 1-4 behave.
+
+**Components:**
+- `.dw/config/dw.config.yml` — Master config (depth, roles, flags)
+- `.dw/config/dw.config.local.yml` — Machine-specific override (gitignored)
+- Presets: `solo` · `team` · `enterprise`
+- Depth routing: `quick` · `standard` · `thorough`
+- Role system: `dev` · `techlead` · `ba` · `qc` · `pm`
+
+**Obsolescence test:** Team size and preferences always vary. Config always needed.
+
+**Team impact:** Same dw-kit serves vibe coder (preset solo) and enterprise team (preset enterprise) with same core.
+
+---
+
+## Pillar Cross-References
+
+| Question | Answer location |
+|----------|----------------|
+| "Is this safe to do?" | Pillar 1 (Guards) — hooks block |
+| "What's everyone working on?" | Pillar 2 (Surfaces) — ACTIVE.md |
+| "Why did we choose X?" | Pillar 3 (Records) — ADRs |
+| "Where were we yesterday?" | Pillar 4 (Bridges) — tracking.md |
+| "How does our team work?" | Pillar 5 (Tunes) — config + presets |
+
+## Design Principles
+
+1. **Descriptive, not prescriptive** — AI chooses approach; dw-kit supplies context + safety
+2. **Obsolescence-aware** — Every feature passes "more valuable if AI smarter?" test
+3. **Dual audience** — Solo + team from same core, different defaults
+4. **Data-driven evolution** — Telemetry guides cut decisions, not gut-feel
+5. **Escape hatches** — `--no-dw`, `legacy_features: true`, `DW_NO_TELEMETRY=1`
+
+## Future: Pillar 6 — JANITORS (deferred to post-v2.0)
+
+**Status:** Draft, deferred — see `.dw/decisions/0003-pillar-6-janitors.md`
+
+**Role:** Reactive cleanup of AI-generated waste. Current 5 pillars are *preventive* (govern what goes in); Janitors governs *what stays*.
+
+**Rationale:** When 99% of code is AI-generated, prevention alone cannot scale. Inspired by urban waste management — cities use multi-tier systems (sort → collect → recycle → regulate), not just "don't litter."
+
+**Revisit:** After v2.0 GA (post 2026-08-15), based on real-world friction data.
+
+## Versioning
+
+- **v1.3** — Foundation (new format, scaffolding, telemetry)
+- **v1.4** — Data-driven cuts based on telemetry evidence
+- **v2.0** — Unified release with full 5-pillar integration
+- **v2.1+** — Advanced features (auto-handoff LLM, cross-repo, dashboard UI)
+- **v2.2+** — Janitors pillar (if validated by v2.0 friction data)