ai-developer-skill-os 8.1.10 → 8.2.0

package/.agents/registry/index.yaml

@@ -0,0 +1,259 @@
+# AUTO-GENERATED BY registry-builder (tooling/build-registry.js)
+# DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
+schema_version: 1
+manifest_version: '8.2'
+generated_at: '2026-07-27T02:25:53.341Z'
+capabilities:
+  qk-access-policy:
+    path: .agents/skills/qk-access-policy
+    version: 8.0.0
+    tags:
+      - access
+      - policy
+    dependencies:
+      - feature-delivery
+  qk-agent-observability:
+    path: .agents/skills/qk-agent-observability
+    version: 8.1.3
+    tags:
+      - agent
+      - observability
+    dependencies:
+      - skill-evolution
+  qk-ai-builder:
+    path: .agents/skills/qk-ai-builder
+    version: 8.2.0
+    tags:
+      - ai
+      - builder
+    dependencies:
+      - feature-delivery
+  qk-api-lifecycle:
+    path: .agents/skills/qk-api-lifecycle
+    version: 8.0.0
+    tags:
+      - api
+      - lifecycle
+    dependencies:
+      - feature-delivery
+  qk-bug-resolution:
+    path: .agents/skills/qk-bug-resolution
+    version: 8.0.0
+    tags:
+      - bug
+      - resolution
+    dependencies:
+      - bug-resolution
+  qk-code-review:
+    path: .agents/skills/qk-code-review
+    version: 8.0.0
+    tags:
+      - code
+      - review
+    dependencies:
+      - code-review
+  qk-context-loader:
+    path: .agents/skills/qk-context-loader
+    version: 8.0.0
+    tags:
+      - context
+      - loader
+    dependencies:
+      - research
+  qk-data-lifecycle:
+    path: .agents/skills/qk-data-lifecycle
+    version: 8.0.0
+    tags:
+      - data
+      - lifecycle
+    dependencies:
+      - feature-delivery
+  qk-db-optimizer:
+    path: .agents/skills/qk-db-optimizer
+    version: 8.0.0
+    tags:
+      - db
+      - optimizer
+    dependencies:
+      - refactor
+  qk-design-system-engineering:
+    path: .agents/skills/qk-design-system-engineering
+    version: 8.1.0
+    tags:
+      - design
+      - system
+      - engineering
+    dependencies:
+      - feature-delivery
+  qk-devops-platform:
+    path: .agents/skills/qk-devops-platform
+    version: 8.1.1
+    tags:
+      - devops
+      - platform
+    dependencies:
+      - feature-delivery
+  qk-docs:
+    path: .agents/skills/qk-docs
+    version: 8.0.0
+    tags:
+      - docs
+    dependencies:
+      - documentation
+  qk-engineering-standard:
+    path: .agents/skills/qk-engineering-standard
+    version: 8.0.0
+    tags:
+      - engineering
+      - standard
+    dependencies:
+      - code-review
+  qk-fe-api-integration:
+    path: .agents/skills/qk-fe-api-integration
+    version: 8.0.0
+    tags:
+      - fe
+      - api
+      - integration
+    dependencies:
+      - feature-delivery
+  qk-feature-delivery:
+    path: .agents/skills/qk-feature-delivery
+    version: 8.0.0
+    tags:
+      - feature
+      - delivery
+    dependencies:
+      - feature-delivery
+  qk-frontend-architecture:
+    path: .agents/skills/qk-frontend-architecture
+    version: 8.1.0
+    tags:
+      - frontend
+      - architecture
+    dependencies:
+      - feature-delivery
+      - qk-ui-builder
+      - qk-ui-system-builder
+  qk-help:
+    path: .agents/skills/qk-help
+    version: 8.0.0
+    tags:
+      - help
+    dependencies:
+      - internal
+  qk-orchestrator:
+    path: .agents/skills/qk-orchestrator
+    version: 8.0.0
+    tags:
+      - orchestrator
+    dependencies:
+      - research
+  qk-product-specification:
+    path: .agents/skills/qk-product-specification
+    version: 8.1.0
+    tags:
+      - product
+      - specification
+    dependencies:
+      - spec-driven-development
+      - qk-feature-delivery
+  qk-production-release:
+    path: .agents/skills/qk-production-release
+    version: 8.0.0
+    tags:
+      - production
+      - release
+    dependencies:
+      - internal
+  qk-project-bootstrap:
+    path: .agents/skills/qk-project-bootstrap
+    version: 8.2.0
+    tags:
+      - project
+      - bootstrap
+    dependencies:
+      - feature-delivery
+  qk-project-health:
+    path: .agents/skills/qk-project-health
+    version: 8.0.0
+    tags:
+      - project
+      - health
+    dependencies:
+      - code-review
+  qk-project-memory:
+    path: .agents/skills/qk-project-memory
+    version: 8.0.0
+    tags:
+      - project
+      - memory
+    dependencies:
+      - documentation
+  qk-security-audit:
+    path: .agents/skills/qk-security-audit
+    version: 8.1.0
+    tags:
+      - security
+      - audit
+    dependencies:
+      - security-audit
+      - qk-validation-gate
+  qk-system-evolution:
+    path: .agents/skills/qk-system-evolution
+    version: 8.0.0
+    tags:
+      - system
+      - evolution
+    dependencies:
+      - refactor
+  qk-test-engineering:
+    path: .agents/skills/qk-test-engineering
+    version: 8.1.0
+    tags:
+      - test
+      - engineering
+    dependencies:
+      - feature-delivery
+  qk-ui-audit:
+    path: .agents/skills/qk-ui-audit
+    version: 8.0.0
+    tags:
+      - ui
+      - audit
+    dependencies:
+      - code-review
+  qk-ui-builder:
+    path: .agents/skills/qk-ui-builder
+    version: 8.0.0
+    tags:
+      - ui
+      - builder
+    dependencies:
+      - feature-delivery
+  qk-ui-system-builder:
+    path: .agents/skills/qk-ui-system-builder
+    version: 8.0.0
+    tags:
+      - ui
+      - system
+      - builder
+    dependencies:
+      - feature-delivery
+  qk-validation-gate:
+    path: .agents/skills/qk-validation-gate
+    version: 8.2.0
+    tags:
+      - validation
+      - gate
+    dependencies:
+      - code-review
+  qk-web-quality-gate:
+    path: .agents/skills/qk-web-quality-gate
+    version: 8.1.0
+    tags:
+      - web
+      - quality
+      - gate
+    dependencies:
+      - feature-delivery

