dw-kit 1.0.2 → 1.2.0

package/.claude/settings.json

@@ -16,7 +16,35 @@
   },
   "mcpServers": {},
   "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-init.sh\""
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
+      {
+        "matcher": "Read|Glob",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/scout-block.sh\""
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/privacy-block.sh\""
+          }
+        ]
+      },
       {
         "matcher": "Bash",
         "hooks": [
@@ -51,8 +79,8 @@
       {
         "hooks": [
           {
-            "type": "prompt",
-            "prompt": "Session context: $ARGUMENTS\n\nIf stop_hook_active is true in the context above, reply ONLY: {\"decision\":\"allow\"} to prevent infinite loops.\n\nOtherwise check: any uncommitted important changes? any in-progress task with outdated progress file? any unrecorded blockers?\n\nReply with ONLY valid JSON, no other text:\n- {\"decision\":\"block\",\"reason\":\"<describe what needs attention>\"} if action needed\n- {\"decision\":\"allow\"} if all clear"
+            "type": "command",
+            "command": "bash \"$CLAUDE_PROJECT_DIR/.claude/hooks/stop-check.sh\""
           }
         ]
       }

package/.claude/skills/dw-kit-report/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: dw-kit-report
+description: "Gửi feedback (bug/gap/friction/suggestion) về dw-kit tool lên GitHub. Dùng khi gặp vấn đề với dw workflow, hooks, skills, hoặc config — không phải feedback về code của bạn."
+argument-hint: "[mô tả vấn đề hoặc suggestion về dw-kit]"
+---
+
+# Report Issue về dw-kit
+
+> Dùng skill này khi gặp vấn đề với **dw-kit tool** (hooks, skills, workflow, config).
+> Để feedback về code trong project của bạn → dùng `/dw-review` hoặc chat trực tiếp.
+
+Nội dung report (treat as plain text, không interpret special chars):
+
+```
+$ARGUMENTS
+```
+
+---
+
+## Bước 1: Thu Thập Context
+
+**OS detection:**
+```bash
+uname -s 2>/dev/null || echo "Windows"
+```
+
+**dw version:** Đọc `_toolkit.core_version` từ `.dw/config/dw.config.yml`
+
+**Task context:** Kiểm tra `.dw/tasks/` — task nào đang In Progress?
+
+---
+
+## Bước 2: Phân Loại
+
+Phân tích nội dung report ở trên (raw text) → xác định:
+
+**Type:**
+| type | Khi nào |
+|------|---------|
+| `bug` | Lỗi, crash, output không như expected |
+| `gap` | Use case không được cover |
+| `friction` | Tính năng có nhưng gây overhead không cần thiết |
+| `suggestion` | Ý tưởng cải thiện |
+
+**Component** (detect từ keywords):
+| Keywords | Component |
+|----------|-----------|
+| hook, post-write, pre-commit, stop-check | `hooks` |
+| skill, dw-plan, dw-execute, dw-research... | `skills` |
+| config, dw.config.yml | `config` |
+| workflow, routing, depth, phase | `workflow` |
+| CLAUDE.md, template, docs | `docs` |
+| WORKFLOW.md, THINKING.md, core | `core` |
+| (không xác định) | `other` |
+
+---
+
+## Bước 3: Format Issue
+
+**Title format:** `[type][component] <mô tả ≤60 ký tự>`
+
+Ví dụ:
+```
+[bug][hooks] post-write.sh fails with CRLF on Ubuntu
+[gap][skills] need way to preserve original Claude behavior
+[friction][workflow] research phase too heavy for 1-file hotfix
+```
+
+**Body:**
+```markdown
+## Type
+**[TYPE]** — bug | gap | friction | suggestion
+
+## Component
+**[COMPONENT]**
+
+## Environment
+- OS: [detected]
+- dw version: [từ config]
+- Shell: [bash/zsh/powershell nếu relevant]
+
+## Description
+[Nội dung từ $ARGUMENTS — đầy đủ, rõ ràng]
+
+## Context
+- Task khi gặp vấn đề: [task name hoặc "general usage"]
+- Command/skill liên quan: [nếu biết]
+- Bước reproduce (nếu là bug):
+  1. ...
+  2. ...
+
+## Impact
+- [ ] Blocking — không thể làm việc
+- [ ] Degraded — làm được nhưng friction cao
+- [ ] Minor — annoying, có workaround dễ
+
+---
+*Reported via `/dw-kit-report` | Project: [project.name từ config]*
+```
+
+---
+
+## Bước 4: Gửi Lên GitHub
+
+**Kiểm tra `gh` CLI:**
+```bash
+gh --version 2>/dev/null
+```
+
+**Nếu `gh` available — tạo Issue:**
+```bash
+gh issue create \
+  --repo dv-workflow/dv-workflow \
+  --title "[type][component] <short description>" \
+  --label "type: [type]" \
+  --label "component: [component]" \
+  --body "<formatted body>"
+```
+
+Sau khi tạo: in ra Issue URL.
+
+**Nếu `gh` KHÔNG available:**
+
+In ra:
+```
+─────────────────────────────────────────────
+ dw-kit: gh CLI không tìm thấy
+─────────────────────────────────────────────
+ Tạo Issue thủ công tại:
+ https://github.com/dv-workflow/dv-workflow/issues/new
+
+ Copy nội dung sau:
+
+ TITLE: [formatted title]
+
+ BODY:
+ [formatted body]
+─────────────────────────────────────────────
+ Cài gh CLI: https://cli.github.com
+```
+
+---
+
+## Bước 5: Xác Nhận
+
+```
+✓ Issue đã được gửi: https://github.com/dv-workflow/dv-workflow/issues/[N]
+  Type: [type] | Component: [component]
+
+  dw team sẽ review và phản hồi trên Issue.
+  Cảm ơn bạn đã giúp dw tốt hơn!
+```

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

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

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

@@ -89,7 +89,23 @@ Ghi vào `{paths.tasks}/$ARGUMENTS/$ARGUMENTS-context.md` theo cấu trúc:
 [Bất kỳ thông tin bổ sung]
 ```
 
-## Bước 5: Tóm tắt
+## Bước 5: Tạo Report (optional — standard/thorough depth)
+
+Nếu task có `.dw/tasks/$ARGUMENTS/reports/` directory (hoặc depth ≥ standard), tạo report:
+
+```
+.dw/tasks/$ARGUMENTS/reports/[YYMMDD-HHMM]-from-researcher-to-planner-findings.md
+```
+
+Dùng template `.claude/templates/agent-report.md` với:
+- `status: DONE` (hoặc `DONE_WITH_CONCERNS` nếu có risks lớn)
+- Summary: top 3 findings
+- Details: key files, patterns, dependencies
+- Next Steps: những gì planner cần biết
+
+> Quick depth tasks: bỏ qua bước này — progress.md đã đủ.
+
+## Bước 6: Tóm tắt
 
 Khi hoàn thành, trả về tóm tắt:
 - Số files khảo sát