dw-kit 1.0.0

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

@@ -0,0 +1,274 @@
+---
+name: dw-flow
+description: "Orchestrator: chạy toàn bộ workflow từ đầu đến cuối cho một task, tự động kết nối các phases, dừng tại các human checkpoints để confirm/feedback. Mạnh nhất khi bạn muốn AI tự drive cả task."
+argument-hint: "[task-name] hoặc DW_DEPTH=[depth] [task-name]"
+---
+
+# dw-flow — Full Task Workflow Orchestrator
+
+Task: **$ARGUMENTS**
+
+> AI sẽ tự động chạy qua tất cả phases phù hợp với depth của project.
+> Bạn chỉ cần xem kết quả và phản hồi tại các **[CHECKPOINT]**.
+
+---
+
+## Bước 0: Khởi động
+
+### Parse arguments
+
+Kiểm tra `$ARGUMENTS` có dạng `DW_DEPTH=[depth] [task-name]` không:
+- Nếu có (ví dụ: `DW_DEPTH=quick fix-bug-123`) → dùng `quick` làm depth, `fix-bug-123` làm task-name
+- Nếu không → task-name = `$ARGUMENTS` toàn bộ
+
+### Đọc config
+
+Đọc `.dw/config/dw.config.yml`:
+- `workflow.default_depth` → depth mặc định (dùng nếu không có DW_DEPTH override)
+- `paths.tasks` → location task docs (dùng làm base path — thay thế `{paths.tasks}` trong toàn bộ file này)
+- `tracking.estimation`, `tracking.log_work`
+- `team.roles` → ai cần approve gì
+
+**Depth cuối cùng** = DW_DEPTH override (nếu có) → `workflow.default_depth` từ config.
+
+### Kiểm tra task docs
+
+Kiểm tra task đã có docs chưa (`{paths.tasks}/[task-name]/`):
+- Nếu chưa → tạo mới (follow instructions trong `.claude/skills/dw-task-init/SKILL.md`)
+- Nếu rồi → đọc progress, hỏi: "Task đã có docs. Tiếp tục từ phase nào?"
+  - Options: `research | plan | gate-c | execute | review | fresh-start`
+  - Nếu chọn `execute` → kiểm tra plan status trước (xem mục "Resume Handling")
+  - Nếu chọn `gate-c` → đọc plan và hiển thị GATE C như thể vừa xong phase Plan
+
+Hiển thị kế hoạch trước khi bắt đầu:
+
+```
+╔══════════════════════════════════════════════════════╗
+║  dw-flow: [task-name]
+║  Depth: [quick|standard|thorough]
+║  Pipeline:
+║  [danh sách phases sẽ chạy dựa trên depth]
+╚══════════════════════════════════════════════════════╝
+```
+
+---
+
+## Pipeline theo Depth
+
+### quick
+```
+[1] Task Init  →  [2] Research (optional)  →  [GATE Q1: Confirm Scope]
+→  [3] Execute  →  [GATE Q2: Approve Changes]  →  [4] Commit
+```
+
+### standard *(mặc định)*
+```
+[1] Task Init  →  [2] Research  →  [GATE A: Confirm Scope]
+→  [3] Plan  →  [GATE C: Approve Plan ← HARD GATE]
+→  [4] Execute  →  [5] Review  →  [GATE D: Approve Changes]  →  [6] Commit
+```
+
+### thorough
+```
+[1] Task Init  →  [2] Requirements  →  [GATE A: Confirm Scope]
+→  [3] Estimate  →  [4] Research  →  [5] Arch Review  →  [GATE B: TL Approve Architecture]
+→  [6] Plan  →  [GATE C: Approve Plan ← HARD GATE]  →  [7] Test Plan
+→  [8] Execute  →  [9] Review  →  [GATE D: Approve Changes]
+→  [10] Docs Update  →  [11] Log Work  →  [12] Commit
+```
+
+> ⚠ **Thorough depth** chạy 12 phases — chỉ dùng cho critical tasks. Nếu bị gián đoạn giữa chừng, dùng `stop` + resume thay vì restart.
+
+---
+
+## Thực Hiện Từng Phase
+
+Với **mỗi phase**, làm như sau:
+1. Thông báo bắt đầu phase: `▶ Phase N: [tên phase]`
+2. Follow **toàn bộ instructions** trong SKILL.md tương ứng (đường dẫn bên dưới)
+3. Hiển thị output đầy đủ
+4. Sau phase, nếu có GATE → hiển thị checkpoint (xem mục CHECKPOINTS)
+5. Nếu không có GATE → thông báo "✓ Phase N complete" và chuyển ngay phase tiếp theo
+
+### Quy tắc khi follow sub-skill trong flow context
+
+Khi đọc và follow bất kỳ SKILL.md nào bên dưới, áp dụng các quy tắc sau:
+- **BỎ QUA** phần "Tiếp theo: /dw-xxx" ở cuối mỗi skill — dw-flow tự handle next step
+- **BỎ QUA** lệnh "DỪNG chờ approve" trong dw-plan và các skills tương tự — dw-flow sẽ hiển thị GATE thay thế
+- **CHỈ** lấy output, ghi files, hiển thị kết quả — không tự dừng workflow
+
+### SKILL.md references (đọc và follow từng file này):
+- Task Init → `.claude/skills/dw-task-init/SKILL.md`
+- Requirements → `.claude/skills/dw-requirements/SKILL.md`
+- Estimate → `.claude/skills/dw-estimate/SKILL.md`
+- Research → `.claude/skills/dw-research/SKILL.md`
+- Arch Review → `.claude/skills/dw-arch-review/SKILL.md`
+- Plan → `.claude/skills/dw-plan/SKILL.md`
+- Test Plan → `.claude/skills/dw-test-plan/SKILL.md`
+- Execute → `.claude/skills/dw-execute/SKILL.md`
+- Review → `.claude/skills/dw-review/SKILL.md`
+- Docs Update → `.claude/skills/dw-docs-update/SKILL.md`
+- Log Work → `.claude/skills/dw-log-work/SKILL.md`
+- Commit → `.claude/skills/dw-commit/SKILL.md`
+
+---
+
+## CHECKPOINTS (Human Gates)
+
+Tại mỗi GATE, **dừng lại** và hiển thị:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  [GATE X] — [Tên gate]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  [Tóm tắt output phase vừa xong — 3-5 bullets]
+
+  Options:
+  → ok / continue          Tiếp tục phase tiếp theo
+  → revise: [feedback]     AI chỉnh sửa phase này rồi hỏi lại
+  → skip [phase-name]      Bỏ qua phase tiếp theo
+  → stop                   Dừng workflow tại đây
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Xử lý response:
+
+**`ok` / `continue` / `approved` / _(bất kỳ affirmative)_**
+→ Chuyển ngay phase tiếp theo, không hỏi thêm.
+
+**`revise: [nội dung]`**
+→ Đọc feedback, chỉnh sửa output của phase vừa xong.
+→ Hiển thị lại output đã chỉnh.
+→ Hỏi lại checkpoint (cùng options).
+→ Có thể revise nhiều lần.
+
+**`skip [phase-name]`**
+→ Bỏ qua phase được chỉ định.
+→ Thông báo: "Skipped [phase-name]. Continuing with [next-phase]..."
+
+**`stop`**
+→ Dừng workflow.
+→ Tóm tắt những gì đã hoàn thành.
+→ Hướng dẫn resume: "Để tiếp tục: `/dw-flow [task-name]` → chọn phase"
+
+**Feedback tự do** (không dùng keyword trên)
+→ Interpret là `revise: [feedback]`
+→ AI tự hiểu và điều chỉnh.
+
+---
+
+## GATE Descriptions
+
+### GATE Q1 — Confirm Scope (quick only)
+Sau Research (nếu có) hoặc Task Init.
+Tóm tắt: phạm vi task, approach dự kiến, files sẽ thay đổi.
+→ User confirm để tiếp tục Execute trực tiếp.
+
+### GATE Q2 — Approve Changes (quick only)
+Sau Review (nếu có) hoặc Execute.
+Tóm tắt: thay đổi đã thực hiện, issues phát hiện (nếu review được chạy).
+→ User confirm để commit.
+
+### GATE A — Confirm Scope / Approve Research (standard + thorough)
+Sau Research (hoặc Requirements với thorough).
+Tóm tắt: phạm vi task, risks chính, approach gợi ý.
+→ User confirm để tiếp tục Plan.
+
+### GATE B — Approve Architecture (thorough only)
+Sau Arch Review.
+Tóm tắt: TL decisions, must-fix concerns.
+→ Cần TL approve rõ ràng trước khi plan.
+
+### GATE C — Approve Plan (standard + thorough) ← HARD GATE
+Sau Plan. **Bắt buộc approve** — không tự ý skip.
+Hiển thị:
+- Số subtasks
+- Estimated effort (nếu có)
+- Top risks
+- Files sẽ thay đổi
+
+**Sau khi user approve GATE C:**
+→ Cập nhật `{paths.tasks}/[task-name]/[task-name]-plan.md`: đổi `Trạng thái: Draft → cần approve` thành `Trạng thái: Approved`
+→ Sau đó mới proceed sang Execute
+
+→ Chỉ execute khi có explicit "approved" / "ok"
+
+### GATE D — Approve Changes (standard + thorough)
+Sau Review.
+Tóm tắt: issues tìm được (Critical/Warning/Suggestion).
+→ Nếu có Critical → **phải fix trước** khi commit.
+→ Nếu chỉ Warning → user chọn.
+
+---
+
+## Resume Handling
+
+Khi user chọn resume từ `execute` mà plan chưa có `Trạng thái: Approved`:
+1. Đọc plan file
+2. Nếu status là `Draft` hoặc `cần approve` → **hiển thị GATE C** với nội dung plan hiện tại
+3. Chỉ tiến vào Execute sau khi user approve GATE C và plan status đã được cập nhật
+
+Khi user chọn `gate-c` trực tiếp:
+→ Đọc plan file, hiển thị GATE C, xử lý như bình thường.
+
+---
+
+## Progress Tracking
+
+Cập nhật `{paths.tasks}/[task-name]/[task-name]-progress.md` sau **mỗi phase** hoàn thành.
+*(Lưu ý: `{paths.tasks}` là template — thay bằng giá trị `paths.tasks` đã đọc từ config)*
+
+```markdown
+## Flow Progress
+| Phase | Status | Timestamp | Notes |
+|-------|--------|-----------|-------|
+| task-init | ✓ Done | [time] | |
+| research | ✓ Done | [time] | [key finding] |
+| plan | ✓ Done | [time] | [N subtasks] |
+| execute | 🔄 In Progress | [time] | ST-2/4 done |
+```
+
+---
+
+## Khi Gặp Vấn Đề Trong Execute
+
+Nếu trong phase Execute, phát hiện:
+- **Scope vượt plan** → DỪNG, hiển thị mini-GATE:
+  ```
+  ⚠ Scope Issue Detected
+  → extend-plan: [mô tả]   Cập nhật plan rồi tiếp tục
+  → skip-subtask           Bỏ qua subtask này
+  → stop                   Dừng để review lại
+  ```
+- **Test fail không rõ** → Tự động chạy debug routine (`.claude/skills/dw-debug/SKILL.md`), báo kết quả
+- **Blocker** → Dừng, mô tả blocker rõ ràng, đề xuất options
+
+---
+
+## Summary khi Hoàn Thành
+
+```
+╔══════════════════════════════════════════════════════╗
+║  ✅ dw-flow complete: [task-name]
+╠══════════════════════════════════════════════════════╣
+║  Phases completed  : [list]
+║  Subtasks done     : N/N
+║  Commits           : [N commits, hashes]
+║  Effort            : [Xh actual vs Yh estimated] (nếu tracking)
+║  Issues found      : [N Critical fixed, N Warnings]
+╠══════════════════════════════════════════════════════╣
+║  Còn lại (nếu có) :
+║  - [ ] Chờ TL review PR
+║  - [ ] Update DECISIONS.md (nếu có arch decision)
+╚══════════════════════════════════════════════════════╝
+```
+
+---
+
+## Tips
+
+- Muốn chạy nhanh nhất? Override depth: `/dw-flow DW_DEPTH=quick fix-bug-123`
+- Muốn dừng và tiếp tục sau? Gõ `stop` tại bất kỳ GATE nào
+- Muốn bỏ một phase? `skip docs-update` hoặc `skip log-work`
+- Muốn xem lại plan trước khi approve? File ở `.dw/tasks/[task-name]/[task-name]-plan.md`
+- Dừng giữa plan và execute? Resume bằng `gate-c` để re-confirm plan trước khi execute

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

