ai-developer-skill-os 8.3.0 → 9.0.0

package/.agents/skills/qk-ui-system-builder/evals/scorecard.yaml

@@ -0,0 +1,26 @@
+name: qk-ui-system-builder-eval
+description: Đánh giá việc khởi tạo Design System Tokens
+version: 9.0.0
+threshold: 85 # Đảm bảo tokens sinh ra ánh xạ 1:1 với contract
+
+metrics:
+  - id: strict_token_mapping
+    name: Ánh xạ chuẩn xác từ Contract
+    description: Các token được tạo ra có khớp 1:1 với DESIGN.md không?
+    weight: 45
+    criteria:
+      - Tuyệt đối không tự bịa (hallucinate) các token màu sắc/kích thước ngoài hợp đồng (45đ)
+
+  - id: naming_conventions
+    name: Kỷ luật Đặt tên (Naming Convention)
+    description: Cấu trúc biến CSS có đúng chuẩn và dễ mở rộng không?
+    weight: 30
+    criteria:
+      - Sử dụng đúng cấu trúc `--color-role-shade` thay vì tên ngẫu nhiên (30đ)
+
+  - id: dark_mode_support
+    name: Hỗ trợ Giao diện Tối (Dark Mode)
+    description: Có xử lý cấu trúc biến để hỗ trợ Data-theme/Dark-mode không?
+    weight: 25
+    criteria:
+      - Thiết lập base variables có khả năng scale cho các theme khác nhau (25đ)

package/.agents/skills/qk-validation-gate/SKILL.md

@@ -1,12 +1,12 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-validation-gate
-version: 8.2.0
+version: 9.0.0
 status: stable
 description: "Cổng kiểm tra chất lượng & Eval Pipeline bắt buộc — chạy linters, tests, và đánh giá scorecard.yaml định lượng cho AI Agent."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
 
-# ── V8: Classification ─────────────────────────────────────
+# ── V9: Classification ─────────────────────────────────────
 type: utility
 
 intent:
