ai-developer-skill-os 7.5.1 → 8.1.5

package/README.md

@@ -1,74 +1,52 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v7.5.1
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.1.4
 
-> **v7.5.1 "Anti-Slop & Zero-Trust Architecture"**
+> **v8.1.4 "Agent Engineering OS + Design Intelligence"**
 
-Hệ sinh thái AI Developer Skill OS đã được tái cấu trúc hoàn toàn. Thay vì cung cấp các "công cụ rời rạc" (Toolbox), phiên bản V7 được thiết kế như một **Hệ điều hành khép kín, hoạt động theo kỷ luật của một Kiến trúc sư Hệ thống (50 năm kinh nghiệm)**.
+Hệ sinh thái AI Developer Skill OS đã lột xác hoàn toàn. Từ một bộ "công cụ phân tán" (Toolbox) ở V7, phiên bản V8.1.4 được thiết kế như một **Hệ điều hành khép kín (Agent Engineering OS)**, sở hữu năng lực giám sát, bảo vệ ranh giới quyết định (Decision Boundaries) và được trang bị thêm tầng **Design Intelligence**.
 
 ---
 
-## 🏗️ Triết Lý Hoạt Động Cốt Lõi (V7 Kernel)
+## 🏗️ Triết Lý Hoạt Động Cốt Lõi (V8 Kernel)
 
-### 1. Zero-Trust Context (Không bao giờ đoán mò)
-Mọi kỹ năng phân tích logic và backend (như `qk-feature-delivery`, `qk-orchestrator`) đều bị khoá chặt, không được phép hoạt động nếu chưa có **Dependency Graph** (Bản đồ cấu trúc) từ `qk-context-loader`. AI không được phép thay đổi code dựa trên trí tưởng tượng.
+### 1. Decision Boundary (Ranh giới Thẩm quyền)
+Không còn tình trạng một Skill ôm đồm mọi việc. Mọi Skill (Kỹ năng) hiện tại bị quản lý bởi các trường `owns`, `does_not_own`, `conflicts_with`, `delegates_to`. Thợ code UI (`qk-ui-builder`) không được phép tự ra quyết định kiến trúc, và ngược lại.
 
-### 2. Contract-First (Khế ước đi đầu)
-- **Frontend / UI**: Mọi sửa đổi giao diện đều phải dựa trên `DESIGN.md`. Nếu vi phạm (tạo ra giao diện lười biếng "slop", dùng màu mặc định sai lệch), AI sẽ tự động bị đánh trượt bài kiểm toán.
-- **Backend / API**: Mọi API phải được viết `OpenAPI/Swagger` schema trước khi viết logic thực tế (`qk-api-lifecycle`).
-- **Database**: Cấm truy vấn mù. Bắt buộc phải có Schema định nghĩa rõ ràng trước (`qk-data-lifecycle`).
+### 2. Design Intelligence Layer
+Khắc phục điểm yếu "mù thẩm mỹ" của AI. Agent giờ đây không chỉ biết code mà còn có Gu Thẩm Mỹ (Design Taste). Dựa trên yêu cầu của bạn, hệ thống tự động tra cứu **Knowledge Graph** để chọn đúng Theme (Fintech, Healthcare, SaaS...), Typography và Visual Patterns trước khi giao việc cho UI Builder.
 
-### 3. Repair Loop (Chu trình Sửa Lỗi Khép Kín)
-Bảo vệ mã nguồn khỏi thói quen "sửa vội" của AI. Lỗi bắt buộc phải qua chu trình điều tra nghiêm ngặt: `Observe -> Hypothesis -> Evidence -> Fix -> Verify` (`qk-bug-resolution`).
+### 3. Khế Ước Đi Đầu (Contract-First & Zero-Trust)
+- **Frontend / UI**: Mọi sửa đổi phải tuân thủ Design System (được `qk-design-system-engineering` kiểm duyệt).
+- **Backend / API**: Phải viết OpenAPI/Swagger contract trước (`qk-api-lifecycle`).
+- **Data**: Cấm AI tự đoán cấu trúc DB, mọi truy vấn phải có Schema (`qk-data-lifecycle`).
 
 ---
 
-## 🧩 Danh sách 22 Master Skills
+## 🧩 Danh sách 30 Master Skills
 
