evnict-kit 0.2.2 → 0.2.3

package/README.md

@@ -158,6 +158,7 @@ evnict-kit init-rules --tool=cursor
 | `evnict-kit doctor` | 🩺 Kiểm tra môi trường, phiên bản, cập nhật |
 | `evnict-kit info` | 📊 Thống kê chi tiết toolkit |
 | `evnict-kit upgrade` | 🔄 Kiểm tra & cập nhật phiên bản mới nhất |
+| `evnict-kit sync` | 🔄 Re-deploy templates vào các project — ghi đè files evnict-kit, giữ nguyên files user |
 
 ### Lệnh Agent (gõ trong AI Agent chat)
 
@@ -281,7 +282,7 @@ FE: Đọc handoff.md → implement → update 🟢 Đã xử lý
 | Metric | Count |
 |--------|-------|
 | Rule Sets | 5 |
-| Skills | 22 |
+| Skills | 23 |
 | Workflows | 17 |
 | Supported AI Tools | 5 |
 | Tech Stacks (BE) | SpringBoot · ASP.NET · Java EE |
@@ -305,7 +306,14 @@ FE: Đọc handoff.md → implement → update 🟢 Đã xử lý
 
 ## 📜 Changelog
 
-### v0.2.2 (Current)
+### v0.2.3 (Current)
+- 🎨 **Frontend Design Skill**: Skill mới `evnict-kit-frontend-design` — hướng dẫn tư duy thiết kế UI chất lượng cao cho Angular, tránh "AI slop" aesthetics
+- 🧠 **Context Refresh**: Thêm section "Tuân thủ Rules & Context" vào TẤT CẢ 36 workflows/skills — cơ chế smart check (chỉ đọc lại nếu chưa đọc, tiết kiệm token)
+- 🎯 **FE Design Hint**: 6 workflows có code FE được bổ sung nhắc tham chiếu skill frontend-design
+- 🔄 **Sync Command**: Lệnh `evnict-kit sync` — re-deploy templates khi upgrade version, không xóa files user tự thêm
+- 📦 Hỗ trợ cả Antigravity + Claude workflows
+
+### v0.2.2
 - 🧹 Removed obsolete standalone commands (`init-rules`, `init-context`, `init-workflow`, `init-check`)
 - 🩺 `doctor` command: health check, version check, workspace status
 - 📊 `info` command: toolkit statistics dashboard

package/bin/cli.js

@@ -5,9 +5,10 @@ import { addCommand } from '../src/commands/add.js';
 import { doctorCommand } from '../src/commands/doctor.js';
 import { infoCommand } from '../src/commands/info.js';
 import { upgradeCommand } from '../src/commands/upgrade.js';
+import { syncCommand } from '../src/commands/sync.js';
 
 const program = new Command();
-program.name('evnict-kit').description('EVNICT AI-Assisted Development Toolkit v0.2.2').version('0.2.2');
+program.name('evnict-kit').description('EVNICT AI-Assisted Development Toolkit v0.2.3').version('0.2.3');
 
 program.command('init')
   .description('Khoi tao workspace + deploy rules/skills/workflows vao tung project')
@@ -43,4 +44,9 @@ program.command('upgrade')
   .option('-y, --yes', 'Auto-confirm upgrade')
   .action(upgradeCommand);
 