package/.agents/skills/_template/capability.yaml

@@ -0,0 +1,20 @@
+# capability.yaml — Machine-readable Capability Manifest
+# Schema Version 1 — EDAOS v8.2 Governed Capability Platform
+schema_version: 1
+
+id: qk-template-capability
+version: "8.2.0"
+description: "Brief 1-line objective description of this capability for sub-second registry indexing."
+
+dependencies:
+  - qk-validation-gate
+
+tools:
+  - view_file
+  - replace_file_content
+
+knowledge:
+  - engineering-standard
+
+eval:
+  scorecard: evals/scorecard.yaml

package/.agents/skills/_template/evals/scorecard.yaml

@@ -0,0 +1,19 @@
+# scorecard.yaml — Governed Evaluation Schema
+# Schema Version 1 — EDAOS v8.2 Eval Platform
+schema_version: 1
+extends: default
+passing_threshold: 80
+
+criteria:
+  correctness:
+    weight: 40
+    description: "Exact adherence to logical requirements, architectural contracts, and syntax integrity."
+  completeness:
+    weight: 20
+    description: "Zero omission of required inputs, parameters, and boundary conditions."
+  security_and_governance:
+    weight: 25
+    description: "Compliance with zero-trust design, secret exclusion, and EDAOS safety rules."
+  formatting:
+    weight: 15
+    description: "Strict adherence to expected structured format without broken artifacts."

