ai-developer-skill-os 8.3.0 → 8.3.1

package/.agents/skills/qk-ui-builder/capability.yaml

@@ -0,0 +1,29 @@
+schema_version: 1
+id: "qk-ui-builder"
+version: "8.3.1"
+description: "Xây dựng, sửa, audit, và học UI — từ Figma/ảnh, map API, fix bug UI, đến redesign cấu trúc."
+dependencies:
+  - "feature-delivery"
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "ui-implementation"
+    - "component-patterns"
+    - "design-system-integration"
+  references:
+    - "design-system"
+    - "architecture"
+    - "accessibility"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "ui-component-implementation"
+    - "design-token-application"
+  does_not_own:
+    - "visual-direction"
+    - "brand-identity"
+  conflicts_with: []
+  delegates_to: []

package/.agents/skills/qk-ui-system-builder/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-ui-system-builder
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Xây dựng Design System và token library từ DESIGN.md — không tự đặt ra token ngoài contract."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]

package/.agents/skills/qk-ui-system-builder/capability.yaml

@@ -0,0 +1,25 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-ui-system-builder"
+version: "8.3.1"
+description: "Xây dựng Design System và token library từ DESIGN.md — không tự đặt ra token ngoài contract."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "design-tokens"
+    - "ui-system"
+  references:
+    - "design-system"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "tokens"
+    - "ui-system"
+  does_not_own:
+    - "page implementation"
+    - "visual direction"
+  conflicts_with:
+    - "qk-design-system-engineering"

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: 8.3.1
+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,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-validation-gate
-version: 8.2.0
+version: 8.3.1
 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]

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: "8.3.1"
+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: 8.3.1
+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,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-web-quality-gate
-version: 8.1.0
+version: 8.3.1
 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]

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: "8.3.1"
+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: 8.3.1
+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 (vd: "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,33 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [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/bin/install.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import fs from 'fs';
 import path from 'path';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "8.3.0",
+  "version": "8.3.1",
   "description": "EDAOS v8.3 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
   "main": "bin/install.js",
   "files": [
@@ -26,6 +26,8 @@
     "test:registry": "vitest run && node tooling/build-registry.js",
     "test:graph": "node tooling/validate-graph.js",
     "lint": "node bin/lint.js",
+    "eval": "node evals/runner.js",
+    "eval:all": "node evals/runner.js --all",
     "test:agent": "node tests/agent-evaluation/runner/evaluate-routing.js",
     "generate:evaluation": "node tooling/generate-evaluation-cases.cjs",
     "install:antigravity": "node bin/install.js --ide=antigravity --scope=2",