openmoneta-dev-kit 2.2.0 → 2.3.0

package/hooks/inject-process-context.sh

@@ -5,23 +5,31 @@
 # AGENTS.md ở project root vẫn có đầy đủ chi tiết — AI đọc khi cần.
 #
 # Cũng check update từ remote git repo (cache 24h).
+#
+# Multi-platform (v2.3.0): mặc định install home là ~/.cursor (Cursor).
+# Adapter Claude Code gọi script này với env:
+#   OPENMONETA_HOME=~/.claude        — đổi nơi đọc version/registry/cache
+#   OPENMONETA_SKIP_SUMMARY=1        — bỏ inject summary 6 bước (tránh nạp đôi
+#                                      khi platform đã load quy trình qua CLAUDE.md → @AGENTS.md)
 
 set -euo pipefail
 
 INPUT_JSON=$(cat 2>/dev/null || echo '{}')
 
-# Auto-register project vào Cursor registry (seed cho `update --all-projects`).
-# Im lặng. Chỉ append khi: workspace có docs/INDEX.md, Cursor install home đã cài,
+OM_HOME="${OPENMONETA_HOME:-$HOME/.cursor}"
+
+# Auto-register project vào registry của install home (seed cho `update --all-projects`).
+# Im lặng. Chỉ append khi: workspace có docs/INDEX.md, install home đã cài,
 # và path chưa có trong registry (dedup, chuẩn hoá pwd -P).
