ai-developer-skill-os 9.1.2 → 9.3.0

package/.agents/workflows/context-discovery.yml

@@ -0,0 +1,94 @@
+name: context-discovery
+version: 9.2.0
+description: "Pipeline load context dự án và vẽ dependency graph trước khi thực hiện task — ngăn hallucination kiến trúc."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: review
+
+triggers:
+  - "load context"
+  - "tìm hiểu codebase"
+  - "explore architecture"
+  - "explain the codebase"
+  - "trace dependency"
+  - "hiểu project"
+  - "which skill should i use"
+  - "help me choose"
+
+ide_binding:
+  slash_command: "/discover"
+  aliases: ["/context", "/explore", "/research"]
+
+steps:
+  - id: define_scope
+    name: "Xác định phạm vi cần khám phá"
+    purpose: "Biết chính xác cần tìm hiểu gì để phục vụ task tiếp theo"
+    required: true
+    inputs:
+      - task_goal            # Task người dùng muốn làm sau context load
+    outputs:
+      - discovery_questions  # Các câu hỏi cụ thể cần trả lời
+      - entry_points         # Files/folders bắt đầu đọc
+    actions:
+      - "Đặt 3-5 câu hỏi cụ thể cần trả lời (không đọc mọi thứ)"
+      - "Ưu tiên: package.json / go.mod / pyproject.toml → biết stack"
+      - "Sau đó: src/ structure → biết architecture pattern"
+    exit_on_fail: BLOCKED
+
+  - id: detect_stack
+    name: "Phát hiện Stack & Architecture"
+    purpose: "Xác định tech stack, project type, và conventions đang dùng"
+    required: true
+    inputs:
+      - entry_points
+    outputs:
+      - detected_stack       # language, framework, DB, CSS, test runner...
+      - project_type         # web-app / api / data-pipeline / monorepo / ai-agent
+      - architecture_pattern # feature-based / domain / layered / atomic
+    actions:
+      - "Đọc package.json / requirements.txt / go.mod / Cargo.toml"
+      - "Đọc cấu trúc thư mục src/ (1 level sâu)"
+      - "Tìm config files: tsconfig, prisma/schema, docker-compose, .env.example"
+      - "Đọc tối đa 2-3 file entry point để xác nhận pattern"
+
+  - id: map_dependencies
+    name: "Vẽ Dependency Map"
+    purpose: "Hiểu component nào phụ thuộc vào component nào"
+    required: false
+    skip_if: "Task không cần hiểu cross-component dependencies"
+    inputs:
+      - detected_stack
+      - entry_points
+    outputs:
+      - dependency_map       # Key components + their relationships
+      - critical_paths       # Paths hay bị ảnh hưởng khi thay đổi
+    context_budget: 100
+    actions:
+      - "Dùng grep_search để trace imports, không đọc toàn bộ file"
+      - "Đọc targeted sections (≤ 100 lines per read)"
+      - "Ghi lại circular deps hay God File nếu phát hiện"
+
+  - id: synthesize
+    name: "Tổng hợp Context"
+    purpose: "Đóng gói kết quả sẵn sàng inject vào skill thực thi tiếp theo"
+    required: true
+    inputs:
+      - detected_stack
+      - dependency_map
+      - discovery_questions
+    outputs:
+      - context_summary      # Stack + Architecture + Key files
+      - skill_recommendation # Skill phù hợp nhất cho task hiện tại
+      - warnings             # Deprecated patterns, risks, anti-patterns phát hiện
+    actions:
+      - "Viết summary dạng bullet (không dài hơn 10 dòng)"
+      - "Đề xuất skill phù hợp nhất nếu chưa được chọn"
+      - "Flag pattern cũ hoặc vi phạm convention"
+      - "Ghi log execution trace vào evals/traces/ nếu có"
+
+escalation:
+  max_retries: 1
+  on_failure: "Report partial findings với confidence level, list files chưa đọc được"

package/.agents/workflows/feature-delivery.yml

