dw-kit 1.0.0 → 1.0.1

package/.claude/hooks/post-write.sh

@@ -22,9 +22,7 @@ except:
 [ -z "$FILE_PATH" ] && exit 0
 
 # ── Đọc lint command từ config ────────────────────────────────────────────────
-CONFIG_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/config/dw.config.yml"
-# Fallback sang old config nếu chưa migrate
-[ ! -f "$CONFIG_FILE" ] && CONFIG_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/config/dw.config.yml"
+CONFIG_FILE="${CLAUDE_PROJECT_DIR:-$PWD}/.dw/config/dw.config.yml"
 [ ! -f "$CONFIG_FILE" ] && exit 0
 
 LINT_CMD=$(grep -m1 "lint_command:" "$CONFIG_FILE" 2>/dev/null \

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

@@ -6,52 +6,42 @@ argument-hint: ""
 
 # Upgrade dv-workflow-kit
 
-## Điều Kiện Tiên Quyết
+## Điều Kiện tiên quyết
 
-Skill này yêu cầu toolkit được cài qua git submodule tại `.dw-module/`.
+Toolkit được cài theo luồng chuẩn v1 trong project hiện tại (thường là `npm install -g dw-kit` + `dw init`).
+Các tùy chỉnh của team được đặt tại:
+- overrides: `.dw/adapters/claude-cli/overrides/`
+- extensions (skills mới): `.dw/adapters/claude-cli/extensions/`
 
-## Bước 1: Kiểm tra setup
+## Bước 1: Preview upgrade (khuyến nghị)
 
-Kiểm tra `.dw-module/` có tồn tại và là git repo:
 ```bash
-ls .dw-module/.git
+dw upgrade --check
+dw upgrade --dry-run
 ```
 
-Nếu không có → thông báo: "Toolkit chưa được cài dạng git submodule. Xem `examples/integration-guide/README.md`."
-
-## Bước 2: Pull version mới nhất
+## Bước 2: Backup config (tùy chọn nhưng nên làm)
 
-```bash
-cd .dv-workflow && git fetch origin && git log origin/main --oneline -5
-```
-
-Hiển thị 5 commits mới nhất của upstream để user biết có gì thay đổi.
-
-## Bước 3: Backup config
-
-Trước khi update, backup config hiện tại:
 ```bash
 cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
 ```
 
-Thông báo: "Config đã backup tại `.dw/config/dw.config.yml.backup-[date]`"
-
-## Bước 4: Update submodule
+## Bước 3: Chạy upgrade
 
 ```bash
-cd .dv-workflow && git pull origin main
+dw upgrade
 ```
 
-## Bước 5: So sánh và update files
+`dw upgrade` sẽ update toolkit files theo version mới và **tôn trọng overrides** của team (không ghi đè override).
+
+## Bước 4: Validate & health check
 
-Chạy setup script với mode update (không overwrite):
 ```bash
-bash .dw-module/examples/integration-guide/setup.sh
+dw validate
+dw doctor
 ```
 
-Script dùng `cp -n` (no-clobber) — chỉ copy files MỚI, không overwrite files đã customize.
-
-## Bước 6: Báo cáo kết quả
+## Bước 5: Báo cáo kết quả
 
 ```
 === Upgrade Report ===
@@ -64,7 +54,7 @@ Files mới (đã copy):
   + .claude/templates/en/task-context.md
 
 Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
-  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .dw-module/.claude/skills/dw-task-init/SKILL.md
+  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .claude/skills/dw-task-init/SKILL.md
   ~ .claude/agents/planner.md
 
 Files của bạn (giữ nguyên):
@@ -72,11 +62,11 @@ Files của bạn (giữ nguyên):
 
 Lưu ý:
   - Review các files "đã thay đổi" và merge thủ công nếu cần
-  - Xem CHANGELOG tại .dw-module/CHANGELOG.md để biết breaking changes
+  - Xem CHANGELOG của release (nếu cần) để biết breaking changes
   - Chạy /dw-config-validate sau khi upgrade để kiểm tra config
 ```
 
-## Bước 7: Cleanup backup (tùy chọn)
+## Cleanup backup (tùy chọn)
 
 Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
 Nếu y: `rm .dw/config/dw.config.yml.backup-*`

package/.dw/adapters/claude-cli/extensions/README.md

@@ -1,4 +1,4 @@
-# .dw/adapters/claude-cli/extensions/
+# .dw/adapters/claude-cli/extensions/
 
 > **NET-NEW TEAM SKILLS — Không conflict với generated, không bị overwrite.**
 
@@ -15,7 +15,7 @@ extensions/
     └── README.md       ← optional: mô tả skill
 ```
 
-`setup.sh` copy tất cả skills trong thư mục này vào `.claude/skills/`.
+`dw upgrade` copy tất cả skills trong thư mục này vào `.claude/skills/` (extensions không ghi đè skills đã customize).
 
 ## Ví dụ Skills Phù Hợp
 

package/.dw/adapters/claude-cli/generated/README.md

@@ -1,7 +1,7 @@
-# .dw/adapters/claude-cli/generated/
+# .dw/adapters/claude-cli/generated/
 
 > **AUTO-GENERATED — Không edit tay.**
-> Thư mục này được overwrite khi chạy `scripts/upgrade.sh` hoặc `setup.sh`.
+> Thư mục này được overwrite khi nâng cấp toolkit trong quá trình build/generation nội bộ.
 
 ## Nội dung
 
@@ -16,7 +16,7 @@ generated/
 
 ## Cách hoạt động
 
-`setup.sh` → copy `generated/` → `.claude/`, với overrides từ `overrides/` thắng.
+`dw init`/`dw upgrade` → populate `.claude/`, áp dụng overrides từ `overrides/` (override thắng).
 
 ## Nếu muốn customize
 

package/.dw/adapters/claude-cli/overrides/README.md

@@ -1,4 +1,4 @@
-# .dw/adapters/claude-cli/overrides/
+# .dw/adapters/claude-cli/overrides/
 
 > **TEAM CUSTOMIZATIONS — KHÔNG BAO GIỜ bị overwrite khi upgrade.**
 
@@ -19,11 +19,13 @@ overrides/
     └── reviewer.md       ← override generated/agents/reviewer.md
 ```
 
-Khi upgrade, `scripts/upgrade.sh` sẽ:
+Khi chạy `dw upgrade`, luồng sẽ:
 1. Update `generated/` từ toolkit mới
 2. Apply overrides từ thư mục này (overrides thắng generated)
 3. Copy kết quả vào `.claude/`
 
+Trong v1, luồng chuẩn là `dw upgrade`: nó tôn trọng overrides khi cập nhật `.claude/`.
+
 ## Khi nào nên override?
 
 - Team có domain-specific review rules

package/README.md

@@ -1,183 +1,124 @@
-# dw-kit
+# dw-kit
 
-> Bộ workflow toolkit cho dev team sử dụng Claude Code Agent — từ requirements đến dashboard.
+> An AI development workflow toolkit for teams using agentic IDEs (Claude Code, Cursor) — from idea to review-ready commits.
 
-**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)
+**v1.0** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md)
 
 ---
 
