dw-kit 1.0.0

package/.claude/templates/task-progress.md

@@ -0,0 +1,65 @@
+# Progress: [Task Name]
+
+## Trạng thái: Not Started | In Progress | Blocked | Done
+## Branch: [branch-name]
+## Bắt đầu: [date]
+## Kết thúc: [date — khi done]
+
+---
+
+## Subtask Progress
+
+| # | Subtask | Trạng thái | Commit | Người thực hiện | Ghi chú |
+|---|---------|-----------|--------|-----------------|---------|
+| ST-1 | | Pending | | | |
+| ST-2 | | Pending | | | |
+
+**Trạng thái**: Pending → In Progress → Done | Blocked | Skipped
+
+## Changelog
+
+Ghi lại mọi thay đổi so với plan gốc.
+
+### [date] — [mô tả thay đổi]
+- **Lý do**: [tại sao thay đổi]
+- **Ảnh hưởng**: [subtasks nào bị ảnh hưởng]
+- **Quyết định bởi**: [human / agent / cả hai]
+
+## Phát Hiện Mới
+
+Ghi lại khi phát hiện giả định sai, rủi ro mới, hoặc scope thay đổi.
+
+| # | Phát hiện | Ảnh hưởng | Hành động | Trạng thái |
+|---|-----------|-----------|-----------|-----------|
+| 1 | | | | Resolved / Open |
+
+## Blockers
+
+- [ ] [Blocker 1] — owner: [ai chịu trách nhiệm] — since: [date]
+
+<!-- Section dưới chỉ hiển thị khi flags.log_work = true -->
+
+## Effort Log
+
+| Ngày | Subtask | Loại công việc | Estimate | Actual | Ghi chú |
+|------|---------|---------------|----------|--------|---------|
+| | | coding/testing/review | | | |
+
+### Tổng kết Effort
+
+| Metric | Giá trị |
+|--------|---------|
+| Total Estimate | |
+| Total Actual | |
+| Variance | |
+| Accuracy | % |
+
+## Handoff Notes
+
+Ghi lại khi kết thúc session để người/agent tiếp theo hiểu context.
+
+### Session [date]
+- **Đang ở**: ST-[N] — [mô tả trạng thái]
+- **Context quan trọng**: [decisions, gotchas]
+- **Bước tiếp theo**: [việc cần làm ngay]
+- **Cẩn thận**: [warnings, edge cases đã gặp]

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

@@ -0,0 +1,36 @@
+# .dw/adapters/claude-cli/extensions/
+
+> **NET-NEW TEAM SKILLS — Không conflict với generated, không bị overwrite.**
+
+## Mục đích
+
+Thêm skills hoàn toàn mới mà không có trong dw-kit core.
+
+## Cách dùng
+
+```
+extensions/
+└── dw-deploy/
+    ├── SKILL.md        ← skill definition
+    └── README.md       ← optional: mô tả skill
+```
+
+`setup.sh` copy tất cả skills trong thư mục này vào `.claude/skills/`.
+
+## Ví dụ Skills Phù Hợp
+
+- `/dw-deploy` — deployment workflow cho team
+- `/dw-migration` — database migration helper
+- `/dw-release` — release checklist
+- `/dw-notify` — team notification integration
+
+## Convention
+
+- Tên folder = tên skill (kebab-case)
+- SKILL.md theo format chuẩn (xem `.claude/skills/` cho examples)
+- Tên skill nên bắt đầu bằng `dw-` để nhất quán
+
+## Đóng góp cho community
+
+Nếu skill hữu ích cho mọi team, submit PR vào toolkit repo.
+Xem `docs/custom-skills.md` để biết hướng dẫn.

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