@@ -98,7 +98,7 @@ steps:
 
   - id: verify
     name: "Verify implementation"
-    purpose: "Xác nhận feature hoạt động đúng theo acceptance criteria"
+    purpose: "Xác nhận feature hoạt động đúng theo acceptance criteria — quality gate bắt buộc"
     required: true
     skip_if: null
     inputs:
@@ -107,11 +107,15 @@ steps:
       - modified_files
     outputs:
       - verification_result
-      - unmet_criteria      # Any criteria not yet met
+      - unmet_criteria
+      - quality_gate_result   # PASS | PARTIAL | FAIL
     actions:
-      - "Đối chiếu từng acceptance criterion"
+      - "Đối chiếu từng acceptance criterion — list unmet nếu có"
       - "Re-read key implementation sections"
-      - "Run tests nếu có"
+      - "Run linter nếu có (npm run lint / ruff / eslint)"
+      - "Run tests nếu có (npm test / pytest / go test)"
+      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
+      - "  Checklist: universal_checks + feature-delivery specific checks"
       - "Ghi log execution trace vào evals/traces/"
     exit_on_fail: PARTIAL
 

package/.agents/workflows/refactor.yml

@@ -77,8 +77,8 @@ steps:
       - "Không add functionality mới trong khi refactor"
 
   - id: verify
-    name: "Verify behavior unchanged"
-    purpose: "Xác nhận external behavior giống hệt trước refactor"
+    name: "Verify behavior unchanged + quality gate"
+    purpose: "Xác nhận external behavior giống hệt trước refactor VÀ quality cải thiện"
     required: true
     skip_if: null
     inputs:
@@ -87,10 +87,13 @@ steps:
     outputs:
       - behavior_preserved    # true/false
       - test_results          # pass/fail/na
+      - quality_gate_result   # PASS | FAIL
     actions:
       - "Re-read modified sections"
-      - "So sánh với current_behavior_summary"
+      - "So sánh với current_behavior_summary — behavior PHẢI giống hệt"
       - "Chạy tests nếu có"
+      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
+      - "  Checklist: universal_checks + refactor specific checks"
       - "Ghi log execution trace vào evals/traces/"
     exit_on_fail: FAILED
 

package/.agents/workflows/shared/quality-gate.yml