@@ -0,0 +1,81 @@
+---
+name: dw-handoff
+description: "Tạo tài liệu bàn giao session để người hoặc agent tiếp theo có thể tiếp tục không cần hỏi lại. Dùng cuối session hoặc khi chuyển task."
+argument-hint: "[task-name]"
+---
+
+# Bàn Giao Session
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `workflow.default_depth`.
+
+## Thu Thập Thông Tin
+
+### 1. Git state
+```bash
+git log --oneline -5         # commits gần nhất
+git status                   # unstaged/staged changes
+git stash list               # stashed work
+```
+
+### 2. Task progress
+Đọc `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
+- Subtask nào đã done?
+- Subtask nào đang làm dở?
+- Blockers nào đang tồn tại?
+
+### 3. Code state
+- Có code uncommitted không?
+- Tests đang ở trạng thái pass/fail?
+- Có TODO/FIXME nào mới thêm vào?
+
+## Viết Handoff Notes
+
+Ghi vào mục "Handoff Notes" trong `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md`:
+
+```markdown
+## Handoff Notes
+
+### Session [ngày giờ] → [người/agent tiếp theo]
+
+**Trạng thái nhanh**: [1 câu mô tả]
+
+**Đang ở**: ST-[N] — [tên subtask] — [% hoặc mô tả tiến độ]
+
+**Đã hoàn thành**:
+- ✅ ST-1: [tên] (commit: abc1234)
+- ✅ ST-2: [tên] (commit: def5678)
+
+**Đang làm dở**:
+- 🔄 ST-3: [tên]
+  - Done: [phần đã làm]
+  - Còn lại: [phần chưa làm]
+  - Files đang edit: [danh sách]
+
+**Blockers**:
+- ❌ [Blocker nếu có]
+
+**Bước tiếp theo** (theo thứ tự):
+1. [Việc cần làm đầu tiên]
+2. [Tiếp theo]
+
+**Context quan trọng**:
+- [Quyết định A đã được đưa ra vì lý do X]
+- [Cẩn thận: file Y có logic đặc biệt ở line Z]
+- [Assumption: Z đang được coi là đúng]
+
+**Uncommitted changes**: [Có / Không — nếu có, mô tả]
+```
+
+## Thông Báo
+
+Sau khi ghi xong, hiển thị:
+- Tóm tắt handoff notes
+- Lệnh để người/agent tiếp theo bắt đầu:
+  ```
+  Đọc: {paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md
+  Tiếp tục: /dw-execute $ARGUMENTS
+  ```

package/.claude/skills/dw-log-work/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: dw-log-work
+description: "Ghi nhận effort thực tế cho task hoặc subtask. So sánh với estimate. Cập nhật metrics tracking. Dùng sau khi hoàn thành subtask/task."
+argument-hint: "[task-name]"
+---
+
+# Ghi Nhận Effort
+
+Task: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml`:
+- `tracking.log_work` — nếu `false` → thông báo "Log work 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
+
+## Hỏi User (Interactive)
+
+Hỏi thông tin cần ghi:
+
+```
+1. Subtask nào? (ST-1 / ST-2 / all)
+2. Thời gian thực tế: [X hours/points]
+3. Loại công việc: coding / testing / review / research / documentation
+4. Ghi chú (optional): [lý do lệch estimate, blockers gặp, etc.]
+```
+
+## Ghi Vào Progress File
+
+Cập nhật `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-progress.md` → mục "Effort Log":
+
+```markdown
+| [date] | ST-N | [loại] | [estimate] | [actual] | [ghi chú] |
+```
+
+## Cập Nhật Metrics File
+
+Ghi vào `.dw/metrics/effort-log.json`:
+
+```json
+{
+  "date": "YYYY-MM-DD",
+  "task": "task-name",
+  "subtask": "ST-N",
+  "type": "coding",
+  "estimate": X,
+  "actual": Y,
+  "variance": Y-X,
+  "accuracy_pct": (X/Y)*100,
+  "notes": "..."
+}
+```
+
+## Tóm Tắt
+
+Sau khi log, hiển thị:
+
+```
+✅ Đã ghi: ST-N — Actual: Xh (Estimate: Yh)
+Variance: +Zh (over) / -Zh (under)
+
+Task tổng (đến hiện tại):
+  Total estimated: Xh
+  Total actual:    Yh
+  Accuracy:        Z%
+```
+
+Nếu variance > 50%: "⚠️ Lệch estimate đáng kể. Cân nhắc cập nhật estimate cho subtasks còn lại."

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

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

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

@@ -0,0 +1,47 @@
+# Plan: [Task Name]
+
+## Ngày: [date] | Trạng thái: Draft → Approved
+
+---
+
+## Tóm Tắt
+
+[1-2 câu: mục tiêu và approach được chọn]
+
+## Phương Án So Sánh
+
+| # | Phương án | Ưu điểm | Nhược điểm | Chọn? |
+|---|-----------|---------|------------|-------|
+| 1 | | | | **Chọn** |
+| 2 | | | | Loại — lý do: |
+
+## Subtasks
+
+### ST-1: [Tên]
+- **Mô tả**: [cụ thể]
+- **Files**: [danh sách]
+- **Criteria**: [ ] [điều kiện pass]
+- **Dependencies**: none
+- **Estimate**: [nếu bật]
+
+### ST-2: [Tên]
+- **Mô tả**: ...
+- **Dependencies**: ST-1
+
+## Rủi Ro & Giả Định
+
+| # | Loại | Mô tả | Xác suất | Tác động | Mitigation |
+|---|------|--------|----------|----------|------------|
+| 1 | Giả định | | | | |
+| 2 | Rủi ro | | Cao/TB/Thấp | | |
+
+## Edge Cases
+
+- [ ] [Edge case cần xử lý]
+
+## Tác Động Hệ Thống
+
+- Modules: [danh sách]
+- API changes: [Có / Không]
+- Migration: [Có / Không]
+- Breaking: [Có / Không]

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

@@ -0,0 +1,98 @@
+---
+name: dw-requirements
+description: "BA skill: Thu thập, phân tích và viết requirements document + user stories. Dùng ở đầu feature trước khi dev bắt đầu."
+argument-hint: "[feature-name]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+---
+
+# Thu Thập & Viết Requirements
+
+Feature: **$ARGUMENTS**
+
+## Đọc Config
+
+Đọc `.dw/config/dw.config.yml` → `paths.tasks`, `team.roles`, `workflow.default_depth`.
+Skill này dành cho depth: `standard` hoặc `thorough`.
+
+## Quy Trình
+
+### 1. Thu thập thông tin
+
+Hỏi (hoặc đọc từ conversation context):
+- **Business goal**: Mục tiêu kinh doanh là gì?
+- **User problems**: Người dùng đang gặp vấn đề gì?
+- **Stakeholders**: Ai bị ảnh hưởng? (end user, admin, ops)
+- **Scope**: In-scope là gì? Out-of-scope là gì?
+- **Constraints**: Deadline? Tech constraints? Budget?
+- **Success criteria**: Làm sao biết feature thành công?
+
+### 2. Phân tích & cấu trúc
+
+Tổ chức yêu cầu thành:
+- **Functional requirements**: Hệ thống PHẢI làm gì
+- **Non-functional requirements**: Performance, security, scalability
+- **User stories**: As [who], I want [what], so that [why]
+- **Acceptance criteria**: Điều kiện pass/fail
+
+### 3. Tạo Requirements Doc
+
+Ghi ra `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-requirements.md`:
+
+```markdown
+# Requirements: [Feature Name]
+
+## Ngày: [date] | Author: BA | Status: Draft
+
+## Business Context
+**Goal**: [Mục tiêu kinh doanh]
+**Problem**: [Vấn đề cần giải quyết]
+**Success Metrics**: [Đo lường thành công bằng gì]
+
+## Stakeholders
+| Role | Nhu cầu | Priority |
+|------|---------|---------|
+| End User | | Must-have |
+| Admin | | |
+
+## User Stories
+
+### Epic: [Tên epic]
+
+**US-001**: Tiêu đề ngắn gọn
+- **As**: [role]
+- **I want**: [action/feature]
+- **So that**: [business value]
+- **Acceptance Criteria**:
+  - [ ] Given [context], when [action], then [result]
+  - [ ] Given [context], when [edge case], then [expected behavior]
+- **Priority**: Must-have / Should-have / Nice-to-have
+- **Estimate**: [rough size]
+
+## Functional Requirements
+| # | Requirement | Priority | Notes |
+|---|------------|---------|-------|
+
+## Non-Functional Requirements
+| # | Requirement | Metric |
+|---|------------|--------|
+| NFR-1 | Performance: page load < 2s | p95 |
+| NFR-2 | Availability: 99.9% uptime | |
+
+## Out of Scope
+- [Điều này KHÔNG bao gồm]
+
+## Open Questions
+- [ ] [Câu hỏi cần BA/PM làm rõ]
+
+## Dependencies
+- [Feature/system khác cần có trước]
+```
+
+## Sau Khi Tạo
+
+- Thông báo dev: "Requirements doc sẵn sàng tại [path]"
+- Gợi ý: "TL có thể chạy `/dw-arch-review $ARGUMENTS` để review technical feasibility"
+- Gợi ý: "Dev có thể chạy `/dw-task-init $ARGUMENTS` để bắt đầu implementation"