@@ -0,0 +1,23 @@
+# .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`.
+
+## Nội dung
+
+Chứa Claude Code-specific files được generate từ `core/` + `.dw/config/dw.config.yml`:
+
+```
+generated/
+├── skills/          # Skill shell files (.claude/skills/ → populated từ đây)
+├── agents/          # Agent files (.claude/agents/ → populated từ đây)
+└── settings.json    # settings.json base template
+```
+
+## Cách hoạt động
+
+`setup.sh` → copy `generated/` → `.claude/`, với overrides từ `overrides/` thắng.
+
+## Nếu muốn customize
+
+Đặt file override vào `.dw/adapters/claude-cli/overrides/` — không edit tay ở đây.

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

@@ -0,0 +1,35 @@
+# .dw/adapters/claude-cli/overrides/
+
+> **TEAM CUSTOMIZATIONS — KHÔNG BAO GIỜ bị overwrite khi upgrade.**
+
+## Mục đích
+
+Đặt file override vào đây khi team muốn customize skill hoặc agent mà không mất khi upgrade toolkit.
+
+## Cách dùng
+
+Tạo file với đường dẫn tương tự `generated/`:
+
+```
+overrides/
+├── skills/
+│   └── plan/
+│       └── SKILL.md      ← override generated/skills/plan/SKILL.md
+└── agents/
+    └── reviewer.md       ← override generated/agents/reviewer.md
+```
+
+Khi upgrade, `scripts/upgrade.sh` 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/`
+
+## Khi nào nên override?
+
+- Team có domain-specific review rules
+- Team muốn thêm instruction vào planning workflow
+- Team cần custom output format
+
+## Khi nào dùng extensions/ thay vì overrides/?
+
+Dùng `extensions/` cho skills net-new (không override gì trong generated).

package/.dw/adapters/generic/AGENT.md

@@ -0,0 +1,169 @@
+# dw-kit Workflow — Generic Agent Instructions
+
+> **For**: Cursor, Windsurf, Copilot Chat, or any AI coding assistant
+> **Note**: This is a methodology reference. It cannot replicate Claude Code-specific features
+> (agent delegation with tool constraints, hooks, MCP integration). For full capabilities, use the Claude CLI adapter.
+
+---
+
+## Setup
+
+1. Copy this file to your project root as `AGENT.md` (or paste into your AI assistant's context)
+2. Copy `.dw/config/dw.config.yml` to your project and fill in your settings
+3. Create `.dw/tasks/` directory for task documentation
+
+---
+
+## Configuration
+
+Read `.dw/config/dw.config.yml` for:
+- `workflow.default_depth` — quick | standard | thorough
+- `team.roles` — available team roles
+- `quality.test_command`, `quality.lint_command` — quality gates
+- `paths.tasks` — where task docs are stored
+
+---
+
+## Depth Routing
+
+| Scope | Depth | Workflow |
+|-------|-------|---------|
+| ≤2 files, hotfix | quick | Understand → Execute → Close |
+| 3-5 files | standard | All 6 phases |
+| 6+ files, API/DB changes | thorough | All phases + arch review |
+
+---
+
+## Workflow Phases
+
+### Phase 1: Initialize
+
+Create task documentation at `{paths.tasks}/[task-name]/`:
+```
+[name]-context.md    # Research findings
+[name]-plan.md       # Implementation plan
+[name]-progress.md   # Progress tracking
+```
+
+**Before proceeding**: Task name defined, scope assessed, depth chosen.
+
+### Phase 2: Understand (Research)
+
+Explore the codebase:
+- Find all files related to the task
+- Map dependencies (upstream and downstream)
+- Identify current patterns and conventions
+- Check test coverage
+- Note git history for recent changes in the area
+- Document what is unclear
+
+Fill in `[name]-context.md` with findings.
+
+**Before proceeding**: All files identified, no critical unknowns.
+
+### Phase 3: Plan
+
+Design solution before writing any code:
+- Consider ≥2 approaches with trade-offs
+- Apply devil's advocate: strongest reason NOT to choose your preferred approach
+- Break into subtasks (each ≤3 files, ≤4 hours, independent commit)
+- Order: schema → service → API → tests → docs
+
+Fill in `[name]-plan.md`.
+
+**STOP**: Wait for human approval before executing.
+If team has TL: TL must review architecture decisions.
+
+### Phase 4: Execute
+
+For each subtask:
+1. Read acceptance criteria
+2. Write tests first (failing) — RED
+3. Implement to make tests pass — GREEN
+4. Refactor if needed — REFACTOR
+5. Update progress file
+6. Commit: `type(scope): description`
+
+**Rules**:
+- Only work within subtask scope
+- If ambiguous → stop and ask (don't guess for large changes)
+- If scope changes → update plan, ask human
+
+### Phase 5: Verify
+
+**Self-review** (always):
+- Logic correct? Edge cases handled?
+- No debug code (console.log, debugger, etc.)
+- No sensitive data (passwords, tokens, keys)
+
+**Automated** (if configured):
+```bash
+{quality.test_command}
+{quality.lint_command}
+```
+
+**Peer/TL review** (standard+):
+- Architecture decisions reviewed
+- Code review with checklist (see `.dw/core/QUALITY.md`)
+
+**QA** (thorough + qc role):
+- QA reviews against test plan
+- Explicit sign-off required
+
+### Phase 6: Close
+
+Commit format:
+```
+<type>(<scope>): <description ≤72 chars>
+
+Co-Authored-By: [AI assistant name]
+```
+
+Update progress file: status → Done.
+If handing off: write handoff notes (done/in-progress/blocked, next steps).
+
+---
+
+## Standalone: Debug
+
+When encountering a bug:
+1. **Investigate**: Reproduce exactly. Gather evidence (error, stack trace, file:line).
+2. **Diagnose**: Form hypothesis. Verify. Find root cause (not symptom).
+3. **Fix**: Fix root cause. Test the fix. Check for regressions. Commit.
+
+---
+
+## Quality Principles
+
+Full quality strategy: `.dw/core/QUALITY.md`
+
+Key principles:
+- Write tests before implementation (TDD)
+- Each subtask = one commit
+- Review checklist: correctness, security, performance, maintainability, tests
+- CRITICAL issues must be fixed before merge
+
+---
+
+## Limitations of This Adapter
+
+This generic adapter provides the **methodology** but cannot provide:
+
+| Feature | Claude CLI Adapter | Generic Adapter |
+|---------|-------------------|-----------------|
+| Agent delegation (researcher/planner/reviewer) | ✅ | ❌ |
+| Tool constraints (read-only research agent) | ✅ | ❌ |
+| Pre-commit hooks (safety-guard, quality gates) | ✅ | ❌ |
+| MCP server integration | ✅ | ❌ |
+| Automatic progress tracking | ✅ | Manual |
+
+For full capabilities, use Claude Code with the Claude CLI adapter.
+
+---
+
+## Full Methodology Reference
+
+- Workflow phases: `.dw/core/WORKFLOW.md`
+- Thinking framework: `.dw/core/THINKING.md`
+- Quality strategy: `.dw/core/QUALITY.md`
+- Role definitions: `.dw/core/ROLES.md`

package/.dw/adapters/generic/README.md

@@ -0,0 +1,21 @@
+# Generic Adapter
+
+Dành cho bất kỳ AI coding assistant nào (Cursor, Windsurf, Copilot, etc.).
+
+## Cách dùng
+
+1. Copy `AGENT.md` vào project root
+2. Copy `.dw/config/dw.config.yml` và điền settings
+3. Tạo `.dw/tasks/` directory
+
+## Limitations
+
+Generic adapter cung cấp **methodology** (what to do), không phải **execution** (how Claude Code does it).
+
+Không có:
+- Agent delegation với tool constraints
+- Pre-commit hooks (safety-guard, quality gates)
+- MCP server integration
+- Automatic context management
+
+Muốn full capabilities → dùng Claude Code với Claude CLI adapter.

package/.dw/config/config.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "dw-kit Configuration Schema",
+  "description": "Schema for config/dw.config.yml",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name":     { "type": "string", "minLength": 1 },
+        "language": { "type": "string", "enum": ["vi", "en"], "default": "vi" }
+      }
+    },
+    "workflow": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "default_depth": {
+          "type": "string",
+          "enum": ["quick", "standard", "thorough"],
+          "default": "standard"
+        }
+      }
+    },
+    "team": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "roles": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["dev", "techlead", "ba", "qc", "pm"]
+          },
+          "minItems": 1,
+          "contains": { "const": "dev" },
+          "description": "dev is always required"
+        }
+      }
+    },
+    "quality": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "test_command":  { "type": "string", "default": "" },
+        "lint_command":  { "type": "string", "default": "" },
+        "block_on_fail": { "type": "boolean", "default": false }
+      }
+    },
+    "tracking": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "estimation":      { "type": "boolean", "default": false },
+        "log_work":        { "type": "boolean", "default": false },
+        "estimation_unit": {
+          "type": "string",
+          "enum": ["hours", "story-points", "t-shirt"],
+          "default": "hours"
+        }
+      }
+    },
+    "paths": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "tasks": { "type": "string", "default": ".dw/tasks" },
+        "docs":  { "type": "string", "default": ".dw/docs" }
+      }
+    },
+    "claude": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "models": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "plan":    { "type": "string", "default": "" },
+            "execute": { "type": "string", "default": "" },
+            "review":  { "type": "string", "default": "" }
+          }
+        },
+        "structured_output":  { "type": "boolean", "default": true },
+        "worktree_execution": { "type": "boolean", "default": false },
+        "mcp": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "command"],
+            "additionalProperties": false,
+            "properties": {
+              "name":    { "type": "string" },
+              "command": { "type": "string" },
+              "args":    { "type": "array", "items": { "type": "string" } },
+              "env": {
+                "type": "object",
+                "additionalProperties": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "_toolkit": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "core_version":     { "type": "string" },
+        "platform_version": { "type": "string" },
+        "capability_version": { "type": "string" },
+        "installed":        { "type": "string" },
+        "last_upgrade":     { "type": "string" },
+        "migrated_from":    { "type": "string" }
+      }
+    }
+  }
+}

package/.dw/config/dw.config.yml

@@ -0,0 +1,82 @@
+# ============================================================================
+# dw-kit Configuration — v1
+# ============================================================================
+# Copy file này vào project và tùy chỉnh theo nhu cầu.
+# Toolkit đọc file này để điều chỉnh behavior per project.
+# ============================================================================
+
+# --- Project Info -----------------------------------------------------------
+project:
+  name: "my-project"
+  language: "vi"               # vi | en
+
+# --- Workflow ----------------------------------------------------------------
+workflow:
+  default_depth: "standard"   # quick | standard | thorough
+  # AI assesses per-task và có thể recommend depth khác nhau:
+  #   quick    : ≤2 files, hotfix, familiar module
+  #   standard : 3-5 files, module mới, unfamiliar code
+  #   thorough : 6+ files, API contract changes, DB schema, security
+
+# --- Team -------------------------------------------------------------------
+team:
+  roles:
+    - dev              # luôn có
+    - techlead         # architecture review, plan approval
+    # - ba             # requirements, user stories
+    # - qc             # test plans, QA sign-off
+    # - pm             # dashboard, reports
+
+# --- Quality Gates ----------------------------------------------------------
+quality:
+  test_command: ""     # ví dụ: "npm test" | "pytest" | "go test ./..."
+  lint_command: ""     # ví dụ: "npm run lint" | "ruff check ." | "golangci-lint run"
+  block_on_fail: false # true = block commit nếu test/lint fail
+
+# --- Tracking ---------------------------------------------------------------
+tracking:
+  estimation: false
+  log_work: false
+  estimation_unit: "hours"    # hours | story-points | t-shirt
+
+# --- Paths ------------------------------------------------------------------
+paths:
+  tasks: ".dw/tasks"
+  docs: ".dw/docs"
+
+# --- Claude Capabilities (Layer 2) ------------------------------------------
+# Tính năng đặc thù của Claude Code.
+claude:
+  # Model per phase — để trống = dùng model mặc định từ Claude Code settings
+  models:
+    plan: ""           # ví dụ: "claude-opus-4-6" cho complex planning
+    execute: ""        # ví dụ: "claude-sonnet-4-6"
+    review: ""
+
+  # Structured JSON output từ reviewer và estimate skills
+  structured_output: true
+
+  # Isolate execution trong git worktree (cho risky refactors)
+  worktree_execution: false
+
+  # MCP servers — Claude Code sẽ load các servers này
+  mcp: []
+  # Ví dụ:
+  # mcp:
+  #   - name: "github"
+  #     command: "npx @modelcontextprotocol/server-github"
+  #     env:
+  #       GITHUB_TOKEN: "${GITHUB_TOKEN}"
+  #   - name: "jira"
+  #     command: "npx @anthropic/mcp-server-jira"
+  #     env:
+  #       JIRA_URL: "${JIRA_URL}"
+  #       JIRA_TOKEN: "${JIRA_TOKEN}"
+
+# --- Toolkit Version (do not edit manually) ---------------------------------
+_toolkit:
+  core_version: "1.0"
+  platform_version: "1.0"
+  capability_version: "1.0"
+  installed: "2026-03-23"
+  last_upgrade: "2026-03-23"

package/.dw/config/presets/enterprise.yml

@@ -0,0 +1,52 @@
+# dw-kit Preset: Enterprise — Full Workflow
+# Dùng cho: 5+ devs, full team roles, metrics tracking
+# Kế thừa từ: config/dw.config.yml (copy và modify)
+
+project:
+  name: "my-project"
+  language: "vi"
+
+workflow:
+  default_depth: "thorough"
+
+team:
+  roles:
+    - dev
+    - techlead
+    - ba
+    - qc
+    - pm
+
+quality:
+  test_command: ""     # BẮT BUỘC điền: "npm test" | "pytest" | ...
+  lint_command: ""     # BẮT BUỘC điền: "npm run lint" | ...
+  block_on_fail: true  # Block commit nếu fail
+
+tracking:
+  estimation: true
+  log_work: true
+  estimation_unit: "story-points"
+
+paths:
+  tasks: ".dw/tasks"
+  docs: ".dw/docs"
+
+claude:
+  models:
+    plan: "claude-opus-4-6"     # Dùng model mạnh nhất cho planning
+    execute: "claude-sonnet-4-6"
+    review: "claude-sonnet-4-6"
+  structured_output: true
+  worktree_execution: true      # Isolate risky refactors
+  mcp: []
+  # Uncomment và điền env vars để enable external integrations:
+  # mcp:
+  #   - name: "github"
+  #     command: "npx @modelcontextprotocol/server-github"
+  #     env:
+  #       GITHUB_TOKEN: "${GITHUB_TOKEN}"
+
+_toolkit:
+  core_version: "1.0"
+  platform_version: "1.0"
+  capability_version: "1.0"

package/.dw/config/presets/small-team.yml

@@ -0,0 +1,39 @@
+# dw-kit Preset: Small Team — Standard Workflow
+# Dùng cho: 2-5 devs, có TL, sprint-based development
+# Kế thừa từ: config/dw.config.yml (copy và modify)
+
+project:
+  name: "my-project"
+  language: "vi"
+
+workflow:
+  default_depth: "standard"
+
+team:
+  roles:
+    - dev
+    - techlead
+
+quality:
+  test_command: ""     # điền vào: "npm test" | "pytest" | ...
+  lint_command: ""     # điền vào: "npm run lint" | "ruff check ." | ...
+  block_on_fail: false
+
+tracking:
+  estimation: true
+  log_work: false
+  estimation_unit: "hours"
+
+paths:
+  tasks: ".dw/tasks"
+  docs: ".dw/docs"
+
+claude:
+  structured_output: true
+  worktree_execution: false
+  mcp: []
+
+_toolkit:
+  core_version: "1.0"
+  platform_version: "1.0"
+  capability_version: "1.0"