+program.command('sync')
+  .description('Re-deploy templates (workflows/skills/rules) vao cac project da init — ghi de files evnict-kit, giu nguyen files user')
+  .option('-y, --yes', 'Auto-confirm sync (khong hoi)')
+  .action(syncCommand);
+
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evnict-kit",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "EVNICT AI-Assisted Development Toolkit - Bộ công cụ hỗ trợ phát triển phần mềm với AI theo quy định QĐ-TTPM",
   "type": "module",
   "bin": {

package/scripts/patch-workflows.js

@@ -0,0 +1,142 @@
+/**
+ * Patch script: Add Context Refresh + FE Design hint to all workflows
+ * Run: node scripts/patch-workflows.js
+ */
+import { readFileSync, writeFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const TEMPLATES_DIR = join(import.meta.dirname, '..', 'templates');
+
+// ═══════════════════════════════════════════
+// Context Refresh block (smart check mechanism)
+// ═══════════════════════════════════════════
+const CONTEXT_REFRESH = `
+---
+
+## ⚠️ NHẮC NHỞ: Tuân thủ Rules & Context
+
+> **Agent dùng lâu có thể quên rules.** Trước khi bắt đầu code, tự kiểm tra:
+
+### Quick Check (agent tự đánh giá)
+1. ✅ Tôi đã đọc \`.agent/rules/\` trong phiên làm việc này chưa?
+2. ✅ Tôi đã đọc AGENTS.md (hoặc context file) chưa?
+3. ✅ Tôi nhớ rõ coding conventions của dự án này không?
+
+**→ Nếu BẤT KỲ câu nào = "CHƯA" hoặc "KHÔNG CHẮC":**
+- Đọc lại tất cả files trong \`.agent/rules/\` (hoặc thư mục rules tương ứng)
+- Đọc lại AGENTS.md (hoặc context file tương ứng)
+- Query wiki nếu có: \`grep -rl "{keyword}" {wiki_path}/processed/ --include="*.md"\`
+
+**→ Nếu TẤT CẢ = "RỒI" → tiếp tục workflow, KHÔNG cần đọc lại.**
+
+> **NGUYÊN TẮC:** Không chắc convention → ĐỌC LẠI rule file. KHÔNG đoán.
+`;
+
+// ═══════════════════════════════════════════
+// FE Design hint block
+// ═══════════════════════════════════════════
+const FE_DESIGN_HINT = `
+> 🎨 **FE UI Quality:** Khi tạo/sửa UI component, tham khảo skill \`evnict-kit-frontend-design\`
+> để đảm bảo chất lượng thiết kế cao. Áp dụng Design Thinking (Purpose → Tone → Constraints → Differentiation) trước khi code UI.
+`;
+
+// ═══════════════════════════════════════════
+// Files that need FE Design hint (in addition to Context Refresh)
+// ═══════════════════════════════════════════
+const FE_HINT_FILES = [
+  'evnict-kit-feature-small.md',
+  'evnict-kit-feature-large.md',
+  'evnict-kit-implement.md',
+  'evnict-kit-plan.md',
+  'evnict-kit-handoff.md',
+  'evnict-kit-bug-fix.md',
+];
+
+// ═══════════════════════════════════════════
+// Process workflow files in a tool directory
+// ═══════════════════════════════════════════
+function patchFile(filePath, addFeHint) {
+  let content = readFileSync(filePath, 'utf8');
+  
+  // Skip if already patched
+  if (content.includes('NHẮC NHỞ: Tuân thủ Rules & Context')) {
+    console.log(`   ⏭️  Already patched: ${filePath}`);
+    return false;
+  }
+
+  // Find the insertion point — before "## Checklist" or "## Tiêu chí" at the end
+  const checklistPatterns = [
+    /\n## Checklist[^\n]*\n/,
+    /\n## Checklist hoàn thành[^\n]*\n/,
+    /\n## Tiêu chí hoàn thành[^\n]*\n/,
+    /\n## Tiêu chí thành công[^\n]*\n/,
+    /\n## Output[^\n]*\n/,
+  ];
+
+  let insertPos = -1;
+  for (const pattern of checklistPatterns) {
+    const match = content.match(pattern);
+    if (match) {
+      insertPos = content.lastIndexOf(match[0]);
+      break;
+    }
+  }
+
+  let insertBlock = '';
+  
+  // Add FE Design hint if applicable
+  if (addFeHint) {
+    insertBlock += FE_DESIGN_HINT;
+  }
+  
+  // Add Context Refresh
+  insertBlock += CONTEXT_REFRESH;
+
+  if (insertPos >= 0) {
+    // Insert before checklist
+    content = content.slice(0, insertPos) + insertBlock + content.slice(insertPos);
+  } else {
+    // No checklist found — append at end
+    content = content.trimEnd() + '\n' + insertBlock + '\n';
+  }
+
+  writeFileSync(filePath, content, 'utf8');
+  console.log(`   ✅ Patched: ${filePath}${addFeHint ? ' (+FE Design)' : ''}`);
+  return true;
+}
+
+// ═══════════════════════════════════════════
+// Main
+// ═══════════════════════════════════════════
+const toolDirs = ['antigravity', 'claude'];
+let patchedCount = 0;
+
+for (const tool of toolDirs) {
+  const wfDir = join(TEMPLATES_DIR, 'workflows', tool);
+  if (!existsSync(wfDir)) {
+    console.log(`⚠️  Skipping ${tool} — directory not found`);
+    continue;
+  }
+
+  console.log(`\n══ Patching ${tool} workflows ══`);
+  const files = readdirSync(wfDir).filter(f => f.endsWith('.md') && f !== 'README.md');
+  
+  for (const file of files) {
+    const addFeHint = FE_HINT_FILES.includes(file);
+    const patched = patchFile(join(wfDir, file), addFeHint);
+    if (patched) patchedCount++;
+  }
+}
+
+// Also patch skills
+const skillDirs = ['evnict-kit-create-component', 'evnict-kit-create-page'];
+console.log(`\n══ Patching skills ══`);
+for (const skillDir of skillDirs) {
+  const skillPath = join(TEMPLATES_DIR, 'skills', skillDir, 'SKILL.md');
+  if (existsSync(skillPath)) {
+    const patched = patchFile(skillPath, true);
+    if (patched) patchedCount++;
+  }
+}
+
+console.log(`\n✅ Done! Patched ${patchedCount} files.`);

package/scripts/postinstall.js

@@ -14,7 +14,7 @@ const c = {
   yellow: '\x1b[33m',
 };
 
-const version = '0.2.2';
+const version = '0.2.3';
 
 console.log('');
 console.log(`${c.bold}${c.cyan}  +====================================================+${c.reset}`);

package/src/commands/init.js

@@ -54,7 +54,7 @@ async function initInteractive(options) {
 
   console.log(`
 ╔═══════════════════════════════════════════╗
-║     🚀 EVNICT-KIT v0.2.2: Init Setup    ║
+║     🚀 EVNICT-KIT v0.2.3: Init Setup    ║
 ╚═══════════════════════════════════════════╝
 `);
 
@@ -223,7 +223,7 @@ async function deployWorkspace({ name, tool, repoConfigs, db, wikiEnabled, cwd }
 
   console.log(`
 ╔═══════════════════════════════════════════════════════╗
-║         🚀 EVNICT-KIT v0.2.2: Init Workspace         ║
+║         🚀 EVNICT-KIT v0.2.3: Init Workspace         ║
 ╚═══════════════════════════════════════════════════════╝
 
    Project:  ${name}
@@ -248,7 +248,7 @@ async function deployWorkspace({ name, tool, repoConfigs, db, wikiEnabled, cwd }
   writeFile(join(evnictDir, 'handoff/be-status.md'), `# BE Status\nstatus: idle\n`, {cwd,silent:true});
   writeFile(join(evnictDir, 'handoff/fe-status.md'), `# FE Status\nstatus: idle\n`, {cwd,silent:true});
 
-  // v0.2.2: Tạo handoff.md template
+  // v0.2.3: Tạo handoff.md template
   const handoffTemplate = `# Agent Handoff Log
 > File này dùng để trao đổi giữa BE Agent và FE Agent.
 > Mỗi issue ghi theo format bên dưới.
@@ -363,7 +363,7 @@ async function deployWorkspace({ name, tool, repoConfigs, db, wikiEnabled, cwd }
 
   console.log(`
 ╔═══════════════════════════════════════════════════════╗
-║  ✅  Workspace "${name}" v0.2.2 initialized!          ║
+║  ✅  Workspace "${name}" v0.2.3 initialized!          ║
 ╠═══════════════════════════════════════════════════════╣
 ║                                                       ║
 ║  Projects:                                            ║
@@ -468,7 +468,7 @@ function updateGitignore(projectPath, projectName) {
 }
 
 // ════════════════════════════════════════════════════════════════════
-// Deploy to individual project — v0.2.2 Multi-Tool Adapter Pattern
+// Deploy to individual project — v0.2.3 Multi-Tool Adapter Pattern
 // ════════════════════════════════════════════════════════════════════
 
 function deployToProject(projectPath, cwd, opts) {
@@ -678,7 +678,7 @@ function deployShared(projectPath, cwd, opts) {
     writeFile(join(projectPath, 'Instruct-Agent-AI.md'), content, {cwd});
   }
 
-  // ═══ GETTING-STARTED.md (v0.2.2) ═══
+  // ═══ GETTING-STARTED.md (v0.2.3) ═══
   const guideTemplate = join(TEMPLATES_DIR, 'GETTING-STARTED.md');
   if (existsSync(guideTemplate)) {
     let content = readFileSync(guideTemplate, 'utf8');
@@ -699,7 +699,7 @@ function genConfig(name, repoConfigs, db, tool, wiki) {
     `  - { folder: "${r.folder}", type: "${r.type}", tech: "${r.tech}" }`
   ).join('\n');
 
-  return `# EVNICT-KIT v0.2.2 Config
+  return `# EVNICT-KIT v0.2.3 Config
 project:
   name: "${name}"
 repos:

package/src/commands/sync.js

@@ -0,0 +1,317 @@
+import { existsSync, readFileSync, readdirSync, unlinkSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import readline from 'node:readline';
+import { loadConfig, getToolMap, TECH_LABELS, SUPPORTED_TOOLS } from '../utils/config.js';
+import { ensureDir, writeFile, TEMPLATES_DIR } from '../utils/file.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// ── Colors ──
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+};
+
+// ════════════════════════════════════════════════════════════════════
+// Detect evnict-kit managed files vs user files
+// evnict-kit files always start with "evnict-kit-" prefix
+// or numbered prefix like "01-evnict-kit-", "02-evnict-kit-"
+// ════════════════════════════════════════════════════════════════════
+
+function isEvnictKitFile(filename) {
+  return filename.startsWith('evnict-kit-') ||
+         /^\d{2}-evnict-kit-/.test(filename);
+}
+
+function isEvnictKitSkillDir(dirname) {
+  return dirname.startsWith('evnict-kit-');
+}
+
+// ════════════════════════════════════════════════════════════════════
+// Sync templates into a project — overwrite evnict-kit files only
+// ════════════════════════════════════════════════════════════════════
+
+function syncRules(projectPath, cwd, tool, toolMap) {
+  const rulesSrc = join(TEMPLATES_DIR, 'rules', tool);
+  const rulesDest = join(projectPath, toolMap.rulesDir);
+  if (!existsSync(rulesSrc) || !toolMap.rulesDir) return { updated: 0, skipped: 0, userFiles: [] };
+
+  ensureDir(rulesDest, cwd);
+  const srcFiles = readdirSync(rulesSrc).filter(f => f.endsWith('.md') || f.endsWith('.mdc'));
+  let updated = 0, skipped = 0;
+  const userFiles = [];
+
+  // Detect user files in dest
+  if (existsSync(rulesDest)) {
+    const destFiles = readdirSync(rulesDest).filter(f => !f.startsWith('.'));
+    for (const f of destFiles) {
+      if (!isEvnictKitFile(f) && !srcFiles.includes(f)) {
+        userFiles.push(f);
+      }
+    }
+  }
+
+  // Overwrite evnict-kit rules
+  for (const file of srcFiles) {
+    const content = readFileSync(join(rulesSrc, file), 'utf8');
+    const destPath = join(rulesDest, file);
+    const existed = existsSync(destPath);
+    writeFile(destPath, content, { overwrite: true, cwd, silent: true });
+    if (existed) {
+      updated++;
+      console.log(`      🔄 ${file}`);
+    } else {
+      updated++;
+      console.log(`      ✨ ${file} (new)`);
+    }
+  }
+
+  return { updated, skipped, userFiles };
+}
+
+function syncWorkflows(projectPath, cwd, tool, toolMap) {
+  const wfSrc = join(TEMPLATES_DIR, 'workflows', tool);
+  const wfDest = join(projectPath, toolMap.workflowsDir);
+  if (!existsSync(wfSrc) || !toolMap.workflowsDir) return { updated: 0, skipped: 0, userFiles: [] };
+
+  ensureDir(wfDest, cwd);
+  const srcFiles = readdirSync(wfSrc).filter(f => f.endsWith('.md'));
+  let updated = 0;
+  const userFiles = [];
+
+  // Detect user files in dest
+  if (existsSync(wfDest)) {
+    const destFiles = readdirSync(wfDest).filter(f => f.endsWith('.md'));
+    for (const f of destFiles) {
+      if (!isEvnictKitFile(f) && !srcFiles.includes(f) && f !== 'README.md') {
+        userFiles.push(f);
+      }
+    }
+  }
+
+  for (const file of srcFiles) {
+    const content = readFileSync(join(wfSrc, file), 'utf8');
+    const destPath = join(wfDest, file);
+    const existed = existsSync(destPath);
+    writeFile(destPath, content, { overwrite: true, cwd, silent: true });
+    if (existed) {
+      updated++;
+      console.log(`      🔄 ${file}`);
+    } else {
+      updated++;
+      console.log(`      ✨ ${file} (new)`);
+    }
+  }
+
+  return { updated, userFiles };
+}
+
+function syncSkills(projectPath, cwd, toolMap) {
+  const skillsSrc = join(TEMPLATES_DIR, 'skills');
+  if (!existsSync(skillsSrc) || !toolMap.skillsDir) return { updated: 0, newSkills: 0, userSkills: [] };
+
+  const srcDirs = readdirSync(skillsSrc, { withFileTypes: true })
+    .filter(d => d.isDirectory());
+  let updated = 0, newSkills = 0;
+  const userSkills = [];
+
+  // Detect user skills in dest
+  const skillsDest = join(projectPath, toolMap.skillsDir);
+  if (existsSync(skillsDest)) {
+    const destDirs = readdirSync(skillsDest, { withFileTypes: true })
+      .filter(d => d.isDirectory())
+      .map(d => d.name);
+    const srcNames = srcDirs.map(d => d.name);
+    for (const d of destDirs) {
+      if (!srcNames.includes(d) && !isEvnictKitSkillDir(d)) {
+        userSkills.push(d);
+      }
+    }
+  }
+
+  for (const d of srcDirs) {
+    const dest = join(projectPath, toolMap.skillsDir, d.name);
+    const existed = existsSync(dest);
+    ensureDir(dest, cwd);
+
+    // Overwrite all files in skill dir
+    const skillFiles = readdirSync(join(skillsSrc, d.name), { withFileTypes: true });
+    for (const entry of skillFiles) {
+      if (entry.isFile()) {
+        const content = readFileSync(join(skillsSrc, d.name, entry.name), 'utf8');
+        writeFile(join(dest, entry.name), content, { overwrite: true, cwd, silent: true });
+      }
+    }
+
+    if (existed) {
+      updated++;
+      console.log(`      🔄 ${d.name}/`);
+    } else {
+      newSkills++;
+      console.log(`      ✨ ${d.name}/ (new)`);
+    }
+  }
+
+  return { updated, newSkills, userSkills };
+}
+
+function syncSharedFiles(projectPath, cwd, toolMap) {
+  let updated = 0;
+
+  // GETTING-STARTED.md
+  const guideTemplate = join(TEMPLATES_DIR, 'GETTING-STARTED.md');
+  if (existsSync(guideTemplate)) {
+    const guideDest = join(projectPath, 'GETTING-STARTED.md');
+    if (existsSync(guideDest)) {
+      const content = readFileSync(guideTemplate, 'utf8');
+      // Preserve {{}} placeholders — user may have customized
+      writeFile(guideDest, content, { overwrite: true, cwd, silent: true });
+      console.log(`      🔄 GETTING-STARTED.md`);
+      updated++;
+    }
+  }
+
+  return { updated };
+}
+
+// ════════════════════════════════════════════════════════════════════
+// Main sync command
+// ════════════════════════════════════════════════════════════════════
+
+export async function syncCommand(options) {
+  const cwd = process.cwd();
+
+  // Load config
+  const config = loadConfig(cwd);
+  if (!config) {
+    console.error('❌ Không tìm thấy .evnict/config.yaml. Chạy evnict-kit init trước.');
+    process.exit(1);
+  }
+
+  const name = config.project?.name;
+  const tool = config.ai_tool || 'antigravity';
+  const repos = config.repos || [];
+
+  if (!SUPPORTED_TOOLS.includes(tool)) {
+    console.error(`❌ Tool "${tool}" chưa hỗ trợ.`);
+    process.exit(1);
+  }
+
+  const toolMap = getToolMap(tool);
+  const pkgPath = join(__dirname, '..', '..', 'package.json');
+  const version = JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+
+  console.log(`
+${c.bold}${c.cyan}╔═══════════════════════════════════════════════════════╗
+║         🔄 EVNICT-KIT v${version}: Sync Templates         ║
+╚═══════════════════════════════════════════════════════╝${c.reset}
+
+   Project: ${c.bold}${name}${c.reset}
+   Tool:    ${tool} → ${toolMap.agentDir}/
+   Repos:   ${repos.map(r => r.folder).join(', ')}
+`);
+
+  // Confirm unless --yes
+  if (!options.yes) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise(r => rl.question(
+      `${c.yellow}⚠️  Sync sẽ GHI ĐÈ tất cả files evnict-kit (workflows, skills, rules).${c.reset}
+   Files do user tự thêm sẽ KHÔNG bị xóa.
+   Tiếp tục? (y/N): `, r
+    ));
+    rl.close();
+
+    if (answer.trim().toLowerCase() !== 'y' && answer.trim().toLowerCase() !== 'yes') {
+      console.log('\n   ⏭️  Đã hủy sync.');
+      return;
+    }
+  }
+
+  console.log('');
+
+  // ── Sync each project ──
+  const summary = { totalUpdated: 0, totalNew: 0, userFiles: [] };
+
+  for (const repo of repos) {
+    const projectPath = join(cwd, repo.folder);
+    if (!existsSync(projectPath)) {
+      console.log(`   ⚠️  ${repo.folder}/ không tồn tại — skip`);
+      continue;
+    }
+
+    console.log(`${c.bold}── ${repo.type.toUpperCase()}: ${repo.folder} ──${c.reset}`);
+
+    // Rules
+    if (toolMap.rulesDir) {
+      console.log(`   📏 Rules → ${toolMap.rulesDir}/`);
+      const r = syncRules(projectPath, cwd, tool, toolMap);
+      summary.totalUpdated += r.updated;
+      if (r.userFiles.length > 0) {
+        summary.userFiles.push(...r.userFiles.map(f => `${repo.folder}/${toolMap.rulesDir}/${f}`));
+        console.log(`      ${c.green}✅ ${r.userFiles.length} user files preserved${c.reset}`);
+      }
+    }
+
+    // Workflows
+    if (toolMap.workflowsDir) {
+      console.log(`   📋 Workflows → ${toolMap.workflowsDir}/`);
+      const w = syncWorkflows(projectPath, cwd, tool, toolMap);
+      summary.totalUpdated += w.updated;
+      if (w.userFiles.length > 0) {
+        summary.userFiles.push(...w.userFiles.map(f => `${repo.folder}/${toolMap.workflowsDir}/${f}`));
+        console.log(`      ${c.green}✅ ${w.userFiles.length} user files preserved${c.reset}`);
+      }
+    }
+
+    // Skills
+    if (toolMap.skillsDir) {
+      console.log(`   🎯 Skills → ${toolMap.skillsDir}/`);
+      const s = syncSkills(projectPath, cwd, toolMap);
+      summary.totalUpdated += s.updated;
+      summary.totalNew += s.newSkills;
+      if (s.userSkills.length > 0) {
+        summary.userFiles.push(...s.userSkills.map(d => `${repo.folder}/${toolMap.skillsDir}/${d}/`));
+        console.log(`      ${c.green}✅ ${s.userSkills.length} user skills preserved${c.reset}`);
+      }
+    }
+
+    // Shared files (GETTING-STARTED.md)
+    console.log(`   📖 Shared files`);
+    const sh = syncSharedFiles(projectPath, cwd, toolMap);
+    summary.totalUpdated += sh.updated;
+
+    console.log('');
+  }
+
+  // ── Summary ──
+  console.log(`${c.bold}${c.cyan}╔═══════════════════════════════════════════════════════╗
+║  ✅  Sync complete!                                   ║
+╠═══════════════════════════════════════════════════════╣${c.reset}
+║
+║  📊 ${c.bold}${summary.totalUpdated} files updated${c.reset}, ${c.bold}${summary.totalNew} new files${c.reset}
+║  ${c.green}🔒 ${summary.userFiles.length} user files preserved (không bị xóa)${c.reset}`);
+
+  if (summary.userFiles.length > 0) {
+    console.log(`║`);
+    console.log(`║  ${c.dim}User files kept:${c.reset}`);
+    for (const f of summary.userFiles) {
+      console.log(`║     ${c.dim}· ${f}${c.reset}`);
+    }
+  }
+
+  console.log(`║
+║  ${c.dim}Lưu ý: Context file (AGENTS.md/CLAUDE.md/.cursorrules)${c.reset}
+║  ${c.dim}và rules RP05 (project conventions) KHÔNG bị ghi đè —${c.reset}
+║  ${c.dim}vì chứa nội dung riêng của từng dự án.${c.reset}
+║
+${c.bold}${c.cyan}╚═══════════════════════════════════════════════════════╝${c.reset}
+`);
+}

package/src/commands/upgrade.js

@@ -114,7 +114,13 @@ function doUpgrade(targetVersion) {
     });
     console.log('');
     console.log(`  ${c.green}+${c.reset} ${c.bold}Upgraded successfully -> v${targetVersion}${c.reset}`);
-    console.log(`  ${c.dim}Run ${c.cyan}evnict-kit doctor${c.dim} to verify.${c.reset}`);
+    console.log('');
+    console.log(`  ${c.yellow}!${c.reset} ${c.bold}Quan trọng:${c.reset} Chạy lệnh sau để cập nhật templates vào các project:`);
+    console.log(`  ${c.cyan}  cd <workspace-folder>${c.reset}`);
+    console.log(`  ${c.cyan}  evnict-kit sync${c.reset}`);
+    console.log('');
+    console.log(`  ${c.dim}Lệnh sync sẽ ghi đè workflows/skills/rules mới,${c.reset}`);
+    console.log(`  ${c.dim}nhưng giữ nguyên files bạn tự thêm.${c.reset}`);
     console.log('');
   } catch (e) {
     console.log('');

package/src/utils/config.js

@@ -97,7 +97,7 @@ export const TECH_TYPE_HINTS = {
 
 /**
  * Tool-specific directory and file mapping
- * Mỗi AI tool có cách tổ chức riêng — v0.2.2 Multi-Tool Support
+ * Mỗi AI tool có cách tổ chức riêng — v0.2.3 Multi-Tool Support
  */
 export const TOOL_MAP = {
   antigravity: {
@@ -153,7 +153,7 @@ export const TOOL_MAP = {
 };
 
 /**
- * Tools that have templates ready — v0.2.2: ALL 5 tools supported
+ * Tools that have templates ready — v0.2.3: ALL 5 tools supported
  */
 export const SUPPORTED_TOOLS = ['antigravity', 'claude', 'cursor', 'copilot', 'codex'];
 

package/templates/GETTING-STARTED.md

@@ -1,5 +1,5 @@
 # EVNICT-KIT — Hướng Dẫn Sử Dụng
-> File này được tạo bởi evnict-kit v0.2.2
+> File này được tạo bởi evnict-kit v0.2.3
 > Đọc file này để biết dùng workflow nào cho công việc nào
 
 ---
@@ -190,7 +190,28 @@ evnict-kit init → init-rules → init-context → init-check → init-wiki →
 
 ---
 
+## 🔄 Cập nhật evnict-kit
+
+Khi có phiên bản mới:
+```bash
+# Bước 1: Cập nhật CLI
+evnict-kit upgrade          # hoặc: npm install -g evnict-kit@latest
+
+# Bước 2: Cập nhật templates vào project
+cd <workspace-folder>
+evnict-kit sync             # Ghi đè workflows/skills/rules mới
+
+# Bước 3 (tùy chọn): Kiểm tra
+evnict-kit doctor           # Verify version + workspace status
+```
+
+> **Lưu ý:** Lệnh `sync` chỉ ghi đè files evnict-kit (prefix `evnict-kit-`).
+> Files bạn tự thêm vào workflows/skills/rules sẽ **KHÔNG bị xóa**.
+> Context file (AGENTS.md) và project conventions cũng **KHÔNG bị ghi đè**.
+
+---
+
 ## 📌 Phiên bản
-- **evnict-kit:** v0.2.2
+- **evnict-kit:** v0.2.3
 - **Ngày tạo:** {{DATE}}
 - **Project:** {{PROJECT_NAME}}