ai-developer-skill-os 7.0.2 → 7.5.0

package/docs/CHI_TIET_SKILLS.md

@@ -5,7 +5,7 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 ---
 
 ## 🏗️ Lớp 0: Foundation Layer (Nền Tảng Cốt Lõi)
-*Lớp này đóng vai trò như "Não bộ trung ương", chuyên nhận lệnh, cấp quyền, cung cấp luật lệ và chuẩn bị môi trường trước khi bất kỳ dòng code nào được viết ra.*
+*Lớp này đóng vai trò như "Não bộ trung tâm", chuyên nhận lệnh, cấp quyền, cung cấp luật lệ và chuẩn bị môi trường trước khi bất kỳ dòng code nào được viết ra.*
 
 ### 1. `qk-orchestrator` (Trợ Lý Điều Phối)
 - **Mô tả:** Nhận lệnh chung chung từ người dùng, tự động phân tích ý đồ và định hướng luồng công việc (chọn gọi các kỹ năng nào tiếp theo).
@@ -15,23 +15,19 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 - **Mô tả:** Có khả năng đọc lướt dự án để gom chính xác các file liên quan đến task hiện tại (chống tràn bộ nhớ token của AI).
 - **Khi nào dùng:** Khi code dự án quá lớn, cần khoanh vùng các file cần sửa.
 
-### 3. `qk-policy-engine` (Động Cơ Chính Sách)
-- **Mô tả:** Xét duyệt xem yêu cầu của người dùng hoặc hành động của AI có vi phạm các nguyên tắc cốt lõi của dự án không.
-- **Khi nào dùng:** Được AI tự động gọi trước khi thực thi để đảm bảo tính hợp lệ.
-
-### 4. `qk-access-policy` (Kiểm Soát Phân Quyền)
+### 3. `qk-access-policy` (Kiểm Soát Phân Quyền)
 - **Mô tả:** Xử lý và cung cấp các quy tắc về bảo mật (Security), phân quyền (RBAC), Authentication (JWT/OAuth).
 - **Khi nào dùng:** Khi tính năng liên quan đến việc bảo mật, ai được quyền truy cập vào đâu.
 
-### 5. `qk-project-memory` (Trí Nhớ Dự Án)
+### 4. `qk-project-memory` (Trí Nhớ Dự Án)
 - **Mô tả:** Lưu trữ DNA của dự án, các quyết định kiến trúc, UI pattern và các convention đã được thống nhất từ trước.
 - **Khi nào dùng:** Khi muốn AI làm theo đúng style đã có sẵn trong dự án.
 
-### 6. `qk-engineering-standard` (Bộ Luật Thiết Kế)
+### 5. `qk-engineering-standard` (Bộ Luật Thiết Kế)
 - **Mô tả:** Bơm các "luật thép" (về Frontend, Backend, Database) vào ngữ cảnh để bắt AI tuân thủ cấu trúc thư mục và naming.
 - **Khi nào dùng:** Tự động gọi để ép AI viết code không bị rác.
 
-### 7. `qk-project-bootstrap` (Khởi Tạo Dự Án)
+### 6. `qk-project-bootstrap` (Khởi Tạo Dự Án)
 - **Mô tả:** Setup toàn bộ khung sườn của một dự án mới tinh từ con số 0 (Cấu hình lint, format, folder structure).
 - **Khi nào dùng:** Lúc bắt đầu dự án mới.
 
@@ -40,15 +36,15 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 ## 🎨 Lớp 1: UI System Layer (Hệ Thống Giao Diện)
 *Nhóm chuyên biệt về vẽ giao diện và quản lý hệ thống thành phần (Components).*
 
-### 8. `qk-ui-system-builder` (Kỹ Sư Hệ Thống UI)
+### 7. `qk-ui-system-builder` (Kỹ Sư Hệ Thống UI)
 - **Mô tả:** Quản lý Design Token, tạo ra các Component có thể tái sử dụng (Button, Table, Form) đảm bảo tính nhất quán toàn dự án.
 - **Khi nào dùng:** Xây dựng thư viện giao diện, tránh viết CSS lộn xộn.
 