package/.agents/skills/qk-agent-observability/SKILL.md

@@ -71,3 +71,14 @@ selection:
 
 # Agent Observability Capability
 This skill enables tracking and observing the AI agent's own behavior, decisions, and accuracy metrics without interfering with application or infrastructure observability systems.
+
+---
+
+## Scope
+- ✅ Monitor agent decision boundaries and token budgets during execution
+- ✅ Record execution traces and accuracy metrics into `evals/traces/` for quantitative verification
+- ✅ Detect failure patterns or repetitive tool calling loops to trigger safe demotion/stopping
+
+## Non-Goals
+- ❌ Monitor infrastructure servers, Kubernetes pods, or external application metrics
+- ❌ Alter runtime execution paths outside of established boundary validation rules

package/.agents/skills/qk-ai-builder/SKILL.md

@@ -1,9 +1,9 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-ai-builder
-version: 8.0.0
+version: 8.2.0
 status: stable
-description: "Thiết kế AI logic, Prompts, RAG pipelines với bảo mật chống Injection — structured output bắt buộc."
+description: "Thiết kế Governed AI Agent & RAG pipelines theo chuẩn V8.2 — Đóng gói bằng capability.yaml, data discipline 4-folder và Eval Pipeline."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
 
 # ── V8: Classification ─────────────────────────────────────
@@ -91,16 +91,19 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 ---
 
-## Scope
-- ✅ Design strict, deterministic system prompts
-- ✅ Sanitize user inputs before LLM (Anti-Injection)
-- ✅ Validate LLM output before using in business logic
-- ✅ Structured output (JSON schema) over raw text
+## Scope & V8.2 Governed Capability Design
+- ✅ **Capability Packaging:** Design modular AI capabilities paired with machine-readable `capability.yaml` and `scorecard.yaml` eval rubrics.
+- ✅ **Universal 4-Folder Discipline:** Enforce clean separation of Prompt Engineering (`prompts/`), Immutable Raw Data vs Clean Processed Chunks (`data/`), Modular Micro-skills (`agents/`), and Empirical Evals (`evals/`).
+- ✅ **Eval-Driven Pipeline:** Move from static `Prompt -> Output` to the closed-loop V8.2 workflow:
+  `Prompt -> Execution -> Trace Log -> Evaluation (scorecard) -> Quality Gate -> Release Report`
+- ✅ Design strict, deterministic system prompts with structured JSON outputs.
+- ✅ Sanitize user inputs before LLM ingestion (Anti-Injection).
 
 ## Non-Goals
-- ❌ Open-ended chat prompts without system boundaries
-- ❌ Trust LLM output for critical logic without validation
-- ❌ Use raw user input directly in prompts
+- ❌ Modify or override files located in `data/raw/` (must remain immutable ground-truth)
+- ❌ Create unguided AI chat loops without structured eval criteria or trace records
+- ❌ Trust LLM output for critical logic without quantitative verification via `qk-validation-gate`
+- ❌ Use raw user input directly in prompts without sanitization
 
 ---
 

package/.agents/skills/qk-project-bootstrap/SKILL.md

@@ -1,9 +1,9 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-bootstrap
-version: 8.0.0
+version: 8.2.0
 status: stable
-description: "Khởi tạo dự án mới với cấu trúc chuẩn, linters, DESIGN.md — không bao giờ thiếu foundation."
+description: "Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
 
 # ── V8: Classification ─────────────────────────────────────
@@ -100,77 +100,81 @@ On missing precondition:
 
 ---
 