-## Toolkit Này Làm Gì?
+## What is dw-kit?
 
-Thay vì để Claude tự do code, dw-kit tạo ra **rails có cấu trúc**:
+dw-kit helps your team run AI-assisted development with a **repeatable workflow** and clear checkpoints:
 
 ```
-Research  →  Plan  →  Execute (TDD)  →  Review  →  Commit
+Initialize → Understand → Plan → Execute (TDD) → Verify → Close
 ```
 
-Với đầy đủ hỗ trợ cho các roles trong team: BA · TL · Dev · QC · PM.
+```mermaid
+%%{init: {'flowchart': {'nodeSpacing': 10, 'rankSpacing': 18}}}%%
+flowchart LR
+  classDef extra fill:#f3f4f6,stroke:#9ca3af,stroke-width:1px,color:#111;
 
----
+  D[Init + Understand] --> P[Plan (approve)]
+  P -->|approved| E[Execute (TDD)]
+  P -->|revise| P
 
-## Quick Start
+  E --> V[Verify (gates)]
+  V -->|sign-off| C[Close (handoff + archive)]
+  V -->|revise (fix)| E
 
-### Option A — npm (recommended)
+  subgraph Extra[Depth=thorough]
+    R[Req] --> Est[Est] --> AR[Arch] --> P
+    P -.-> TP[Test] -.-> E
+    E -.-> DU[Docs] --> LW[Log] -.-> C
+  end
 
-```bash
-npm install -g dw-kit
+  class R,Est,AR,TP,DU,LW extra
 ```
 
-Then in your project directory:
+### 6 phases (full workflow)
+- **Initialize**: clarify task scope and set up the workspace + task docs.
+- **Understand**: survey the codebase, dependencies, patterns, and test coverage (no implementation).
+- **Plan**: design the solution and subtasks; **pause for your approval**.
+- **Execute**: implement using **TDD**; each subtask produces a commit.
+- **Verify**: run quality gates + review sign-off to ensure correctness and safety.
+- **Close**: handoff notes, finalize progress, and archive when done.
 
-```bash
-dw init
-```
+It’s designed for collaboration (Dev / Tech Lead / QA / PM) and keeps work auditable via lightweight task docs.
 
-Interactive wizard asks 3 questions (project, depth, language) and auto-selects roles by depth. Or use presets:
+---
+
+## Install
 
 ```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
+npm install -g dw-kit
 ```
 
-Zero-install (one-time use):
+---
 
-```bash
-npx dw-kit init
-```
+## Quick start
 
-### Option B — Git submodule (legacy)
+From your project directory:
 
 ```bash