-### 9. `qk-design-to-code` (Chuyển Đổi Thiết Kế)
+### 8. `qk-design-to-code` (Chuyển Đổi Thiết Kế)
 - **Mô tả:** Đọc hiểu hình ảnh/Figma để tự động chuyển thành mã nguồn giao diện (React, Tailwind, v.v.).
 - **Khi nào dùng:** Bóc tách UI từ bản thiết kế.
 
-### 10. `qk-ui-audit` (Kiểm Toán Giao Diện)
+### 9. `qk-ui-audit` (Kiểm Toán Giao Diện)
 - **Mô tả:** Kiểm tra độ nhất quán UI/UX, hỗ trợ Responsive trên điện thoại và tối ưu khả năng tiếp cận (Accessibility - a11y).
 - **Khi nào dùng:** Kiểm tra lỗi UI sau khi hoàn thiện giao diện.
 
@@ -57,32 +53,40 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 ## 💻 Lớp 2: Development Layer (Phát Triển E2E)
 *Khối thực thi mạnh mẽ nhất, đi từ A-Z một tính năng cụ thể.*
 
-### 11. `qk-feature-delivery` (Chuyển Giao Tính Năng)
+### 10. `qk-feature-delivery` (Chuyển Giao Tính Năng)
 - **Mô tả:** Kỹ năng toàn năng, tự động phân tích thiết kế Database -> Viết API -> Xây UI -> Viết Unit Test cho một tính năng trọn vẹn.
 - **Khi nào dùng:** Xây dựng tính năng hoàn chỉnh (Ví dụ: Chức năng Thanh Toán).
 
-### 12. `qk-api-lifecycle` (Vòng Đời API)
+### 11. `qk-api-lifecycle` (Vòng Đời API)
 - **Mô tả:** Chuyên biệt cho Backend: Viết spec, tạo Service, định nghĩa Type, viết Test và sinh tài liệu cho API.
 - **Khi nào dùng:** Xây dựng các Endpoint API.
 
-### 13. `qk-data-lifecycle` (Vòng Đời Dữ Liệu)
+### 12. `qk-data-lifecycle` (Vòng Đời Dữ Liệu)
 - **Mô tả:** Quản lý Schema, tạo file Migration, tối ưu câu lệnh truy vấn (SQL, Prisma, v.v.).
 - **Khi nào dùng:** Thay đổi cấu trúc cơ sở dữ liệu.
 
+### 13. `qk-db-optimizer` (Tối Ưu Database)
+- **Mô tả:** Phân tích EXPLAIN plan, tìm N+1 queries, đề xuất index và tối ưu query performance.
+- **Khi nào dùng:** Truy vấn chậm, performance DB issue.
+
+### 14. `qk-fe-api-integration` (Tích Hợp API Frontend)
+- **Mô tả:** Consume API Backend, quản lý State, bind vào UI — tuân thủ kiến trúc Base dự án.
+- **Khi nào dùng:** Khi cần gọi API từ frontend, map DTO, xử lý Loading/Error states.
+
 ---
 
 ## 🛡️ Lớp 3: Quality Assurance Layer (Đảm Bảo Chất Lượng)
 *Kiểm tra độ sạch của code và diệt bug.*
 
-### 14. `qk-project-health` (Kiểm Toán Dự Án)
+### 15. `qk-project-health` (Kiểm Toán Dự Án)
 - **Mô tả:** Quét toàn bộ dự án để tìm Code Smell, Nợ kỹ thuật (Tech Debt), và các vi phạm kiến trúc.
 - **Khi nào dùng:** Định kỳ kiểm tra chất lượng mã nguồn hoặc tối ưu hiệu năng.
 