@@ -0,0 +1,94 @@
+name: quality-gate
+version: 9.2.0
+description: "Shared quality gate — embedded vào bước verify của feature-delivery, bug-resolution, refactor. Source of truth duy nhất cho R-C-10 checklist."
+type: shared-step
+
+# ─────────────────────────────────────────────────────────────
+# CÁCH DÙNG TRONG WORKFLOW:
+#   Trong step verify của workflow, thêm dòng sau vào actions:
+#   - "Áp dụng shared quality gate: xem .agents/workflows/shared/quality-gate.yml"
+#   Rồi liệt kê CHỈ những check đặc thù của workflow đó.
+#
+# KHÔNG copy toàn bộ checklist này vào workflow — trỏ về file này.
+# Khi cần update checklist: sửa file này, tất cả workflow tự được cập nhật.
+# ─────────────────────────────────────────────────────────────
+
+universal_checks:
+  description: "Áp dụng cho MỌI workflow có side_effects: edit_files (R-C-10 trong coding.md)"
+  items:
+    - id: fn-length
+      check: "Function length ≤ 40 lines"
+      action: "Extract sub-function nếu vi phạm"
+
+    - id: file-length
+      check: "File length ≤ 300 lines"
+      action: "Split module nếu vi phạm"
+
+    - id: nesting-depth
+      check: "Nesting depth ≤ 3 levels"
+      action: "Extract early return hoặc helper function"
+
+    - id: cyclomatic
+      check: "Cyclomatic complexity ≤ 10"
+      action: "Simplify conditions, extract logic"
+
+    - id: no-silent-errors
+      check: "Không có empty catch, không dùng `!` hoặc `as` để bypass type"
+      action: "Fix root cause — report BLOCKED nếu không rõ root cause"
+
+    - id: no-magic-numbers
+      check: "Không có magic numbers/strings trong logic"
+      action: "Extract thành named constant"
+
+    - id: dry
+      check: "Không có logic lặp ≥ 2 lần"
+      action: "Extract thành shared function/util"
+
+    - id: naming
+      check: "Naming conventions: camelCase fn, PascalCase class, UPPER_SNAKE constant"
+      action: "Rename theo convention"
+
+    - id: no-console-log
+      check: "Không có console.log/print/fmt.Println debug còn sót"
+      action: "Xóa hoặc thay bằng proper logger"
+
+    - id: root-cause-fix
+      check: "Fix là root cause, không phải symptom patch"
+      action: "Report BLOCKED nếu root cause chưa rõ"
+
+workflow_specific_checks:
+  feature-delivery:
+    description: "Thêm vào sau universal_checks khi verify feature mới"
+    items:
+      - id: acceptance-criteria
+        check: "Tất cả acceptance criteria đã được đáp ứng"
+        action: "List unmet criteria, report PARTIAL nếu còn thiếu"
+      - id: run-tests
+        check: "Chạy linter + test suite (npm run lint / ruff / eslint / pytest)"
+        action: "Fix lint errors trước khi report SUCCESS"
+
+  bug-resolution:
+    description: "Thêm vào sau universal_checks khi verify bug fix"
+    items:
+      - id: no-regression
+        check: "Callers/dependents không bị break"
+        action: "Đọc caller files, verify interface không thay đổi"
+      - id: security-boundary
+        check: "Tuân thủ R-SEC-04 (Security Boundary)"
+        action: "Flag nếu fix chạm auth/payment/permission code"
+
+  refactor:
+    description: "Thêm vào sau universal_checks khi verify refactor"
+    items:
+      - id: behavior-unchanged
+        check: "External behavior giống hệt trước refactor"
+        action: "So sánh với current_behavior_summary, report FAILED nếu có diff"
+      - id: run-tests
+        check: "Test suite pass — không có regression"
+        action: "Report FAILED + rollback nếu test fail sau refactor"
+
+exit_criteria:
+  SUCCESS:  "Tất cả universal_checks + workflow_specific_checks đều pass"
+  PARTIAL:  "Universal checks pass, nhưng có workflow-specific check chưa xong (VD: test chưa được viết)"
+  FAILED:   "Bất kỳ universal check nào fail, hoặc behavior changed sau refactor, hoặc test regression"
+  BLOCKED:  "Root cause chưa rõ, hoặc thiếu thông tin để verify"

package/.agents/workflows/skin-governance.yml

