dw-kit 1.0.2 → 1.2.0

package/README.md

@@ -1,139 +1,119 @@
-# dw-kit
-
-> 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) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md)
-
----
-
-## What is dw-kit?
-
-dw-kit helps your team run AI-assisted development with a **repeatable workflow** and clear checkpoints:
-
-```
-Initialize → Understand → Plan → Execute (TDD) → Verify → Close
-```
-
-```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
-
-  E --> V["Verify (gates)"]
-  V -->|sign-off| C["Close (handoff + archive)"]
-  V -->|"revise (fix)"| E
-
-  subgraph Extra["Depth=thorough"]
-    R[Req] --> Est[Est] --> AR[Arch] --> P
-    P -.-> TP[Test] -.-> E
-    E -.-> DU[Docs] --> LW[Log] -.-> C
-  end
-
-  class R,Est,AR,TP,DU,LW extra
-```
-
-## Workflow overview
-
-`dw` runs a 6-phase process (all phases for `standard` and `thorough`):
-
-Initialize → Understand → Plan (stops for approval) → Execute (TDD; 1 commit per subtask) → Verify (quality gates + review sign-off) → Close (handoff + archive when done).
-
-### 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.
-
-It’s designed for collaboration (Dev / Tech Lead / QA / PM) and keeps work auditable via lightweight task docs.
-
----
-
-## Install
-
-```bash
-npm install -g dw-kit
-```
-
----
-
-## Quick start
-
-Setup dw in project directory:
-
-```bash
-dw init
-```
-
-Then in **Claude Code CLI**, run the full workflow:
-
-```
-/dw-flow your-task-or-anythings
-```
-
----
-
-Discover other skills:
-
-```
-/dw-prompt
-/dw-thinking
-...
-
-```
-
----
-
-## CLI commands
-
-```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
-dw prompt               # build a well-structured task prompt (autocomplete + wizard)
-dw prompt --text "..."  # non-interactive: structure a description directly
-dw claude-vn-fix        # patch Claude CLI to fix Vietnamese IME (backup/restore)
-```
-
-`dw claude-vn-fix` patches the local Claude CLI bundle to fix Vietnamese IME input (DEL char `\x7f` issue). Includes auto-backup and rollback.
-
----
-
-## Depth system
-
-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 |
-
-Configured in `.dw/config/dw.config.yml`:
-
-```yaml
-workflow:
-  default_depth: "standard"
-```
-
----
-
-## What gets added to your repo?
-
-```
-.dw/        # methodology, config, adapters, task docs
-.claude/    # Claude Code: skills, hooks, agents, rules
-CLAUDE.md   # project context for the agent
-```
-
----
-
-Maintainer: [huygdv](mailto:huygdv19@gmail.com)
+# dw-kit
+
+> An AI development workflow toolkit for teams using agentic IDEs (Claude Code, Cursor) — from idea to review-ready commits.
+
+**v1.2** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md)
+
+---
+
+## What is dw-kit?
+
+dw-kit helps your team run AI-assisted development with a **repeatable workflow** and clear checkpoints:
+
+```
+Initialize → Understand → Plan → Execute (TDD) → Verify → Close
+```
+
+<img src="docs/workflow-diagram.svg" alt="dw-kit workflow diagram" />
+
+## Workflow overview
+
+`dw` runs a 6-phase process (all phases for `standard` and `thorough`):
+
+Initialize → Understand → Plan (stops for approval) → Execute (TDD; 1 commit per subtask) → Verify (quality gates + review sign-off) → Close (handoff + archive when done).
+
+### 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.
+
+It’s designed for collaboration (Dev / Tech Lead / QA / PM) and keeps work auditable via lightweight task docs.
+
+---
+
+## Install
+
+```bash
+npm install -g dw-kit
+```
+
+---
+
+## Quick start
+
+Setup dw in project directory:
+
+```bash
+dw init
+```
+
+Then in **Claude Code CLI**, run the full workflow:
+
+```
+/dw-flow your-task-or-anythings
+```
+
+---
+
+Discover other skills:
+
+```
+/dw-prompt
+/dw-thinking
+...
+
+```
+
+---
+
+## CLI commands
+
+```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
+dw prompt               # build a well-structured task prompt (autocomplete + wizard)
+dw prompt --text "..."  # non-interactive: structure a description directly
+dw claude-vn-fix        # patch Claude CLI to fix Vietnamese IME (backup/restore)
+```
+
+`dw claude-vn-fix` patches the local Claude CLI bundle to fix Vietnamese IME input (DEL char `\x7f` issue). Includes auto-backup and rollback.
+
+---
+
+## Depth system
+
+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 |
+
+Configured in `.dw/config/dw.config.yml`:
+
+```yaml
+workflow:
+  default_depth: "standard"
+```
+
+---
+
+## What gets added to your repo?
+
+```
+.dw/        # methodology, config, adapters, task docs
+.claude/    # Claude Code: skills, hooks, agents, rules
+CLAUDE.md   # project context for the agent
+```
+
+---
+
+Maintainer: [huygdv](mailto:huygdv19@gmail.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dw-kit",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
   "type": "module",
   "bin": {
@@ -8,12 +8,44 @@
   },
   "files": [
     "bin/",
-    "src/",
+    "src/cli.mjs",
+    "src/commands/",
+    "src/lib/",
     ".dw/core/",
     ".dw/config/",
     ".dw/adapters/",
-    "scripts/",
-    ".claude/",
+    ".claude/agents/",
+    ".claude/hooks/",
+    ".claude/rules/",
+    ".claude/skills/dw-arch-review/",
+    ".claude/skills/dw-archive/",
+    ".claude/skills/dw-commit/",
+    ".claude/skills/dw-config-init/",
+    ".claude/skills/dw-config-validate/",
+    ".claude/skills/dw-dashboard/",
+    ".claude/skills/dw-debug/",
+    ".claude/skills/dw-docs-update/",
+    ".claude/skills/dw-estimate/",
+    ".claude/skills/dw-execute/",
+    ".claude/skills/dw-flow/",
+    ".claude/skills/dw-handoff/",
+    ".claude/skills/dw-kit-report/",
+    ".claude/skills/dw-log-work/",
+    ".claude/skills/dw-onboard/",
+    ".claude/skills/dw-plan/",
+    ".claude/skills/dw-prompt/",
+    ".claude/skills/dw-requirements/",
+    ".claude/skills/dw-research/",
+    ".claude/skills/dw-retroactive/",
+    ".claude/skills/dw-review/",
+    ".claude/skills/dw-rollback/",
+    ".claude/skills/dw-sprint-review/",
+    ".claude/skills/dw-task-init/",
+    ".claude/skills/dw-test-plan/",
+    ".claude/skills/dw-thinking/",
+    ".claude/skills/dw-upgrade/",
+    ".claude/templates/",
+    ".claude/settings.json",
     "CLAUDE.md"
   ],
   "engines": {

package/src/cli.mjs

@@ -1,92 +1,92 @@
-import { Command } from 'commander';
-import { createRequire } from 'node:module';
-import { fileURLToPath } from 'node:url';
-import { dirname, join } from 'node:path';
-import chalk from 'chalk';
-import { getUpdateNotice, scheduleUpdateCheck } from './lib/update-checker.mjs';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const require = createRequire(import.meta.url);
-const pkg = require(join(__dirname, '..', 'package.json'));
-
-export function run(argv) {
-  // Show cached update notice (non-blocking), then schedule fresh check in background
-  const latestVersion = getUpdateNotice(pkg.version);
-  scheduleUpdateCheck(pkg.version);
-
-  const program = new Command();
-
-  program
-    .name('dw')
-    .description('dw-kit — AI development workflow toolkit')
-    .version(pkg.version, '-v, --version');
-
-  program
-    .command('init')
-    .description('Setup dw-kit in current project (interactive wizard)')
-    .option('-p, --preset <name>', 'Use preset: solo-quick | small-team | enterprise')
-    .option('-a, --adapter <platform>', 'Target platform: claude-cli | cursor | generic', 'claude-cli')
-    .option('-s, --silent', 'Non-interactive mode (reads DW_NAME, DW_DEPTH, DW_ROLES, DW_LANG env vars)')
-    .action(async (opts) => {
-      const { initCommand } = await import('./commands/init.mjs');
-      await initCommand(opts);
-    });
-
-  program
-    .command('upgrade')
-    .description('Update dw-kit files in current project')
-    .option('-n, --dry-run', 'Preview changes without applying')
-    .option('-c, --check', 'Only check if update is available')
-    .option('-l, --layer <name>', 'Update specific layer: core | platform | capability | all', 'all')
-    .action(async (opts) => {
-      const { upgradeCommand } = await import('./commands/upgrade.mjs');
-      await upgradeCommand(opts);
-    });
-
-  program
-    .command('validate')
-    .description('Validate .dw/config/dw.config.yml against schema')
-    .option('-f, --file <path>', 'Config file path', '.dw/config/dw.config.yml')
-    .action(async (opts) => {
-      const { validateCommand } = await import('./commands/validate.mjs');
-      await validateCommand(opts);
-    });
-
-  program
-    .command('doctor')
-    .description('Check dw-kit installation health')
-    .action(async () => {
-      const { doctorCommand } = await import('./commands/doctor.mjs');
-      await doctorCommand();
-    });
-
-  program
-    .command('prompt')
-    .description('Build a well-structured task prompt with autocomplete + guided wizard')
-    .option('-t, --text <text>', 'Non-interactive: provide description directly')
-    .action(async (opts) => {
-      const { promptCommand } = await import('./commands/prompt.mjs');
-      await promptCommand(opts);
-    });
-
-  program
-    .command('claude-vn-fix')
-    .description('Patch Claude CLI to fix Vietnamese IME (local, with backup/restore)')
-    .option('--path <file>', 'Path to @anthropic-ai/claude-code/cli.js (optional; auto-detect if omitted)')
-    .option('--restore', 'Restore from latest backup')
-    .option('--dry-run', 'Show what would change without writing')
-    .action(async (opts) => {
-      const { claudeVnFixCommand } = await import('./commands/claude-vn-fix.mjs');
-      await claudeVnFixCommand(opts);
-    });
-
-  program.parse(argv);
-
-  if (latestVersion) {
-    console.log();
-    console.log(chalk.yellow(`  ↑ Update available`) + `  v${pkg.version} → ` + chalk.green.bold(`v${latestVersion}`));
-    console.log(`    Run ` + chalk.cyan(`npm install -g dw-kit`) + ` to update`);
-    console.log();
-  }
-}
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import chalk from 'chalk';
+import { getUpdateNotice, scheduleUpdateCheck } from './lib/update-checker.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const require = createRequire(import.meta.url);
+const pkg = require(join(__dirname, '..', 'package.json'));
+
+export function run(argv) {
+  // Show cached update notice (non-blocking), then schedule fresh check in background
+  const latestVersion = getUpdateNotice(pkg.version);
+  scheduleUpdateCheck(pkg.version);
+
+  const program = new Command();
+
+  program
+    .name('dw')
+    .description('dw-kit — AI development workflow toolkit')
+    .version(pkg.version, '-v, --version');
+
+  program
+    .command('init')
+    .description('Setup dw-kit in current project (interactive wizard)')
+    .option('-p, --preset <name>', 'Use preset: solo-quick | small-team | enterprise')
+    .option('-a, --adapter <platform>', 'Target platform: claude-cli | cursor | generic', 'claude-cli')
+    .option('-s, --silent', 'Non-interactive mode (reads DW_NAME, DW_DEPTH, DW_ROLES, DW_LANG env vars)')
+    .action(async (opts) => {
+      const { initCommand } = await import('./commands/init.mjs');
+      await initCommand(opts);
+    });
+
+  program
+    .command('upgrade')
+    .description('Update dw-kit files in current project')
+    .option('-n, --dry-run', 'Preview changes without applying')
+    .option('-c, --check', 'Only check if update is available')
+    .option('-l, --layer <name>', 'Update specific layer: core | platform | capability | all', 'all')
+    .action(async (opts) => {
+      const { upgradeCommand } = await import('./commands/upgrade.mjs');
+      await upgradeCommand(opts);
+    });
+
+  program
+    .command('validate')
+    .description('Validate .dw/config/dw.config.yml against schema')
+    .option('-f, --file <path>', 'Config file path', '.dw/config/dw.config.yml')
+    .action(async (opts) => {
+      const { validateCommand } = await import('./commands/validate.mjs');
+      await validateCommand(opts);
+    });
+
+  program
+    .command('doctor')
+    .description('Check dw-kit installation health')
+    .action(async () => {
+      const { doctorCommand } = await import('./commands/doctor.mjs');
+      await doctorCommand();
+    });
+
+  program
+    .command('prompt')
+    .description('Build a well-structured task prompt with autocomplete + guided wizard')
+    .option('-t, --text <text>', 'Non-interactive: provide description directly')
+    .action(async (opts) => {
+      const { promptCommand } = await import('./commands/prompt.mjs');
+      await promptCommand(opts);
+    });
+
+  program
+    .command('claude-vn-fix')
+    .description('Patch Claude CLI to fix Vietnamese IME (local, with backup/restore)')
+    .option('--path <file>', 'Path to @anthropic-ai/claude-code/cli.js (optional; auto-detect if omitted)')
+    .option('--restore', 'Restore from latest backup')
+    .option('--dry-run', 'Show what would change without writing')
+    .action(async (opts) => {
+      const { claudeVnFixCommand } = await import('./commands/claude-vn-fix.mjs');
+      await claudeVnFixCommand(opts);
+    });
+
+  program.parse(argv);
+
+  if (latestVersion) {
+    console.log();
+    console.log(chalk.yellow(`  ↑ Update available`) + `  v${pkg.version} → ` + chalk.green.bold(`v${latestVersion}`));
+    console.log(`    Run ` + chalk.cyan(`npm install -g dw-kit`) + ` to update`);
+    console.log();
+  }
+}

package/src/commands/init.mjs

@@ -135,7 +135,7 @@ async function setupProject(projectDir, { projectName, depth, roles, language, a
 
   if (adapter === 'claude-cli') {
     copyClaudeFiles(projectDir);
-    copyCLAUDEmd(projectDir);
+    createMinimalCLAUDEmd(projectDir, projectName);
   } else if (adapter === 'cursor') {
     copyCursorFiles(projectDir);
     copyGenericAdapter(projectDir);
@@ -191,34 +191,34 @@ function copyClaudeFiles(projectDir) {
   if (skipCount > 0) log(`  ${skipCount} existing files preserved`);
 }
 
-function copyCLAUDEmd(projectDir) {
-  const src = join(TOOLKIT_ROOT, 'CLAUDE.md');
+function createMinimalCLAUDEmd(projectDir, projectName) {
   const dst = join(projectDir, 'CLAUDE.md');
 
   if (existsSync(dst)) {
-    warn('CLAUDE.md already exists — skipping (review manually if needed)');
+    // User already has their own CLAUDE.md — leave it completely alone
     return;
   }
 
-  copyFile(src, dst);
+  const content = `# ${projectName}
+
+> Add your project description here.
 
-  const techStackSection = `
 ---
 
 ## Tech Stack
 
 <!-- Update with your project's actual stack -->
-- Framework: [e.g. NestJS / Django / Laravel / Next.js]
-- Database: [e.g. PostgreSQL / MySQL / MongoDB]
-- Testing: [e.g. Jest / Pytest / PHPUnit]
+- Framework:
+- Database:
+- Testing:
 
 ## Project-Specific Rules
 
-<!-- Add project-specific rules -->
-- [Rule 1]
+<!-- Add project-specific rules here -->
+<!-- dw workflow rules are auto-loaded from .claude/rules/ -->
 `;
-  appendFileSync(dst, techStackSection, 'utf-8');
-  ok('CLAUDE.md (with Tech Stack template section)');
+  writeFileSync(dst, content, 'utf-8');
+  ok('CLAUDE.md (minimal project template — dw rules are in .claude/rules/)');
 }
 
 function copyCursorFiles(projectDir) {
@@ -276,7 +276,7 @@ function createRuntimeDirs(projectDir) {
 
 function updateGitignore(projectDir) {
   const gitignorePath = join(projectDir, '.gitignore');
-  const entriesToAdd = ['.dw/metrics/', '.dw/reports/', 'CLAUDE.local.md'];
+  const entriesToAdd = ['CLAUDE.local.md', '.claude/settings.local.json', '.dw/config/dw.config.local.yml'];
 
   if (existsSync(gitignorePath)) {
     const content = readFileSync(gitignorePath, 'utf-8');
@@ -304,8 +304,8 @@ function printSummary({ projectName, depth, roles, language, adapter }) {
   console.log(`  Files created:`);
   console.log(`    .dw/               — core/, config/, adapters/, tasks, docs`);
   if (adapter === 'claude-cli') {
-    console.log(`    .claude/           — skills, agents, hooks, rules`);
-    console.log(`    CLAUDE.md`);
+    console.log(`    .claude/           — skills, agents, hooks, rules/`);
+    console.log(`    CLAUDE.md          — minimal project template (dw rules in .claude/rules/)`);
   } else if (adapter === 'cursor') {
     console.log(`    .cursor/rules/     — workflow rules for Cursor`);
     console.log(`    AGENT.md           — methodology reference`);
@@ -317,7 +317,7 @@ function printSummary({ projectName, depth, roles, language, adapter }) {
     console.log(`  Next steps:`);
     console.log(`    Run: claude (to open Claude Code in this directory in terminal)`);
     console.log(`    Run: /dw-flow [task-name]`);
-    console.log(`    Suggested: Update Tech Stack in CLAUDE.md (optional, recommended)`);
+    console.log(`    Suggested: Update Tech Stack + rules in CLAUDE.md`);
   } else if (adapter === 'cursor') {
     console.log(`  Next steps:`);
     console.log(`    1. Open Cursor in this directory`);

package/src/commands/prompt.mjs

@@ -1,14 +1,12 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { load as yamlLoad } from 'js-yaml';
 import { header, info, ok, warn, err, log } from '../lib/ui.mjs';
 import { copyToClipboard } from '../lib/clipboard.mjs';
 import { getSuggestions, isVague, expandTemplate } from '../lib/prompt-suggest.mjs';
+import { detectPlatform } from '../lib/platform.mjs';
 
 export async function promptCommand(opts) {
   header('dw-kit Prompt Builder');
 
-  const adapter = readAdapter();
+  const adapter = detectPlatform(process.cwd());
 
   // Non-interactive mode: --text <text>
   if (opts.text !== undefined) {
@@ -112,14 +110,3 @@ function outputResult(text, adapter) {
     info('(generic adapter — copy the text above manually)');
   }
 }
-
-function readAdapter() {
-  const configPath = join(process.cwd(), '.dw', 'config', 'dw.config.yml');
-  if (!existsSync(configPath)) return 'claude-cli';
-  try {
-    const config = yamlLoad(readFileSync(configPath, 'utf-8'));
-    return config?.adapter || 'claude-cli';
-  } catch {
-    return 'claude-cli';
-  }
-}

package/src/lib/config.mjs

@@ -7,6 +7,35 @@ export function loadConfig(configPath) {
   return yaml.load(content);
 }
 
+/**
+ * Load config với local override (v1.2+).
+ * dw.config.yml  — shared, committed
+ * dw.config.local.yml — machine-specific, gitignored
+ * Local values win over base values (shallow merge per top-level key).
+ */
+export function loadConfigWithLocal(configDir) {
+  const basePath = `${configDir}/dw.config.yml`;
+  const localPath = `${configDir}/dw.config.local.yml`;
+
+  const base = loadConfig(basePath);
+  if (!base) return null;
+
+  if (!existsSync(localPath)) return base;
+
+  const local = loadConfig(localPath);
+  if (!local) return base;
+
+  const merged = { ...base };
+  for (const key of Object.keys(local)) {
+    if (typeof local[key] === 'object' && !Array.isArray(local[key]) && local[key] !== null) {
+      merged[key] = { ...(merged[key] || {}), ...local[key] };
+    } else {
+      merged[key] = local[key];
+    }
+  }
+  return merged;
+}
+
 export function writeConfig(configPath, data) {
   const content = yaml.dump(data, {
     indent: 2,
@@ -57,9 +86,9 @@ export function buildConfig({ projectName, language, depth, roles }) {
       mcp: [],
     },
     _toolkit: {
-      core_version: '1.0',
+      core_version: '1.2',
       platform_version: '1.0',
-      capability_version: '1.0',
+      capability_version: '1.2',
       installed: today,
       last_upgrade: today,
     },