-register_project_cursor() {
+register_project() {
   local ws="$1"
   [[ -n "$ws" && -f "$ws/docs/INDEX.md" ]] || return 0
   # Bỏ qua repo nguồn của chính kit (tránh update --all-projects đè docs bespoke).
   if [[ -f "$ws/package.json" ]] && grep -q '"name": *"openmoneta-dev-kit"' "$ws/package.json" 2>/dev/null; then
     return 0
   fi
-  [[ -f "$HOME/.cursor/.openmoneta-version" ]] || return 0
-  local reg="$HOME/.cursor/.openmoneta-projects"
+  [[ -f "$OM_HOME/.openmoneta-version" ]] || return 0
+  local reg="$OM_HOME/.openmoneta-projects"
   local abs
   abs="$(cd "$ws" 2>/dev/null && pwd -P)" || return 0
   [[ -n "$abs" ]] || return 0
@@ -38,7 +46,7 @@ if command -v jq >/dev/null 2>&1; then
     rm -f "$WORKSPACE_FROM_INPUT/.cursor/.docs-index-read" 2>/dev/null || true
     rm -f "$WORKSPACE_FROM_INPUT/.cursor/.decisions-read" 2>/dev/null || true
   fi
-  register_project_cursor "$WORKSPACE_FROM_INPUT" 2>/dev/null || true
+  register_project "$WORKSPACE_FROM_INPUT" 2>/dev/null || true
 fi
 
 # === Summary 6 bước (~45 dòng, ~650 tokens) ===
@@ -78,12 +86,12 @@ SUMMARY='# OpenMoneta Dev Kit v1.7.0 — Quy trình 6 bước (Adaptive Planning
 
 # === Auto-check update (cache 24h) ===
 UPDATE_NOTICE=""
-VERSION_FILE="$HOME/.cursor/.openmoneta-version"
-REPO_FILE="$HOME/.cursor/.openmoneta-repo"
-CHECK_CACHE="$HOME/.cursor/.openmoneta-update-check"
+VERSION_FILE="$OM_HOME/.openmoneta-version"
+REPO_FILE="$OM_HOME/.openmoneta-repo"
+CHECK_CACHE="$OM_HOME/.openmoneta-update-check"
 
-[[ -f "$VERSION_FILE" ]] || VERSION_FILE="$HOME/.cursor/.cursor-team-dev-version"
-[[ -f "$REPO_FILE" ]] || REPO_FILE="$HOME/.cursor/.cursor-team-dev-repo"
+[[ -f "$VERSION_FILE" ]] || VERSION_FILE="$OM_HOME/.cursor-team-dev-version"
+[[ -f "$REPO_FILE" ]] || REPO_FILE="$OM_HOME/.cursor-team-dev-repo"
 
 check_update() {
   [[ -f "$VERSION_FILE" && -f "$REPO_FILE" ]] || return 0
@@ -130,7 +138,11 @@ check_update() {
 
 check_update 2>/dev/null || true
 
-FULL_CONTEXT="${SUMMARY}${UPDATE_NOTICE}"
+if [[ -n "${OPENMONETA_SKIP_SUMMARY:-}" ]]; then
+  FULL_CONTEXT="${UPDATE_NOTICE}"
+else
+  FULL_CONTEXT="${SUMMARY}${UPDATE_NOTICE}"
+fi
 
 if command -v jq >/dev/null 2>&1; then
   jq -n --arg ctx "$FULL_CONTEXT" '{

package/hooks/verify-completion.sh

@@ -107,7 +107,8 @@ for plan in $ALL_RECENT_PLANS; do
 done
 
 # === Check 6: Module README synced (BLOCK strict) ===
-LIST_MODULES_SCRIPT="$HOME/.cursor/scripts/list-affected-modules.sh"
+# OPENMONETA_HOME: adapter Claude Code set về ~/.claude; default giữ Cursor.
+LIST_MODULES_SCRIPT="${OPENMONETA_HOME:-$HOME/.cursor}/scripts/list-affected-modules.sh"
 AFFECTED=""
 if [[ -x "$LIST_MODULES_SCRIPT" || -f "$LIST_MODULES_SCRIPT" ]]; then
   AFFECTED=$(bash "$LIST_MODULES_SCRIPT" "$CHANGES_FILE" 2>/dev/null || true)

package/install-claude-code.sh

@@ -0,0 +1,262 @@
+#!/usr/bin/env bash
+# install-claude-code.sh - Cài OpenMoneta Dev Kit vào ~/.claude/ (Claude Code).
+#
+# KHÁC install-opencode.sh một điểm CHỦ ĐÍCH: ~/.claude/ là thư mục sống của user
+# (settings, sessions, skills/agents riêng) → installer copy THEO MANIFEST từng item,
+# TUYỆT ĐỐI không rm -rf thư mục chuẩn (skills/, agents/) của Claude Code.
+#
+# Usage:
+#   bash install-claude-code.sh                # Cài bình thường (interactive confirm)
+#   bash install-claude-code.sh --yes          # Cài không hỏi xác nhận
+#   bash install-claude-code.sh --no-backup    # Skip backup (không khuyến nghị)
+
+set -euo pipefail
+
+AUTO_YES=0
+DO_BACKUP=1
+for arg in "$@"; do
+  case "$arg" in
+    --yes|-y) AUTO_YES=1 ;;
+    --no-backup) DO_BACKUP=0 ;;
+    --help|-h)
+      grep '^#' "$0" | sed 's/^# \?//' | head -12
+      exit 0
+      ;;
+  esac
+done
+
+REPO_DIR="$(cd "$(dirname "$0")" && pwd)"
+CLAUDE_DIR="$HOME/.claude"
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+BACKUP_DIR="$CLAUDE_DIR/.backup-openmoneta-$TIMESTAMP"
+MANIFEST="$CLAUDE_DIR/.openmoneta-manifest"
+
+echo "==> OpenMoneta Dev Kit Installer for Claude Code"
+echo "    Source: $REPO_DIR"
+echo "    Target: $CLAUDE_DIR"
+echo ""
+
+if [[ ! -f "$REPO_DIR/VERSION" ]]; then
+  echo "[!] Không phải repo OpenMoneta Dev Kit (thiếu VERSION). Abort." >&2
+  exit 1
+fi
+NEW_VERSION=$(cat "$REPO_DIR/VERSION")
+
+case "$(uname -s)" in
+  Darwin*|Linux*) ;;
+  *)
+    echo "[!] OS $(uname -s) chưa hỗ trợ cho Claude Code installer (Windows: planned)." >&2
+    exit 1
+    ;;
+esac
+
+for required in bash cp mkdir rm python3; do
+  command -v "$required" >/dev/null 2>&1 || {
+    echo "[!] Thiếu dependency: $required" >&2
+    exit 1
+  }
+done
+
+if ! command -v jq >/dev/null 2>&1; then
+  echo "[!] CẢNH BÁO: máy thiếu 'jq'. Hooks enforcement sẽ FAIL-OPEN (không chặn gì)."
+  echo "    Cài jq để enforcement hoạt động: brew install jq (macOS) / apt install jq (Linux)."
+  echo ""
+fi
+
+# Pre-flight: settings.json phải là JSON hợp lệ TRƯỚC khi installer đụng bất cứ gì
+# (nếu để đến bước merge mới abort thì manifest cũ đã bị dọn → artifacts mồ côi).
+if [[ -f "$CLAUDE_DIR/settings.json" ]]; then
+  if ! python3 -c 'import json,sys; json.load(open(sys.argv[1]))' "$CLAUDE_DIR/settings.json" 2>/dev/null; then
+    echo "[!] ABORT: $CLAUDE_DIR/settings.json không phải JSON hợp lệ." >&2
+    echo "    Sửa file rồi chạy lại installer. Chưa có gì bị thay đổi." >&2
+    exit 1
+  fi
+fi
+
+VERSION_FILE="$CLAUDE_DIR/.openmoneta-version"
+REPO_FILE="$CLAUDE_DIR/.openmoneta-repo"
+INSTALL_FILE="$CLAUDE_DIR/.openmoneta-installed-at"
+
+EXISTING_VERSION=""
+if [[ -f "$VERSION_FILE" ]]; then
+  EXISTING_VERSION=$(cat "$VERSION_FILE" 2>/dev/null || echo "unknown")
+fi
+
+if [[ -n "$EXISTING_VERSION" ]]; then
+  echo "Phát hiện OpenMoneta Dev Kit for Claude Code hiện tại: v$EXISTING_VERSION → sẽ cập nhật lên v$NEW_VERSION"
+else
+  echo "Cài đặt mới OpenMoneta Dev Kit for Claude Code: v$NEW_VERSION"
+fi
+
+if [[ -d "$CLAUDE_DIR" && $DO_BACKUP -eq 1 ]]; then
+  echo "Backup các item bị đụng vào: $BACKUP_DIR"
+fi
+
+if [[ $AUTO_YES -eq 0 ]]; then
+  read -r -p "Tiếp tục? [y/N] " ans
+  if [[ "$ans" != "y" && "$ans" != "Y" ]]; then
+    echo "Hủy."
+    exit 0
+  fi
+fi
+
+mkdir -p "$CLAUDE_DIR"
+
+# === Backup: chỉ backup những item installer sẽ đụng ===
+if [[ $DO_BACKUP -eq 1 ]]; then
+  echo ""
+  echo "==> Backup..."
+  mkdir -p "$BACKUP_DIR"
+  for item in settings.json templates scripts .openmoneta-version .openmoneta-manifest; do
+    src="$CLAUDE_DIR/$item"
+    if [[ -e "$src" ]]; then
+      cp -R "$src" "$BACKUP_DIR/"
+      echo "  + $item"
+    fi
+  done
+  if [[ -d "$CLAUDE_DIR/hooks/openmoneta" ]]; then
+    mkdir -p "$BACKUP_DIR/hooks"
+    cp -R "$CLAUDE_DIR/hooks/openmoneta" "$BACKUP_DIR/hooks/"
+    echo "  + hooks/openmoneta"
+  fi
+  if [[ -z "$(ls -A "$BACKUP_DIR" 2>/dev/null)" ]]; then
+    rmdir "$BACKUP_DIR" 2>/dev/null || true
+    echo "  (không có gì để backup)"
+  fi
+fi
+
+# === Dọn bản cài cũ theo manifest (clean update — chỉ xóa item kit đã cài) ===
+if [[ -f "$MANIFEST" ]]; then
+  echo ""
+  echo "==> Dọn bản cài cũ (theo manifest)..."
+  while IFS= read -r item; do
+    [[ -z "$item" ]] && continue
+    case "$item" in
+      /*|*..*) continue ;;  # chỉ chấp nhận path tương đối an toàn
+    esac
+    if [[ -e "$CLAUDE_DIR/$item" ]]; then
+      rm -rf "${CLAUDE_DIR:?}/$item"
+    fi
+  done < "$MANIFEST"
+  rm -f "$MANIFEST"
+fi
+
+echo ""
+echo "==> Cài OpenMoneta config cho Claude Code..."
+
+NEW_MANIFEST_ITEMS=()
+
+# Skills: copy từng skill của kit vào ~/.claude/skills/<name>/ (giữ skill riêng của user).
+mkdir -p "$CLAUDE_DIR/skills"
+for skill_dir in "$REPO_DIR/skills/"*/; do
+  name=$(basename "$skill_dir")
+  rm -rf "${CLAUDE_DIR:?}/skills/$name"
+  cp -R "$skill_dir" "$CLAUDE_DIR/skills/$name"
+  NEW_MANIFEST_ITEMS+=("skills/$name")
+done
+echo "  + skills/ ($(ls "$REPO_DIR/skills" | wc -l | tr -d ' ') skill của kit; skill riêng của bạn giữ nguyên)"
+
+# Agents: copy từng file (giữ agent riêng của user).
+mkdir -p "$CLAUDE_DIR/agents"
+for agent_file in "$REPO_DIR/claude/agents/"*.md; do
+  name=$(basename "$agent_file")
+  cp "$agent_file" "$CLAUDE_DIR/agents/$name"
+  NEW_MANIFEST_ITEMS+=("agents/$name")
+done
+echo "  + agents/ (4 subagent của kit; agent riêng của bạn giữ nguyên)"
+
+# Hooks: adapters + core (bash hooks gốc dùng chung với Cursor) — thư mục kit-owned.
+rm -rf "$CLAUDE_DIR/hooks/openmoneta"
+mkdir -p "$CLAUDE_DIR/hooks/openmoneta/core"
+cp "$REPO_DIR/claude/hooks/"*.sh "$CLAUDE_DIR/hooks/openmoneta/"
+cp "$REPO_DIR/hooks/"*.sh "$CLAUDE_DIR/hooks/openmoneta/core/"
+chmod +x "$CLAUDE_DIR/hooks/openmoneta/"*.sh "$CLAUDE_DIR/hooks/openmoneta/core/"*.sh
+NEW_MANIFEST_ITEMS+=("hooks/openmoneta")
+echo "  + hooks/openmoneta/ (5 adapter + 5 core hook)"
+
+# Templates + scripts (kit-owned, cần cho init-project.sh chạy độc lập không cần Cursor).
+rm -rf "$CLAUDE_DIR/templates"
+cp -R "$REPO_DIR/templates" "$CLAUDE_DIR/templates"
+NEW_MANIFEST_ITEMS+=("templates")
+echo "  + templates/"
+
+rm -rf "$CLAUDE_DIR/scripts"
+cp -R "$REPO_DIR/scripts" "$CLAUDE_DIR/scripts"
+chmod +x "$CLAUDE_DIR/scripts/"*.sh 2>/dev/null || true
+NEW_MANIFEST_ITEMS+=("scripts")
+echo "  + scripts/"
+
+# === Merge hooks config vào settings.json (idempotent, không đè key user) ===
+SETTINGS="$CLAUDE_DIR/settings.json"
+FRAGMENT="$REPO_DIR/claude/settings-hooks.json"
+
+python3 - "$SETTINGS" "$FRAGMENT" <<'PYEOF'
+import json, sys, os
+
+settings_path, fragment_path = sys.argv[1], sys.argv[2]
+
+with open(fragment_path) as f:
+    fragment = json.load(f)
+
+settings = {}
+if os.path.exists(settings_path):
+    try:
+        with open(settings_path) as f:
+            settings = json.load(f)
+    except (json.JSONDecodeError, ValueError) as e:
+        # KHÔNG đè file hỏng/không parse được — user tự sửa rồi chạy lại.
+        print(f"  [!] ABORT: không parse được {settings_path}: {e}", file=sys.stderr)
+        print("      Sửa file (JSON hợp lệ) rồi chạy lại installer. Chưa có gì bị ghi đè.", file=sys.stderr)
+        sys.exit(1)
+
+hooks = settings.setdefault("hooks", {})
+
+def entry_commands(entry):
+    return {h.get("command") for h in entry.get("hooks", []) if isinstance(h, dict)}
+
+added = 0
+for event, frag_entries in fragment.get("hooks", {}).items():
+    existing = hooks.setdefault(event, [])
+    if not isinstance(existing, list):
+        print(f"  [!] ABORT: settings.json hooks.{event} không phải list — không merge được.", file=sys.stderr)
+        sys.exit(1)
+    existing_cmds = set()
+    for e in existing:
+        if isinstance(e, dict):
+            existing_cmds |= entry_commands(e)
+    for fe in frag_entries:
+        if entry_commands(fe) & existing_cmds:
+            continue  # đã có (idempotent)
+        existing.append(fe)
+        added += 1
+
+with open(settings_path, "w") as f:
+    json.dump(settings, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+
+print(f"  + settings.json (merge hooks: {added} entry mới, key user giữ nguyên)")
+PYEOF
+
+# === Ghi manifest + version files ===
+printf '%s\n' "${NEW_MANIFEST_ITEMS[@]}" > "$MANIFEST"
+echo "$NEW_VERSION" > "$VERSION_FILE"
+echo "$REPO_DIR" > "$REPO_FILE"
+date -Iseconds > "$INSTALL_FILE"
+
+echo ""
+echo "================================================"
+echo "✅ Cài đặt thành công OpenMoneta Dev Kit for Claude Code v$NEW_VERSION"
+echo "================================================"
+echo ""
+echo "Đã cài vào: $CLAUDE_DIR/ (theo manifest: $MANIFEST)"
+if [[ $DO_BACKUP -eq 1 && -d "$BACKUP_DIR" ]]; then
+  echo "Backup tại: $BACKUP_DIR/"
+fi
+echo ""
+echo "Bước tiếp theo:"
+echo "  1. Mở project cần dùng Claude Code."
+echo "  2. Chạy: OPENMONETA_HOME=$CLAUDE_DIR bash $CLAUDE_DIR/scripts/init-project.sh ."
+echo "     (hoặc: openmoneta init --claude)"
+echo "  3. RESTART Claude Code (hooks chỉ được nạp lúc session start; kiểm tra bằng /hooks)."
+echo ""
+echo "Lưu ý: project-level CLAUDE.md import @AGENTS.md — AGENTS.md là source of truth."

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "openmoneta-dev-kit",
-  "version": "2.2.0",
-  "description": "OpenMoneta Dev Kit — Biến Cursor IDE / OpenCode thành team developer hoàn chỉnh với quy trình 6 bước, adaptive planning, hooks enforcement, và token-aware doc routing",
+  "version": "2.3.0",
+  "description": "OpenMoneta Dev Kit — Biến Cursor IDE / OpenCode / Claude Code thành team developer hoàn chỉnh với quy trình 6 bước, adaptive planning, hooks enforcement, và token-aware doc routing",
   "keywords": [
     "cursor",
     "opencode",
+    "claude-code",
     "ai",
     "developer-tools",
     "workflow",
@@ -29,8 +30,10 @@
     "hooks/",
     "scripts/",
     "opencode/",
+    "claude/",
     "install.sh",
     "install-opencode.sh",
+    "install-claude-code.sh",
     "install.ps1",
     "install-opencode.ps1",
     "uninstall.sh",

package/scripts/init-project.sh

@@ -377,6 +377,29 @@ sync_opencode_project_guard() {
   rm -rf ".opencode/plugins" ".opencode/plugin" 2>/dev/null || true
 }
 
+sync_claude_md() {
+  # Claude Code KHÔNG đọc AGENTS.md natively → cần shim CLAUDE.md import @AGENTS.md
+  # (khuyến nghị chính thức Anthropic; AGENTS.md vẫn là source of truth chung 3 platform).
+  # CHỈ tạo khi init chạy cho Claude Code home (openmoneta init --claude) — tránh sinh
+  # file lạ trong repo của team không dùng Claude Code.
+  if [[ "$OPENMONETA_HOME" != "$HOME/.claude" ]]; then
+    return 0
+  fi
+  local dst="CLAUDE.md"
+  if [[ -f "$dst" ]]; then
+    if grep -qE '^@AGENTS\.md' "$dst" 2>/dev/null; then
+      SKIPPED+=("file: CLAUDE.md (đã import @AGENTS.md)")
+    else
+      SKIPPED+=("file: CLAUDE.md (đã có sẵn — KHÔNG đè; thêm dòng '@AGENTS.md' thủ công để dùng chung quy trình OpenMoneta)")
+    fi
+    return 0
+  fi
+  cat > "$dst" <<'EOF'
+@AGENTS.md
+EOF
+  CREATED+=("file: CLAUDE.md (import @AGENTS.md)")
+}
+
 # === Bước 1: Tạo cấu trúc thư mục tối thiểu ===
 echo "==> Tạo thư mục tối thiểu..."
 ensure_dir "docs"
@@ -394,6 +417,7 @@ sync_docs_index
 sync_decisions_index
 sync_plans_index
 sync_opencode_project_guard
+sync_claude_md
 
 # === Bước 3: .gitignore với patterns chuẩn ===
 echo "==> Update .gitignore..."
@@ -407,6 +431,7 @@ PATTERNS=(
   ".cursor/.changelog-baseline"
   ".cursor/.last-test-result"
   ".cursor/.ui-session.json"
+  ".cursor/.claude-stop-loop-*.json"
 )
 
 if [[ ! -f "$GITIGNORE" ]]; then

package/skills/automated-testing/SKILL.md

@@ -15,6 +15,8 @@ Chạy script tự động (idempotent):
 bash ~/.cursor/skills/automated-testing/scripts/install-playwright.sh
 ```
 
+> OpenCode/Claude Code: script cùng path trong `~/.config/opencode/skills/` / `~/.claude/skills/`.
+
 Script sẽ:
 1. Detect package manager (`npm`/`pnpm`/`yarn`/`bun`).
 2. Cài `@playwright/test` + `dotenv`.

package/skills/automated-testing/scripts/install-playwright.sh

@@ -42,7 +42,10 @@ echo "==> Cài Chromium browser cho Playwright..."
 npx playwright install chromium --with-deps 2>/dev/null || npx playwright install chromium
 
 # Copy playwright.config.ts từ template nếu chưa có
+# Tìm template theo platform đã cài (Cursor → OpenCode → Claude Code).
 TEMPLATE="$HOME/.cursor/templates/playwright.config.ts.tpl"
+[[ -f "$TEMPLATE" ]] || TEMPLATE="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/templates/playwright.config.ts.tpl"
+[[ -f "$TEMPLATE" ]] || TEMPLATE="$HOME/.claude/templates/playwright.config.ts.tpl"
 TARGET="playwright.config.ts"
 if [[ -f "$TARGET" ]]; then
   echo "==> $TARGET đã tồn tại, skip."

package/skills/decision-recorder/SKILL.md

@@ -36,7 +36,7 @@ KHÔNG ĐẢO NGƯỢC một kiến trúc đã Accepted (LOCKED) khi CHƯA:
 ## Cách tạo ADR mới
 
 1. Đọc `docs/decisions/INDEX.md` để biết số ADR lớn nhất hiện có → `NNNN` mới = max + 1 (4 chữ số).
-2. Copy template `~/.cursor/templates/adr.md.tpl` (hoặc `~/.config/opencode/templates/adr.md.tpl`) → `docs/decisions/NNNN-<slug>.md`.
+2. Copy template `~/.cursor/templates/adr.md.tpl` (OpenCode: `~/.config/opencode/templates/adr.md.tpl`; Claude Code: `~/.claude/templates/adr.md.tpl`) → `docs/decisions/NNNN-<slug>.md`.
 3. Điền 5 section: Context, Decision, **Rejected alternatives (kèm root cause)**, Consequences (known limitations), Failed approaches log.
 4. Điền field: `Status: Accepted (LOCKED)`, `Date`, `Module(s)`, `Plan nguồn` (link plan archive nếu có — đây là **tầng chi tiết**), `Supersedes` (nếu thay ADR cũ).
 5. Cập nhật bảng trong `docs/decisions/INDEX.md`.

package/skills/docs-maintenance/SKILL.md

@@ -60,6 +60,8 @@ bash ~/.cursor/scripts/docs-audit.sh --worklist    # MISSING/STALE/ok (TSV: slug
 bash ~/.cursor/scripts/docs-audit.sh --validate     # liệt kê GHOST (doc/INDEX trỏ source/module đã mất)
 ```
 
+> Đường dẫn script theo platform: Cursor `~/.cursor/scripts/`, OpenCode `~/.config/opencode/scripts/`, Claude Code `~/.claude/scripts/`.
+
 (OpenCode: `~/.config/opencode/scripts/docs-audit.sh`.) **BẮT BUỘC chạy cả `--validate`** ở mọi mode để không bỏ sót ghost. Mode `audit` in cả 2 kết quả rồi dừng, không qua các bước tạo/sửa dưới.
 
 ### 2. (Repo lớn) đọc song song
@@ -117,7 +119,7 @@ Cho mỗi file LEGACY:
 
 1. **Đọc file legacy** — nó ĐÃ CÓ rationale thật. KHÔNG suy diễn từ code.
 2. Xác định `NNNN` mới = max ADR hiện có trong INDEX + 1 (4 chữ số).
-3. Tạo `docs/decisions/NNNN-<slug>.md` theo `~/.cursor/templates/adr.md.tpl`, **map nội dung có sẵn** vào 5 section (Context/Decision/Rejected alternatives/Consequences/Failed approaches log). Phần nào file cũ KHÔNG có → để trống + ghi `(legacy: không ghi rõ)`, KHÔNG chế ra.
+3. Tạo `docs/decisions/NNNN-<slug>.md` theo `~/.cursor/templates/adr.md.tpl` (OpenCode/Claude Code: `templates/adr.md.tpl` trong home tương ứng), **map nội dung có sẵn** vào 5 section (Context/Decision/Rejected alternatives/Consequences/Failed approaches log). Phần nào file cũ KHÔNG có → để trống + ghi `(legacy: không ghi rõ)`, KHÔNG chế ra.
 4. Field: `Status` (giữ theo file cũ nếu có, mặc định `Accepted (LOCKED)`), `Date` (lấy từ tên file/nội dung cũ), `Module(s)` (nếu suy được từ nội dung), `Plan nguồn: —`.
 5. Xóa file legacy cũ (đã chuyển nội dung) — hoặc nếu format cũ là chuẩn nội bộ của dự án, hỏi user trước khi xóa.
 6. Thêm dòng vào bảng `INDEX.md`.

package/skills/module-architect/SKILL.md

@@ -190,7 +190,7 @@ Quy ước slug:
 | `src/modules/auth/...` | `auth` | `docs/modules/auth/` |
 | `src/auth/...` (single-repo, không có `modules/`) | `auth` | `docs/modules/auth/` |
 
-> Helper: `bash ~/.cursor/scripts/list-affected-modules.sh .cursor/.session-changes.json` infer slug từ file đã sửa.
+> Helper: `bash ~/.cursor/scripts/list-affected-modules.sh .cursor/.session-changes.json` infer slug từ file đã sửa (OpenCode/Claude Code: script cùng tên trong `~/.config/opencode/scripts/` / `~/.claude/scripts/`).
 
 ### Bước 2.2 — Backfill khi chạm vào module chưa có docs
 
@@ -229,7 +229,7 @@ Quy tắc maintenance:
 | `src/modules/auth/z.ts` | `auth` | `docs/modules/auth/` |
 | `src/auth/z.ts` (no `modules/`) | `auth` | `docs/modules/auth/` |
 
-> Helper script: `bash ~/.cursor/scripts/list-affected-modules.sh .cursor/.session-changes.json`.
+> Helper script: `bash ~/.cursor/scripts/list-affected-modules.sh .cursor/.session-changes.json` (OpenCode/Claude Code: script cùng tên trong home tương ứng).
 
 **Workflow cho mỗi module slug**:
 

package/src/commands/init.js

@@ -1,15 +1,18 @@
 const { execSync } = require("node:child_process")
 const path = require("node:path")
-const { getPkgRoot, OPENCODE_DIR, isWindows } = require("../lib/paths")
+const { getPkgRoot, OPENCODE_DIR, CLAUDE_DIR, isWindows } = require("../lib/paths")
 
 async function run(args) {
   let projectDir = process.cwd()
   let isOpenCode = false
+  let isClaude = false
   const remaining = []
 
   for (const arg of args) {
     if (arg === "--opencode") {
       isOpenCode = true
+    } else if (arg === "--claude") {
+      isClaude = true
     } else if (arg.startsWith("-")) {
       remaining.push(arg)
     } else {
@@ -27,6 +30,9 @@ async function run(args) {
   if (isOpenCode) {
     env.OPENMONETA_HOME = OPENCODE_DIR
     console.log(`  Mode: OpenCode`)
+  } else if (isClaude) {
+    env.OPENMONETA_HOME = CLAUDE_DIR
+    console.log(`  Mode: Claude Code`)
   }
 
   const shellCmd = isWindows()

package/src/commands/install.js

@@ -7,15 +7,21 @@ async function run(args) {
   const autoYes = args.includes("--yes") || args.includes("-y")
   const cursorOnly = args.includes("--cursor")
   const opencodeOnly = args.includes("--opencode")
-  const both = !cursorOnly && !opencodeOnly
+  const claudeOnly = args.includes("--claude")
+  // Default (không flag) giữ Cursor + OpenCode như trước. Claude Code là opt-in
+  // qua --claude để không tạo ~/.claude trên máy không dùng Claude Code.
+  const both = !cursorOnly && !opencodeOnly && !claudeOnly
 
   const v = getLocalVersion() || "unknown"
   const pkgRoot = getPkgRoot()
 
   if (both) {
     console.log(`\n  🔧 Cài OpenMoneta Dev Kit v${v} cho Cursor + OpenCode`)
+    console.log(`     (Claude Code: opt-in, chạy thêm: openmoneta install --claude)`)
   } else if (cursorOnly) {
     console.log(`\n  🔧 Cài OpenMoneta Dev Kit v${v} cho Cursor`)
+  } else if (claudeOnly) {
+    console.log(`\n  🔧 Cài OpenMoneta Dev Kit v${v} cho Claude Code`)
   } else {
     console.log(`\n  🔧 Cài OpenMoneta Dev Kit v${v} cho OpenCode`)
   }
@@ -44,7 +50,20 @@ async function run(args) {
     }
   }
 
-  console.log(`\n  🎉 Hoàn tất. Restart Cursor/OpenCode để áp dụng.`)
+  if (claudeOnly) {
+    try {
+      const flags = autoYes ? "--yes" : ""
+      // Chưa có install-claude-code.ps1 — Windows defer (xem plan 2026-06-11).
+      const cmd = `bash "${path.join(pkgRoot, "install-claude-code.sh")}" ${flags}`.trim()
+      console.log(`\n  ▶ Claude Code...`)
+      execSync(cmd, { stdio: "inherit", cwd: pkgRoot })
+      console.log(`  ✅ Claude Code done.`)
+    } catch (err) {
+      console.error(`  ❌ Claude Code failed: ${err.message}`)
+    }
+  }
+
+  console.log(`\n  🎉 Hoàn tất. Restart Cursor/OpenCode/Claude Code để áp dụng.`)
 }
 
 module.exports = { run }

package/src/commands/uninstall.js

@@ -1,7 +1,7 @@
-const { unlinkSync, rmdirSync, existsSync, readdirSync, lstatSync } = require("node:fs")
+const { unlinkSync, rmdirSync, existsSync, readdirSync, lstatSync, readFileSync, writeFileSync } = require("node:fs")
 const path = require("node:path")
 const { execSync } = require("node:child_process")
-const { CURSOR_DIR, OPENCODE_DIR, isInstalled, getPkgRoot, isWindows, runScript } = require("../lib/paths")
+const { CURSOR_DIR, OPENCODE_DIR, CLAUDE_DIR, isInstalled, getPkgRoot, isWindows, runScript } = require("../lib/paths")
 
 function rmDir(dir) {
   if (!existsSync(dir)) return
@@ -20,6 +20,55 @@ function rmFile(p) {
   if (existsSync(p)) unlinkSync(p)
 }
 
+// ~/.claude chứa data + skills/agents riêng của user → KHÔNG xóa nguyên thư mục.
+// Chỉ xóa đúng item kit đã cài (theo .openmoneta-manifest) + gỡ hooks entries
+// openmoneta khỏi settings.json.
+function uninstallClaude() {
+  if (!existsSync(CLAUDE_DIR)) return
+
+  const manifest = path.join(CLAUDE_DIR, ".openmoneta-manifest")
+  if (existsSync(manifest)) {
+    const items = readFileSync(manifest, "utf8")
+      .split("\n")
+      .map((l) => l.trim())
+      .filter(Boolean)
+    for (const item of items) {
+      const p = path.join(CLAUDE_DIR, item)
+      // Manifest chỉ chứa path tương đối bên trong ~/.claude.
+      if (!p.startsWith(CLAUDE_DIR + path.sep)) continue
+      if (existsSync(p)) {
+        if (lstatSync(p).isDirectory()) rmDir(p)
+        else unlinkSync(p)
+      }
+    }
+    unlinkSync(manifest)
+  }
+
+  const settingsFile = path.join(CLAUDE_DIR, "settings.json")
+  if (existsSync(settingsFile)) {
+    try {
+      const settings = JSON.parse(readFileSync(settingsFile, "utf8"))
+      if (settings.hooks && typeof settings.hooks === "object") {
+        const isOpenmonetaEntry = (entry) =>
+          Array.isArray(entry.hooks) && entry.hooks.some((h) => typeof h.command === "string" && h.command.includes("hooks/openmoneta/"))
+        for (const event of Object.keys(settings.hooks)) {
+          if (!Array.isArray(settings.hooks[event])) continue
+          settings.hooks[event] = settings.hooks[event].filter((e) => !isOpenmonetaEntry(e))
+          if (settings.hooks[event].length === 0) delete settings.hooks[event]
+        }
+        if (Object.keys(settings.hooks).length === 0) delete settings.hooks
+      }
+      writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + "\n")
+    } catch {
+      console.warn(`  ⚠ Không parse được ${settingsFile} — giữ nguyên, gỡ hooks openmoneta thủ công nếu cần.`)
+    }
+  }
+
+  for (const f of [".openmoneta-version", ".openmoneta-repo", ".openmoneta-installed-at", ".openmoneta-update-check"]) {
+    rmFile(path.join(CLAUDE_DIR, f))
+  }
+}
+
 async function run(args) {
   const purge = args.includes("--purge")
   const autoYes = args.includes("--yes") || args.includes("-y")
@@ -75,8 +124,10 @@ async function run(args) {
     rmFile(path.join(dir, "AGENTS.md"))
   }
 
+  uninstallClaude()
+
   console.log(`\n  ✅ Đã gỡ cài đặt.`)
-  console.log(`     Restart Cursor/OpenCode để hoàn tất.`)
+  console.log(`     Restart Cursor/OpenCode/Claude Code để hoàn tất.`)
 }
 
 module.exports = { run }