dw-kit 1.0.0

package/.claude/hooks/safety-guard.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# .claude/hooks/safety-guard.sh
+# Intercept destructive Bash commands trước khi execute.
+# exit 0 = allow, exit 2 = block
+#
+# Được gọi bởi PreToolUse hook cho tất cả Bash commands.
+
+INPUT=$(cat)
+
+COMMAND=$(echo "$INPUT" | grep -o '"command"[[:space:]]*:[[:space:]]*"[^"]*"' \
+  | sed 's/"command"[[:space:]]*:[[:space:]]*"//;s/"$//' | head -1)
+
+[ -z "$COMMAND" ] && exit 0
+
+# ── Pattern 1: rm -rf với path quá rộng ──────────────────────────────────────
+# Block: rm -rf / | rm -rf * | rm -rf . (nguy hiểm)
+# Allow: rm -rf ./specific/path | rm -rf /tmp/specific-file
+if echo "$COMMAND" | grep -qE 'rm\s+-rf?\s+(\/\s*$|\*|\.(\s|$))'; then
+  echo "🚨 BLOCKED: rm -rf với path nguy hiểm ($COMMAND)" >&2
+  echo "   Chỉ định path cụ thể hơn để proceed." >&2
+  exit 2
+fi
+
+# ── Pattern 2: git push --force lên main/master ───────────────────────────────
+if echo "$COMMAND" | grep -qE 'git\s+push\s+.*--force'; then
+  BRANCH=$(echo "$COMMAND" | grep -oE '(main|master|develop|dev)' | head -1)
+  if [ -n "$BRANCH" ]; then
+    echo "🚨 BLOCKED: git push --force lên $BRANCH" >&2
+    echo "   Force push lên protected branch không được phép." >&2
+    exit 2
+  fi
+  # Force push lên non-protected branch: warn nhưng allow
+  echo "⚠  Warning: git push --force (non-protected branch)" >&2
+  echo "   Proceed nếu intentional." >&2
+  exit 0
+fi
+
+# ── Pattern 3: Destructive SQL không có WHERE ─────────────────────────────────
+if echo "$COMMAND" | grep -qiE '(DELETE\s+FROM|UPDATE\s+\w+\s+SET)' \
+   && ! echo "$COMMAND" | grep -qi 'WHERE'; then
+  echo "🚨 BLOCKED: Destructive SQL không có WHERE clause" >&2
+  echo "   Thêm WHERE clause hoặc confirm intentional." >&2
+  exit 2
+fi
+
+# ── Pattern 4: DROP TABLE / DROP DATABASE ────────────────────────────────────
+if echo "$COMMAND" | grep -qiE 'DROP\s+(TABLE|DATABASE|SCHEMA)'; then
+  echo "⚠  Warning: DROP statement detected ($COMMAND)" >&2
+  echo "   Đây có phải migration script đã được review không?" >&2
+  # Warn but allow — user có thể đang chạy migration
+  exit 0
+fi
+
+exit 0

package/.claude/rules/code-style.md

@@ -0,0 +1,37 @@
+# Code Style & Conventions
+
+## Nguyên tắc chung
+- Đặt tên biến/hàm rõ ràng, tự giải thích (self-documenting)
+- Ưu tiên đơn giản, dễ đọc hơn clever code
+- Mỗi function làm MỘT việc
+- Comments giải thích WHY, không phải WHAT
+- Xử lý errors ở đầu function (guard clauses / early return)
+
+## Naming Conventions
+- Variables/Functions: camelCase
+- Classes/Components: PascalCase
+- Constants: UPPER_SNAKE_CASE
+- Files: kebab-case hoặc theo convention của framework
+- Directories: kebab-case
+
+## File Organization
+- 1 component/class per file (trừ khi strongly related)
+- Group imports: external → internal → relative
+- Export ở cuối file hoặc inline (nhất quán trong project)
+
+## Error Handling
+- KHÔNG swallow errors (catch rỗng)
+- Log đủ context để debug (error message, input data, stack)
+- Dùng custom error types cho domain errors
+- Validate input ở boundary (API, form, external data)
+
+## Testing
+- Test file cùng tên với source: `foo.ts` → `foo.test.ts` hoặc `foo.spec.ts`
+- Mỗi test case kiểm tra MỘT behavior
+- Test name mô tả expected behavior: "should return error when input is empty"
+- Arrange → Act → Assert pattern
+- KHÔNG mock internal implementation details
+
+## NOTE
+Đây là quy tắc mặc định. Team tùy chỉnh theo stack cụ thể của dự án.
+Thêm framework-specific rules vào file này hoặc tạo file riêng trong `.claude/rules/`.