-## Scope
-- ✅ Initialize project with standard tooling
-- ✅ Generate `DESIGN.md` (mandatory for any UI project)
-- ✅ Configure: ESLint, Prettier, TypeScript strict mode
-- ✅ Create standard directory structure
+## Scope & V8.2 Blueprint Generator
+- ✅ **One-Click Blueprint Selection:** Choose from Blueprint Plugins (`coding`, `rag`, `workflow`, `enterprise`).
+- ✅ **Generate `project.yaml`:** Copy appropriate manifest from `.agents/blueprints/<type>/project.yaml.tpl` to workspace root.
+- ✅ **Initialize Project Scaffolding:** Create standard directory structure (including the **4-Folder RAG Architecture** for AI projects).
+- ✅ **Configure Tooling:** Linter, Prettier, TypeScript strict mode, or Python environment depending on stack.
+- ✅ **Generate `DESIGN.md`:** Mandatory brand & token contract for any UI project.
 
 ## Non-Goals
+- ❌ Skip `project.yaml` workspace manifest initialization
 - ❌ Skip DESIGN.md for UI projects
 - ❌ Hardcode outdated dependency versions
-- ❌ Skip README
+- ❌ Skip README or documentation
 
 ---
 
-## Standard Directory Structures
-
-### Next.js / React
-```
-src/
-├── app/              # Pages (App Router) or pages/
-├── components/       # Shared UI components
-│   ├── ui/           # Design system primitives
-│   └── [feature]/    # Feature-specific components
-├── hooks/            # Custom React hooks
-├── lib/              # Utilities, helpers
-├── services/         # API service functions
-├── types/            # TypeScript type definitions
-└── styles/           # Global CSS + DESIGN.md tokens
-DESIGN.md             # Brand & Design Contract
+## V8.2 Blueprint Plugins & Directory Structures
+
+### 1. RAG & AI Agents (The 4-Folder Architecture Blueprint)
+*Activated when building AI agents, RAG engines, or domain automation.*
+```text
+project.yaml              # ⭐ V8.2 Workspace Manifest (Profiles & Capabilities)
+prompts/                  # Prompt instructions managed as code
+├── system/
+├── tasks/
+└── tools/
+data/                     # Strict data discipline
+├── raw/                  # IMMUTABLE original files (PDFs, Excel, Revit/CAD)
+└── processed/            # Cleaned, standardized chunks for AI ingestion
+agents/                   # Agent configurations and domain micro-skills
+├── skills/
+└── tools/
+evals/                    # Quantitative validation evidence
+├── tests/
+├── traces/               # Audit execution traces
+└── scorecards/           # scorecard.yaml eval rubrics
 ```
 
-### NestJS / Express API
-```
+### 2. Standard Coding Workspaces (Next.js / React / Node)
+*Activated when developing software applications or UI components.*
+```text
+project.yaml              # ⭐ V8.2 Workspace Manifest
 src/
-├── modules/
-│   └── [feature]/
-│       ├── [feature].controller.ts
-│       ├── [feature].service.ts
-│       ├── [feature].repository.ts
-│       └── dto/
-├── common/           # Shared utilities, guards, interceptors
-├── config/           # Environment configuration
-└── main.ts
+├── app/                  # Pages or App Router
+├── components/           # Shared UI components & Design system primitives
+├── hooks/
+├── lib/
+├── services/             # API integration & State stores
+├── types/
+└── styles/
+DESIGN.md                 # Brand & Design Contract
 ```
 
-### Vite + React
-```
-src/
-├── assets/
-├── components/
-├── pages/
-├── router/
-├── services/
-├── stores/           # State management
-└── types/
+### 3. Automation Workflows (n8n & Data ETL)
+```text
+project.yaml              # ⭐ V8.2 Workspace Manifest
+workflows/                # Automation graphs & JSON blueprints
+connectors/               # API & Database integrations
+pipelines/                # Transformation scripts
+evals/                    # Traceability logs
 ```
 
 ---
 
 ## Required Files Checklist
 ```