-### 15. `qk-bug-resolution` (Giải Quyết Bug Triệt Để)
+### 16. `qk-bug-resolution` (Giải Quyết Bug Triệt Để)
 - **Mô tả:** Tái hiện lỗi, đào sâu tìm Root Cause, cung cấp giải pháp an toàn và viết Regression Test để chống lỗi lặp lại.
 - **Khi nào dùng:** Sửa các lỗi đứt gãy hoặc logic nghiêm trọng.
 
-### 16. `qk-validation-gate` (Cổng Kiểm Định)
+### 17. `qk-validation-gate` (Cổng Kiểm Định)
 - **Mô tả:** Kỹ năng chặn cửa. Bắt buộc chạy Test, Linting và Scan Security. Chỉ khi "PASS" mới cho phép kết thúc task.
 - **Khi nào dùng:** Nằm cuối quy trình code của bất kỳ tính năng nào.
 
@@ -91,11 +95,11 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 ## 🚀 Lớp 4 & 5: Evolution & Operation (Vận Hành & Tiến Hóa)
 *Triển khai dự án lên Production và nâng cấp phiên bản lớn.*
 
-### 17. `qk-system-evolution` (Tiến Hóa Hệ Thống)
+### 18. `qk-system-evolution` (Tiến Hóa Hệ Thống)
 - **Mô tả:** Nâng cấp dependency (VD: Next 14 lên 15), phân tích rủi ro ảnh hưởng và thực thi nâng cấp an toàn không downtime.
 - **Khi nào dùng:** Update version framework/thư viện.
 
-### 18. `qk-production-release` (Triển Khai Môi Trường)
+### 19. `qk-production-release` (Triển Khai Môi Trường)
 - **Mô tả:** Viết Dockerfile, cấu hình CI/CD Pipelines (Github Actions), Deploy lên Cloud (AWS, Vercel).
 - **Khi nào dùng:** Release sản phẩm cho người dùng cuối.
 
@@ -103,7 +107,7 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 
 ## 🤖 Lớp 6: AI Builder Layer (Tích hợp AI)
 
-### 19. `qk-ai-builder` (Xây Dựng AI App)
+### 20. `qk-ai-builder` (Xây Dựng AI App)
 - **Mô tả:** Chuyên thiết kế và code các ứng dụng AI như RAG (Retrieval-Augmented Generation), Agent logic và Prompt Engineering.
 - **Khi nào dùng:** Tích hợp LLM vào trong phần mềm của bạn.
 
@@ -112,14 +116,10 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 ## 📚 Lớp 7: Knowledge Layer (Tri Thức & Tài Liệu)
 *Hệ thống tự học và viết tài liệu vĩ đại của OS.*
 
-### 20. `qk-docs` (Kỹ Sư Tài Liệu)
+### 21. `qk-docs` (Kỹ Sư Tài Liệu)
 - **Mô tả:** Tự động sinh hoặc cập nhật tài liệu cho con người đọc: `README.md`, `CHANGELOG.md`, `API Docs`.
 - **Khi nào dùng:** Nằm ở cuối quy trình sau khi hoàn thành tính năng.
 
-### 21. `qk-documentation-system` (Hệ Thống Trí Nhớ)
-- **Mô tả:** Quản trị Tri thức máy. Tự động rút trích các Quyết định Kỹ thuật (ADR) hoặc Pattern mới xuất hiện trong code, và nạp ngược lại vào `qk-project-memory`.
-- **Khi nào dùng:** Hệ thống "tự học" để Agent trở nên thông minh hơn qua từng ngày.
-
 ### 22. `qk-help` (Tra Cứu Nhanh)
 - **Mô tả:** Cuốn từ điển sống. Cung cấp thông tin và hướng dẫn chi tiết (Pro-tips) về cách sử dụng toàn bộ hệ thống.
 - **Khi nào dùng:** Bất kỳ khi nào người dùng cần hỗ trợ sử dụng hệ điều hành.

package/docs/HUONG_DAN_SU_DUNG.md