package/.claude/rules/commit-standards.md

@@ -0,0 +1,37 @@
+# Commit Standards
+
+## Format
+```
+<type>(<scope>): <mô tả tiếng Việt hoặc tiếng Anh>
+
+[Body - chi tiết thay đổi, lý do]
+[Blank line]
+[Footer - breaking changes, references]
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+## Types
+| Type | Khi nào dùng |
+|------|-------------|
+| `feat` | Tính năng mới |
+| `fix` | Sửa lỗi |
+| `refactor` | Tái cấu trúc, không thay đổi behavior |
+| `test` | Thêm/sửa tests |
+| `docs` | Tài liệu, comments |
+| `chore` | Build, config, dependencies |
+| `style` | Format, whitespace (không thay đổi logic) |
+| `perf` | Cải thiện performance |
+
+## Quy tắc
+- Mỗi commit = 1 subtask hoặc 1 đơn vị logic hoàn chỉnh
+- Mô tả ngắn <= 72 ký tự
+- Dùng thì hiện tại: "thêm", "sửa", "cập nhật" (không phải "đã thêm")
+- KHÔNG commit files chứa secrets (.env, credentials, tokens)
+- KHÔNG commit console.log/debugger còn sót
+
+## Branch Naming
+```
+<type>/<task-name>
+```
+Ví dụ: `feat/user-auth`, `fix/login-redirect`, `refactor/api-structure`

package/.claude/rules/workflow-rules.md

@@ -0,0 +1,62 @@
+# Workflow Rules
+
+## Config-Driven Behavior
+
+Trước khi thực hiện bất kỳ skill nào, PHẢI đọc `.dw/config/dw.config.yml`:
+
+1. Kiểm tra `flags.<skill_name>` — nếu `false` → KHÔNG chạy, thông báo user
+2. Kiểm tra `level` — nếu skill yêu cầu level cao hơn → thông báo và hỏi user
+3. Nếu flag = `"skip"` → cho phép nhưng không enforce
+
+## Level Requirements
+
+| Skill | Level 1 | Level 2 | Level 3 |
+|-------|---------|---------|---------|
+| task-init | yes | yes | yes |
+| research | yes | yes | yes |
+| plan | skip | yes | yes |
+| execute | yes | yes | yes |
+| commit | yes | yes | yes |
+| review | no | yes | yes |
+| debug | yes | yes | yes |
+| estimate | no | skip | yes |
+| log-work | no | skip | yes |
+| living-docs | no | no | yes |
+| dashboard | no | no | yes |
+| handoff | skip | yes | yes |
+
+## Flag Behavior
+
+- `true` : Skill hoạt động và được enforce trong workflow
+- `false` : Skill bị tắt, skip trong workflow chain
+- `"skip"` : Skill có sẵn nhưng optional, user tự quyết định
+
+## Collaboration Rules
+
+### Khi làm việc cùng Human Dev
+- DỪNG và hỏi trước khi: thay đổi architecture, xóa code, thay đổi API contract
+- Ghi rõ trong progress: quyết định nào do agent, quyết định nào cần human
+- Nếu phát hiện conflict với plan → DỪNG, cập nhật progress, hỏi user
+
+### Khi bàn giao giữa sessions
+- Luôn cập nhật progress file trước khi kết thúc
+- Ghi rõ: đang ở subtask nào, blockers, context quan trọng
+- Commit work-in-progress nếu có thay đổi đáng kể
+
+## Multi-Role Workflow
+
+```
+BA: /dw-requirements → output: requirements doc
+     ↓
+TL: /dw-arch-review → output: architecture decision + approve
+     ↓
+Dev+Agent: /dw-task-init → /dw-research → /dw-plan → [TL approve] → /dw-execute
+     ↓
+QC: /dw-test-plan → manual/auto testing
+     ↓
+Dev+Agent: /dw-review → /dw-commit → PR
+     ↓
+PM: /dw-dashboard → project health view
+```
+
+Không phải mọi task đều cần full chain. Routing complexity quyết định.

package/.claude/settings.json

@@ -0,0 +1,71 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(*)",
+      "Grep(*)",
+      "Glob(*)",
+      "Bash(git log *)",
+      "Bash(git diff *)",
+      "Bash(git show *)",
+      "Bash(git status)",
+      "Bash(git blame *)",
+      "Bash(git stash list)",
+      "Bash(ls *)",
+      "Bash(wc *)"
+    ]
+  },
+  "mcpServers": {},
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/pre-commit-gate.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/safety-guard.sh\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/post-write.sh\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "prompt",
+            "prompt": "Trước khi kết thúc, kiểm tra: (1) Có uncommitted changes quan trọng không? (2) Task đang làm dở chưa cập nhật progress? (3) Có blocker nào chưa ghi lại? Nếu có vấn đề, trả về {\"decision\": \"block\", \"reason\": \"[mô tả]\"}. Nếu OK, trả về {\"decision\": \"allow\"}."
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/progress-ping.sh\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/settings.local.json

@@ -0,0 +1,12 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:alexop.dev)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:docs.anthropic.com)",
+      "Bash(grep -rL \"^name:\" .claude/skills/dw-*/SKILL.md)",
+      "Bash(grep -c '\\\\$ARGUMENTS\\\\|context: fork\\\\|allowed-tools' .dw/adapters/generic/AGENT.md)",
+      "Bash(grep [v1.0.0] CHANGELOG.md)"
+    ]
+  }
+}

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

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

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

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

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

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

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

@@ -0,0 +1,91 @@
+---
+name: dw-config-init
+description: "Khởi tạo dv-workflow-kit cho dự án mới. Tạo config file, thư mục, và cấu trúc cần thiết."
+argument-hint: "[project-name]"
+---
+
+# Khởi Tạo dv-workflow-kit
+
+Thiết lập toolkit cho dự án: **$ARGUMENTS**
+
+## Quy Trình
+
+### 1. Hỏi thông tin cơ bản
+
+Nếu chưa có đủ thông tin, hỏi user:
+- **Project type**: `new-product` hay `old-maintenance`?
+- **Level**: 1 (lite), 2 (standard), hay 3 (full)?
+- **Team roles**: Những role nào tham gia? (dev, techlead, ba, qc, pm)
+
+### 2. Tạo config file
+
+Copy `.dw/config/dw.config.yml` vào root dự án.
+Cập nhật các giá trị:
+- `project.name` = tên dự án
+- `project.type` = loại dự án
+- `level` = level đã chọn
+
+Nếu **new-product**:
+```yaml
+level: 2
+flags:
+  research: true
+  plan: true
+  execute: true
+  commit: true
+  review: true
+  living_docs: false    # Bật lên level 3
+  estimation: true
+  log_work: true
+```
+
+Nếu **old-maintenance**:
+```yaml
+level: 1
+flags:
+  research: true
+  plan: "skip"          # Optional cho bug fixes
+  execute: true
+  commit: true
+  review: "skip"
+  debug: true
+  estimation: "skip"
+  log_work: "skip"
+```
+
+### 3. Tạo thư mục
+
+```bash
+mkdir -p .dw/tasks .dw/docs .dw/metrics .dw/reports
+```
+
+### 4. Auto-enable role flags
+
+Nếu team có `ba` → bật `requirements_skill: true`
+Nếu team có `qc` → bật `test_plan_skill: true`
+Nếu team có `techlead` → bật `arch_review_skill: true`
+Nếu team có `pm` → bật `dashboard_skill: true`
+
+### 5. Validate config
+
+Sau khi tạo hoặc khi user gọi `/dw-config-init` trên config đã có, kiểm tra:
+
+**Known keys** (nếu có key nào ngoài danh sách → warn typo):
+- Top-level: `project`, `level`, `team`, `flags`, `routing`, `estimation`, `metrics`, `paths`
+- `flags` keys: `research`, `plan`, `execute`, `commit`, `review`, `debug`, `living_docs`, `docs_update_on_commit`, `estimation`, `log_work`, `metrics_tracking`, `dora_metrics`, `pre_commit_tests`, `pre_commit_lint`, `block_commit_on_fail`, `handoff`, `thinking_framework`, `requirements_skill`, `test_plan_skill`, `arch_review_skill`, `dashboard_skill`
+
+**Level check**:
+- Nếu `level: 3` → hiển thị warning: "Level 3 đang ở trạng thái beta — một số features (living docs automation, DORA calculation, dashboard HTML export) chưa fully automated."
+
+**Flag value check**:
+- Mỗi flag phải là `true`, `false`, hoặc `"skip"` — nếu giá trị khác → warn
+
+Hiển thị kết quả validation trước khi thông báo hoàn tất.
+
+### 6. Thông báo kết quả
+
+Hiển thị:
+- Config đã tạo với settings gì
+- Danh sách skills có sẵn (dựa trên flags)
+- Hướng dẫn bước tiếp theo
+- Gợi ý: "Chạy `/dw-task-init [tên-task]` để bắt đầu task đầu tiên"