-[ ] package.json — with lint + test + build scripts
-[ ] tsconfig.json — strict: true enabled
-[ ] .eslintrc / eslint.config.js — project standard
-[ ] .prettierrc — formatting config
+[ ] project.yaml — V8.2 Machine-readable Workspace Manifest
+[ ] package.json / pyproject.toml — dependencies and scripts
+[ ] tsconfig.json — strict mode enabled (if TypeScript)
+[ ] .eslintrc / .prettierrc — project standard linting and formatting
 [ ] .gitignore — standard entries
 [ ] README.md — project description + setup instructions
 [ ] DESIGN.md — (UI projects) brand contract with color/font/spacing tokens
-[ ] .env.example — all env vars listed (no actual values)
+[ ] evals/scorecard.yaml — (AI/RAG/Workflow projects) eval standard
 ```
-
----
+-----
 
 ## DESIGN.md Minimum Template
 ```markdown

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

@@ -1,9 +1,9 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-validation-gate
-version: 8.0.0
+version: 8.2.0
 status: stable
-description: "Cổng kiểm tra chất lượng bắt buộc với ngưỡng pass/fail cụ thể — chặn đứng mọi mã nguồn lỗi."
+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 ─────────────────────────────────────
@@ -101,15 +101,17 @@ runtime_version: 1
 schema_version: 2
 ---
 
-## Scope
-- ✅ Run lint, type-check, tests, security audit in sequence
-- ✅ Enforce pass/fail with concrete thresholds
-- ✅ Report results with structured Evidence Format
+## Scope & V8.2 Eval Pipeline
+- ✅ Run lint, type-check, tests, and security audit in sequence
+- ✅ **Execute V8.2 Eval Pipeline:** Read `scorecard.yaml` (or inherited schemas) and compute quantitative scores for AI/Agent outputs.
+- ✅ Enforce pass/fail with concrete thresholds (Code coverage >= 80%, Eval scorecard >= passing threshold, typically 80/100).
+- ✅ Validate Trace execution logs in `evals/traces/` to ensure zero hallucination and ground-truth compliance.
+- ✅ Report results with structured Evidence Format.
 
 ## Non-Goals
 - ❌ Fix failing tests or lint errors (fixes go to qk-bug-resolution)
-- ❌ Skip any gate check unless user explicitly allows
-- ❌ Override failing thresholds with "ignore" flags
+- ❌ Skip any gate check or eval scorecard unless user explicitly allows
+- ❌ Override failing thresholds with "ignore" flags or fabricated LLM scores without trace evidence
 
 skill_version: 7.5.0
 runtime_version: 1
@@ -140,6 +142,11 @@ build:
   must_succeed: true
   max_warnings: 5
   bundle_size_limit: 500KB    # Gzipped (if applicable)