@@ -1,7 +1,7 @@
 # Hướng Dẫn Sử Dụng — AI Developer Skill OS
 
 **Tác giả:** Quang Khánh  
-**Phiên bản:** v2.0.0 (Master OS Architecture)
+**Phiên bản:** v7.5.0 (Anti-Slop & Zero-Trust Architecture)
 
 Chào mừng bạn đến với **AI Developer Skill OS**, hệ điều hành kỹ năng (Skill Framework) biến các trợ lý AI (Gemini, Antigravity, Claude Code, Cursor, Windsurf) từ một "cỗ máy sinh code" thành một **Senior Software Engineer / Chief Architect** thực thụ với khả năng tự học, tự kiểm toán và tự viết tài liệu.
 
@@ -13,10 +13,10 @@ Thông thường, khi bạn yêu cầu AI "Làm cho tôi tính năng X", AI sẽ
 
 Với hệ điều hành 22 Master Skills này:
 1. Bạn đưa ra yêu cầu thông qua **`qk-orchestrator`**.
-2. Hệ thống sẽ tự động gọi **`qk-context-loader`** để gom đúng file (tránh tràn ngữ cảnh) và **`qk-policy-engine`** để kiểm tra quyền.
+2. Hệ thống sẽ tự động gọi **`qk-context-loader`** để gom đúng file (tránh tràn ngữ cảnh).
 3. Kế tiếp, **`qk-engineering-standard`** sẽ gắn các "luật thép" (rules) của dự án vào ngữ cảnh.
 4. AI kích hoạt kỹ năng thực thi E2E như **`qk-feature-delivery`** để code và test trọn vẹn.
-5. Cuối cùng, **`qk-validation-gate`** chặn lại kiểm tra lỗi, trước khi giao cho **`qk-docs`** và **`qk-documentation-system`** tự động cập nhật tài liệu và bộ nhớ hệ thống.
+5. Cuối cùng, **`qk-validation-gate`** chặn lại kiểm tra lỗi, trước khi giao cho **`qk-docs`** tự động cập nhật tài liệu.
 
 ---
 

package/docs/SPEC.md

@@ -1,6 +1,6 @@
-# AI Developer Skill OS - Specification (v4)
+# AI Developer Skill OS - Specification (v7.5)
 
-This document defines the strict contract and schema for developing Custom Skills in the AI Developer Skill OS. The metadata frontmatter is frozen to ensure cross-platform compatibility (Cursor, Claude Code, Windsurf, Gemini).
+This document defines the strict contract and schema for all `SKILL.md` files in the AI Developer Skill OS. Every active skill MUST comply with this specification. The frontmatter is frozen to ensure cross-platform compatibility and deterministic agent behavior.
 
 ## 1. Frontmatter Contract (YAML)
 
@@ -9,29 +9,79 @@ Every `SKILL.md` must begin with this exact YAML structure. Do not add, remove,
 ```yaml
 ---
 name: qk-[skill-name]
+category: [core|frontend|backend|fullstack|security|qa|maintenance|devops|utilities]
 version: X.Y.Z
-updated: YYYY-MM-DD
-description: Brief summary of what this skill accomplishes.
-behavior: static-analysis | development | validation | maintenance
-intent: review-code | fix-bug | implement-feature | validate | maintain
-priority: low | medium | high | critical
-tags: [tag1, tag2]
-platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: Natural language phrase that activates this skill.
-inputs: [Required inputs]
-outputs: [Expected outputs]
-allowed_tools: [Tool1, Tool2]
-pipeline: [analyze, plan, implement, validate, complete]
+description: "[One sentence — what this skill does]"
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+execution_mode: deterministic
+
+# Orchestrator routing metadata
+cost: [low|medium|high]
+latency: [fast|medium|slow]
+risk: [low|medium|high]
+side_effects: [edit_files|run_commands|read_only|none]
+produces: [report|code|schema|plan|tokens]
+consumes: [context-graph|design-md|stack-trace|json-payload|none]
+
+token_budget:
+  max_files_read: 3
+  max_lines_per_read: 150
+  max_shell_commands: 2
+  stop_early: true
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---
 ```
 