@@ -0,0 +1,115 @@
+name: skin-governance
+version: 9.2.0
+description: "Workflow tối ưu hóa, kiểm định và nâng cấp AI Skin — observe usage, measure success, improve, validate, promote."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: skill-evolution
+
+triggers:
+  - "improve this skill"
+  - "tối ưu skill"
+  - "why does this skill keep failing"
+  - "optimize this workflow"
+  - "phân tích usage skill"
+  - "nâng cấp skin"
+  - "skin governance"
+
+ide_binding:
+  slash_command: "/skin-tune"
+  aliases: ["/evolve-skill", "/skin-governance"]
+
+steps:
+  - id: observe_usage
+    name: "Observe Usage"
+    purpose: "Thống kê cách skill được gọi, token consumed, exit codes phân bổ"
+    required: true
+    inputs:
+      - skill_logs
+      - evals_traces
+    outputs:
+      - usage_metrics        # trigger_rate, avg_tokens, exit_distribution
+    actions:
+      - "Đọc evals/traces/ của skill target"
+      - "Thống kê trigger rate và token usage per exit code"
+      - "Phát hiện pattern gọi sai skill (routing error)"
+
+  - id: measure_success
+    name: "Measure Success Rate"
+    purpose: "Đánh giá chất lượng thực thi theo scorecard"
+    required: true
+    inputs:
+      - usage_metrics
+      - scorecard_yaml
+    outputs:
+      - success_rate         # % SUCCESS / total runs
+      - weak_areas           # Steps hay fail nhất
+    actions:
+      - "Tính SUCCESS / FAILED / PARTIAL / BLOCKED ratio"
+      - "Xác định bước nào trong workflow hay bị BLOCKED nhất"
+      - "So sánh với threshold trong scorecard.yaml"
+
+  - id: detect_failure
+    name: "Detect Failure Patterns"
+    purpose: "Tìm root cause của các lần fail — không đoán mò"
+    required: true
+    inputs:
+      - execution_results
+      - evals_traces
+    outputs:
+      - failure_patterns     # Categorized: ambiguous_input | hallucination | budget_overrun | wrong_routing
+    actions:
+      - "Phân loại lỗi: ambiguous_input / hallucination / budget_overrun / wrong_routing"
+      - "Tìm ví dụ cụ thể từ traces"
+      - "Ghi root cause evidence cho từng category"
+
+  - id: improve_skill
+    name: "Propose Improvement"
+    purpose: "Đề xuất thay đổi cụ thể — không thay đổi ngầm"
+    required: true
+    inputs:
+      - failure_patterns
+      - skill_body
+    outputs:
+      - improvement_proposal   # Diff: what to add/remove/change + reason
+    actions:
+      - "Giảm noise trong instruction (xóa rule không được enforce)"
+      - "Cập nhật examples với case thực tế từ traces"
+      - "Tinh chỉnh token_budget nếu hay bị overrun"
+      - "Cập nhật triggers nếu routing hay sai"
+      - "KHÔNG tự sửa — trả proposal để human review"
+    human_checkpoint:
+      condition: always
+      message: "Review improvement proposal trước khi apply vào SKILL.md"
+
+  - id: validate
+    name: "Validate Proposal"
+    purpose: "Đảm bảo bản cải tiến không vi phạm governance rules"
+    required: true
+    inputs:
+      - improvement_proposal
+    outputs:
+      - validation_result    # PASS | FAIL với lý do
+    actions:
+      - "Kiểm tra schema compliance (SPEC.md frontmatter)"
+      - "Đảm bảo không tạo scope overlap với skill khác"
+      - "Verify triggers không trùng skill khác trong routing table"
+
+  - id: promote
+    name: "Promote to Stable"
+    purpose: "Đưa bản cải tiến vào production sau khi đã validate"
+    required: true
+    inputs:
+      - validation_result
+    outputs:
+      - promoted_skill       # version bumped SKILL.md
+    actions:
+      - "Bump patch version (9.2.x → 9.2.x+1)"
+      - "Cập nhật registry: node tooling/generate-registry.js"
+      - "Ghi changelog entry"
+
+escalation:
+  max_retries: 1
+  on_failure: "Hủy bỏ bản cải tiến, giữ nguyên version hiện tại, ghi failure reason"

package/README.md

@@ -1,99 +1,184 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v9.1.1
+# AI Developer Skill OS v9.2.0
 
-> **v9.1.1 "EDAOS v9.1 — Governed Capability & Universal Project Knowledge V1 Architecture"**
+> **v9.2.0 "EDAOS v9.2 — Role-Aware Execution & Semantic Naming"**
 
-Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **V9.1.1 (EDAOS v9.1.1)** với kiến trúc **Universal Project Knowledge V1 (Local Private & Self-Init Architecture)**, kết hợp cùng mô hình Manifest-First và Eval Pipeline, biến AI từ trợ lý bị động thành Sư phụ Lập trình (Elite AI Engineer) thấu hiểu sâu sắc codebase và tri thức dự án với chi phí tra cứu gần như bằng 0.
+Phiên bản **v9.2.0** tập trung vào 3 nâng cấp cốt lõi:
+1. **Role-Aware Execution** — AI tự động điều chỉnh chiều sâu phân tích theo role khai báo trong `DEV_PROFILE.md`
+2. **Semantic Naming** — Đổi tên skills, workflows theo đúng mục đích thực tế, loại bỏ tên trừu tượng
+3. **Prompt Templates theo Role** — Mỗi skill có examples cụ thể cho từng role (fe/be/fullstack/data/ai-engineer/devops)
 
 ---
 
