dw-kit 1.0.0

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

@@ -0,0 +1,75 @@
+---
+name: dw-config-validate
+description: "Kiểm tra .dw/config/dw.config.yml có hợp lệ không. Phát hiện unknown keys, typos, invalid values. Chạy sau khi sửa config thủ công."
+argument-hint: ""
+---
+
+# Validate Config
+
+Kiểm tra `.dw/config/dw.config.yml` trong project hiện tại.
+
+## Bước 1: Đọc config
+
+Đọc toàn bộ `.dw/config/dw.config.yml`.
+
+## Bước 2: Kiểm tra top-level keys
+
+**Known top-level keys:**
+```
+project, level, team, flags, routing, estimation, metrics, paths
+```
+
+Nếu có key nào khác → **WARN**: "Unknown top-level key: `[key]` — có thể là typo?"
+
+## Bước 3: Kiểm tra `flags` keys
+
+**Known flag 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
+```
+
+Nếu có flag key nào khác → **WARN**: "Unknown flag: `[key]` — có thể là typo? Flag này sẽ bị ignore."
+
+## Bước 4: Kiểm tra flag values
+
+Mỗi flag phải có giá trị `true`, `false`, hoặc `"skip"`.
+Nếu giá trị khác → **ERROR**: "Flag `[key]` có giá trị không hợp lệ: `[value]`. Phải là true | false | \"skip\"."
+
+## Bước 5: Kiểm tra `level`
+
+- Phải là `1`, `2`, hoặc `3`.
+- Nếu `level: 3` → **INFO**: "Level 3 đang ở beta — living docs automation, DORA auto-calculation, và dashboard HTML export chưa fully implemented."
+
+## Bước 6: Kiểm tra `project.language`
+
+- Phải là `"vi"` hoặc `"en"`.
+- Nếu `"en"` → kiểm tra `.claude/templates/en/` có tồn tại không. Nếu không → **WARN**: "English templates chưa có. Chạy `/dw-upgrade` để lấy templates mới nhất."
+
+## Bước 7: Báo cáo kết quả
+
+```
+=== Config Validation Report ===
+
+File: .dw/config/dw.config.yml
+Project: [project.name]
+Level: [level]
+Language: [language]
+
+ERRORS (phải fix):
+  [danh sách lỗi nếu có]
+
+WARNINGS (nên xem xét):
+  [danh sách warnings nếu có]
+
+INFO:
+  [thông tin thêm]
+
+[OK] Config hợp lệ  /  [FAIL] Có X error(s) cần fix
+```
+
+Nếu không có lỗi: "Config hợp lệ. X flags đang bật, Y flags đang tắt."

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

@@ -0,0 +1,209 @@
+---
+name: dw-dashboard
+description: "Tạo báo cáo tổng hợp cho PM: trạng thái tasks, metrics DORA, effort tracking, velocity. Ghi ra file report để share."
+argument-hint: "[sprint-name | period: last-week | last-month | all]"
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - "Bash(git log *)"
+  - "Bash(git diff *)"
+  - "Bash(ls *)"
+---
+
+# PM Dashboard — Báo Cáo Dự Án
+
+Period: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `paths.tasks` → location task docs
+- `tracking.log_work` → có data effort tracking không
+- `workflow.default_depth` → level of reporting detail
+
+## Thu Thập Dữ Liệu
+
+### 1. Tasks Overview
+```bash
+ls {paths.tasks}/    # danh sách tasks
+```
+
+Đọc từng `*-progress.md` để lấy:
+- Trạng thái (Not Started / In Progress / Blocked / Done)
+- Subtasks done/total
+- Blockers hiện tại
+
+### 2. Git Metrics (DORA)
+```bash
+# Commits trong period
+git log --oneline --after="[start-date]" --before="[end-date]"
+
+# Lead time: time from first commit to merge
+git log --format="%H %ad" --date=short
+
+# Frequency
+git log --format="%ad" --date=short | sort | uniq -c
+```
+
+### 3. Effort Data
+Đọc `{.dw/metrics}/effort-log.json` nếu có.
+
+### 4. Quality Metrics
+Đọc review reports (nếu có) để lấy:
+- Critical issues found/fixed
+- Test coverage trend
+
+## Tính DORA Metrics
+
+```
+Deployment Frequency = commits merged / working days
+Lead Time = avg(merge_date - first_commit_date) per feature
+Change Failure Rate = (hotfixes + rollbacks) / total deploys × 100%
+MTTR = avg time from incident_detected to resolved
+```
+
+So sánh với thresholds trong config và xếp loại: Elite / High / Medium / Low.
+
+## Tính DORA Tự Động Từ Git
+
+```bash
+# Deployment frequency (commits/merges per day trong period)
+git log --oneline --after="[start]" --before="[end]" | wc -l
+
+# Lead time: trung bình từ commit đầu đến commit cuối của mỗi feature branch
+git log --format="%H %ad %s" --date=iso --after="[start]"
+
+# Change failure rate: đếm commits có message chứa "fix", "hotfix", "revert"
+git log --oneline --after="[start]" | grep -iE "(hotfix|revert|fix:)" | wc -l
+
+# MTTR: thời gian từ "fix commit" đến "hotfix commit" liền sau (nếu có)
+```
+
+Xếp loại theo DORA elite benchmarks: Deployment Frequency (daily), Lead Time (<1h), MTTR (<1h), Change Failure Rate (<5%).
+
+## Tạo Report (Markdown + HTML)
+
+Ghi ra `{paths.reports}/dashboard-[date].md` VÀ `{paths.reports}/dashboard-[date].html`:
+
+```markdown
+# Dashboard: [Project Name]
+## Period: $ARGUMENTS | Generated: [date]
+
+---
+
+## 🎯 Tóm Tắt Nhanh (Executive Summary)
+
+| Metric | Giá trị | Trend | Target |
+|--------|---------|-------|--------|
+| Tasks Done | X/Y | ↑ | |
+| Velocity | Xh/week | → | |
+| Blocked Tasks | X | ↓ better | 0 |
+| Estimation Accuracy | X% | | >80% |
+
+---
+
+## 📋 Trạng Thái Tasks
+
+| Task | Trạng thái | Progress | Blockers | ETA |
+|------|-----------|----------|----------|-----|
+| task-a | ✅ Done | 100% | — | — |
+| task-b | 🔄 In Progress | 60% | — | [date] |
+| task-c | ❌ Blocked | 30% | [mô tả] | TBD |
+
+---
+
+## 📊 DORA Metrics
+
+| Metric | Giá trị | Level | Mục tiêu |
+|--------|---------|-------|----------|
+| Deployment Frequency | X/week | 🟡 High | Elite: daily |
+| Lead Time | X days | 🟢 High | Elite: <1 day |
+| Change Failure Rate | X% | 🟢 Elite | <5% |
+| MTTR | X hours | 🟡 High | Elite: <1h |
+
+> Thang điểm: 🟢 Elite | 🔵 High | 🟡 Medium | 🔴 Low
+
+---
+
+## ⏱️ Effort & Velocity
+
+| Dev | Estimated | Actual | Accuracy | Tasks |
+|----|----------|--------|----------|-------|
+| [name] | Xh | Yh | Z% | N |
+| **Team** | **Xh** | **Yh** | **Z%** | **N** |
+
+**Velocity**: X story-points/sprint (or X hours/week)
+
+---
+
+## 🔍 Highlights
+
+### ✅ Điểm tốt tuần này
+- [Achievement 1]
+
+### ⚠️ Rủi ro cần theo dõi
+- [Risk 1] — Owner: [name]
+
+### 🎯 Focus tuần tới
+- [Priority 1]
+```
+
+## HTML Report
+
+File HTML được generate kèm với markdown:
+
+```html
+<!DOCTYPE html>
+<html lang="vi">
+<head>
+  <meta charset="UTF-8">
+  <title>Dashboard: [Project] — [Period]</title>
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+           max-width: 960px; margin: 40px auto; padding: 0 20px; color: #333; }
+    h1 { color: #1a1a2e; border-bottom: 3px solid #4361ee; padding-bottom: 8px; }
+    h2 { color: #16213e; margin-top: 32px; }
+    table { width: 100%; border-collapse: collapse; margin: 16px 0; }
+    th { background: #4361ee; color: white; padding: 10px 12px; text-align: left; }
+    td { padding: 9px 12px; border-bottom: 1px solid #e9ecef; }
+    tr:hover { background: #f8f9fa; }
+    .badge-elite { background: #2ecc71; color: white; padding: 2px 8px; border-radius: 12px; font-size: 12px; }
+    .badge-high  { background: #3498db; color: white; padding: 2px 8px; border-radius: 12px; font-size: 12px; }
+    .badge-medium{ background: #f39c12; color: white; padding: 2px 8px; border-radius: 12px; font-size: 12px; }
+    .badge-low   { background: #e74c3c; color: white; padding: 2px 8px; border-radius: 12px; font-size: 12px; }
+    .summary-grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 16px; margin: 20px 0; }
+    .summary-card { background: #f8f9fa; border-left: 4px solid #4361ee;
+                    padding: 16px; border-radius: 4px; }
+    .summary-card .value { font-size: 28px; font-weight: 700; color: #4361ee; }
+    .summary-card .label { font-size: 13px; color: #666; margin-top: 4px; }
+    footer { margin-top: 48px; font-size: 12px; color: #999; border-top: 1px solid #eee; padding-top: 12px; }
+  </style>
+</head>
+<body>
+  <h1>Dashboard: [Project Name]</h1>
+  <p>Period: <strong>[period]</strong> &nbsp;|&nbsp; Generated: [date]</p>
+
+  <div class="summary-grid">
+    <div class="summary-card"><div class="value">[X/Y]</div><div class="label">Tasks Done</div></div>
+    <div class="summary-card"><div class="value">[X]h</div><div class="label">Velocity / week</div></div>
+    <div class="summary-card"><div class="value">[X]%</div><div class="label">Est. Accuracy</div></div>
+    <div class="summary-card"><div class="value">[X]</div><div class="label">Blocked Tasks</div></div>
+  </div>
+
+  <!-- Tasks table, DORA table, Effort table — populate từ data thu thập -->
+  [CONTENT_PLACEHOLDER]
+
+  <footer>Generated by dv-workflow-kit &nbsp;|&nbsp; <a href="../.dw/tasks/">Task Docs</a></footer>
+</body>
+</html>
+```
+
+Điền `[CONTENT_PLACEHOLDER]` với các bảng HTML tương ứng với nội dung markdown report.
+
+## Lưu & Thông Báo
+
+Sau khi tạo:
+- Thông báo đường dẫn: `{paths.reports}/dashboard-[date].md` và `.html`
+- Tóm tắt 3-5 bullets cho PM đọc nhanh
+- Gợi ý: "Mở file .html trong browser để xem report đẹp hơn. Share .md qua Slack/email."

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

@@ -0,0 +1,97 @@
+---
+name: dw-debug
+description: "Debug có hệ thống theo quy trình Investigate → Diagnose → Fix. Dùng khi gặp lỗi, test fail, hoặc behavior bất thường."
+argument-hint: "[mô tả vấn đề]"
+---
+
+# Debug Có Hệ Thống
+
+Vấn đề: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+
+---
+
+## Phase 1: INVESTIGATE — Thu thập thông tin
+
+### 1.1 Xác định symptoms
+- Error message đầy đủ là gì? (stack trace, log)
+- Reproduction steps: làm gì để trigger lỗi?
+- Xảy ra lần đầu khi nào? Có gì thay đổi gần đây?
+- Tần suất: always / flaky / one-time?
+- Môi trường: dev / staging / production?
+
+### 1.2 Thu thập evidence
+```bash
+# Git: thay đổi gần đây
+git log --oneline -10
+git diff HEAD~3
+
+# Tìm error trong code
+grep -r "[error keyword]" --include="*.ts"
+```
+
+### 1.3 Xác định phạm vi
+- Feature nào bị ảnh hưởng?
+- Chỉ 1 user hay tất cả?
+- Data cụ thể nào trigger lỗi?
+
+---
+
+## Phase 2: DIAGNOSE — Tìm root cause
+
+### 2.1 Đặt giả thuyết
+Liệt kê 2-4 giả thuyết có thể về nguyên nhân, ưu tiên từ khả năng cao nhất.
+
+### 2.2 Kiểm chứng từng giả thuyết
+- Đọc code liên quan
+- Trace data flow
+- Kiểm tra config, environment variables
+- Xem test coverage có bỏ sót case này không
+
+### 2.3 Thu hẹp phạm vi
+- Loại trừ dần từng giả thuyết
+- Tìm exact line/function gây lỗi
+- Xác định root cause (không phải symptom)
+
+---
+
+## Phase 3: FIX — Sửa và verify
+
+### 3.1 Implement fix tối thiểu
+- Fix đúng root cause, không phải workaround
+- Không thay đổi scope ngoài bug fix
+
+### 3.2 Viết regression test TRƯỚC khi fix
+```
+// Test phải FAIL trước fix, PASS sau fix
+test("should handle [edge case that caused bug]", () => { ... })
+```
+
+### 3.3 Verify
+- Test mới pass
+- Existing tests không bị break
+- Manual verify reproduction steps
+
+### 3.4 Ghi lại
+
+```markdown
+## Debug Report
+
+**Root Cause**: [giải thích ngắn gọn]
+**Fix**: [mô tả thay đổi]
+**Prevention**: [làm sao tránh lặp lại]
+**Test added**: [tên test]
+```
+
+---
+
+## Khi Bị Bí
+
+Nếu sau 2 giả thuyết vẫn không tìm được root cause:
+1. Mô rộng hơn: xem toàn bộ data flow
+2. Thêm logging tạm thời để narrow down
+3. Bisect git: `git bisect` để tìm commit gây lỗi
+4. Hỏi: trình bày findings cho user, propose next steps

package/.claude/skills/dw-docs-update/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: dw-docs-update
+description: "Cập nhật living docs khi code thay đổi. Phát hiện docs lỗi thời và cập nhật tự động. Dùng sau khi execute hoặc commit."
+argument-hint: "[scope: all | architecture | api | models | task-name]"
+---
+
+# Cập Nhật Living Docs
+
+Scope: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → kiểm tra:
+- `paths.docs` → thư mục living docs (mặc định: `.dw/docs`)
+- `workflow.default_depth` → nếu `quick`, gợi ý nhưng không bắt buộc
+
+## Living Docs Structure
+
+```
+{paths.docs}/
+├── ARCHITECTURE.md      # Kiến trúc tổng quan hệ thống
+├── API.md               # API endpoints & contracts
+├── DATA-MODELS.md       # Database schema & data models
+├── DECISIONS.md         # Architecture Decision Records (ADR)
+├── GLOSSARY.md          # Thuật ngữ dự án
+├── SETUP.md             # Hướng dẫn setup & chạy dự án
+└── modules/
+    └── [module-name].md # Docs riêng cho từng module
+```
+
+## Quy Trình
+
+### Bước 0: Scaffold (lần đầu chạy)
+
+Nếu `{paths.docs}/` không tồn tại hoặc trống → tạo cấu trúc ban đầu:
+```bash
+mkdir -p {paths.docs}/modules
+```
+Tạo các file skeleton: `ARCHITECTURE.md`, `API.md`, `DATA-MODELS.md`, `DECISIONS.md`, `GLOSSARY.md`, `SETUP.md`.
+Thông báo: "Khởi tạo living docs tại `{paths.docs}/` — lần chạy đầu tiên."
+
+### Nếu scope = "all" hoặc không có argument
+
+1. **Detect changes**:
+   ```bash
+   git diff --name-only HEAD~10   # 10 commits gần nhất
+   git diff --name-only --cached  # staged changes
+   ```
+
+2. **Classify changes** theo pattern:
+   | Pattern file | Docs cần update |
+   |-------------|-----------------|
+   | `*model*`, `*schema*`, `*migration*`, `*entity*` | `DATA-MODELS.md` |
+   | `*route*`, `*controller*`, `*handler*`, `*endpoint*` | `API.md` |
+   | `*config*`, `*app.*`, `package.json`, `*.yml` | `ARCHITECTURE.md` |
+   | `*.md` trong project (không phải `.dw/docs/`) | Kiểm tra DECISIONS.md |
+   | Thư mục mới xuất hiện | `ARCHITECTURE.md` + tạo `modules/[name].md` |
+
+3. **Stale check**: Với mỗi doc cần update, đọc nội dung hiện tại, so sánh với code thực tế. Ghi rõ: "Phần X đang mô tả Y nhưng code hiện tại là Z."
+
+4. **Update**: Chỉ cập nhật những gì thực sự lỗi thời. Thêm timestamp cuối mỗi update.
+
+### Nếu scope = "architecture"
+- Đọc cấu trúc thư mục, main config files, entry points
+- Cập nhật ARCHITECTURE.md với cấu trúc hiện tại
+
+### Nếu scope = "api"
+- Grep tất cả route/endpoint definitions
+- Cập nhật API.md với danh sách endpoints hiện tại
+
+### Nếu scope = "models"
+- Đọc schema definitions, migration files, model files
+- Cập nhật DATA-MODELS.md
+
+### Nếu scope = [task-name]
+- Đọc progress file của task
+- Cập nhật docs liên quan đến thay đổi của task
+
+## Khi Tạo Doc Mới (lần đầu)
+
+Nếu file doc chưa tồn tại → tạo mới với cấu trúc chuẩn:
+
+### ARCHITECTURE.md
+```markdown
+# Kiến Trúc Hệ Thống
+
+## Tổng Quan
+[Mô tả high-level]
+
+## Tech Stack
+| Layer | Technology |
+|-------|-----------|
+
+## Cấu Trúc Thư Mục
+[Tree structure]
+
+## Modules
+| Module | Vai trò | Entry point |
+|--------|---------|-------------|
+
+## Data Flow
+[Diagram]
+
+## Cập nhật lần cuối: [date]
+```
+
+### DECISIONS.md (ADR Format)
+```markdown
+# Architecture Decision Records
+
+## ADR-001: [Tiêu đề]
+- **Ngày**: [date]
+- **Trạng thái**: Accepted | Superseded | Deprecated
+- **Bối cảnh**: [Tại sao cần quyết định]
+- **Quyết định**: [Đã chọn gì]
+- **Hệ quả**: [Ảnh hưởng]
+```
+
+## Output
+
+Sau khi cập nhật, báo cáo:
+- Files đã cập nhật: [danh sách]
+- Thay đổi chính: [tóm tắt]
+- Docs vẫn có thể stale: [nếu có]
+- Ghi timestamp "Cập nhật lần cuối" vào mỗi doc file

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

@@ -0,0 +1,90 @@
+---
+name: dw-estimate
+description: "Ước lượng effort cho task. Phân tích subtasks từ plan và đưa ra estimate theo đơn vị cấu hình (hours/story-points/t-shirt). Dùng sau /plan."
+argument-hint: "[task-name]"
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+---
+
+# Ước Lượng Effort
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `tracking.estimation` — nếu `false` → thông báo "Estimation chưa bật cho project này" và DỪNG
+- `tracking.estimation_unit` → đơn vị (hours / story-points / t-shirt)
+- `paths.tasks` → location task docs
+
+## Điều Kiện
+
+Nếu chưa có plan (`{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`) → thông báo cần chạy `/dw-plan` trước.
+
+## Quy Trình Estimation
+
+### 1. Đọc plan & context
+- Đọc toàn bộ subtasks
+- Đọc context để hiểu technical complexity
+- Hiểu dependencies giữa subtasks
+
+### 2. Estimate từng subtask
+
+Với mỗi subtask, phân tích:
+- **Complexity**: Low / Medium / High
+  - Low: Rõ ràng, ít dependencies, code cũ đã có pattern
+  - Medium: Cần thiết kế, có vài dependencies
+  - High: Phức tạp, nhiều unknowns, cần research thêm
+- **Uncertainty**: Low / Medium / High (có unknown chưa giải quyết?)
+- **Estimate**: Dựa trên complexity + uncertainty
+
+**Reference nhanh (hours):**
+| Complexity | Low uncertainty | Medium | High uncertainty |
+|-----------|-----------------|--------|-----------------|
+| Low | 1-2h | 2-4h | 4-8h |
+| Medium | 2-4h | 4-8h | 8-16h |
+| High | 4-8h | 8-16h | 16-40h |
+
+**Reference (story points - Fibonacci):** 1, 2, 3, 5, 8, 13, 21
+**Reference (t-shirt):** XS(<2h), S(2-4h), M(4-8h), L(8-16h), XL(16-40h), XXL(>40h)
+
+### 3. Uncertainty buffer
+
+- Low uncertainty overall: +0%
+- Medium: +20%
+- High: +50%
+- Nhiều unknowns / first-time tech: +100% (double)
+
+### 4. Breakdown theo categories
+
+```
+Research:      [X]
+Planning:      [done]
+Coding:        [X per subtask]
+Testing:       [X — thường 20-30% coding]
+Review:        [X — thường 10-15% coding]
+Documentation: [X — nếu living docs bật]
+Buffer:        [X%]
+Total:         [sum]
+```
+
+## Ghi Vào Plan
+
+Cập nhật phần "Estimation Tổng" trong plan file.
+
+## Trình Bày
+
+```markdown
+## Estimation Summary: $ARGUMENTS
+
+| Subtask | Complexity | Uncertainty | Estimate |
+|---------|-----------|-------------|---------|
+| ST-1 | Low | Low | 2h |
+| ST-2 | Medium | Medium | 6h |
+
+**Total Estimate**: X hours (với buffer Y%)
+**Confidence**: High / Medium / Low
+**Risk note**: [nếu có unknowns lớn]
+```

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

@@ -0,0 +1,98 @@
+---
+name: dw-execute
+description: "Thực hiện implementation theo plan đã được approve. Tuân thủ TDD, commit sau mỗi subtask. Chỉ dùng khi plan đã được duyệt."
+argument-hint: "[task-name]"
+---
+
+# Thực Hiện Implementation
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → lấy:
+- `paths.tasks` → location task docs
+- `quality.test_command` → lệnh chạy tests (nếu có)
+- `quality.lint_command` → lệnh chạy linter (nếu có)
+- `quality.block_on_fail` → có block commit khi fail không
+- `tracking.log_work` → ghi effort tracking không
+- `workflow.default_depth` → `thorough` = cần docs-update, review bắt buộc
+
+## Trước Khi Bắt Đầu
+
+1. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-plan.md`
+2. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md`
+3. Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`
+4. Xác nhận plan có `Trạng thái: Approved`
+
+Nếu plan chưa approved → **DỪNG**, yêu cầu approve trước.
+Nếu chưa có plan → **DỪNG**, yêu cầu chạy `/dw-plan $ARGUMENTS`.
+Nếu có progress → tiếp tục từ subtask cuối cùng chưa done.
+
+## Quy Trình Cho MỖI Subtask
+
+### Step 1: Chuẩn bị
+- Đọc subtask từ plan (mô tả, files, criteria)
+- Cập nhật progress: subtask → `in_progress`
+
+### Step 2: Test First (TDD)
+- Viết test cho subtask (nếu applicable)
+- Chạy test → confirm FAIL (red)
+- Nếu test đã pass → kiểm tra lại, có thể test sai
+
+### Step 3: Implement
+- Code theo spec trong plan
+- Tuân thủ conventions trong `.claude/rules/code-style.md`
+- KHÔNG thay đổi scope ngoài plan
+
+### Step 4: Verify
+- Chạy test → confirm PASS (green)
+- Nếu `quality.lint_command` không rỗng: chạy linter
+- Nếu `quality.block_on_fail = true` và fail → DỪNG, fix trước
+- Nếu `quality.block_on_fail = false` → cảnh báo, cho phép tiếp tục
+
+### Step 5: Cập nhật Progress
+Cập nhật `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
+```markdown
+| ST-N | [Subtask name] | Done | abc1234 | [ghi chú] |
+```
+
+Nếu `tracking.log_work = true`, ghi effort thực tế vào:
+```markdown
+### Effort Log
+| Subtask | Estimate | Actual | Ghi chú |
+```
+
+### Step 6: Commit
+```
+<type>(<scope>): <mô tả subtask>
+
+Subtask ST-N of $ARGUMENTS
+```
+
+## Khi Phát Hiện Vấn Đề
+
+### Giả định sai / Scope thay đổi
+1. **DỪNG** implementation ngay
+2. Ghi vào progress → mục "Phát Hiện Mới"
+3. Thông báo user: vấn đề gì, ảnh hưởng gì
+4. Đề xuất: tiếp tục / cập nhật plan / thay đổi hướng
+5. **CHỜ** quyết định từ user
+
+### Test fail không rõ nguyên nhân
+1. KHÔNG sửa test để pass (trừ khi test sai)
+2. Chạy `/dw-debug` nếu cần
+3. Ghi vào progress nếu mất thời gian
+
+### Conflict với code khác
+1. Ghi vào progress
+2. Thông báo user
+3. Đề xuất giải quyết
+
+## Khi Hoàn Thành Tất Cả Subtasks
+
+1. Cập nhật progress: Trạng thái → `Done`
+2. Tóm tắt: subtasks completed, commits, issues encountered
+3. Luôn gợi ý: "Tiếp theo: `/dw-review $ARGUMENTS`"
+4. Nếu `workflow.default_depth = thorough`: "Cần chạy `/dw-docs-update $ARGUMENTS`"
+5. Nếu `tracking.log_work = true`: Hiển thị estimate vs actual, gợi ý `/dw-log-work $ARGUMENTS`