+### Field Definitions
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | string | YES | Skill identifier, must start with `qk-` |
+| `category` | enum | YES | Primary domain: `core`, `frontend`, `backend`, `fullstack`, `security`, `qa`, `maintenance`, `devops`, `utilities` |
+| `version` | semver | YES | Semantic version of this skill |
+| `description` | string | YES | One-sentence summary of the skill's purpose |
+| `platforms` | array | YES | Supported AI platforms. Valid values: `antigravity`, `claude-code`, `cursor`, `windsurf`, `kilo-code` |
+| `execution_mode` | string | YES | Must be `deterministic` for all v7.5 skills |
+| `cost` | enum | YES | Token/compute cost: `low`, `medium`, `high` |
+| `latency` | enum | YES | Expected execution speed: `fast`, `medium`, `slow` |
+| `risk` | enum | YES | Risk level of side effects: `low`, `medium`, `high` |
+| `side_effects` | enum | YES | What the skill modifies: `edit_files`, `run_commands`, `read_only`, `none` |
+| `produces` | array | YES | Output artifacts: `report`, `code`, `schema`, `plan`, `tokens` |
+| `consumes` | array | YES | Required inputs: `context-graph`, `design-md`, `stack-trace`, `json-payload`, `none` |
+| `token_budget.max_files_read` | int | YES | Maximum files to read before stopping |
+| `token_budget.max_lines_per_read` | int | YES | Maximum lines per file read operation |
+| `token_budget.max_shell_commands` | int | YES | Maximum shell commands allowed |
+| `token_budget.stop_early` | bool | YES | Whether to stop when confidence threshold is reached |
+| `exit_codes` | array | YES | Valid exit codes for this skill |
+
 ## 2. Skill Body Structure (Markdown)
 
-The body of the `SKILL.md` file MUST contain the following sections:
+The body of the `SKILL.md` file MUST contain the following sections in order:
+
+1. **Header:** Skill title and language rule
+2. **Preconditions:** Checklist of required inputs/state before execution
+3. **Scope:** What the skill explicitly does (✅) and does not do (❌)
+4. **Priority Order:** P1–P4 checks with skip thresholds for token budget management
+5. **Workflow:** Phased execution steps with explicit decision trees and exit conditions
+6. **Confidence Model:** HIGH/MEDIUM/LOW confidence levels with actions
+7. **Severity:** CRITICAL/HIGH/MEDIUM/LOW severity definitions with examples
+8. **Evidence Format:** Mandatory template for all findings
+9. **Retry Policy:** Retry logic with maximum attempt limits
+10. **Escalation Rules:** Structured BLOCKED response format
+11. **Handoff Contract:** JSON schema for `Consumes` and `Produces`
+12. **Output Format:** Mandatory output template
+13. **Exit Codes:** Table mapping codes to meanings
+
+## 3. Naming Conventions
+
+- Skill files: `skills/qk-[skill-name]/SKILL.md`
+- Registry entry: `qk-[skill-name]`
+- All code, identifiers, and file names: English only
+- Explanations and reports: Vietnamese (match user language)
 
-1. **Goal:** The core objective of the skill.
-2. **Chain of Thought (SOP):** The exact step-by-step reasoning the agent must follow.
-3. **Constraints & Rules:** Hard boundaries and limits for this specific skill.
-4. **Handoff Pipeline (Optional):** How this skill transitions to the next phase (e.g. passing to validation).
+## 4. Compliance Enforcement
 
-*Note: Skill documents MUST NOT declare Verification Levels or override Tool Efficiency policies. Those are exclusively managed by the Global Kernel (`AGENTS.md`).*
+- All skills MUST pass `npm run lint` (which validates frontmatter against this spec)
+- The `## Compliance` table at the bottom of each `SKILL.md` is deprecated and MUST be removed
+- CI pipeline enforces schema compliance automatically