-git submodule add https://github.com/dv-workflow/dv-workflow.git .dw-module
-bash .dw-module/setup.sh
+dw init
 ```
 
-`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:
+Then in **Claude Code** (Update for Cursor/Antigravity/... in the next version):
 
 ```
-/dw-task-init tên-feature
+/dw-flow new-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
-```
-
----
+## Workflow overview
 
-## Depth System (thay thế Level 1/2/3)
+`dw` runs a 6-phase process (all phases for `standard` and `thorough`):
 
-| 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"
-```
+Initialize → Understand → Plan (stops for approval) → Execute (TDD; 1 commit per subtask) → Verify (quality gates + review sign-off) → Close (handoff + archive when done).
 
-`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)
+## CLI commands
 
-```
-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)
+```bash
+dw init                 # setup wizard / presets
+dw validate             # validate .dw/config/dw.config.yml
+dw doctor               # installation health check
+dw upgrade              # update toolkit files (override-aware)
+dw upgrade --check      # check for updates only
+dw upgrade --dry-run    # preview changes
 ```
 
 ---
 
-## Cấu Trúc Sau Khi Setup
+## Depth system
 
-```
-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
-```
+Pick a default depth for your project, then override per task when risk increases.
 
----
+| Depth | Best for | Workflow |
+|-------|----------|----------|
+| `quick` | Solo dev, hotfix, familiar code | Understand → Execute → Close |
+| `standard` | Small teams, new features | Full 6 phases |
+| `thorough` | Risky changes (API/DB/security) | Full workflow + arch-review + test-plan |
 
-## Skills Có Sẵn
+Configured in `.dw/config/dw.config.yml`:
 
-Xem [docs/cheatsheet.md](docs/cheatsheet.md) để có bảng tham chiếu nhanh.
+```yaml
+workflow:
+  default_depth: "standard"
+```
 
 ---
 
-## Migrating từ v0.3
+## What gets added to your repo?
 
-```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
+.dw/        # methodology, config, adapters, task docs
+.claude/    # Claude Code: skills, hooks, agents, rules
+CLAUDE.md   # project context for the agent
 ```
 
-`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)
+Maintainer: [huygdv](mailto:huygdv19@gmail.com)

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "dw-kit",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
   "type": "module",
   "bin": {
-    "dw": "./bin/dw.mjs"
+    "dw": "bin/dw.mjs"
   },
   "files": [
     "bin/",
@@ -14,8 +14,7 @@
     ".dw/adapters/",
     "scripts/",
     ".claude/",
-    "CLAUDE.md",
-    "setup.sh"
+    "CLAUDE.md"
   ],
   "engines": {
     "node": ">=18"
@@ -40,7 +39,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/dv-workflow/dv-workflow.git"
+    "url": "git+https://github.com/dv-workflow/dv-workflow.git"
   },
   "homepage": "https://github.com/dv-workflow/dv-workflow#readme",
   "dependencies": {

package/scripts/e2e-local-check.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/bin/bash
 # scripts/e2e-local-check.sh
 # End-to-end local publish check (pack -> install -> run CLI)
 
@@ -60,7 +60,6 @@ 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"

package/src/cli.mjs

@@ -55,14 +55,5 @@ export function run(argv) {
       await doctorCommand();
     });
 
-  program
-    .command('migrate')
-    .description('Migrate project from dw-kit v0.3 to v1')
-    .option('-n, --dry-run', 'Preview migration without applying')
-    .action(async (opts) => {
-      const { migrateCommand } = await import('./commands/migrate.mjs');
-      await migrateCommand(opts);
-    });
-
   program.parse(argv);
 }

package/src/smoke-test.mjs

@@ -72,7 +72,7 @@ test('--version returns semver', () => {
 
 test('--help lists all commands', () => {
   const out = dw('--help', TEMP_BASE);
-  for (const cmd of ['init', 'upgrade', 'validate', 'doctor', 'migrate']) {
+  for (const cmd of ['init', 'upgrade', 'validate', 'doctor']) {
     assert(out.includes(cmd), `Missing command: ${cmd}`);
   }
 });
@@ -288,16 +288,6 @@ test('upgrade fails on project without config', () => {
   }
 });
 
-// ── Test: dw migrate ─────────────────────────────────────────────────────────
-console.log();
-console.log('▶ dw migrate');
-
-test('migrate on v1 project reports no v0.3 config', () => {
-  const dir = join(TEMP_BASE, 'init-solo');
-  const out = dw('migrate', dir);
-  assert(out.includes('Already on v1') || out.includes('No v0.3'), 'Should report no migration needed');
-});
-
 // ── Cleanup ──────────────────────────────────────────────────────────────────
 rmSync(TEMP_BASE, { recursive: true });