+
+eval_scorecard:
+  default_passing_threshold: 80 # minimum weighted evaluation score
+  trace_verification_required: true # must log tool executions in evals/traces
+  zero_tolerance_hallucination: true
 ```
 
 skill_version: 7.5.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [8.2.0] — 2026-07 — EDAOS v8.2: Governed Capability Metadata & Eval Platform
+
+### Added
+- **Manifest-First Architecture & Registry Engine**: Created `tooling/build-registry.js` (`npm run build:registry`) generating lightweight lookup index `.agents/registry/index.yaml` and O(1) runtime adjacency graph `.agents/registry/graph.json` with cycle/orphan detection.
+- **V8.2 Blueprint Plugins**: Introduced customizable project scaffolding templates under `.agents/blueprints/` (`rag`, `coding`, `workflow`) featuring multi-profile environments (`development`, `production`, `testing`) and feature flags.
+- **Governed Capability Manifests**: Created minimalist `.agents/skills/_template/capability.yaml` (`schema_version: 1`) to decouple execution metadata from natural language instructions.
+- **Eval Pipeline Platform**: Added quantitative verification frameworks via inheritance-ready `.agents/skills/_template/evals/scorecard.yaml` (`extends: default`), linking ground-truth execution traces with automated score rubrics.
+- **Domain Patterns Reference Architecture**: Added reference blueprint for Enterprise Domain AI at `.agents/knowledge/domain-patterns/construction/ddc-construction-ai-blueprint.md` (Construction AI, DDC 192 domain skills, QTO IFC bóc tách, n8n automation workflows) showcasing zero interference with core developer capabilities.
+
+### Changed
+- **`qk-project-bootstrap` Evolution (v8.2.0)**: Upgraded to support One-Click Blueprint selection, automated `project.yaml` generation, and the Universal 4-Folder RAG Architecture (`prompts/`, `data/`, `agents/`, `evals/`).
+- **`qk-validation-gate` Evolution (v8.2.0)**: Integrated automated Eval Pipeline validation, reading `scorecard.yaml` rubrics, verifying trace logs in `evals/traces/`, and enforcing quantitative pass thresholds.
+- **`qk-ai-builder` Evolution (v8.2.0)**: Upgraded to Manifest-first capability packaging and strict 4-folder data discipline (immutable `data/raw/` vs cleaned `data/processed/`).
+- Updated system core description in `package.json` to reflect the EDAOS v8.2 paradigm shift.
+- Synced `.agents/CHANGELOG.md` and `.agents/README.md` with root documentation.
+
+---
+
 ## [8.1.7] — 2026-07 — README Sync
 
 ### Changed

package/README.md

@@ -1,27 +1,31 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.1.7
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v8.2.0
 
-> **v8.1.7 "Agent Engineering OS + Design Intelligence"**
+> **v8.2.0 "EDAOS v8.2 — Governed Capability Metadata & Eval Platform"**
 
-Hệ sinh thái AI Developer Skill OS đã lột xác hoàn toàn. Từ một bộ "công cụ phân tán" (Toolbox) ở V7, phiên bản V8.1.7 được thiết kế như một **Hệ điều hành khép kín (Agent Engineering OS)**, sở hữu năng lực giám sát, bảo vệ ranh giới quyết định (Decision Boundaries) và được trang bị thêm tầng **Design Intelligence**.
+Hệ sinh thái AI Developer Skill OS tiến hóa lên phiên bản **V8.2.0 (EDAOS v8.2)** với kiến trúc **Manifest-First & Eval Platform**, giúp giảm tối đa chi phí nhận thức (cognitive load) cho các AI Agent thế hệ mới (như Antigravity) nhờ chỉ định ranh giới định lượng, đồ thị phụ thuộc O(1), và các Blueprint Plugins quy chuẩn cho từng ngành nghề kỹ thuật.
 
 ---
 
-## 🏗️ Triết Lý Hoạt Động Cốt Lõi (V8 Kernel)
+## 🏗️ 4 Trụ Cột Kiến Trúc Cốt Lõi (EDAOS v8.2 Architecture)
 
-### 1. Decision Boundary (Ranh giới Thẩm quyền)
-Không còn tình trạng một Skill ôm đồm mọi việc. Mọi Skill (Kỹ năng) hiện tại bị quản lý bởi các trường `owns`, `does_not_own`, `conflicts_with`, `delegates_to`. Thợ code UI (`qk-ui-builder`) không được phép tự ra quyết định kiến trúc, và ngược lại.
+### 1. Manifest-First & O(1) Registry Engine
+Không còn phụ thuộc vào việc đọc/scan toàn bộ markdown mệt mỏi. AI Agent tra cứu siêu dữ liệu từ `.agents/registry/index.yaml` và kiểm duyệt chu trình không lặp (acyclic validation) thông qua O(1) graph JSON (`.agents/registry/graph.json`). Tốc độ hiểu và phân công năng lực đạt ngưỡng sub-second!
 
-### 2. Design Intelligence Layer
-Khắc phục điểm yếu "mù thẩm mỹ" của AI. Agent giờ đây không chỉ biết code mà còn có Gu Thẩm Mỹ (Design Taste). Dựa trên yêu cầu của bạn, hệ thống tự động tra cứu **Knowledge Graph** để chọn đúng Theme (Fintech, Healthcare, SaaS...), Typography và Visual Patterns trước khi giao việc cho UI Builder.
+### 2. V8.2 Blueprint Plugins & Universal 4-Folder Architecture
+Khởi tạo dự án (chỉ đạo qua `qk-project-bootstrap`) hỗ trợ sinh file `project.yaml` gốc từ thư viện Blueprint Plugins:
+- **RAG / AI Agents:** Cấu trúc 4 thư mục chuẩn thực chiến: `prompts/`, `data/` (bảo vệ `data/raw` bất biến), `agents/`, và `evals/`.
+- **Standard Software Coding:** Kiến trúc module sạch vững chắc với `DESIGN.md` và rào cản kiểm duyệt tự động.
+- **Automation Workflows:** Các luồng tích hợp n8n và dữ liệu lớn.
 
-### 3. Khế Ước Đi Đầu (Contract-First & Zero-Trust)
-- **Frontend / UI**: Mọi sửa đổi phải tuân thủ Design System (được `qk-design-system-engineering` kiểm duyệt).
-- **Backend / API**: Phải viết OpenAPI/Swagger contract trước (`qk-api-lifecycle`).
-- **Data**: Cấm AI tự đoán cấu trúc DB, mọi truy vấn phải có Schema (`qk-data-lifecycle`).
+### 3. Eval Pipeline Platform (Khép Kín Kiểm Định)
+Chấm dứt việc tin tưởng AI blindly. Mọi Capability đều có thẻ điểm định lượng (`scorecard.yaml`), kết nối log thực thi thực tế từ thư mục `evals/traces/` qua cổng thẩm định sắt đá `qk-validation-gate`. Trách nhiệm định lượng 0–100 với sai số 0% (zero tolerance for fabrication).
+
+### 4. Domain Patterns Separation (Bảo Vệ Kernel)
+Các hệ thống AI chuyên sâu (như **Xây dựng DDC 192 skills**, bóc tách BIM/IFC, ERP) được tải lập trình viên cấu hình dạng Module dưới `knowledge/domain-patterns/` thay vì phơi bày trực tiếp vào 30 Core Developer Skills, giữ cho đồ thị cốt lõi luôn nhanh bén mượt mà!
 
 ---
 
-## 🧩 Danh sách 30 Master Skills
+## 🧩 Danh sách 30 Master Skills (Core Developer Capabilities)
 
 Các kỹ năng được quản lý bằng **Capability Graph** và được đánh giá liên tục thông qua Evaluation Suite. Bao gồm 7 lĩnh vực:
 1. **Core & Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-project-memory`, `qk-help`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ai-developer-skill-os",
-  "version": "8.1.10",
-  "description": "Agent Engineering OS: A deterministic capability graph, governance rules, and dynamic knowledge base for AI coding agents.",
+  "version": "8.2.0",
+  "description": "EDAOS v8.2 — Governed Capability Metadata & Eval Platform: Blueprints organize, manifests govern, registries accelerate.",
   "main": "bin/install.js",
   "files": [
     "bin",
@@ -20,9 +20,10 @@
     "node": ">=18.0.0"
   },
   "scripts": {
+    "build:registry": "node tooling/build-registry.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "test:registry": "vitest run --config vitest.config.js",
+    "test:registry": "vitest run && node tooling/build-registry.js",
     "test:graph": "node tooling/validate-graph.js",
     "lint": "node bin/lint.js",
     "test:agent": "node tests/agent-evaluation/runner/evaluate-routing.js",
@@ -49,7 +50,11 @@
     "developer",
     "agent",
     "prompts",
-    "framework"
+    "framework",
+    "edaos",
+    "manifest",
+    "registry",
+    "eval"
   ],
   "author": "Quang Khánh",
   "license": "MIT",