package/framework/skill-schema.md

@@ -0,0 +1,310 @@
+# Skill Schema V7.5 — Runtime Standard Specification
+
+> **Mục đích:** Đây là "lint rules" chính thức cho mọi skill trong bộ V7.5.
+> Bất kỳ skill nào không pass spec này đều **phải được fix trước khi publish**.
+
+---
+
+## Frontmatter Required Fields
+
+```yaml
+# REQUIRED — tất cả fields sau đây bắt buộc phải có
+name: string               # qk-[skill-name]
+category: enum             # core|frontend|backend|fullstack|security|qa|maintenance|devops|utilities
+version: semver            # 7.5.x
+description: string        # one sentence, ends without period
+platforms: array           # [antigravity, claude-code, cursor, windsurf, kilo-code]
+execution_mode: string     # deterministic | exploratory
+skill_version: semver      # same as version
+runtime_version: integer   # 1 (current runtime contract version)
+schema_version: integer    # 2 (current schema version)
+cost: enum                 # low | medium | high
+latency: enum              # fast | medium | slow
+risk: enum                 # low | medium | high
+side_effects: enum         # edit_files | run_commands | read_only | none
+produces: array            # [code, report, schema, plan, tokens]
+consumes: array            # [context-graph, design-md, stack-trace, json-payload, none]
+token_budget:
+  max_files_read: integer  # 1–10
+  max_lines_per_read: integer  # 50–200
+  max_shell_commands: integer  # 0–5
+  stop_early: boolean
+exit_codes: array          # must include: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+```
+
+**Lint Rule:** Bất kỳ field nào thiếu → FAIL frontmatter check.
+
+---
+
+## 11 Required Body Sections
+
+Dưới đây là 11 sections bắt buộc trong body mỗi SKILL.md, theo thứ tự.
+**Special skills** (redirect, help) được miễn một số section — xem `special_skill_exemptions` cuối file.
+
+### Section 1: Language Rule Header
+```
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese (match user language).
+```
+**Lint Rule:** Phải có ngay sau heading `# qk-[name]`.
+
+---
+
+### Section 2: Preconditions
+```markdown
+## Preconditions
+- [ ] [Condition 1]
+- [ ] [Condition N]
+
+\`\`\`
+On missing precondition:
+  EXIT: BLOCKED
+  Message: "[specific message]"
+\`\`\`
+```
+**Lint Rules:**
+- Phải có ít nhất 1 precondition
+- Phải có code block với `EXIT: BLOCKED` và `Message:`
+- Không được chỉ có "Repository accessible" — phải specific
+
+---
+
+### Section 3: Scope + Non-Goals
+```markdown
+## Scope
+- ✅ [What it DOES]
+
+## Non-Goals
+- ❌ [Anti-pattern — with reason]
+```
+**Lint Rules:**
+- Scope: ≥ 2 items
+- Non-Goals: ≥ 3 items
+- At least one Non-Goal must be about tool usage (never create scripts / never read entire files)
+
+---
+
+### Section 4: Priority Order
+```markdown
+## Priority Order
+| Priority | Task | Skip Threshold |
+|----------|------|----------------|
+| P1       | ...  | Never          |
+```
+**Lint Rules:**
+- Minimum 3 priorities
+- P1 must have "Never" skip threshold
+- At least one Px must have a percentage threshold (e.g., "Budget < 50%")
+
+---
+
+### Section 5: Workflow with Decision Trees
+```markdown
+## Workflow
+
+### Phase N — [Name]
+**Steps:**
+1. [step]
+
+**Decision:**
+\`\`\`
+IF [condition] → [action]
+ELSE → [action]
+\`\`\`
+
+**Exit When:**
+- [condition] → go to Phase N+1 | EXIT: [code]
+```
+**Lint Rules:**
+- Minimum 2 phases
+- Each phase MUST have at least one `Decision:` block
+- Each phase MUST have `Exit When:` conditions
+- No phase can have only "steps" without decisions
+
+---
+
+### Section 6: Confidence Model
+```markdown
+## Confidence Model
+| Level  | Condition | Action |
+|--------|-----------|--------|
+| HIGH   | ...       | ...    |
+| MEDIUM | ...       | ...    |
+| LOW    | ...       | EXIT: BLOCKED |
+```
+**Lint Rules:**
+- Must have all 3 levels: HIGH, MEDIUM, LOW
+- LOW must always lead to either BLOCKED or user confirmation
+
+---
+
+### Section 7: Severity
+```markdown
+## Severity
+| Level    | Definition | Example |
+|----------|-----------|---------|
+| CRITICAL | ...       | ...     |
+| HIGH     | ...       | ...     |
+| MEDIUM   | ...       | ...     |
+| LOW      | ...       | ...     |
+```
+**Lint Rules:**
+- Must have all 4 levels: CRITICAL, HIGH, MEDIUM, LOW
+- Each level must have a concrete Example column
+
+---
+
+### Section 8: Evidence Format
+```markdown
+## Evidence Format
+\`\`\`
+[SEVERITY] path/to/file.ts:LINE
+[Field]:    [value]
+Confidence: [HIGH|MEDIUM|LOW]
+Fix:        [suggestion]
+\`\`\`
+```
+**Lint Rules:**
+- Must include `[SEVERITY]` tag with file:LINE format
+- Must include `Confidence:` field
+- Must include `Fix:` field
+- Must include a filled example below the template
+
+---
+
+### Section 9: Retry Policy
+```markdown
+## Retry Policy
+\`\`\`
+[trigger]
+  └─ [action]
+       ├─ [outcome A]
+       └─ [outcome B] → [escalation]
+            └─ Do NOT retry more than N times
+\`\`\`
+```
+**Lint Rules:**
+- Must have explicit max retry count (≤ 3)
+- Must specify what happens after max retries (ESCALATE or FAILED)
+- Read-only skills may have simplified retry: "Audit is read-only — no retry needed."
+
+---
+
+### Section 10: Escalation Rules
+```markdown
+## Escalation Rules
+\`\`\`
+BLOCKED: [specific reason]
+Missing:
+  - [artifact or info needed]
+Questions:
+  1. [specific question]
+Recommended Assumptions (if proceeding):
+  - [assumption]
+\`\`\`
+```
+**Lint Rules:**
+- Must have structured format: BLOCKED, Missing, Questions, Recommended Assumptions
+- Cannot be just "ask user" or "STOP"
+- Must have at least 1 specific question
+
+---
+
+### Section 11: Handoff Contract
+```markdown
+## Handoff Contract
+### Consumes
+\`\`\`json
+{ "from": "...", "required_fields": [...], "optional_fields": [...] }
+\`\`\`
+### Produces
+\`\`\`json
+{ "to": "...", "output_fields": [...] }
+\`\`\`
+```
+**Lint Rules:**
+- Both Consumes and Produces must be present
+- `required_fields` must be a non-empty array
+- `to` in Produces must reference a real skill name or "user"
+
+---
+
+### Section 12: Exit Codes Table
+```markdown
+## Exit Codes
+| Code    | Meaning | When |
+|---------|---------|------|
+| SUCCESS | ...     | ...  |
+| PARTIAL | ...     | ...  |
+| BLOCKED | ...     | ...  |
+| FAILED  | ...     | ...  |
+```
+**Lint Rules:**
+- Must have all 4 codes: SUCCESS, PARTIAL, BLOCKED, FAILED
+- Each must have "When" column with specific trigger condition
+
+---
+
+### Section 13: Compliance Block (NEW — End of File)
+```markdown
+## Compliance
+| Check                | Status |
+|----------------------|--------|
+| Runtime Standard     | 11/11  |
+| Frontmatter Complete | ✅     |
+| References Valid     | ✅     |
+| Decision Trees       | PASS   |
+| Thresholds Defined   | PASS   |
+| schema_version       | 2      |
+| runtime_version      | 1      |
+```
+**Lint Rules:**
+- Must be the LAST section in every skill
+- Must be auto-generated or manually updated on each change
+- "References Valid" = all `references/*.md` files actually exist
+
+---
+
+## Reference Files Rule
+
+If a SKILL.md mentions `references/[file].md`, that file MUST exist.
+
+```
+LINT ERROR: qk-ui-audit references "references/anti-slop-checklist.md" — FILE NOT FOUND
+```
+
+---
+
+## Special Skill Exemptions
+
+Some skills have reduced requirements:
+
+| Skill Type | Exempted Sections |
+|-----------|-------------------|
+| Redirect skill (`qk-policy-engine`) | Sections 2-12 optional — must have redirect target |
+| Help/Discovery skill (`qk-help`) | Sections 5-11 optional — must have skill list |
+
+---
+
+## Lint Scoring
+
+```
+Total sections: 13 (including Compliance block)
+Frontmatter: Pass/Fail (binary)
+
+Score = (sections_present / 13) × 100
+
+Grade:
+  100%  → COMPLIANT ✅
+  90%+  → MINOR ISSUES ⚠️
+  70%+  → NEEDS WORK ❌
+  <70%  → NON-COMPLIANT 🔴
+```
+
+---
+
+## Version History
+
+| schema_version | runtime_version | Changes |
+|---------------|-----------------|---------|
+| 1             | 1               | Initial V7.0 (YAML constraints only) |
+| 2             | 1               | V7.5 Runtime Standard (11 sections + metadata) |