-## 🧭 Kiến Trúc Trí Nhớ Dự Án (Universal Project Knowledge V1 - Local Private Mode)
-- **Quản trị như Source Code:** Tri thức dự án đơn giản, minh bạch, có thể xem xét (review) và **luôn có con người phê duyệt** (AI Đề xuất -> Con người Phê duyệt via `/learn` hoặc `./qk-project-memory`).
-- **Chính sách Local Private Duy Nhất & Tự động Khởi tạo (Self-Init Protocol):** 
-  - *Bộ Nhớ Cá Nhân (`.ai-local/`):* Toàn bộ tri thức ghi nhớ của dự án được tập trung lưu tại thư mục `.ai-local/` (bao gồm `AGENTS.md` và `knowledge/index.yaml`). Đã loại bỏ hoàn toàn chế độ dùng chung (`.agents/knowledge/index.yaml` - Shared Mode) để đảm bảo quyền riêng tư và tránh xung đột khi làm việc nhóm.
-  - *Tự động Khởi tạo & Bảo mật Gitignore:* Bất cứ khi nào AI kích hoạt kỹ năng hoặc cần tra cứu/học tri thức mà thư mục `.ai-local/` chưa tồn tại trong gốc dự án, AI **BẮT BUỘC** tự động tạo cấu trúc thư mục này và tự động thêm dòng `.ai-local/` vào file `.gitignore` của dự án ngay lập tức.
-- **Tối Ưu Nhảy Sọt (Navigator):** File `.ai-local/AGENTS.md` giới hạn siêu gọn dưới 100 dòng làm bản đồ chỉ đường, kết hợp cùng `.ai-local/knowledge/index.yaml` (lưu trữ đúng 4 loại: *Architecture, Convention, Pattern, Hard Bug*), triệt tiêu 80% chi phí tìm kiếm mù lòa (zero redundant searches).
+## Bắt đầu nhanh
 
----
+### Bước 1 — Khai báo role và stack một lần
 
-## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v9.0 Architecture)
+Tạo file `.agents/DEV_PROFILE.md` trong dự án:
 
-### 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!
+```yaml
+role: fullstack          # fe | be | fullstack | data | ai-engineer | devops
+stack:
+  frontend:  Next.js 14 + TypeScript
+  backend:   tRPC + Prisma
+  database:  PostgreSQL
+  css:       Tailwind CSS
+ai_style: concise        # concise | detailed | teaching
+```
 
-### 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.
+AI sẽ đọc file này trước mọi yêu cầu — không cần nhắc lại stack mỗi 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).
+### Bước 2 — Gọi skill
 
-### 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à!
+```bash
+# Cú pháp command
+./qk-feature-delivery
+./qk-bug-resolution
+./qk-api-lifecycle --fw=fastapi
+
+# Hoặc ngôn ngữ tự nhiên — AI tự route đúng skill
+"fix bug login crash"
+"viết api tạo đơn hàng"
+"refactor file UserService.ts quá dài"
+```
 
----
+### Cài đặt
 
