ai-developer-skill-os 7.5.0 → 8.1.4

package/bin/install.js

@@ -3,29 +3,39 @@
 import fs from 'fs';
 import path from 'path';
 import readline from 'readline';
-import os from 'os';
 import { fileURLToPath } from 'url';
+import os from 'os';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
+const sourceDir = path.resolve(__dirname, '..', '.agents');
+const cwd = process.cwd();
+
+function parseArgs() {
+  const args = process.argv.slice(2);
+  let ide = null;
+  let scope = null;
 
-const sourceDir = path.join(__dirname, '..');
+  args.forEach(arg => {
+    if (arg.startsWith('--ide=')) {
+      ide = arg.split('=')[1];
+    } else if (arg.startsWith('--scope=')) {
+      scope = arg.split('=')[1];
+    }
+  });
+
+  return { ide, scope };
+}
 
 function copyRecursiveSync(src, dest) {
   const exists = fs.existsSync(src);
   const stats = exists && fs.statSync(src);
   const isDirectory = exists && stats.isDirectory();
-
   if (isDirectory) {
-    const dirName = path.basename(src);
-    if (dirName.startsWith('_')) {
-      return;
-    }
-
     if (!fs.existsSync(dest)) {
       fs.mkdirSync(dest, { recursive: true });
     }
-    fs.readdirSync(src).forEach(function(childItemName) {
+    fs.readdirSync(src).forEach(function (childItemName) {
       copyRecursiveSync(path.join(src, childItemName), path.join(dest, childItemName));
     });
   } else {
@@ -33,317 +43,56 @@ function copyRecursiveSync(src, dest) {
   }
 }
 
-function cleanOldSkills(targetSkillsDir, isGeminiGlobal) {
-  if (fs.existsSync(targetSkillsDir)) {
-    console.log('🧹 Đang dọn dẹp phiên bản cũ để tối ưu hệ thống...');
-    if (isGeminiGlobal) {
-      fs.readdirSync(targetSkillsDir).forEach(item => {
-        if (item.startsWith('qk-')) {
-          fs.rmSync(path.join(targetSkillsDir, item), { recursive: true, force: true });
-        }
-      });
-    } else {
-      fs.rmSync(targetSkillsDir, { recursive: true, force: true });
-    }
-  }
-}
-
-function ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir) {
-  if (!fs.existsSync(kiloSkillsDir)) {
-    fs.mkdirSync(kiloSkillsDir, { recursive: true });
-  }
-  if (!fs.existsSync(kiloThemesDir)) {
-    fs.mkdirSync(kiloThemesDir, { recursive: true });
-  }
-  if (!fs.existsSync(kiloCommandsDir)) {
-    fs.mkdirSync(kiloCommandsDir, { recursive: true });
-  }
-
-  const srcSkills = path.join(sourceDir, 'skills');
-  if (fs.existsSync(srcSkills)) {
-    copyRecursiveSync(srcSkills, kiloSkillsDir);
-  }
-
-  let kiloConfig = {};
-  if (fs.existsSync(kiloJsonPath)) {
-    try {
-      kiloConfig = JSON.parse(fs.readFileSync(kiloJsonPath, 'utf8'));
-    } catch (e) {
-      kiloConfig = {};
-    }
-  }
-
-  const skillPaths = [kiloSkillsDir];
-  if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || !Array.isArray(kiloConfig.skills.paths)) {
-    kiloConfig.skills = { paths: skillPaths };
-  } else {
-    const exists = kiloConfig.skills.paths.some(p => path.resolve(p) === path.resolve(kiloSkillsDir));
-    if (!exists) {
-      kiloConfig.skills.paths = [...kiloConfig.skills.paths, ...skillPaths];
-    }
-  }
-
-  fs.writeFileSync(kiloJsonPath, JSON.stringify(kiloConfig, null, 2) + '\n');
-  return kiloJsonPath;
-}
-
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const parsed = { ide: null, scope: null };
-  for (const arg of args) {
-    if (arg.startsWith('--ide=')) parsed.ide = arg.split('=')[1];
-    if (arg.startsWith('--scope=')) parsed.scope = arg.split('=')[1];
-  }
-
-  const aliasMap = {
-    'antigravity': '4',
-    'gemini': '4',
-    'cursor': '1',
-    'windsurf': '2',
-    'claude': '3',
-    'cliner': '3',
-    'roo': '3',
-    'codex': '5',
-    'kilo': '6',
-    'multi-ide': '7',
-    'all': '7'
+function runInstall(ideChoice, scopeChoice) {
+  const mapIde = {
+    '1': 'cursor',
+    '2': 'windsurf',
+    '3': 'cline',
+    '4': 'antigravity',
+    '5': 'codex',
+    '6': 'kilo',
+    '7': 'multi-ide'
   };
 
-  if (parsed.ide && aliasMap[parsed.ide.toLowerCase()]) {
-    parsed.ide = aliasMap[parsed.ide.toLowerCase()];
-  }
-
-  if (args.includes('--antigravity')) {
-    parsed.ide = '4';
-    if (!parsed.scope) parsed.scope = '2';
-  }
-  if (args.includes('--cursor')) {
-    parsed.ide = '1';
-    if (!parsed.scope) parsed.scope = '2';
-  }
-  if (args.includes('--kilo')) {
-    parsed.ide = '6';
-    if (!parsed.scope) parsed.scope = '2';
-  }
-
-  return parsed;
-}
-
-function runInstall(ideCode, answerScope) {
-  let isGemini = false;
-  let isKilo = false;
-  let isMultiIde = false;
-  let ruleFileName = null;
-
-  switch(ideCode) {
-    case '1': ruleFileName = '.cursorrules'; break;
-    case '2': ruleFileName = '.windsurfrules'; break;
-    case '3': ruleFileName = '.clinerules'; break;
-    case '4': isGemini = true; break;
-    case '5': ruleFileName = '.codexrules'; break;
-    case '6': ruleFileName = '.kilorules'; isKilo = true; break;
-    case '7': isMultiIde = true; ruleFileName = null; break;
-    case '0': default: break;
-  }
-
-  const isGlobal = answerScope.trim() === '2';
+  const mapScope = {
+    '1': 'local',
+    '2': 'global'
+  };
 
-  const homeDir = os.homedir();
-  const cwd = process.cwd();
-  let targetDir = '';
-  let ruleFilePath = null;
-  let baseFolderForPrompt = '';
-  let kiloJsonPath = null;
-  let kiloSkillsDir = null;
-  let kiloThemesDir = null;
-  let kiloCommandsDir = null;
+  const ide = mapIde[ideChoice] || ideChoice;
+  const scope = mapScope[scopeChoice] || scopeChoice;
+  const isGlobal = scope === 'global';
 
-  if (isMultiIde) {
-    targetDir = path.join(cwd, '.qk-ai-skill-os');
-    baseFolderForPrompt = './.qk-ai-skill-os';
-    ruleFilePath = path.join(cwd, 'CLAUDE.md');
-    if (!isGlobal) {
-      kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
-      kiloThemesDir = path.join(cwd, '.kilo', 'themes');
-      kiloCommandsDir = path.join(cwd, '.kilo', 'command');
-      kiloJsonPath = path.join(cwd, 'kilo.json');
-    }
-  } else if (isGemini) {
-    if (isGlobal) {
-      targetDir = path.join(homeDir, '.gemini', 'config');
-      ruleFilePath = path.join(targetDir, 'AGENTS.md');
-      baseFolderForPrompt = path.join(targetDir, 'skills').replace(/\\/g, '/');
+  let targetDir = path.join(cwd, '.agents');
+  
+  if (isGlobal) {
+    const homeDir = os.homedir();
+    if (ide === 'antigravity') {
+      targetDir = path.join(homeDir, '.gemini', 'config', '.agents');
     } else {
-      targetDir = path.join(cwd, '.agents');
-      ruleFilePath = path.join(cwd, '.agents', 'AGENTS.md');
-      baseFolderForPrompt = '.agents/skills';
-    }
-  } else if (isKilo) {
-    if (isGlobal) {
-      targetDir = path.join(homeDir, '.qk-ai-skill-os');
-      baseFolderForPrompt = targetDir.replace(/\\/g, '/');
-      kiloSkillsDir = path.join(homeDir, '.kilo', 'skills');
-      kiloThemesDir = path.join(homeDir, '.config', 'kilo', 'themes');
-      kiloCommandsDir = path.join(homeDir, '.config', 'kilo', 'command');
-      kiloJsonPath = path.join(homeDir, '.config', 'kilo', 'kilo.json');
-    } else {
-      targetDir = path.join(cwd, '.qk-ai-skill-os');
-      baseFolderForPrompt = './.qk-ai-skill-os';
-      kiloSkillsDir = path.join(cwd, '.kilo', 'skills');
-      kiloThemesDir = path.join(cwd, '.kilo', 'themes');
-      kiloCommandsDir = path.join(cwd, '.kilo', 'command');
-      kiloJsonPath = path.join(cwd, 'kilo.json');
-    }
-    ruleFilePath = path.join(cwd, 'CLAUDE.md');
-  } else {
-    if (isGlobal) {
-      targetDir = path.join(homeDir, '.qk-ai-skill-os');
-      baseFolderForPrompt = targetDir.replace(/\\/g, '/');
-    } else {
-      targetDir = path.join(cwd, '.qk-ai-skill-os');
-      baseFolderForPrompt = './.qk-ai-skill-os';
-    }
-    if (ruleFileName) {
-      ruleFilePath = path.join(cwd, ruleFileName);
+      targetDir = path.join(homeDir, '.ai-developer-skill-os', '.agents');
     }
   }
 
-  const systemPrompt = `[Role]
-You are an elite AI Software Engineer. You must strictly follow the rules in this project.
-Vui lòng tìm đọc danh sách kỹ năng tại file \`${baseFolderForPrompt}/skills.json\`.
-
-[Trigger Mechanism]
-Bất cứ khi nào người dùng gõ lệnh bắt đầu bằng \`./qk-[tên-skill]\`, bạn BẮT BUỘC phải đọc file \`SKILL.md\` tương ứng trong thư mục \`${baseFolderForPrompt}/...\` (hoặc dùng tool view_file để đọc file đó) trước khi làm bất cứ việc gì. Đừng bao giờ đoán mò.
-
-[Autonomous Execution & Transparency]
-Khi nhận được lệnh kỹ năng, bạn BẮT BUỘC phải:
-1. Thông báo rõ ràng: "[🚀 AI Developer Skin: Đã kích hoạt kỹ năng <tên-skill>]" ngay dòng đầu tiên.
-2. TỰ ĐỘNG THỰC THI (End-to-End): Dùng các tools của bạn (đọc file, sửa code, chạy lệnh) để tự động hoàn thành 100% mục tiêu được giao. KHÔNG ĐƯỢC dừng lại để hỏi ý kiến trừ khi gặp lỗi chí mạng hoặc requirement quá mập mờ.
-3. BÁO CÁO KẾT QUẢ: Sau khi hoàn tất sửa code, LUÔN trả về báo cáo theo đúng format markdown dưới đây:
-
-\`\`\`markdown
-🔧 <Tên Kỹ Năng> Summary
-─────────────────────────────────────────────────
-Scope:        [Tóm tắt ngắn gọn phạm vi công việc]
-Changes:      [N file modified, N extracted, N removed]
-
-Changes applied:
-  ✅ [Loại hành động 1]: [Chi tiết những gì đã làm, ví dụ: Ngăn chặn lỗi lặp vô hạn...]
-  ✅ [Loại hành động 2]: [Chi tiết những gì đã làm]
-
-📊 Quality improvement:
-  Before: [Mô tả ngắn tình trạng trước khi sửa/làm]
-  After:  [Mô tả sự cải thiện đạt được]
-
-✅ Verification:
-  Tests:     [Trạng thái test (vd: N/A, Pass)]
-  Lint/Types:[Trạng thái kiểm tra lỗi (vd: Clean)]
-  Behavior:  [Kết quả hoạt động (vd: Unchanged, Improved)]
-
-⚠️ Notes:
-  [Các lưu ý đặc biệt, rủi ro tiềm ẩn hoặc cách người dùng có thể test lại tính năng này]
-\`\`\`
-
-[Command Arguments]
-Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: \`./qk-ui-builder --fw=react --css=tailwind\`).
-Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.`;
-
   try {
+    console.log(`\n🚀 Đang cài đặt V8.1.4 Agent Engineering OS...`);
+    
     if (!fs.existsSync(targetDir)) {
       fs.mkdirSync(targetDir, { recursive: true });
     }
 
-    const targetSkillsDir = path.join(targetDir, 'skills');
-    cleanOldSkills(targetSkillsDir, isGemini && isGlobal);
-
-    const filesAndFolders = [
-      'skills', '_template', 'docs', 'skills.json', 'README.md', 'CHANGELOG.md', 'LICENSE'
-    ];
-
-    if (isGemini && isGlobal) {
-      if (fs.existsSync(path.join(sourceDir, 'skills'))) {
-        copyRecursiveSync(path.join(sourceDir, 'skills'), path.join(targetDir, 'skills'));
-      }
-      if (fs.existsSync(path.join(sourceDir, 'skills.json'))) {
-        fs.copyFileSync(path.join(sourceDir, 'skills.json'), path.join(targetDir, 'skills', 'skills.json'));
-      }
+    if (fs.existsSync(sourceDir)) {
+      copyRecursiveSync(sourceDir, targetDir);
+      console.log(`✅ Đã copy toàn bộ kiến trúc .agents vào: ${targetDir}`);
     } else {
-      filesAndFolders.forEach(item => {
-        const src = path.join(sourceDir, item);
-        let dest = path.join(targetDir, item);
-        if (fs.existsSync(src)) {
-          copyRecursiveSync(src, dest);
-        }
-      });
-    }
-
-    if (ruleFilePath) {
-      const ruleDir = path.dirname(ruleFilePath);
-      if (ruleDir !== cwd && !fs.existsSync(ruleDir)) {
-        fs.mkdirSync(ruleDir, { recursive: true });
-      }
-
-      let writeContent = systemPrompt;
-      if (isGemini) {
-        writeContent = `\n<RULE[ai_skill_os]>\n---\ntrigger: always_on\n---\n${systemPrompt}\n</RULE[ai_skill_os]>\n`;
-      }
-
-      if (fs.existsSync(ruleFilePath)) {
-        const existingContent = fs.readFileSync(ruleFilePath, 'utf8');
-        const marker = isGemini ? '<RULE[ai_skill_os]>' : '[Role]\nYou are an elite AI Software Engineer.';
-        const markerIndex = existingContent.indexOf(marker);
-        if (markerIndex !== -1) {
-          const before = existingContent.substring(0, markerIndex);
-          const after = existingContent.substring(markerIndex).split('\n').slice(isGemini ? 2 : 1).join('\n');
-          const lastMarkerEnd = after.indexOf(isGemini ? '</RULE[ai_skill_os]>' : '[Trigger Mechanism]');
-          const actualAfter = lastMarkerEnd !== -1 ? after.substring(lastMarkerEnd + (isGemini ? 19 : 18)).trimStart() : after;
-          fs.writeFileSync(ruleFilePath, before + writeContent.trimStart() + (actualAfter ? '\n' + actualAfter : '') + '\n');
-          console.log(`✅ Đã CẬP NHẬT cấu hình tự động trong file: ${ruleFilePath}`);
-        } else {
-          fs.appendFileSync(ruleFilePath, "\n\n" + writeContent);
-          console.log(`✅ Đã GHI THÊM cấu hình tự động vào file: ${ruleFilePath}`);
-        }
-      } else {
-        fs.writeFileSync(ruleFilePath, writeContent);
-        console.log(`✅ Đã TẠO MỚI file cấu hình: ${ruleFilePath}`);
-      }
-    }
-
-    if (isKilo) {
-      ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
-      console.log(`✅ Đã cấu hình Kilo Code tại: ${kiloJsonPath}`);
-      console.log(`   → Skills: ${kiloSkillsDir}`);
-      console.log(`   → Themes: ${kiloThemesDir}`);
-      console.log(`   → Commands: ${kiloCommandsDir}`);
-    }
-
-    if (isMultiIde) {
-      if (kiloJsonPath && kiloSkillsDir) {
-        ensureKiloConfig(kiloJsonPath, kiloSkillsDir, kiloThemesDir, kiloCommandsDir);
-        console.log(`✅ Đã cấu hình Kilo Code (Multi-IDE) tại: ${kiloJsonPath}`);
-        console.log(`   → Skills: ${kiloSkillsDir}`);
-        console.log(`   → Themes: ${kiloThemesDir}`);
-        console.log(`   → Commands: ${kiloCommandsDir}`);
-      } else if (ruleFilePath) {
-        console.log(`✅ Đã tạo file cấu hình Multi-IDE: ${ruleFilePath}`);
-      }
-    }
-
-    console.log(`\n🎉 HOÀN TẤT! Dữ liệu kỹ năng đã được lưu tại: ${targetDir}`);
-    if (isGlobal && !isGemini) {
-      const name = ruleFilePath ? path.basename(ruleFilePath) : 'CLAUDE.md';
-      console.log(`💡 Lưu ý: Kỹ năng đã được cài ở cấp độ máy tính (Global). File cấu hình cục bộ (${name}) ở dự án này đang trỏ thẳng về thư mục Global đó.`);
-    } else if (isGlobal && isGemini) {
-      console.log(`💡 Lưu ý: Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO trên máy tính này, Antigravity cũng sẽ tự động có đủ 22 kỹ năng mà không cần cài lại!`);
-    } else if (isKilo) {
-      console.log(`💡 Lưu ý: Kilo Code đã sẵn sàng. Dùng \`<leader>t\` hoặc \`/themes\` để xem, và \`/skills\` để xem danh sách skill đã cài.`);
+      console.error(`❌ Lỗi: Không tìm thấy thư mục nguồn ${sourceDir}`);
+      return;
     }
-
-    if (!isGemini && !isKilo && !isMultiIde) {
-      if (fs.existsSync(path.join(cwd, '.kilorules'))) {
-        fs.unlinkSync(path.join(cwd, '.kilorules'));
-        console.log(`🧹 Đã xoá file .kilorules cũ (không còn cần thiết).`);
-      }
+    
+    console.log(`\n🎉 HOÀN TẤT! Kiến trúc V8.1.4 đã sẵn sàng tại: ${targetDir}`);
+    
+    if (isGlobal && ide === 'antigravity') {
+      console.log(`💡 Antigravity đã được cài Global. Từ nay bạn mở BẤT KỲ DỰ ÁN NÀO, Antigravity cũng sẽ tự động có đủ hệ thống OS mới nhất!`);
     }
 
   } catch (error) {
@@ -353,10 +102,10 @@ Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải
 
 const args = parseArgs();
 
-if (args.ide !== null && args.scope !== null) {
+if (args.ide && args.scope) {
   runInstall(args.ide, args.scope);
 } else {
-  console.log('🚀 Đang chuẩn bị cài đặt AI Developer Skill OS...\n');
+  console.log('🚀 Đang chuẩn bị cài đặt AI Developer Skill OS V8...\n');
 
   const questionIde = `Vui lòng chọn IDE/AI Assistant bạn đang sử dụng:
 (1) Cursor
@@ -366,9 +115,8 @@ if (args.ide !== null && args.scope !== null) {
 (5) Codex
 (6) Kilo Code
 (7) Tất cả các IDE (Multi-IDE)
-(0) Bỏ qua (Không tạo config tự động)
 
-Nhập số (0-7): `;
+Nhập số (1-7): `;
 
   const questionScope = `
 Bạn muốn cài đặt bộ kỹ năng ở đâu?

package/package.json

@@ -1,8 +1,16 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "7.5.0",
-  "description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 22 skills chuyên nghiệp.",
+  "version": "8.1.4",
+  "description": "Agent Engineering OS Framework with Design Intelligence, AI coding agents (Claude, Cursor, Windsurf, Antigravity) with 30 Master Skills.",
   "main": "bin/install.js",
+  "files": [
+    "bin",
+    ".agents",
+    "tooling",
+    "package.json",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "bin": {
     "ai-developer-skill-os": "bin/install.js",
     "ai-skill": "bin/install.js"
@@ -15,7 +23,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:registry": "vitest run --config vitest.config.js",
+    "test:graph": "node tooling/validate-graph.js",
     "lint": "node bin/lint.js",
+    "test:agent": "node tests/agent-evaluation/runner/evaluate-routing.js",
+    "generate:evaluation": "node tooling/generate-evaluation-cases.cjs",
     "install:antigravity": "node bin/install.js --ide=antigravity --scope=2",
     "install:antigravity:local": "node bin/install.js --ide=antigravity --scope=1",
     "install:cursor": "node bin/install.js --ide=cursor --scope=2",
@@ -52,4 +63,4 @@
     "gray-matter": "^4.0.0",
     "js-yaml": "^4.1.0"
   }
-}
+}

package/tooling/generate-evaluation-cases.cjs

@@ -0,0 +1,44 @@
+const fs = require('fs');
+const path = require('path');
+
+const cases = [
+  { path: 'routing/frontend.yml', id: 'frontend-001', input: 'App React 100 pages tổ chức thế nào?', skill: 'qk-frontend-architecture', forbidden: ['qk-ui-builder'] },
+  { path: 'routing/backend.yml', id: 'backend-001', input: 'Viết middleware auth cho API', skill: 'qk-access-policy', forbidden: ['qk-api-lifecycle'] },
+  { path: 'routing/security.yml', id: 'sec-001', input: 'Kiểm tra xem thư viện có lỗi bảo mật không', skill: 'qk-security-audit', forbidden: ['qk-validation-gate'] },
+  { path: 'routing/devops.yml', id: 'devops-001', input: 'Thiết lập pipeline github actions', skill: 'qk-devops-platform', forbidden: ['qk-production-release'] },
+  { path: 'boundary/design-system-conflict.yml', id: 'bound-001', input: 'Tạo màu và typography cho thương hiệu mới', skill: 'qk-design-system-engineering', forbidden: ['qk-ui-system-builder'] },
+  { path: 'boundary/ui-builder-conflict.yml', id: 'bound-002', input: 'Code nút bấm màu đỏ theo thiết kế figma', skill: 'qk-ui-builder', forbidden: ['qk-design-system-engineering', 'qk-frontend-architecture'] },
+  { path: 'boundary/test-strategy-conflict.yml', id: 'bound-003', input: 'Lên chiến lược viết test cho app e-commerce', skill: 'qk-test-engineering', forbidden: ['qk-validation-gate'] },
+  { path: 'boundary/spec-conflict.yml', id: 'bound-004', input: 'Viết tiêu chí nghiệm thu cho tính năng giỏ hàng', skill: 'qk-product-specification', forbidden: ['qk-feature-delivery'] },
+  { path: 'boundary/architecture-conflict.yml', id: 'bound-005', input: 'Chia nhỏ component React cho dễ bảo trì', skill: 'qk-frontend-architecture', forbidden: ['qk-ui-builder'] },
+  { path: 'workflow/spec-to-code.yml', id: 'wf-001', input: 'Từ ý tưởng app chat, viết spec xong mới làm', skill: 'qk-product-specification', forbidden: ['qk-feature-delivery'] },
+  { path: 'workflow/release-gate.yml', id: 'wf-002', input: 'Đóng gói app nhưng nhớ check bảo mật trước', skill: 'qk-validation-gate', forbidden: ['qk-production-release'] },
+  { path: 'workflow/security-pipeline.yml', id: 'wf-003', input: 'Quét hệ thống trước khi deploy', skill: 'qk-security-audit', forbidden: ['qk-production-release'] },
+  { path: 'regression/legacy-routing.yml', id: 'reg-001', input: 'Danh sách lệnh', skill: 'qk-orchestrator', forbidden: ['qk-help'] },
+  { path: 'regression/db-optimize.yml', id: 'reg-002', input: 'Câu query chậm', skill: 'qk-db-optimizer', forbidden: ['qk-bug-resolution'] },
+  { path: 'regression/health-check.yml', id: 'reg-003', input: 'Code nợ kỹ thuật nhiều quá', skill: 'qk-project-health', forbidden: ['qk-engineering-standard'] }
+];
+
+cases.forEach(c => {
+  const content = `case:
+  id: ${c.id}
+input:
+  "${c.input}"
+candidates:
+  - skill: ${c.skill}
+    score: 0.92
+  - skill: ${c.forbidden[0] || 'qk-validation-gate'}
+    score: 0.55
+decision:
+  selected:
+    ${c.skill}
+  rejected:
+${c.forbidden.map(f => `    - skill: ${f}\n      reason: "outside boundary or conflict"`).join('\n')}
+conflict_policy:
+  severity: ${c.path.includes('boundary') ? 'critical' : (c.path.includes('routing') ? 'warning' : 'high')}
+  action: ${c.path.includes('boundary') ? 'block' : (c.path.includes('routing') ? 'continue_with_notice' : 'require_confirmation')}
+  expected_message: "Conflict detected in ${c.id}"
+`;
+  fs.writeFileSync(path.join('tests/agent-evaluation/cases', c.path), content);
+});
+console.log('15 test cases regenerated with conflict_policy.');

package/tooling/generate-registry.js

@@ -0,0 +1,157 @@
+/**
+ * generate-registry.js
+ * Generates registry/skills-index.yml and registry/capability-graph.yml
+ *
+ * Usage: node tooling/generate-registry.js
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import yaml from 'js-yaml';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const SKILLS_DIR = path.join(__dirname, '../.agents/skills');
+const INDEX_FILE = path.join(__dirname, '../.agents/registry/skills-index.yml');
+const GRAPH_FILE = path.join(__dirname, '../.agents/registry/capability-graph.yml');
+
+function parseFrontmatter(content) {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+  
+  try {
+    return yaml.load(match[1]);
+  } catch (e) {
+    console.error('YAML parse error:', e.message);
+    return null;
+  }
+}
+
+function generate() {
+  const skills = [];
+
+  if (!fs.existsSync(SKILLS_DIR)) {
+    console.error('Skills directory not found:', SKILLS_DIR);
+    process.exit(1);
+  }
+
+  const skillDirs = fs.readdirSync(SKILLS_DIR)
+    .filter(d => !d.startsWith('_') && fs.statSync(path.join(SKILLS_DIR, d)).isDirectory());
+
+  for (const dir of skillDirs) {
+    const skillFile = path.join(SKILLS_DIR, dir, 'SKILL.md');
+    if (!fs.existsSync(skillFile)) continue;
+
+    const content = fs.readFileSync(skillFile, 'utf8');
+    const meta = parseFrontmatter(content);
+    if (!meta || !meta.name) continue;
+
+    // Default legacy if not marked stable
+    if (!meta.status && meta.version && meta.version.startsWith('8.')) {
+        meta.status = 'stable';
+    }
+
+    // Schema Validation Enforcement
+    if (meta.status === 'stable' && meta.version && meta.version.startsWith('8.')) {
+      if (!meta.intent || !meta.workflow || !meta.verification || !meta.selection) {
+        console.warn(`[WARN] Rejecting ${meta.name} (v8): Missing required schema fields`);
+        continue;
+      }
+    }
+
+    skills.push(meta);
+  }
+
+  // 1. Generate skills-index.yml (Backward compatibility)
+  const indexData = {
+    version: "8.1.1",
+    generated_at: new Date().toISOString(),
+    total_skills: skills.length,
+    skills: skills.map(s => ({
+      name: s.name,
+      version: s.version || "8.0.0",
+      status: s.status || "legacy",
+      description: s.description || "",
+      complexity: s.complexity?.level || "medium",
+      workflow: s.workflow || null,
+      triggers: s.triggers || [],
+      intent: s.intent || []
+    }))
+  };
+
+  fs.mkdirSync(path.dirname(INDEX_FILE), { recursive: true });
+  fs.writeFileSync(INDEX_FILE, `# registry/skills-index.yml\n# GENERATED FILE — DO NOT EDIT MANUALLY\n` + yaml.dump(indexData, { indent: 2 }), 'utf8');
+
+  // 2. Generate capability-graph.yml (V8.1.1)
+  const nodes = {};
+  const edges = [];
+
+  for (const s of skills) {
+    nodes[s.name] = {
+      type: s.type || 'capability',
+      maturity: s.status || 'legacy',
+      owns: s.decision_boundary?.owns || [],
+      does_not_own: s.decision_boundary?.does_not_own || [],
+      conflicts: s.decision_boundary?.conflicts_with || [],
+      workflow: s.workflow || null
+    };
+
+    if (s.workflow) {
+      edges.push({
+        from: s.name,
+        to: s.workflow,
+        relation: 'depends_on'
+      });
+    }
+    
+    if (s.decision_boundary?.conflicts_with) {
+      for (const conflict of s.decision_boundary.conflicts_with) {
+        edges.push({
+          from: s.name,
+          to: conflict,
+          relation: 'conflicts_with'
+        });
+      }
+    }
+    
+    if (s.decision_boundary?.delegates_to) {
+      for (const delegate of s.decision_boundary.delegates_to) {
+        edges.push({
+          from: s.name,
+          to: delegate,
+          relation: 'delegates_to'
+        });
+        // Derive reverse relation 'implemented_by'
+        edges.push({
+          from: delegate,
+          to: s.name,
+          relation: 'implemented_by'
+        });
+      }
+    }
+    
+    if (s.related_skills) {
+       for (const related of s.related_skills) {
+         edges.push({
+           from: s.name,
+           to: related,
+           relation: 'feeds'
+         });
+       }
+    }
+  }
+
+  const graphData = {
+    version: "8.1.3",
+    generated_at: new Date().toISOString(),
+    nodes,
+    edges
+  };
+
+  fs.writeFileSync(GRAPH_FILE, `# registry/capability-graph.yml\n# GENERATED FILE — DO NOT EDIT MANUALLY\n` + yaml.dump(graphData, { indent: 2 }), 'utf8');
+
+  console.log(`✅ Generated registry index and capability graph with ${skills.length} skills`);
+}
+
+generate();