package/package.json

@@ -1,22 +1,33 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "7.0.2",
-  "description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
+  "version": "7.5.0",
+  "description": "Behavior Specification Format Framework, AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 22 skills chuyên nghiệp.",
   "main": "bin/install.js",
   "bin": {
     "ai-developer-skill-os": "bin/install.js",
     "ai-skill": "bin/install.js"
   },
   "type": "module",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
     "test:registry": "vitest run --config vitest.config.js",
-    "lint": "echo \"No linter configured\" && exit 0"
+    "lint": "node bin/lint.js",
+    "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",
+    "install:cursor:local": "node bin/install.js --ide=cursor --scope=1",
+    "install:windsurf": "node bin/install.js --ide=windsurf --scope=2",
+    "install:claude": "node bin/install.js --ide=claude --scope=2",
+    "install:kilo": "node bin/install.js --ide=kilo --scope=2",
+    "install:multi": "node bin/install.js --ide=multi-ide --scope=2"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/phamquangkhanh2999/ai-developer-skill-os.git"
+    "url": "https://github.com/phamquangkhanh2999/ai-developer-skill-os.git"
   },
   "keywords": [
     "ai",

package/patch.js

@@ -0,0 +1,15 @@
+const fs = require('fs');
+let content = fs.readFileSync('bin/install.js', 'utf8');
+
+// Fix kiloConfig bug
+content = content.replace(
+    "if (!Array.isArray(kiloConfig.skills) || typeof kiloConfig.skills !== 'object' || !kiloConfig.skills.paths) {",
+    "if (!kiloConfig.skills || typeof kiloConfig.skills !== 'object' || Array.isArray(kiloConfig.skills) || !kiloConfig.skills.paths) {"
+);
+
+// Replace interactive prompt
+const startMarker = "rl.question(questionIde, (answerIde) => {";
+const endMarker = "} catch (error) {\\n      console.error('? C� l?i x?y ra trong qu� tr�nh c�i d?t:', error.message);\\n    } finally {\\n      rl.close();\\n    }\\n  });\\n});";
+
+const startIdx = content.indexOf(startMarker);
+// Actually simpler regex