-## 🧩 Danh sách 30 Master Skills (Core Developer Capabilities)
+```bash
+# NPX (không cần cài global)
+npx ai-developer-skill-os init
 
-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-data-engineer`, `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`
+# NPM global
+npm i -g ai-developer-skill-os
+
+# Với tham số IDE
+npx ai-developer-skill-os init --ide=cursor --scope=1
+npx ai-developer-skill-os init --ide=windsurf --scope=1
+npx ai-developer-skill-os init --ide=antigravity --scope=2
+```
+
+**IDE được hỗ trợ:** Cursor · Windsurf · Cline / Roo Code · Antigravity · Kilo Code · Codex
 
 ---
 
-## 💻 Cách Cài Đặt (Installation)
+## Kiến trúc v9.2
 
-### 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
+.agents/
+├── DEV_PROFILE.md        ← Khai báo role + stack (đọc đầu mỗi session)
+├── AGENTS.md             ← Entry point: routing table + role behavior matrix
+├── skills/               ← 33 capabilities — mỗi skill có SKILL.md
+├── workflows/            ← 10 execution pipelines
+├── rules/                ← 8 behavior policies
+├── registry/             ← Generated indexes (không sửa tay)
+├── knowledge/            ← Design intelligence + domain patterns
+└── blueprints/           ← Project scaffold templates
 ```
 
-### 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
+### Role Behavior Matrix
 
-# Cài Antigravity Local (chỉ dự án này)
-npx ai-developer-skill-os init --ide=antigravity --scope=1
+| Role | AI tập trung vào | AI bỏ qua |
+|---|---|---|
+| `fe` | Component arch, state, a11y, bundle size | DB schema, backend arch |
+| `be` | API contract, business logic, DB perf, security | CSS, UI layout |
+| `fullstack` | FE+BE end-to-end, type-safe contract | Over-engineering |
+| `data` | Idempotency, data quality, lineage, SLA | Application ORM, UI |
+| `ai-engineer` | Prompt eng, RAG arch, eval pipeline, hallucination | Standard CRUD |
+| `devops` | CI/CD, IaC, observability, rollback | Business logic, UI |
 
-# 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
+## 33 Skills (v9.2.0)
+
+### Core & Orchestration
+| Skill | Mô tả |
+|---|---|
+| `qk-orchestrator` | Route yêu cầu đến đúng skill, kiểm tra preconditions |
+| `qk-context-loader` | Load context, vẽ dependency graph trước khi code |
+| `qk-project-memory` | Lưu/tra cứu project knowledge (Architecture, Convention, Pattern, Hard Bug) |
+| `qk-project-bootstrap` | Khởi tạo dự án mới với Blueprint Plugins (RAG/Coding/Workflow) |
+
+### Product & Architecture
+| Skill | Mô tả |
+|---|---|
+| `qk-product-specification` | Idea → Requirement → Acceptance Criteria → Technical Spec |
+| `qk-frontend-architecture` | Quyết định kiến trúc FE: component strategy, state, routing |
+| `qk-project-audit` | Gap Analysis, Feasibility, Risk Assessment — báo cáo trước khi code |
+
+### Frontend & UI
+| Skill | Mô tả |
+|---|---|
+| `qk-ui-builder` | Build/edit/audit/redesign UI từ Figma/ảnh/design reference |
+| `qk-ui-system-builder` | Build Design System và token library từ DESIGN.md |
+| `qk-design-system-engineering` | Quản trị design system: tokens, component variants, governance |
+| `qk-api-consumer` | Consume API (REST/GraphQL/tRPC), manage state, bind vào UI |
+| `qk-ui-audit` | Audit UI với 57-check Anti-Slop checklist |
+| `qk-web-quality-gate` | A11y, SEO, Web Performance, Security, UX Heuristics |
+
+### Backend & Data
+| Skill | Mô tả |
+|---|---|
+| `qk-api-lifecycle` | Design + implement API với Zero-Trust — contract trước, code sau |
+| `qk-data-lifecycle` | Schema management + safe migrations (freeze → compat → cleanup) |
+| `qk-data-engineer` | Data pipelines: dbt, Spark, Airflow, Delta Lake — idempotency first |
+| `qk-access-policy` | RBAC/ABAC — định nghĩa role matrix trước, implement middleware sau |
+| `qk-db-optimizer` | Evidence-based DB optimization: EXPLAIN → analyze → index |
+
+### Engineering & Delivery
+| Skill | Mô tả |
+|---|---|
+| `qk-feature-delivery` | End-to-end feature: Requirements → Context → Design → Implement |
+| `qk-bug-resolution` | Closed-loop bug fix: Observe → Hypothesis → Evidence → Fix |
+| `qk-refactor` | Tái cấu trúc code không đổi behavior — extract, simplify, decouple |
+| `qk-upgrade` | Nâng cấp library/framework an toàn — incremental, rollback bắt buộc |
+| `qk-docs` | Viết/cập nhật docs chính xác tuyệt đối — match code thực tế |
+
+### Quality & Testing
+| Skill | Mô tả |
+|---|---|
+| `qk-test-engineering` | Test strategy: pyramid, coverage, regression, mock |
+| `qk-validation-gate` | Quality gate: linters, tests, scorecard.yaml (0–100) |
+| `qk-project-health` | Audit: Code Smells, Tech Debt, Architecture (0–100 score) |
+| `qk-code-review` | 4-Phase elite code review với Architect mindset |
+| `qk-engineering-standard` | Enforce SOLID, DRY, Clean Code với ngưỡng metric cụ thể |
+
+### Security, DevOps & AI
+| Skill | Mô tả |
+|---|---|
+| `qk-security-audit` | OWASP, dependency risk, secret detection, permission model |
+| `qk-devops-platform` | CI/CD strategy, deployment architecture, environment management |
+| `qk-production-release` | 8-gate mandatory checklist trước khi deploy production |
+| `qk-ai-builder` | Governed AI Agent & RAG pipeline design — eval pipeline included |
+| `qk-agent-observability` | Monitor AI skin routing decisions, failure patterns |
 
 ---
 
