dw-kit 1.0.0

package/CLAUDE.md

@@ -0,0 +1,98 @@
+<!-- dw-kit | core: 1.0 | platform: 1.0 -->
+# dw-kit
+
+Workflow toolkit cho dev team. Config: `.dw/config/dw.config.yml`
+Methodology: `core/WORKFLOW.md` (load on demand — không phải always-loaded)
+
+---
+
+## Quy Tắc Vàng
+
+1. **Config-driven**: Đọc `.dw/config/dw.config.yml` trước mọi action
+2. **Research trước, code sau**: Task ≥3 files BẮT BUỘC qua research → plan → execute
+3. **Thinking framework**: Áp dụng `core/THINKING.md` khi planning
+4. **TDD**: Viết test trước khi code
+5. **Commit nhỏ**: Mỗi subtask = 1 commit
+
+---
+
+## Routing
+
+Đọc `workflow.default_depth` từ config. AI assess per-task:
+
+| Scope | Depth | Workflow |
+|-------|-------|---------|
+| ≤2 files, hotfix, familiar module | quick | Understand → Execute → Close |
+| 3-5 files, module mới | standard | Tất cả 6 phases |
+| 6+ files, API/DB/security changes | thorough | Full + arch-review + test-plan |
+
+Không chắc scope → dùng `standard`. Assess dựa trên facts (file count, API changes, git blame).
+
+---
+
+## Session Start
+
+1. Đọc `.dw/config/dw.config.yml` → depth, roles, quality commands
+2. Kiểm tra `.dw/tasks/` → active tasks
+3. Đọc `[task]-progress.md` của task đang dở → tiếp tục từ subtask cuối
+
+---
+
+## Skills
+
+| Skill | Mô tả | Depth |
+|-------|--------|-------|
+| `/dw-task-init [name]` | Khởi tạo task docs | all |
+| `/dw-research [name]` | Khảo sát codebase | all |
+| `/dw-plan [name]` | Lập kế hoạch (DỪNG chờ approve) | standard+ |
+| `/dw-execute [name]` | Implement theo plan (TDD) | all |
+| `/dw-commit [msg]` | Smart commit + quality gates | all |
+| `/dw-review` | Code review với checklist | standard+ |
+| `/dw-debug [issue]` | Debug: investigate → diagnose → fix | all |
+| `/dw-thinking [question]` | Apply thinking framework | all |
+| `/dw-estimate [name]` | Ước lượng effort | if enabled |
+| `/dw-log-work [name]` | Ghi effort thực tế | if enabled |
+| `/dw-handoff` | Bàn giao session | all |
+| `/dw-requirements` | BA: requirements + user stories | if ba role |
+| `/dw-test-plan` | QC: test plan + regression | if qc role |
+| `/dw-arch-review` | TL: architecture review | if techlead |
+| `/dw-dashboard` | PM: metrics report | if pm role |
+| `/dw-sprint-review` | Team retrospective | all |
+| `/dw-docs-update` | Cập nhật living docs | thorough |
+| `/dw-config-init` | Khởi tạo config mới | always |
+| `/dw-config-validate` | Validate config file | always |
+| `/dw-upgrade` | Upgrade toolkit | always |
+| `/dw-rollback [name]` | Rollback task docs | always |
+| `/dw-archive [name]` | Archive completed task | always |
+
+---
+
+## Task Documentation
+
+```
+.dw/tasks/[task-name]/
+├── [name]-context.md    # Research findings
+├── [name]-plan.md       # Implementation plan
+└── [name]-progress.md   # Progress + handoff notes
+```
+
+---
+
+## Commit Format
+
+```
+<type>(<scope>): <mô tả ≤72 ký tự>
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
+Types: `feat` `fix` `refactor` `test` `docs` `chore` `style` `perf`
+
+---
+
+## Methodology Reference
+
+Full methodology: `core/WORKFLOW.md`
+Thinking framework: `core/THINKING.md`
+Quality strategy: `core/QUALITY.md`
+Role definitions: `core/ROLES.md`

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 huygdv
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,183 @@
+# dw-kit
+
+> Bộ workflow toolkit cho dev team sử dụng Claude Code Agent — từ requirements đến dashboard.
+
+**v1.0** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Cheatsheet](docs/cheatsheet.md) · [Migration v0.3→v1](scripts/migrate-v03-to-v1.sh)
+
+---
+
+## Toolkit Này Làm Gì?
+
+Thay vì để Claude tự do code, dw-kit tạo ra **rails có cấu trúc**:
+
+```
+Research  →  Plan  →  Execute (TDD)  →  Review  →  Commit
+```
+
+Với đầy đủ hỗ trợ cho các roles trong team: BA · TL · Dev · QC · PM.
+
+---
+
+## Quick Start
+
+### Option A — npm (recommended)
+
+```bash
+npm install -g dw-kit
+```
+
+Then in your project directory:
+
+```bash
+dw init
+```
+
+Interactive wizard asks 3 questions (project, depth, language) and auto-selects roles by depth. Or use presets:
+
+```bash
+dw init --preset small-team     # skip wizard
+dw init --preset solo-quick     # solo dev, minimal ceremony
+dw init --preset enterprise     # full team, all features
+```
+
+Zero-install (one-time use):
+
+```bash
+npx dw-kit init
+```
+
+### Option B — Git submodule (legacy)
+
+```bash
+git submodule add https://github.com/dv-workflow/dv-workflow.git .dw-module
+bash .dw-module/setup.sh
+```
+
+`setup.sh` là luồng legacy/fallback. Luồng khuyến nghị cho v1 là `npm install -g dw-kit` + `dw init`.
+
+### Start working
+
+Open Claude Code in your project directory:
+
+```
+/dw-task-init tên-feature
+```
+
+### CLI Commands
+
+```bash
+dw init              # Setup wizard
+dw upgrade           # Update toolkit files (override-aware)
+dw upgrade --dry-run # Preview changes
+dw upgrade --check   # Check for updates only
+dw validate          # Validate config against schema
+dw doctor            # Check installation health
+dw migrate           # Migrate from v0.3 to v1
+```
+
+---
+
+## Depth System (thay thế Level 1/2/3)
+
+| Depth | Dành cho | Workflow |
+|-------|----------|----------|
+| `quick` | Solo dev, hotfix, familiar code | Understand → Execute → Close |
+| `standard` | Team nhỏ, feature mới | Tất cả 6 phases |
+| `thorough` | Enterprise, API/DB/security changes | Full workflow + arch-review + test-plan |
+
+Cấu hình trong `.dw/config/dw.config.yml`:
+```yaml
+workflow:
+  default_depth: "standard"
+```
+
+`default_depth` là baseline. Với task cụ thể, bạn có thể override sang `thorough` khi scope/risk tăng (API/DB/security), kể cả project nhỏ.
+
+---
+
+## Kiến Trúc v1 (4 Layers)
+
+```
+Layer 0: core/            ← Portable methodology (platform-agnostic)
+Layer 1: .claude/         ← Claude Code execution (agents, hooks, skills)
+Layer 2: config/claude:   ← Model-specific features (extended thinking, MCP)
+Layer 3: adapters/overrides/ ← Team customizations (never overwritten by upgrade)
+```
+
+---
+
+## Cấu Trúc Sau Khi Setup
+
+```
+dự-án-của-bạn/
+├── .dw-module/                 ← toolkit (git submodule, read-only)
+├── core/                         ← portable methodology
+│   ├── WORKFLOW.md               ← 6-phase workflow
+│   ├── THINKING.md               ← thinking framework
+│   ├── QUALITY.md                ← 4-layer quality strategy
+│   └── ROLES.md                  ← team role definitions
+├── config/
+│   ├── dw.config.yml             ← config (~45 lines)
+│   ├── config.schema.json        ← validation schema
+│   └── presets/                  ← solo-quick, small-team, enterprise
+├── adapters/
+│   ├── claude-cli/overrides/     ← team customizations (upgrade-safe)
+│   ├── claude-cli/extensions/    ← net-new team skills
+│   └── generic/AGENT.md          ← for Cursor/Windsurf/Copilot
+├── .claude/                      ← skills, agents, rules, hooks
+├── .dw/                          ← tasks, docs, metrics, reports
+└── scripts/
+    ├── upgrade.sh                ← upgrade toolkit (--dry-run)
+    └── migrate-v03-to-v1.sh      ← migration từ v0.3
+```
+
+---
+
+## Skills Có Sẵn
+
+Xem [docs/cheatsheet.md](docs/cheatsheet.md) để có bảng tham chiếu nhanh.
+
+---
+
+## Migrating từ v0.3
+
+```bash
+dw migrate --dry-run   # preview changes
+dw migrate             # apply migration
+```
+
+Or via bash (legacy):
+
+```bash
+bash scripts/migrate-v03-to-v1.sh --dry-run
+bash scripts/migrate-v03-to-v1.sh
+```
+
+`scripts/upgrade.sh` và `scripts/migrate-v03-to-v1.sh` được giữ cho backward-compat; ưu tiên dùng `dw upgrade` và `dw migrate`.
+
+Migration sẽ:
+- Map `level: 2` → `default_depth: standard`
+- Preserve customized skills vào `.dw/adapters/claude-cli/overrides/`
+- Backup old config, create new `.dw/config/dw.config.yml`
+
+---
+
+## Demo
+
+- [Demo A](examples/demo-A-bug-fix/) — Bug fix workflow (quick depth)
+- [Demo B](examples/demo-B-new-feature/) — Full team feature workflow (BA → PM)
+
+---
+
+## Tài Liệu
+
+| Tài liệu | Nội dung |
+|----------|---------|
+| [docs/README.md](docs/README.md) | Hướng dẫn đầy đủ, setup, tips |
+| [docs/cheatsheet.md](docs/cheatsheet.md) | Bảng tham chiếu nhanh tất cả skills |
+| [docs/custom-skills.md](docs/custom-skills.md) | Hướng dẫn tạo custom skills |
+| [CHANGELOG.md](CHANGELOG.md) | Lịch sử thay đổi |
+
+---
+
+> Maintainer: [huygdv](mailto:huygdv19@gmail.com)

package/bin/dw.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 18) {
+  console.error(`dw-kit requires Node.js >= 18. Current: ${process.version}`);
+  process.exit(1);
+}
+
+process.on('unhandledRejection', (reason) => {
+  console.error();
+  console.error('  Unexpected error:', reason?.message || reason);
+  if (reason?.code === 'EACCES' || reason?.code === 'EPERM') {
+    console.error('  Permission denied. Try running with appropriate permissions.');
+  }
+  if (reason?.code === 'ENOSPC') {
+    console.error('  Disk full. Free up space and try again.');
+  }
+  process.exit(1);
+});
+
+process.on('uncaughtException', (error) => {
+  console.error();
+  console.error('  Fatal error:', error.message);
+  process.exit(1);
+});
+
+const { run } = await import('../src/cli.mjs');
+run(process.argv);

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "dw-kit",
+  "version": "1.0.0",
+  "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
+  "type": "module",
+  "bin": {
+    "dw": "./bin/dw.mjs"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    ".dw/core/",
+    ".dw/config/",
+    ".dw/adapters/",
+    "scripts/",
+    ".claude/",
+    "CLAUDE.md",
+    "setup.sh"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node src/smoke-test.mjs",
+    "link": "npm link",
+    "test:e2e-local": "bash scripts/e2e-local-check.sh"
+  },
+  "keywords": [
+    "ai",
+    "workflow",
+    "claude",
+    "cursor",
+    "development",
+    "toolkit",
+    "tdd",
+    "code-review",
+    "agent"
+  ],
+  "author": "huygdv <huygdv19@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dv-workflow/dv-workflow.git"
+  },
+  "homepage": "https://github.com/dv-workflow/dv-workflow#readme",
+  "dependencies": {
+    "ajv": "^8.18.0",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "js-yaml": "^4.1.1"
+  }
+}

package/scripts/e2e-local-check.sh

@@ -0,0 +1,76 @@
+#!/bin/bash
+# scripts/e2e-local-check.sh
+# End-to-end local publish check (pack -> install -> run CLI)
+
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+log()  { echo "  $*"; }
+info() { echo ""; echo "▶ $*"; }
+ok()   { echo "  ✓  $*"; }
+warn() { echo "  ⚠  $*"; }
+
+cleanup() {
+  if [ -n "${TMP_DIR:-}" ] && [ -d "${TMP_DIR:-}" ]; then
+    rm -rf "$TMP_DIR"
+  fi
+  if [ -n "${PACK_FILE:-}" ] && [ -f "${PACK_FILE:-}" ]; then
+    rm -f "$PACK_FILE"
+  fi
+}
+trap cleanup EXIT
+
+info "Step 1: Run smoke tests"
+npm test
+ok "Smoke tests passed"
+
+info "Step 2: Build npm package tarball"
+PACK_OUTPUT="$(npm pack)"
+PACK_FILE="$(echo "$PACK_OUTPUT" | tail -n 1 | tr -d '\r')"
+if [ ! -f "$PACK_FILE" ]; then
+  echo "  ✗  Failed to produce package tarball"
+  exit 1
+fi
+ok "Tarball: $PACK_FILE"
+
+info "Step 3: Create isolated test project"
+TMP_DIR="$(mktemp -d 2>/dev/null || true)"
+if [ -z "${TMP_DIR}" ]; then
+  TMP_DIR=".tmp-e2e-local-check"
+  rm -rf "$TMP_DIR"
+  mkdir -p "$TMP_DIR"
+fi
+TEST_DIR="$TMP_DIR/e2e-project"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+npm init -y >/dev/null 2>&1
+git init >/dev/null 2>&1 || true
+ok "Created isolated project at $TEST_DIR"
+
+info "Step 4: Install from local tarball"
+npm install "$ROOT_DIR/$PACK_FILE" >/dev/null
+ok "Installed package from tarball"
+
+info "Step 5: Run CLI checks in isolated project"
+VERSION_OUT="$(npx dw --version | tr -d '\r')"
+log "dw --version: $VERSION_OUT"
+npx dw init --preset small-team
+npx dw validate
+npx dw doctor
+npx dw upgrade --check
+npx dw migrate --dry-run
+
+info "Step 6: Verify task-depth override guidance artifacts"
+grep -q "Task-Level Depth Override" ".dw/core/WORKFLOW.md"
+grep -q "Depth Source: default (from config) | override (task-specific)" ".dw/core/templates/vi/task-context.md"
+ok "Depth override guidance exists in generated artifacts"
+
+ok "CLI flow passed in isolated project"
+
+echo ""
+echo "══════════════════════════════════════════"
+echo "  E2E local check passed"
+echo "══════════════════════════════════════════"
+echo ""