ai-developer-skill-os 9.3.1 → 10.2.0

package/tooling/run-aar.js

@@ -1,143 +1,72 @@
 import fs from 'fs';
 import path from 'path';
-import YAML from 'js-yaml';
 import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const rootDir = path.resolve(__dirname, '..');
-const skillsDir = path.join(rootDir, '.agents/skills');
-const graphPath = path.join(rootDir, '.agents/registry/capability-graph.yml');
-const workflowsDir = path.join(rootDir, '.agents/workflows');
+const graphPath = path.join(rootDir, '.agents/registry/graph.json');
 const reportsDir = path.join(rootDir, '.agents/reports');
 
-if (!fs.existsSync(reportsDir)) {
-  fs.mkdirSync(reportsDir, { recursive: true });
-}
-
-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) {
-    return null;
+/**
+ * Run After Action Review (AAR).
+ * Reads graph.json and generates health report.
+ */
+export async function runAar() {
+  if (!fs.existsSync(graphPath)) {
+    console.error('❌ graph.json not found. Run: node tooling/build-registry.js');
+    return;
   }
-}
-
-// 1. Skill Audit
-function runSkillAudit() {
-  const dirs = fs.readdirSync(skillsDir).filter(name => !name.startsWith('_') && fs.statSync(path.join(skillsDir, name)).isDirectory());
-  
-  let report = `# Skill Audit Report\n\n`;
-  let valid = 0;
-
-  dirs.forEach(skill => {
-    const skillPath = path.join(skillsDir, skill, 'SKILL.md');
-    if (!fs.existsSync(skillPath)) return;
-    
-    const content = fs.readFileSync(skillPath, 'utf8');
-    const data = parseFrontmatter(content);
-    if (!data) return;
-
-    // Check boundary
-    const bounds = data.decision_boundary || {};
-    const hasOwns = bounds.owns && bounds.owns.length > 0;
-    const hasNotOwn = bounds.does_not_own && bounds.does_not_own.length > 0;
-    const hasConflicts = bounds.conflicts_with !== undefined; // can be empty array
-    const hasDelegates = bounds.delegates_to !== undefined; // optional
-    
-    let score = 0;
-    if (hasOwns) score += 30;
-    if (hasNotOwn) score += 30;
-    if (hasConflicts) score += 20;
-    if (hasDelegates) score += 20; // bonus if exists or architecture skill
-    if (!hasDelegates && !skill.includes('architecture') && !skill.includes('orchestrator')) {
-        score += 20; // It's fine if implementation skill doesn't delegate
-    }
-
-    report += `## ${skill}\n`;
-    report += `- \`owns\`: ${hasOwns ? '✅' : '❌'}\n`;
-    report += `- \`does_not_own\`: ${hasNotOwn ? '✅' : '❌'}\n`;
-    report += `- \`conflicts_with\`: ${hasConflicts ? '✅' : '❌'}\n`;
-    report += `- \`delegates_to\`: ${hasDelegates ? '✅' : (skill.includes('architecture') ? '❌ (Architecture should delegate)' : '➖ (Optional)')}\n`;
-    report += `**Boundary Health Score: ${score}/100**\n\n`;
-    
-    if (score >= 80) valid++;
-  });
-
-  report += `\n**Total Scanned:** ${dirs.length}\n`;
-  report += `**Total Passed (>=80):** ${valid}\n`;
-
-  fs.writeFileSync(path.join(reportsDir, 'skill-audit.md'), report);
-  console.log('✅ Skill audit complete.');
-}
 
-// 2. Graph Audit
-function runGraphAudit() {
-  if (!fs.existsSync(graphPath)) return;
-  const graph = YAML.load(fs.readFileSync(graphPath, 'utf8'));
-  
-  let report = `# Graph Health Report\n\n`;
-  const incoming = {};
-  const outgoing = {};
-  const conflicts = [];
-  
-  Object.keys(graph.nodes).forEach(n => {
-    incoming[n] = 0;
-    outgoing[n] = 0;
-  });
-
-  graph.edges.forEach(e => {
-    if (outgoing[e.from] !== undefined) outgoing[e.from]++;
-    if (incoming[e.to] !== undefined) incoming[e.to]++;
-    
-    if (e.relation === 'conflicts_with') {
-      conflicts.push(`- **${e.from}** conflicts **${e.to}**\n  - Reason: Semantic overlap\n  - Severity: High\n  - Resolution: Context loader intervention required`);
-    }
-  });
+  if (!fs.existsSync(reportsDir)) {
+    fs.mkdirSync(reportsDir, { recursive: true });
+  }
 
-  report += `## Hub Risk Analysis\n`;
-  const MAX_OUT = 12;
-  const MAX_IN = 15;
-  const ALLOWED_HUBS = ['qk-orchestrator', 'qk-context-loader'];
+  const graph = JSON.parse(fs.readFileSync(graphPath, 'utf8'));
+  const nodes = Object.keys(graph.nodes || {});
+  const edges = graph.edges || [];
+  const adjacency = graph.adjacency || {};
+
+  let report = '# After Action Review (AAR)\n\n';
+  report += `**Generated:** ${new Date().toISOString()}\n\n`;
+
+  // Node health
+  report += '## Node Health\n\n';
+  report += '| Node | Version | Platforms | Dependencies |\n';
+  report += '|------|---------|-----------|-------------|\n';
+  for (const [id, node] of Object.entries(graph.nodes || {})) {
+    const deps = (node.dependencies || []).join(', ') || '—';
+    report += `| ${id} | ${node.version || '—'} | ${(node.platforms || []).join(', ') || '—'} | ${deps} |\n`;
+  }
 
-  Object.keys(outgoing).forEach(id => {
-    const outCount = outgoing[id];
-    const inCount = incoming[id];
-    let risk = 'Low';
-    if (outCount > MAX_OUT || inCount > MAX_IN) {
-      if (ALLOWED_HUBS.includes(id)) {
-        risk = 'Allowed Exception';
-      } else {
-        risk = 'High Risk Hub';
-      }
-    }
-    if (risk !== 'Low') {
-      report += `- **${id}**: Incoming(${inCount}), Outgoing(${outCount}) -> [${risk}]\n`;
+  // Edge summary
+  report += '\n## Edge Summary\n\n';
+  report += `- Total edges: ${edges.length}\n`;
+  report += `- Total nodes: ${nodes.length}\n`;
+  report += `- Orphans: ${graph.orphan_count || 0}\n`;
+  report += `- Has cycles: ${graph.has_cycles || false}\n`;
+
+  // Platform coverage
+  report += '\n## Platform Coverage\n\n';
+  const platformCounts = { antigravity: 0, claude: 0, opencode: 0 };
+  for (const node of Object.values(graph.nodes || {})) {
+    for (const p of node.platforms || []) {
+      if (platformCounts[p] !== undefined) platformCounts[p]++;
     }
-  });
-
-  report += `\n## Conflict Matrix\n`;
-  conflicts.forEach(c => {
-    report += `${c}\n\n`;
-  });
+  }
+  for (const [platform, count] of Object.entries(platformCounts)) {
+    report += `- ${platform}: ${count}/${nodes.length} skills\n`;
+  }
 
-  fs.writeFileSync(path.join(reportsDir, 'graph-health.md'), report);
-  console.log('✅ Graph audit complete.');
-}
+  // Version compliance
+  report += '\n## Version Compliance\n\n';
+  let compliant = 0;
+  for (const [id, node] of Object.entries(graph.nodes || {})) {
+    if (node.version === '10.2.0') compliant++;
+  }
+  report += `- Version 10.2.0: ${compliant}/${nodes.length}\n`;
 
-// 3. Workflow Audit
-function runWorkflowAudit() {
-  const workflows = fs.readdirSync(workflowsDir).filter(f => f.endsWith('.md') || f.endsWith('.yml'));
-  let report = `# Architecture & Workflow Audit\n\n`;
-  report += `## Workflows Found: ${workflows.length}\n`;
-  workflows.forEach(w => {
-    report += `- ${w}\n`;
-  });
-  fs.writeFileSync(path.join(reportsDir, 'architecture-audit.md'), report);
-  console.log('✅ Workflow audit complete.');
+  fs.writeFileSync(path.join(reportsDir, 'aar-report.md'), report);
+  console.log('✅ AAR report generated.');
 }
 
-runSkillAudit();
-runGraphAudit();
-runWorkflowAudit();
+export default { runAar };

package/tooling/sync-versions.js

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 
-const targetVersion = "9.1.0";
+const targetVersion = "10.2.0";
 const rootDir = process.cwd();
 const skillsDir = path.join(rootDir, '.agents', 'skills');
 
@@ -253,7 +253,7 @@ skills.forEach(skill => {
   if (fs.existsSync(skillMdPath)) {
     let content = fs.readFileSync(skillMdPath, 'utf8');
     let newContent = content.replace(/^version:\s*["']?[\d.]+["']?/m, `version: ${targetVersion}`);
-    newContent = newContent.replace(/^# ── V[\d]+: Classification/m, `# ── V9: Classification`);
+    newContent = newContent.replace(/^# ── V[\d]+: Classification/m, `# ── V10: Classification`);
     
     // Inject or update Memory Workflow (except qk-project-memory which manages memory itself)
     if (skill !== 'qk-project-memory' && skill !== 'qk-help') {

package/tooling/validate-graph.js

@@ -1,87 +1,100 @@
-import fs from 'fs';
-import path from 'path';
-import yaml from 'js-yaml';
-
-const GRAPH_FILE = path.resolve('.agents/registry/capability-graph.yml');
-
-function validateGraph() {
-  if (!fs.existsSync(GRAPH_FILE)) {
-    console.error('Không tìm thấy capability-graph.yml');
-    process.exit(1);
-  }
-
-  const content = fs.readFileSync(GRAPH_FILE, 'utf8');
-  const graph = yaml.load(content);
-
-  const nodes = Object.keys(graph.nodes || {});
-  const edges = graph.edges || [];
-
-  let errors = [];
-  
-  // 1. Kiểm tra edge references (tồn tại node đích)
-  let conflictsCount = 0;
-  edges.forEach(e => {
-    if (!nodes.includes(e.to)) {
-       // Cảnh báo nhưng không luôn lỗi vì to có thể là tên workflow
-       if (e.relation !== 'depends_on') {
-         errors.push(`Edge error: '${e.from}' trỏ đến '${e.to}' không tồn tại trong nodes (${e.relation})`);
-       }
-    }
-    if (e.relation === 'conflicts_with') conflictsCount++;
-  });
-
-  // 2. Kiểm tra reverse delegation (implementation -> architecture)
-  // Logic giả định dựa trên keyword
-  edges.forEach(e => {
-    if (e.relation === 'delegates_to') {
-       if (e.from.includes('ui-builder') && e.to.includes('architecture')) {
-           errors.push(`Policy violation: Implementation skill '${e.from}' không được delegate cho Architecture skill '${e.to}'`);
-       }
-    }
-  });
-
-  // 3. Isolated nodes (Ngoại trừ qk-orchestrator, qk-product-specification)
-  let orphanCount = 0;
-  const allowedIsolated = ['qk-orchestrator', 'qk-product-specification'];
-  
-  const connectedNodes = new Set();
-  edges.forEach(e => {
-    connectedNodes.add(e.from);
-    if (nodes.includes(e.to)) connectedNodes.add(e.to);
-  });
-
-  nodes.forEach(n => {
-    if (!connectedNodes.has(n)) {
-       if (!allowedIsolated.includes(n)) {
-          errors.push(`Orphan node: '${n}' bị cô lập (không nối đi đâu, không ai nối tới).`);
-          orphanCount++;
-       }
-    }
-  });
-
-  // Mock Cycles check
-  let cyclesCount = 0; // Để đơn giản, giả lập 0 cycles. Trong thực tế dùng thuật toán DFS.
-
-  const score = Math.max(0, 100 - (errors.length * 5));
-
-  console.log('─────────────────────────────────────────────────');
-  console.log('📊 Capability Graph Health');
-  console.log('─────────────────────────────────────────────────');
-  console.log(`Nodes:       ${nodes.length}`);
-  console.log(`Edges:       ${edges.length}`);
-  console.log(`Coverage:    100%`);
-  console.log(`Conflicts:   ${conflictsCount}`);
-  console.log(`Orphan:      ${orphanCount}`);
-  console.log(`Cycles:      ${cyclesCount}`);
-  console.log(`\nScore:       ${score}/100`);
-  
-  if (errors.length > 0) {
-    console.log('\n⚠️ Cảnh báo & Lỗi:');
-    errors.forEach(err => console.log(`- ${err}`));
-    process.exit(1);
-  } else {
-    console.log('\n✅ Capability Graph hợp lệ.');
-  }
-}
-
-validateGraph();
+import fs from 'fs';
+import path from 'path';
+
+const GRAPH_FILE = path.resolve('.agents/registry/graph.json');
+
+function validateGraph() {
+  if (!fs.existsSync(GRAPH_FILE)) {
+    console.error('Không tìm thấy graph.json');
+    process.exit(1);
+  }
+
+  const content = fs.readFileSync(GRAPH_FILE, 'utf8');
+  const graph = JSON.parse(content);
+
+  const nodes = Object.keys(graph.nodes || {});
+  const edges = graph.edges || [];
+  const adjacency = graph.adjacency || {};
+
+  let errors = [];
+  
+  // 1. Kiểm tra edge references (tồn tại node đích)
+  let conflictsCount = 0;
+  edges.forEach(e => {
+    if (!nodes.includes(e.to)) {
+       // Cảnh báo nhưng không luôn lỗi vì to có thể là tên workflow
+       if (e.relation !== 'depends_on') {
+         errors.push(`Edge error: '${e.from}' trỏ đến '${e.to}' không tồn tại trong nodes (${e.relation})`);
+       }
+    }
+    if (e.relation === 'conflicts_with') conflictsCount++;
+  });
+  // 2. Isolated nodes (Ngoại trừ qk-orchestrator)
+  let orphanCount = 0;
+  const allowedIsolated = ['qk-orchestrator'];
+  
+  const connectedNodes = new Set();
+  edges.forEach(e => {
+    connectedNodes.add(e.from);
+    connectedNodes.add(e.to);
+  });
+
+  nodes.forEach(n => {
+    if (!connectedNodes.has(n)) {
+       if (!allowedIsolated.includes(n)) {
+          errors.push(`Orphan node: '${n}' bị cô lập.`);
+          orphanCount++;
+       }
+    }
+  });
+
+  // Cycle detection using DFS
+  let cyclesCount = 0;
+  const visited = {};
+  const recursionStack = {};
+
+  function detectCycle(node) {
+    visited[node] = true;
+    recursionStack[node] = true;
+    const neighbors = adjacency[node] || [];
+    for (const neighbor of neighbors) {
+      if (!visited[neighbor]) {
+        if (detectCycle(neighbor)) return true;
+      } else if (recursionStack[neighbor]) {
+        cyclesCount++;
+        return true;
+      }
+    }
+    recursionStack[node] = false;
+    return false;
+  }
+
+  for (const node of nodes) {
+    if (!visited[node]) {
+      detectCycle(node);
+    }
+  }
+
+  const score = Math.max(0, 100 - (errors.length * 5) - (cyclesCount * 2));
+
+  console.log('─────────────────────────────────────────────────');
+  console.log('📊 Capability Graph Health');
+  console.log('─────────────────────────────────────────────────');
+  console.log(`Nodes:       ${nodes.length}`);
+  console.log(`Edges:       ${edges.length}`);
+  console.log(`Coverage:    100%`);
+  console.log(`Conflicts:   ${conflictsCount}`);
+  console.log(`Orphan:      ${orphanCount}`);
+  console.log(`Cycles:      ${cyclesCount}`);
+  console.log(`\nScore:       ${score}/100`);
+  
+  if (errors.length > 0) {
+    console.log('\n⚠️ Cảnh báo & Lỗi:');
+    errors.forEach(err => console.log(`- ${err}`));
+    process.exit(1);
+  } else {
+    console.log('\n✅ Capability Graph hợp lệ.');
+  }
+}
+
+validateGraph();

package/tooling/validate-skills.js

@@ -28,11 +28,13 @@ function parseFrontmatter(content) {
   };
 
   const name = extract('name');
-  const version = extract('version') || '7.5.0';
+  const version = extract('version') || '10.2.0';
   let status = extract('status');
   
   if (!status && (version.startsWith('8.') || version.startsWith('9.'))) {
       status = 'stable';
+  } else if (!status && version.startsWith('10.')) {
+      status = 'stable';
   } else if (!status) {
       status = 'legacy';
   }
@@ -41,10 +43,16 @@ function parseFrontmatter(content) {
     name,
     version,
     status,
-    hasIntent: yamlString.includes('intent:'),
     hasWorkflow: yamlString.includes('workflow:'),
-    hasVerification: yamlString.includes('verification:'),
-    hasSelection: yamlString.includes('selection:')
+    hasTriggers: yamlString.includes('triggers:'),
+    hasRules: yamlString.includes('rules:'),
+    hasClassification: yamlString.includes('classification:'),
+    hasReferences: yamlString.includes('references:'),
+    isV10Frontmatter: yamlString.includes('classification:'),
+    isLegacyFrontmatter: yamlString.includes('workflow:') && !yamlString.includes('classification:'),
+    isV10Format: (yamlString.includes('classification:') && yamlString.includes('references:')) ||
+                 (yamlString.includes('workflow:') && !yamlString.includes('classification:')),
+    hasPlatforms: yamlString.includes('platforms:')
   };
 }
 
@@ -58,8 +66,8 @@ function validate() {
     .filter(d => !d.startsWith('_') && fs.statSync(path.join(SKILLS_DIR, d)).isDirectory());
 
   let totalScanned = 0;
-  let stableValid = 0;
-  let stableTotal = 0;
+  let v10Valid = 0;
+  let v10Total = 0;
   let legacyIgnored = 0;
   let missingRequiredCount = 0;
 
@@ -73,13 +81,23 @@ function validate() {
 
     totalScanned++;
 
-    if (meta.status === 'stable' || meta.status === 'experimental') {
-      stableTotal++;
-      if (meta.hasIntent && meta.hasWorkflow && meta.hasVerification && meta.hasSelection) {
-        stableValid++;
+    if (meta.version && meta.version.startsWith('10.')) {
+      v10Total++;
+      const hasExitCodes = content.includes('Thoái Ra Mã') || content.includes('Exit Codes');
+      const hasCompliance = content.includes('Compliance');
+      const hasConfidence = content.includes('Confidence Model') || content.includes('Độ Tin Cậy');
+      const hasEvidence = content.includes('Bằng Chứng') || content.includes('Evidence Format');
+      const hasAllV10Sections = hasExitCodes && hasCompliance && hasConfidence && hasEvidence && meta.hasPlatforms;
+      if (hasAllV10Sections) {
+        v10Valid++;
       } else {
         missingRequiredCount++;
-        console.warn(`[WARN] ${meta.name} is missing required V8 fields`);
+        const missing = [];
+        if (!hasExitCodes) missing.push('Exit Codes');
+        if (!hasCompliance) missing.push('Compliance');
+        if (!hasConfidence) missing.push('Confidence Model');
+        if (!hasEvidence) missing.push('Evidence Format');
+        console.warn(`[WARN] ${meta.name} is missing V10 sections: ${missing.join(', ')}`);
       }
     } else {
       legacyIgnored++;
@@ -87,9 +105,9 @@ function validate() {
   }
 
   console.log(`\nSkills scanned: ${totalScanned}`);
-  console.log(`\nStable/Experimental:`);
-  console.log(`${stableValid}/${stableTotal} valid`);
-  console.log(`\nLegacy:`);
+  console.log(`\nV10 Format:`);
+  console.log(`${v10Valid}/${v10Total} valid`);
+  console.log(`\nLegacy (pre-V10):`);
   console.log(`${legacyIgnored}/${legacyIgnored} ignored`);
   console.log(`\nMissing required:`);
   console.log(`${missingRequiredCount}`);

package/.agents/README.md

@@ -1,90 +0,0 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.2.1
-
-> **v8.2.1 "EDAOS v8.2 — Governed Capability Metadata & Eval Platform"**
-
-Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **v8.2.1 (EDAOS v8.2)** với kiến trúc **Manifest-First & Eval Platform**, giúp giảm tối đa chi phí nhận thức (cognitive load) cho các AI Agent thế hệ mới (như Antigravity) nhờ chỉ định ranh giới định lượng, đồ thị phụ thuộc O(1), và các Blueprint Plugins quy chuẩn cho từng ngành nghề kỹ thuật.
-
----
-
-## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v8.2 Architecture)
-
-### 1. Manifest-First & O(1) Registry Engine
-Không còn phụ thuộc vào việc đọc/scan toàn bộ markdown mệt mỏi. AI Agent tra cứu siêu dữ liệu từ `.agents/registry/index.yaml` và kiểm duyệt chu trình không lặp (acyclic validation) thông qua O(1) graph JSON (`.agents/registry/graph.json`). Tốc độ hiểu và phân công năng lực đạt ngưỡng sub-second!
-
-### 2. V8.2 Blueprint Plugins & Universal 4-Folder Architecture
-Khởi tạo dự án (chỉ đạo qua `qk-project-bootstrap`) hỗ trợ sinh file `project.yaml` gốc từ thư viện Blueprint Plugins:
-- **RAG / AI Agents:** Cấu trúc 4 thư mục chuẩn thực chiến: `prompts/`, `data/` (bảo vệ `data/raw` bất biến), `agents/`, và `evals/`.
-- **Standard Software Coding:** Kiến trúc module sạch vững chắc với `DESIGN.md` và rào cản kiểm duyệt tự động.
-- **Automation Workflows:** Các luồng tích hợp n8n và dữ liệu lớn.
-
-### 3. Eval Pipeline Platform (Khép Kín Kiểm Định)
-Chấm dứt việc tin tưởng AI blindly. Mọi Capability đều có thẻ điểm định lượng (`scorecard.yaml`), kết nối log thực thi thực tế từ thư mục `evals/traces/` qua cổng thẩm định sắt đá `qk-validation-gate`. Trách nhiệm định lượng 0–100 với sai số 0% (zero tolerance for fabrication).
-
-### 4. Domain Patterns Separation (Bảo Vệ Kernel)
-Các hệ thống AI chuyên sâu (như **Xây dựng DDC 192 skills**, bóc tách BIM/IFC, ERP) được tải lập trình viên cấu hình dạng Module dưới `knowledge/domain-patterns/` thay vì phơi bày trực tiếp vào 30 Core Developer Skills, giữ cho đồ thị cốt lõi luôn nhanh bén mượt mà!
-
----
-
-## 🧩 Danh sách 30 Master Skills (Core Developer Capabilities)
-
-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: NXP (Không cần cài global) - MỚI
-```bash
-npx ai-developer-skill-os init
-```
-
-### Cách 2: NPM Global (Khuyên dùng cho cá nhân)
-```bash
-npm i -g ai-developer-skill-os
-```
-
-### 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
-
-# Cài Antigravity Local (chỉ dự án này)
-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ác IDE/AI Assistant Được Hỗ Trợ
-- (1) Cursor
-- (2) Windsurf
-- (3) Cline / Roo Code
-- (4) Antigravity / Gemini
-- (5) Codex
-- (6) Kilo Code
-
----
-
-## 🧪 Đá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 run test:agent
-npm run test:graph
-npm run test:registry
-```
-
-## 🚀 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!