-## 🧪 Đánh Giá Tự Động (Agent Evaluation)
+## Changelog
 
-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):
+### v9.2.0 (2026-09-11)
+- **Thêm:** `DEV_PROFILE.md` — role + stack context file, AI đọc đầu mỗi session
+- **Thêm:** Role Behavior Matrix trong `AGENTS.md` — 6 roles với focus/depth/skip
+- **Thêm:** Prompt templates theo role trong 7 key skills
+- **Đổi tên:** `qk-fe-api-integration` → `qk-api-consumer` (rõ hơn, không FE-only)
+- **Đổi tên:** `qk-system-evolution` → `qk-upgrade` (đúng mục đích thực tế)
+- **Đổi tên:** `qk-project-analyst` → `qk-project-audit` (rõ output là audit report)
+- **Đổi tên workflow:** `skill-evolution.yml` → `skin-governance.yml`
+- **Đổi tên workflow:** `research.yml` → `context-discovery.yml`
+- **Xóa:** `qk-help` (deprecated từ v8.0, superseded bởi `qk-orchestrator`)
+- **Xóa:** `.ai-local/` Self-Init Protocol khỏi tất cả SKILL.md (giảm token overhead)
+- **Fix:** Compact routing table trong `AGENTS.md` — không cần đọc `skills-index.yml`
 
-```bash
-npm run test:agent
-npm run test:graph
-npm run test:registry
-```
+### v9.1.x (2026-08-03)
+- O(1) registry engine, Universal Project Knowledge V1
+
+### v9.0.0 (2026-07-01)
+- V9 schema migration, manifest-first architecture
+
+---
+
+## Đánh giá tự động
 
-## 🚀 Hướng Dẫn Sử Dụng
-Sau khi cài đặt thành công, hãy gõ lệnh:
 ```bash
-./qk-help
+npm run test:agent      # Routing intelligence tests
+npm run test:graph      # Capability graph validation
+npm run test:registry   # Registry consistency check
 ```
-để kích hoạt AI Orchestrator và khám phá sức mạnh của hệ điều hành!

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "9.1.2",
-  "description": "EDAOS v9.1 — Governed Capability Platform & Universal Project Knowledge V1 (Candidate Memory & Golden Rule Architecture).",
+  "version": "9.3.0",
+  "description": "EDAOS v9.3 — SSOT Governed Capability Platform with 2-Clause Triggers & Full Technical Lifecycle.",
   "main": "bin/install.js",
   "files": [
     "bin",