ai-developer-skill-os 8.1.10 → 8.2.1

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-code-review/SKILL.md

@@ -81,7 +81,7 @@ token_budget:
   max_files_read: 10
   max_lines_per_read: 300
   max_shell_commands: 2
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---
@@ -108,15 +108,12 @@ Report: "Missing: Vui lòng cung cấp ngữ cảnh hoặc chỉ định rõ fil
 
 ## Dynamic Context Loading (Tải Ngữ Cảnh Động)
 
-> **BẮT BUỘC:** Trước khi bắt đầu review, Agent phải sử dụng tool `view_file` để nạp các bí kíp tương ứng từ thư mục `references/` nhằm đảm bảo chất lượng review sâu sát nhất.
+> **CHỈ ĐỌC KHI CẦN (on-demand):** Chỉ mở file references/ nếu có vấn đề cụ thể cần xác minh. Đừng đọc trước khi chưa thấy vấn đề.
 
-- **Nếu review AI Config (Skin, Rule, Workflow):**
-  - Mở đọc: `references/ai/v8-schema-validation.md` và `references/ai/ai-anti-patterns.md`.
-- **Nếu review Code Phần mềm (VD: React, Java, Go, v.v.):**
-  - Nhận diện ngôn ngữ/framework.
-  - Mở đọc file tương ứng: `references/languages/[tên-ngôn-ngữ].md` (VD: `react.md`, `java.md`).
-- **Nếu review ở mức tổng quát hoặc PR lớn (Cross-cutting):**
-  - Đọc thêm: `references/cross-cutting/architecture-review-guide.md`, hoặc các file về security/performance nếu phù hợp.
+- **Nếu review AI Config** và phát hiện vấn đề schema/anti-pattern → đọc `references/ai/v8-schema-validation.md` HOẶC `references/ai/ai-anti-patterns.md` (không cần đọc cả 2 nếu không liên quan).
+- **Nếu review Code** và gặp vấn đề ngôn ngữ cụ thể → đọc `references/languages/[tên-ngôn-ngữ].md`.
+- **Nếu review cross-cutting** và cần xác minh architecture → đọc `references/cross-cutting/architecture-review-guide.md`.
+- **Default (80% trường hợp):** Dùng kiến thức có sẵn, không đọc references.
 
 ---
 

package/.agents/skills/qk-context-loader/SKILL.md

@@ -96,10 +96,6 @@ On missing precondition:
   Message: "Vui lòng chỉ định entry point (file hoặc module cần map)."
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Scope
 - ✅ Trace imports/exports from entry point
@@ -112,10 +108,6 @@ schema_version: 2
 - ❌ Guess file names — only follow explicit imports
 - ❌ Load entire repo (max 5 files)
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Priority Order
 
@@ -126,10 +118,6 @@ schema_version: 2
 | P3 | Identify shared/risky modules | Budget < 60% |
 | P4 | Annotate with risk levels | Budget < 70% |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Workflow
 
@@ -149,10 +137,6 @@ ELSE IF entry file not found
   → EXIT: BLOCKED — ask for correct path
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ### Phase 2 — Graph Traversal (Max Depth 3)
 
@@ -171,10 +155,6 @@ IF circular dependency detected
   → Continue building rest of graph
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ### Phase 3 — Risk Assessment & Output
 
@@ -183,10 +163,6 @@ schema_version: 2
 2. Identify: entry points with many dependents = CRITICAL to change carefully
 3. Generate graph in standard JSON + Markdown format
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Output Format (Mandatory Schema)
 
@@ -214,10 +190,6 @@ schema_version: 2
 }
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Evidence Format
 
@@ -228,10 +200,6 @@ Imported by: [N files]
 Exports:    [key exports]
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Handoff Contract
 
@@ -252,10 +220,6 @@ schema_version: 2
 }
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Exit Codes
 

package/.agents/skills/qk-data-lifecycle/SKILL.md

@@ -73,7 +73,7 @@ token_budget:
   max_files_read: 4
   max_lines_per_read: 100
   max_shell_commands: 1
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---

package/.agents/skills/qk-design-system-engineering/SKILL.md

@@ -93,7 +93,7 @@ token_budget:
   max_files_read: 5
   max_lines_per_read: 150
   max_shell_commands: 0
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---