-Các kỹ năng được quản lý cực kỳ chặt chẽ với bài kiểm tra tự động (Vitest) để đảm bảo tính nhất quán của luật lệ:
-- **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-access-policy`
-- **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-fe-api-integration`, `qk-data-lifecycle`, `qk-ui-builder`, `qk-ui-system-builder`
-- **Validation & Standards:** `qk-validation-gate`, `qk-engineering-standard`, `qk-ui-audit`, `qk-project-health`, `qk-bug-resolution`
-- **Ops & AI:** `qk-system-evolution`, `qk-production-release`, `qk-ai-builder`, `qk-project-bootstrap`
-- **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`, `qk-db-optimizer`
+Các kỹ năng được quản lý bằng **Capability Graph** và được đánh giá liên tục thông qua Evaluation Suite. Bao gồm 7 lĩnh vực:
+1. **Core & Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-project-memory`, `qk-help`
+2. **Product & Architecture:** `qk-product-specification`, `qk-project-bootstrap`, `qk-frontend-architecture`
+3. **Frontend & UI:** `qk-design-system-engineering`, `qk-ui-system-builder`, `qk-ui-builder`, `qk-fe-api-integration`, `qk-ui-audit`
+4. **Backend & Data:** `qk-api-lifecycle`, `qk-data-lifecycle`, `qk-access-policy`
+5. **Engineering & Delivery:** `qk-feature-delivery`, `qk-bug-resolution`, `qk-engineering-standard`, `qk-system-evolution`, `qk-docs`
+6. **Quality & Testing:** `qk-test-engineering`, `qk-validation-gate`, `qk-web-quality-gate`, `qk-project-health`
+7. **Security, DevOps & Analytics:** `qk-security-audit`, `qk-db-optimizer`, `qk-devops-platform`, `qk-production-release`, `qk-agent-observability`, `qk-ai-builder`
 
 ---
 
 ## 💻 Cách Cài Đặt (Installation)
 
-### Cách 1: NPM Global (Khuyên dùng cho nhiều máy)
+### Cách 1: NXP (Không cần cài global) - MỚI
 ```bash
-npm i -g ai-developer-skill-os
+npx ai-developer-skill-os init
 ```
 
-### Cách 2: NXP (Không cần cài global)
+### Cách 2: NPM Global (Khuyên dùng cho cá nhân)
 ```bash
-npx ai-developer-skill-os init --ide=antigravity --scope=2
-```
-
-### Cách 3: NPM Scripts (Trong dự án)
-```bash
-# Antigravity Global — 1 lần cài, mọi dự án dùng chung
-npm run install:antigravity
-
-# Antigravity Local — cài riêng cho dự án này
-npm run install:antigravity:local
-
-# Các IDE khác
-npm run install:cursor        # Global Cursor
-npm run install:windsurf      # Global Windsurf
-npm run install:claude        # Global Claude Code
-npm run install:kilo          # Global Kilo Code
-npm run install:multi         # Multi-IDE
+npm i -g ai-developer-skill-os
 ```
 
-## 📦 Tham số cho `init`
-
-| Tham số | Giá trị | Mô tả |
-|---------|---------|-------|
-| `--ide` | `antigravity`, `cursor`, `windsurf`, `claude`, `kilo`, `multi-ide` | IDE/AI Assistant |
-| `--scope` | `1` = Local, `2` = Global | Phạm vi cài đặt |
-
-### Ví dụ thực tế
-
+### Chạy bằng tham số (Command Line Arguments)
 ```bash
 # Cài Antigravity Global (toàn máy)
 npx ai-developer-skill-os init --ide=antigravity --scope=2
@@ -78,24 +56,31 @@ npx ai-developer-skill-os init --ide=antigravity --scope=1
 
 # Cài Cursor Local
 npx ai-developer-skill-os init --ide=cursor --scope=1
-
-# Cài Multi-IDE (tạo CLAUDE.md + .qk-ai-skill-os)
-npx ai-developer-skill-os init --ide=multi-ide --scope=2
 ```
 
-## 🧪 Testing
+## 📦 Các IDE/AI Assistant Được Hỗ Trợ
+- (1) Cursor
+- (2) Windsurf
+- (3) Cline / Roo Code
+- (4) Antigravity / Gemini
+- (5) Codex
+- (6) Kilo Code
 
-Hệ thống được bảo vệ bằng bộ Test Suite (Vitest) để tự động kiểm toán tính hợp lệ của toàn bộ 22 file Kỹ năng trước khi xuất bản:
+---
+
+## 🧪 Đánh Giá Tự Động (Agent Evaluation)
+
+Hệ thống đi kèm một bộ Runner nội bộ để kiểm toán **Routing Intelligence**. Bất kỳ cập nhật nào vào hệ thống Kỹ năng đều phải vượt qua bài kiểm tra hóc búa (Bypass Security, Boundary Attacks, Ambiguous Prompts):
 
 ```bash
-npm test
+npm run test:agent
+npm run test:graph
+npm run test:registry
 ```
 
-## 🚀 Tra Cứu (Help)
-
-Để tra cứu danh sách các Kỹ năng và luật lệ khắt khe của hệ thống V7, hãy gọi:
+## 🚀 Hướng Dẫn Sử Dụng
+Sau khi cài đặt thành công, hãy gõ lệnh:
 ```bash
 ./qk-help
 ```
-
-
+để kích hoạt AI Orchestrator và khám phá sức mạnh của hệ điều hành!

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.1",
-  "description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 22 skills chuyên nghiệp.",
+  "version": "8.1.5",
+  "description": "Agent Engineering OS: A deterministic capability graph, governance rules, and dynamic knowledge base for AI coding agents.",
   "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",

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.');