@@ -85,6 +85,136 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 > **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
+## Memory Workflow
+
+### Pre-flight Retrieve (Trước khi thực thi)
+- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
+  bắt buộc tra cứu:
+  - `.agents/knowledge/index.yaml` (Shared Project Knowledge)
+  - `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
+
+- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
+  - Architecture
+  - Hard Bug
+  - Convention
+  - Pattern
+  - Tech Debt Pattern
+  - 👉 *Domain Focus:* Convention / Architecture (vd: các ngưỡng scorecard, quy định zero hallucination).
+
+- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
+  Không được xem Memory là Source of Truth.
+  Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
+
+---
+
+### Learning Flow (AI tự học có kiểm soát)
+- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
+  - Hard Bug có khả năng tái diễn.
+  - Pattern làm việc lặp lại trong dự án.
+  - Convention hoặc quy tắc kiến trúc mới.
+  - Quyết định Architecture quan trọng.
+  - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
+  - 👉 *Domain Harvest:* Bộ tiêu chí kiểm định mới (Scorecard metric) được tích hợp vào pipeline.
+
+- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
+- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
+- AI không được tự động Promote Candidate Memory thành Project Knowledge.
+
+---
+
+### Post-flight Harvest (Đề xuất → Phê duyệt)
+Sau khi hoàn thành task:
+- AI đánh giá các Candidate Memory đã tạo.
+- Nếu phát hiện tri thức có giá trị tái sử dụng:
+  - Đề xuất người dùng xem xét.
+  - Gửi yêu cầu phê duyệt thông qua:
+    - `/learn`
+    - `qk-project-memory`
+- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
+
+```
+.ai-local/candidates/  ──(Approve)──>  .agents/knowledge/index.yaml
+```
+
+- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
+  - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
+
+---
+
+### Ignore (Không đưa vào Memory)
+Không lưu:
+- Trace log của một session đơn lẻ.
+- Temporary debugging data.
+- Output của một lần chạy test/scan.
+- Report health tạm thời của một đợt kiểm tra.
+- Lỗi nhỏ chỉ xảy ra một lần.
+- Thông tin không có khả năng tái sử dụng.
+- 👉 *Domain Ignore:* Kết quả log pass/fail tạm thời của một build con.
+
+---
+
+### Golden Rule
+> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
+> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
+
+---
+---
+
+### Learning Flow (AI tự học có kiểm soát)
+- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
+  - Hard Bug có khả năng tái diễn.
+  - Pattern làm việc lặp lại trong dự án.
+  - Convention hoặc quy tắc kiến trúc mới.
+  - Quyết định Architecture quan trọng.
+  - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
+  - 👉 *Domain Harvest:* Bộ tiêu chí kiểm định mới (Scorecard metric) được tích hợp vào pipeline.
+
+- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
+- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
+- AI không được tự động Promote Candidate Memory thành Project Knowledge.
+
+---
+
+### Post-flight Harvest (Đề xuất → Phê duyệt)
+Sau khi hoàn thành task:
+- AI đánh giá các Candidate Memory đã tạo.
+- Nếu phát hiện tri thức có giá trị tái sử dụng:
+  - Đề xuất người dùng xem xét.
+  - Gửi yêu cầu phê duyệt thông qua:
+    - `/learn`
+    - `qk-project-memory`
+- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
+
+```
+.ai-local/candidates/  ──(Approve)──>  .agents/knowledge/index.yaml
+```
+
+- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
+  - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
+
+---
+
+### Ignore (Không đưa vào Memory)
+Không lưu:
+- Trace log của một session đơn lẻ.
+- Temporary debugging data.
+- Output của một lần chạy test/scan.
+- Report health tạm thời của một đợt kiểm tra.
+- Lỗi nhỏ chỉ xảy ra một lần.
+- Thông tin không có khả năng tái sử dụng.
+- 👉 *Domain Ignore:* Kết quả log pass/fail tạm thời của một build con.
+
+---
+
+### Golden Rule
+> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
+> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
+
+---
+---
+---
+---
+
 ## Preconditions
 - [ ] Project has `package.json` with lint/test scripts (or equivalent for other runtimes)
 - [ ] Target scope is specified (specific files, or whole project)

package/.agents/skills/qk-validation-gate/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-validation-gate"
+version: "9.0.0"
+description: "Cổng kiểm tra chất lượng & Eval Pipeline bắt buộc — chạy linters, tests, và đánh giá scorecard.yaml định lượng cho AI Agent."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "verification"
+    - "quality-gates"
+    - "test-execution"
+  references:
+    - "coding"
+    - "architecture"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-validation-gate"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-validation-gate/evals/scorecard.yaml

@@ -0,0 +1,26 @@
+name: qk-validation-gate-eval
+description: Đánh giá Cổng kiểm tra Chất lượng V8.2
+version: 9.0.0
+threshold: 100 # Phải đạt 100 điểm tuyệt đối vì đây là lưới rà soát cuối cùng trước khi Release
+
+metrics:
+  - id: threshold_enforcement
+    name: Thi hành Threshold nghiêm ngặt
+    description: Agent có bỏ qua lỗi Lint, Type check hoặc Test coverage không?
+    weight: 40
+    criteria:
+      - Chặn đứng (FAILED) ngay lập tức nếu Lint error > 0, Type error > 0, hoặc Coverage < 80% (40đ)
+
+  - id: quantitative_eval_execution
+    name: Đánh giá định lượng AI (Eval Pipeline)
+    description: Có đọc và áp dụng scorecard.yaml để chấm điểm AI agent output không?
+    weight: 35
+    criteria:
+      - Áp dụng rubric để chấm điểm và từ chối kết quả nếu tổng điểm < Threshold (35đ)
+
+  - id: trace_verification
+    name: Xác minh Trace (Zero Hallucination)
+    description: Có đối chiếu kết quả với file log traces thực tế không?
+    weight: 25
+    criteria:
+      - Bắt buộc kiểm tra dấu vết (traces) thực thi để đảm bảo AI không tự bịa ra kết quả test (25đ)

package/.agents/skills/qk-web-quality-gate/SKILL.md

@@ -1,12 +1,12 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-web-quality-gate
-version: 8.1.0
+version: 9.0.0
 status: experimental
 description: "Kiểm toán tổng thể chất lượng Web: Accessibility (A11y), SEO, Web Performance, Security, UX Heuristics."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
 
-# ── V8: Classification ─────────────────────────────────────
+# ── V9: Classification ─────────────────────────────────────
 type: capability
 
 intent:
@@ -100,6 +100,136 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 > **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
+## Memory Workflow
+
+### Pre-flight Retrieve (Trước khi thực thi)
+- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
+  bắt buộc tra cứu:
+  - `.agents/knowledge/index.yaml` (Shared Project Knowledge)
+  - `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
+
+- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
+  - Architecture
+  - Hard Bug
+  - Convention
+  - Pattern
+  - Tech Debt Pattern
+  - 👉 *Domain Focus:* Convention / Hard Bug (vd: chỉ số Core Web Vitals LCP/CLS, rủi ro bot SEO/A11y).
+
+- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
+  Không được xem Memory là Source of Truth.
+  Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
+
+---
+
+### Learning Flow (AI tự học có kiểm soát)
+- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
+  - Hard Bug có khả năng tái diễn.
+  - Pattern làm việc lặp lại trong dự án.
+  - Convention hoặc quy tắc kiến trúc mới.
+  - Quyết định Architecture quan trọng.
+  - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
+  - 👉 *Domain Harvest:* Mẫu tối ưu hiệu năng web (vd: chiến lược lazyload hình ảnh, bundle partition).
+
+- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
+- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
+- AI không được tự động Promote Candidate Memory thành Project Knowledge.
+
+---
+
+### Post-flight Harvest (Đề xuất → Phê duyệt)
+Sau khi hoàn thành task:
+- AI đánh giá các Candidate Memory đã tạo.
+- Nếu phát hiện tri thức có giá trị tái sử dụng:
+  - Đề xuất người dùng xem xét.
+  - Gửi yêu cầu phê duyệt thông qua:
+    - `/learn`
+    - `qk-project-memory`
+- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
+
+```
+.ai-local/candidates/  ──(Approve)──>  .agents/knowledge/index.yaml
+```
+
+- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
+  - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
+
+---
+
+### Ignore (Không đưa vào Memory)
+Không lưu:
+- Trace log của một session đơn lẻ.
+- Temporary debugging data.
+- Output của một lần chạy test/scan.
+- Report health tạm thời của một đợt kiểm tra.
+- Lỗi nhỏ chỉ xảy ra một lần.
+- Thông tin không có khả năng tái sử dụng.
+- 👉 *Domain Ignore:* Report Lighthouse của lần đo test tạm thời.
+
+---
+
+### Golden Rule
+> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
+> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
+
+---
+---
+
+### Learning Flow (AI tự học có kiểm soát)
+- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
+  - Hard Bug có khả năng tái diễn.
+  - Pattern làm việc lặp lại trong dự án.
+  - Convention hoặc quy tắc kiến trúc mới.
+  - Quyết định Architecture quan trọng.
+  - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
+  - 👉 *Domain Harvest:* Mẫu tối ưu hiệu năng web (vd: chiến lược lazyload hình ảnh, bundle partition).
+
+- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
+- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
+- AI không được tự động Promote Candidate Memory thành Project Knowledge.
+
+---
+
+### Post-flight Harvest (Đề xuất → Phê duyệt)
+Sau khi hoàn thành task:
+- AI đánh giá các Candidate Memory đã tạo.
+- Nếu phát hiện tri thức có giá trị tái sử dụng:
+  - Đề xuất người dùng xem xét.
+  - Gửi yêu cầu phê duyệt thông qua:
+    - `/learn`
+    - `qk-project-memory`
+- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
+
+```
+.ai-local/candidates/  ──(Approve)──>  .agents/knowledge/index.yaml
+```
+
+- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
+  - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
+
+---
+
+### Ignore (Không đưa vào Memory)
+Không lưu:
+- Trace log của một session đơn lẻ.
+- Temporary debugging data.
+- Output của một lần chạy test/scan.
+- Report health tạm thời của một đợt kiểm tra.
+- Lỗi nhỏ chỉ xảy ra một lần.
+- Thông tin không có khả năng tái sử dụng.
+- 👉 *Domain Ignore:* Report Lighthouse của lần đo test tạm thời.
+
+---
+
+### Golden Rule
+> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
+> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
+
+---
+---
+---
+---
+
 ## Preconditions
 - [ ] Ứng dụng web đã có thể chạy hoặc code đã được viết một phần.
 

package/.agents/skills/qk-web-quality-gate/capability.yaml

@@ -0,0 +1,24 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-web-quality-gate"
+version: "9.0.0"
+description: "Kiểm toán tổng thể chất lượng Web: Accessibility (A11y), SEO, Web Performance, Security, UX Heuristics."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "qk-web-quality-gate"
+  references:
+    - "architecture"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "lighthouse audit"
+    - "accessibility review"
+    - "performance audit"
+    - "seo audit"
+  does_not_own:
+    - "ui component implementation"
+  conflicts_with: []

package/.agents/skills/qk-web-quality-gate/evals/scorecard.yaml

@@ -0,0 +1,26 @@
+name: qk-web-quality-gate-eval
+description: Đánh giá chất lượng tổng thể của Web (Performance, SEO, A11y, UX)
+version: 9.0.0
+threshold: 85 # Đảm bảo đo lường đầy đủ 4 trục chất lượng của ứng dụng Web
+
+metrics:
+  - id: core_web_vitals_focus
+    name: Phân tích Core Web Vitals
+    description: Có đánh giá đúng các chỉ số ảnh hưởng đến trải nghiệm (LCP, CLS, INP) không?
+    weight: 40
+    criteria:
+      - Báo cáo rõ ràng về kích thước Bundle, chiến lược Lazy loading và tối ưu hình ảnh (40đ)
+
+  - id: seo_and_accessibility
+    name: Kiểm tra SEO & A11y
+    description: Web có thân thiện với bot tìm kiếm và người khuyết tật không?
+    weight: 35
+    criteria:
+      - Quét Semantic HTML, Meta tags, và các rào cản truy cập ARIA (35đ)
+
+  - id: actionable_recommendations
+    name: Khuyến nghị thực tiễn (Actionable)
+    description: Các đề xuất tối ưu có khả thi để lập trình viên thực hiện ngay không?
+    weight: 25
+    criteria:
+      - "Không chỉ ra lỗi chung chung mà chỉ định rõ cách fix (ví dụ: Thêm loading='lazy' vào thẻ img dòng 15) (25đ)"

package/.agents/workflows/production-release.yml

@@ -0,0 +1,173 @@
+name: production-release
+version: 8.0.0
+description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: release-safety
+
+triggers:
+  - "release production"
+  - "deploy production"
+  - "chuẩn bị release"
+  - "kiểm tra release"
+
+ide_binding:
+  slash_command: "/release"
+  aliases: ["/deploy", "/prod-release"]
+
+steps:
+  - id: gate_1_validation
+    name: "Gate 1: Validation Gate"
+    purpose: "Đảm bảo qk-validation-gate đã pass trước khi release"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - validation_result
+    actions:
+      - "Chạy npm run test:registry"
+      - "Chạy npm run lint"
+      - "Chạy npm run test:agent"
+      - "Chạy npm run test:graph"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "any validation gate fails"
+      message: "Validation gate thất bại. Fix trước khi tiếp tục."
+
+  - id: gate_2_capability
+    name: "Gate 2: Capability Integrity"
+    purpose: "Kiểm tra tất cả capability.yaml hợp lệ và không trùng lặp"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - capability_check
+    actions:
+      - "Validate tất cả capability.yaml files có schema_version: 1"
+      - "Kiểm tra không có capability.yaml trùng id"
+      - "Verify mỗi skill có SKILL.md tương ứng"
+      - "Verify mỗi SKILL.md có capability.yaml tương ứng"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "capability.yaml missing or invalid"
+      message: "Một số capability.yaml bị thiếu hoặc không hợp lệ."
+
+  - id: gate_3_registry
+    name: "Gate 3: Registry Consistency"
+    purpose: "Kiểm tra registry files nhất quán với filesystem"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - registry_check
+    actions:
+      - "Chạy node tooling/build-registry.js"
+      - "So sánh index.yaml với filesystem实际"
+      - "Kiểm tra graph.json không có cycles"
+      - "Kiểm tra không có orphan nodes"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "registry inconsistency detected"
+      message: "Registry không nhất quán với filesystem."
+
+  - id: gate_4_workflows
+    name: "Gate 4: Workflow Validation"
+    purpose: "Kiểm tra tất cả workflow files hợp lệ"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - workflow_check
+    actions:
+      - "Validate tất cả workflow YAML files có schema hợp lệ"
+      - "Kiểm tra mỗi workflow có steps, triggers, exit_codes"
+      - "Verify mỗi skill reference workflow tồn tại"
+      - "Kiểm tra không có workflow reference đến internal"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "workflow validation fails"
+      message: "Một hoặc nhiều workflow không hợp lệ."
+
+  - id: gate_5_security
+    name: "Gate 5: Security Scan"
+    purpose: "Quét bảo mật trước khi release"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - security_report
+    actions:
+      - "Chạy npm audit --production"
+      - "grep_search cho secrets, tokens, API keys trong code"
+      - "Kiểm tra không có hardcoded credentials"
+      - "Verify .env files không bị commit"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "critical or high security issues found"
+      message: "Có vấn đề bảo mật nghiêm trọng. Cần fix trước khi release."
+
+  - id: gate_6_size
+    name: "Gate 6: Bundle & Size Check"
+    purpose: "Kiểm tra kích thước bundle và dependencies"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - size_report
+    actions:
+      - "Chạy npm run build (production mode)"
+      - "Kiểm tra bundle size trong giới hạn"
+      - "Kiểm tra không có devDependencies trong production"
+      - "Verify tree-shaking hoạt động đúng"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "bundle size exceeds limit"
+      message: "Bundle size vượt hạn chế. Cần tối ưu trước khi deploy."
+
+  - id: gate_7_changelog
+    name: "Gate 7: Changelog & Documentation"
+    purpose: "Kiểm tra CHANGELOG.md và documentation đã cập nhật"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - docs_check
+    actions:
+      - "Kiểm tra CHANGELOG.md có entry cho version này"
+      - "Verify README.md phản ánh đúng capabilities hiện tại"
+      - "Kiểm tra SKILL.md descriptions không bị encoding issues"
+      - "Verify capability.yaml descriptions chính xác"
+    exit_on_fail: PARTIAL
+    human_checkpoint:
+      condition: "changelog missing or docs outdated"
+      message: "CHANGELOG hoặc documentation chưa cập nhật. Cần fix trước khi release."
+
+  - id: gate_8_report
+    name: "Gate 8: Release Report"
+    purpose: "Tạo báo cáo release có signed kết quả tất cả gates"
+    required: true
+    skip_if: null
+    inputs:
+      - validation_result
+      - capability_check
+      - registry_check
+      - workflow_check
+      - security_report
+      - size_report
+      - docs_check
+    outputs:
+      - release_report
+    actions:
+      - "Tổng hợp tất cả gate results"
+      - "Generate structured release report"
+      - "Include evidence format cho mỗi gate"
+      - "Record exit code và timestamp"
+      - "Sign report với qk-team key"
+    exit_on_fail: FAILED
+
+escalation:
+  max_retries: 1
+  on_failure: "Report which gates failed and exact fix required. Do NOT deploy."

package/CHANGELOG.md

@@ -5,6 +5,41 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [9.0.0] — 2026-08 — EDAOS v9.0: Universal Project Knowledge V1 & Dual-Mode Memory Architecture
+
+### Added
+- **Universal Project Knowledge Protocol V1 (AI Skin V9)**: Core memory discipline integrated across all 32 developer skills (`qk-*`) and core OS rules.
+- **Dual-Mode Memory Setup**: Fully automated support for Private Mode (`.ai-local/`, git-ignored by default) and Shared Team Mode (`.agents/`, commit/reviewable via PRs).
+- **Pre-flight & Post-flight Governance**: Skills automatically check memory before performing redundant project searches (Navigator pattern) and propose structured knowledge harvesting (`Architecture`, `Convention`, `Pattern`, `Hard Bug`) subject to human confirmation (AI proposes → Human approves).
+- **Zero-Overwrite & Portable References**: Mandatory 100-line limit for project `AGENTS.md`, workspace-relative symbol paths, and immutable memory history (`status: Active` → `Archived`).
+
+## [8.3.1] — 2026-07 — EDAOS v8.3.1: Eval Pipeline & Agentic Governance
+
+### Added
+- **evals/runner.js**: Automated evaluation pipeline script to parse `scorecard.yaml`, run linting, verify agent traces, and calculate total scores against thresholds.
+- **Eval Scripts**: Added `npm run eval` and `npm run eval:all` in `package.json` for running automated validations.
+- **Scorecards**: Created comprehensive, quantitative AI-eval `evals/scorecard.yaml` for all 31 standard skills.
+- **.agents/rules/anti-patterns.md (R-C-09)**: Strict global rule prohibiting AI-slop, God Files, Circular Dependencies, and poor code quality practices.
+
+## [8.3.0] — 2026-07 — EDAOS v8.3: Design System, IDE Config & Infrastructure Fixes
+
+### Added
+- **DESIGN.md**: Design system contract with HSL color tokens, spacing scale, typography, border radius, shadows, animation tokens, dark mode support, and z-index layers
+- **vite.config.js**: Vitest configuration with coverage (v8 provider), reporter setup, and test isolation
+- **bin/lint.js**: Lint script for validating SKILL.md spec compliance, workflow structure, and rule files
+- **.kilo/kilo.json**: Kilo IDE configuration with project paths, commands, agent model settings, and skin design token reference
+- **.kilo/command/ and .kilo/agent/ directories**: Standardized Kilo command and agent configuration directories
+- **qk-context-loader/references/**: Loading patterns document for context dependency graph construction
+
+### Fixed
+- **.agentsignore**: Removed `schemas/` from rogue artifacts list; legitimate schema files at `.agents/docs/schemas/` are now accessible to AI agents
+- **ADR-008 renamed to ADR-005**: Corrected decision sequence to remove gap between ADR-004 and ADR-005
+- **qk-design-system-engineering status**: Changed from `experimental` to `stable` to reflect full V8.2 review compliance
+- **Source .agentsignore**: Fixed same `schemas/` issue in root `.agentsignore` (not just worktree copy)
+
+### Removed
+- **Legacy agent-skills dirs**: Removed obsolete `khanhmcp-server/agent-skills-eval/` and `khanhmcp-server/agent-skills-tool/` directories (pre-V8 artifacts)
+
 ## [8.2.1] — 2026-07 — Token Optimization Patch
 
 ### Fixed

package/README.md

@@ -1,12 +1,21 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.3.0
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v9.0.0
 
-> **v8.3.0 "EDAOS v8.3 — Governed Capability Metadata & Eval Platform"**
+> **v9.0.0 "EDAOS v9.0 — Governed Capability & Universal Project Knowledge V1 Architecture"**
 
-Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **V8.3.0 (EDAOS v8.3)** 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.
+Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **V9.0.0 (EDAOS v9.0)** với kiến trúc **Universal Project Knowledge V1 & Dual-Mode Memory Platform**, 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.
 
 ---
 
-## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v8.2 Architecture)
+## 🧭 Kiến Trúc Trí Nhớ Dự Án (Universal Project Knowledge V1)
+- **Quản trị như Source Code:** Tri thức dự án đơn giản, minh bạch, có thể xem xét (review) qua Pull Request, 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`).
+- **Hai Chế Độ (Dual-Mode):** 
+  - *Private Mode (`.ai-local/`):* Bộ nhớ cá nhân ẩn danh, tự động được thêm vào `.gitignore` để bảo vệ sự riêng tư.
+  - *Shared Mode (`.agents/`):* Tri thức chung cho cả Team và hệ thống CI/CD, có thể commit và review ngang hàng như code.
+- **Tối Ưu Nhảy Sọt (Navigator):** File `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 `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).
+
+---
+
+## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v9.0 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!