package/.agents/skills/qk-devops-platform/SKILL.md

@@ -97,7 +97,7 @@ token_budget:
   max_files_read: 5
   max_lines_per_read: 150
   max_shell_commands: 2
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---

package/.agents/skills/qk-feature-delivery/SKILL.md

@@ -79,7 +79,7 @@ token_budget:
   max_files_read: 5
   max_lines_per_read: 150
   max_shell_commands: 2
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---
@@ -132,6 +132,26 @@ On missing precondition:
 
 ---
 
+## ⚡ FAST PATH (Đọc trước — quyết định ngay)
+
+```
+FAST PATH: Áp dụng nếu task đơn giản (sửa ≤ 1 file, không API mới, không migration DB)
+  → BỎ QUA qk-context-loader
+  → BỎ QUA Phase 1 clarification nếu requirement đã rõ
+  → ĐI THẲNG vào Phase 3 — Implementation
+  → Tiết kiệm 2-3 turn hỏi đáp không cần thiết
+
+VÍ DỤ FAST PATH:
+  ✅ "Sửa label trên button này thành X"
+  ✅ "Thêm validation email vào form"
+  ✅ "Fix bug: hàm này trả về null"
+
+KHÔNG DÙNG FAST PATH:
+  ❌ Tính năng mới span nhiều file (≥ 3 files)
+  ❌ Thay đổi API contract
+  ❌ Migration database
+```
+
 ## Workflow
 
 ### Phase 1 — Requirements Clarification

package/.agents/skills/qk-frontend-architecture/SKILL.md

@@ -113,7 +113,7 @@ token_budget:
   max_files_read: 5
   max_lines_per_read: 150
   max_shell_commands: 0
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---

package/.agents/skills/qk-orchestrator/SKILL.md

@@ -96,10 +96,6 @@ On missing precondition:
   Message: "Vui lòng mô tả yêu cầu của bạn."
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Scope
 - ✅ Analyze user intent and route to the correct skill
@@ -112,10 +108,6 @@ schema_version: 2
 - ❌ Allow UI work without `DESIGN.md` verified
 - ❌ Allow logic work without context graph from `qk-context-loader`
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Priority Order
 
@@ -126,10 +118,6 @@ schema_version: 2
 | P3 | Check pipeline dependencies (e.g., context-loader first) | Never for logic tasks |
 | P4 | Estimate cost/latency for user info | Budget < 70% |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Workflow
 
@@ -157,10 +145,6 @@ ELSE IF no match
 - Skill identified → go to Phase 2
 - No matching skill → EXIT: BLOCKED
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ### Phase 2 — Precondition Check
 
@@ -181,10 +165,6 @@ ELSE
   → EXIT: BLOCKED
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ### Phase 3 — Pipeline Enforcement
 
@@ -208,10 +188,6 @@ Release tasks:
   [qk-validation-gate] → [qk-production-release]
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Routing Table (Quick Reference)
 Full table: see `references/routing-table.md`
@@ -236,10 +212,6 @@ Full table: see `references/routing-table.md`
 | new project, bootstrap, init | `qk-project-bootstrap` | direct |
 | memory, context, recall, lưu | `qk-project-memory` | direct |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Confidence Model
 
@@ -249,10 +221,6 @@ schema_version: 2
 | MEDIUM | Multiple possible skills | Route to most likely, note ambiguity |
 | LOW | Request is too vague | Ask clarifying question |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Escalation Rules
 
@@ -266,10 +234,6 @@ Questions:
 Recommended Assumptions: none — routing requires clear intent
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Handoff Contract
 
@@ -290,10 +254,6 @@ schema_version: 2
 }
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Output Format
 
@@ -312,10 +272,6 @@ Preconditions:
 Exit Code:   SUCCESS
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Exit Codes
 

package/.agents/skills/qk-product-specification/SKILL.md

@@ -111,7 +111,7 @@ token_budget:
   max_files_read: 3
   max_lines_per_read: 150
   max_shell_commands: 0
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---

package/.agents/skills/qk-production-release/SKILL.md

@@ -73,7 +73,7 @@ token_budget:
   max_files_read: 3
   max_lines_per_read: 100
   max_shell_commands: 2
-  stop_early: false
+  stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ---