ai-developer-skill-os 8.3.1 → 9.1.0

package/.agents/AGENTS.md

@@ -39,6 +39,27 @@ Changes applied:
   [Các lưu ý đặc biệt, rủi ro tiềm ẩn hoặc cách người dùng có thể test lại tính năng này]
 ```
 
+[Universal Project Knowledge Protocol V1 (AI Skin V9)]
+Khi thực thi BẤT KỲ kỹ năng nào (tất cả các lệnh `./qk-*` hoặc task code thường), bạn BẮT BUỘC tuân thủ Kỷ Luật Trí Nhớ V1:
+
+1. **Kim chỉ nam tối thượng**:
+   - *"Knowledge phải được quản lý giống như source code: đơn giản, có thể xem xét (review), có thể cập nhật, có thể loại bỏ và luôn có con người chịu trách nhiệm phê duyệt."*
+   - *"Memory chỉ dùng để giảm thời gian tìm kiếm (Navigator), không thay thế việc đọc mã nguồn hiện tại (Not a Source of Truth)."*
+   - *"AGENTS.md và knowledge/index.yaml là tài liệu kỹ thuật của dự án, tuyệt đối KHÔNG phải nhật ký hội thoại của AI."*
+
+2. **Cơ chế tra cứu trước khi làm (Pre-flight Load)**:
+   - Trước khi mò mẫm tìm kiếm toàn dự án (search_web/grep), BẮT BUỘC kiểm tra và tra cứu `index.yaml` (trong `.ai-local/knowledge/` cho Private Mode, hoặc `.agents/knowledge/` cho Shared Mode).
+   - Nếu tìm thấy Pattern/Fact liên quan có `status: Active`, áp dụng NGAY LẬP TỨC để bỏ qua bước search dài dòng.
+
+3. **Cơ chế thu hạch tri thức hậu task (Post-flight Harvest - AI Đề xuất, Con người Phê duyệt)**:
+   - Sau khi hoàn thành task, tự đặt câu hỏi: *"Task này có thuộc 1 trong 4 loại (Architecture, Convention, Pattern, Hard Bug) và có đáng nhớ để giúp mở file nhanh hơn / tránh lỗi trả giá đắt không?"*
+   - KHÔNG bao giờ tự động sửa ngầm file bộ nhớ. Nếu phát hiện tri thức đáng nhớ, trả về tóm tắt đề xuất và yêu cầu **Người dùng Phê Duyệt**. Các thao tác typo, CSS vặt, đổi text, CRUD thường BẮT BUỘC bỏ qua (Dismiss).
+
+4. **Kỷ luật lưu trữ (Two-Mode & Zero-Overwrite)**:
+   - *Mode 1 (Private - Mặc định cho cá nhân)*: Lưu tại `.ai-local/` (bắt buộc chèn vào `.gitignore`).
+   - *Mode 2 (Shared - Cho Team & CI/CD)*: Lưu tại `.agents/` (để commit & review qua Pull Request).
+   - *Giới hạn siêu gọn*: File `AGENTS.md` của dự án phải DƯỚI 100 dòng. `index.yaml` chỉ dùng đường dẫn tương đối (`src/...`) và tham chiếu biểu tượng (Symbol), tuyệt đối không fix cứng đường dẫn ổ đĩa tuyệt đối cá nhân. Khi tri thức cũ thay đổi, chuyển sang `status: Archived`, không được xóa đè lịch sử (Zero-Overwrite).
+
 [Command Arguments]
 Người dùng có thể truyền thêm tham số vào lệnh (ví dụ: `./qk-ui-builder --fw=react --css=tailwind`).
 Nếu người dùng sử dụng tham số (argument), bạn BẮT BUỘC phải tuân thủ tuyệt đối các công nghệ/yêu cầu được chỉ định trong tham số đó thay vì dùng mặc định.

package/.agents/registry/capability-graph.yml

@@ -1,7 +1,7 @@
 # registry/capability-graph.yml
 # GENERATED FILE - DO NOT EDIT MANUALLY.
-version: 8.1.3
-generated_at: '2026-07-29T07:30:08.002Z'
+version: 9.0.0
+generated_at: '2026-08-03T10:30:00.000Z'
 nodes:
   qk-access-policy:
     type: capability
@@ -250,6 +250,17 @@ nodes:
     does_not_own: []
     conflicts: []
     workflow: code-review
+  qk-ui-builder:
+    type: capability
+    maturity: stable
+    owns:
+      - ui components
+      - frontend layouts
+    does_not_own:
+      - design tokens
+      - system rules
+    conflicts: []
+    workflow: feature-delivery
   qk-ui-system-builder:
     type: capability
     maturity: stable

package/.agents/registry/graph.json

@@ -1,11 +1,11 @@
 {
   "schema_version": 1,
   "manifest_version": "8.2",
-  "generated_at": "2026-07-29T10:15:54.629Z",
+  "generated_at": "2026-08-03T03:45:24.184Z",
   "nodes": {
     "qk-access-policy": {
       "path": ".agents/skills/qk-access-policy",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "access",
         "policy"
@@ -16,7 +16,7 @@
     },
     "qk-agent-observability": {
       "path": ".agents/skills/qk-agent-observability",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "agent",
         "observability"
@@ -27,7 +27,7 @@
     },
     "qk-ai-builder": {
       "path": ".agents/skills/qk-ai-builder",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "ai",
         "builder"
@@ -38,7 +38,7 @@
     },
     "qk-api-lifecycle": {
       "path": ".agents/skills/qk-api-lifecycle",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "api",
         "lifecycle"
@@ -49,7 +49,7 @@
     },
     "qk-bug-resolution": {
       "path": ".agents/skills/qk-bug-resolution",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "bug",
         "resolution"
@@ -60,7 +60,7 @@
     },
     "qk-code-review": {
       "path": ".agents/skills/qk-code-review",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "code",
         "review"
@@ -71,7 +71,7 @@
     },
     "qk-context-loader": {
       "path": ".agents/skills/qk-context-loader",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "context",
         "loader"
@@ -82,7 +82,7 @@
     },
     "qk-data-lifecycle": {
       "path": ".agents/skills/qk-data-lifecycle",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "data",
         "lifecycle"
@@ -93,7 +93,7 @@
     },
     "qk-db-optimizer": {
       "path": ".agents/skills/qk-db-optimizer",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "db",
         "optimizer"
@@ -104,7 +104,7 @@
     },
     "qk-design-system-engineering": {
       "path": ".agents/skills/qk-design-system-engineering",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "design",
         "system",
@@ -116,7 +116,7 @@
     },
     "qk-devops-platform": {
       "path": ".agents/skills/qk-devops-platform",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "devops",
         "platform"
@@ -127,7 +127,7 @@
     },
     "qk-docs": {
       "path": ".agents/skills/qk-docs",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "docs"
       ],
@@ -137,7 +137,7 @@
     },
     "qk-engineering-standard": {
       "path": ".agents/skills/qk-engineering-standard",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "engineering",
         "standard"
@@ -148,7 +148,7 @@
     },
     "qk-fe-api-integration": {
       "path": ".agents/skills/qk-fe-api-integration",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "fe",
         "api",
@@ -160,7 +160,7 @@
     },
     "qk-feature-delivery": {
       "path": ".agents/skills/qk-feature-delivery",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "feature",
         "delivery"
@@ -171,7 +171,7 @@
     },
     "qk-frontend-architecture": {
       "path": ".agents/skills/qk-frontend-architecture",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "frontend",
         "architecture"
@@ -182,7 +182,7 @@
     },
     "qk-help": {
       "path": ".agents/skills/qk-help",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "help"
       ],
@@ -192,7 +192,7 @@
     },
     "qk-orchestrator": {
       "path": ".agents/skills/qk-orchestrator",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "orchestrator"
       ],
@@ -202,7 +202,7 @@
     },
     "qk-product-specification": {
       "path": ".agents/skills/qk-product-specification",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "product",
         "specification"
@@ -213,7 +213,7 @@
     },
     "qk-production-release": {
       "path": ".agents/skills/qk-production-release",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "production",
         "release"
@@ -224,7 +224,7 @@
     },
     "qk-project-bootstrap": {
       "path": ".agents/skills/qk-project-bootstrap",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "project",
         "bootstrap"
@@ -235,7 +235,7 @@
     },
     "qk-project-health": {
       "path": ".agents/skills/qk-project-health",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "project",
         "health"
@@ -246,7 +246,7 @@
     },
     "qk-project-memory": {
       "path": ".agents/skills/qk-project-memory",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "project",
         "memory"
@@ -257,7 +257,7 @@
     },
     "qk-refactor": {
       "path": ".agents/skills/qk-refactor",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "refactor"
       ],
@@ -269,7 +269,7 @@
     },
     "qk-security-audit": {
       "path": ".agents/skills/qk-security-audit",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "security",
         "audit"
@@ -280,7 +280,7 @@
     },
     "qk-system-evolution": {
       "path": ".agents/skills/qk-system-evolution",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "system",
         "evolution"
@@ -291,7 +291,7 @@
     },
     "qk-test-engineering": {
       "path": ".agents/skills/qk-test-engineering",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "test",
         "engineering"
@@ -302,7 +302,7 @@
     },
     "qk-ui-audit": {
       "path": ".agents/skills/qk-ui-audit",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "ui",
         "audit"
@@ -313,7 +313,7 @@
     },
     "qk-ui-builder": {
       "path": ".agents/skills/qk-ui-builder",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "ui",
         "builder"
@@ -326,7 +326,7 @@
     },
     "qk-ui-system-builder": {
       "path": ".agents/skills/qk-ui-system-builder",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "ui",
         "system",
@@ -338,7 +338,7 @@
     },
     "qk-validation-gate": {
       "path": ".agents/skills/qk-validation-gate",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "validation",
         "gate"
@@ -349,7 +349,7 @@
     },
     "qk-web-quality-gate": {
       "path": ".agents/skills/qk-web-quality-gate",
-      "version": "8.3.1",
+      "version": "9.0.0",
       "tags": [
         "web",
         "quality",

package/.agents/registry/index.yaml

@@ -2,74 +2,74 @@
 # DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
 schema_version: 1
 manifest_version: '8.2'
-generated_at: '2026-07-29T10:15:54.630Z'
+generated_at: '2026-08-03T03:45:24.184Z'
 capabilities:
   qk-access-policy:
     path: .agents/skills/qk-access-policy
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - access
       - policy
     dependencies: []
   qk-agent-observability:
     path: .agents/skills/qk-agent-observability
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - agent
       - observability
     dependencies: []
   qk-ai-builder:
     path: .agents/skills/qk-ai-builder
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - ai
       - builder
     dependencies: []
   qk-api-lifecycle:
     path: .agents/skills/qk-api-lifecycle
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - api
       - lifecycle
     dependencies: []
   qk-bug-resolution:
     path: .agents/skills/qk-bug-resolution
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - bug
       - resolution
     dependencies: []
   qk-code-review:
     path: .agents/skills/qk-code-review
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - code
       - review
     dependencies: []
   qk-context-loader:
     path: .agents/skills/qk-context-loader
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - context
       - loader
     dependencies: []
   qk-data-lifecycle:
     path: .agents/skills/qk-data-lifecycle
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - data
       - lifecycle
     dependencies: []
   qk-db-optimizer:
     path: .agents/skills/qk-db-optimizer
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - db
       - optimizer
     dependencies: []
   qk-design-system-engineering:
     path: .agents/skills/qk-design-system-engineering
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - design
       - system
@@ -77,27 +77,27 @@ capabilities:
     dependencies: []
   qk-devops-platform:
     path: .agents/skills/qk-devops-platform
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - devops
       - platform
     dependencies: []
   qk-docs:
     path: .agents/skills/qk-docs
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - docs
     dependencies: []
   qk-engineering-standard:
     path: .agents/skills/qk-engineering-standard
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - engineering
       - standard
     dependencies: []
   qk-fe-api-integration:
     path: .agents/skills/qk-fe-api-integration
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - fe
       - api
@@ -105,103 +105,103 @@ capabilities:
     dependencies: []
   qk-feature-delivery:
     path: .agents/skills/qk-feature-delivery
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - feature
       - delivery
     dependencies: []
   qk-frontend-architecture:
     path: .agents/skills/qk-frontend-architecture
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - frontend
       - architecture
     dependencies: []
   qk-help:
     path: .agents/skills/qk-help
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - help
     dependencies: []
   qk-orchestrator:
     path: .agents/skills/qk-orchestrator
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - orchestrator
     dependencies: []
   qk-product-specification:
     path: .agents/skills/qk-product-specification
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - product
       - specification
     dependencies: []
   qk-production-release:
     path: .agents/skills/qk-production-release
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - production
       - release
     dependencies: []
   qk-project-bootstrap:
     path: .agents/skills/qk-project-bootstrap
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - project
       - bootstrap
     dependencies: []
   qk-project-health:
     path: .agents/skills/qk-project-health
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - project
       - health
     dependencies: []
   qk-project-memory:
     path: .agents/skills/qk-project-memory
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - project
       - memory
     dependencies: []
   qk-refactor:
     path: .agents/skills/qk-refactor
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - refactor
     dependencies:
       - refactor
   qk-security-audit:
     path: .agents/skills/qk-security-audit
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - security
       - audit
     dependencies: []
   qk-system-evolution:
     path: .agents/skills/qk-system-evolution
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - system
       - evolution
     dependencies: []
   qk-test-engineering:
     path: .agents/skills/qk-test-engineering
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - test
       - engineering
     dependencies: []
   qk-ui-audit:
     path: .agents/skills/qk-ui-audit
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - ui
       - audit
     dependencies: []
   qk-ui-builder:
     path: .agents/skills/qk-ui-builder
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - ui
       - builder
@@ -209,7 +209,7 @@ capabilities:
       - feature-delivery
   qk-ui-system-builder:
     path: .agents/skills/qk-ui-system-builder
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - ui
       - system
@@ -217,14 +217,14 @@ capabilities:
     dependencies: []
   qk-validation-gate:
     path: .agents/skills/qk-validation-gate
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - validation
       - gate
     dependencies: []
   qk-web-quality-gate:
     path: .agents/skills/qk-web-quality-gate
-    version: 8.3.1
+    version: 9.0.0
     tags:
       - web
       - quality

package/.agents/rules/global.md

@@ -133,3 +133,16 @@ Agent **SHOULD**:
 1. Ask clarification
 2. Present top candidates
 3. Explain missing information
+
+---
+
+## R-G-11: Knowledge & Memory Discipline (V1 / AI Skin V9)
+
+**MUST** govern project memory like source code: simple, reviewable, updatable, and always human-approved.
+
+- **Dual-Mode Setup:** Prefer `.ai-local/` (Private Mode, gitignored) or `.agents/` (Shared Mode, git-commited).
+- **Navigator ONLY:** Memory reduces discovery time; it is NOT a replacement for checking live source code.
+- **Strict Content Bounds:** Only store 4 categories in `knowledge/index.yaml`: `Architecture`, `Convention`, `Pattern`, and `Hard Bug`. Discard routine typos, trivial CSS, and standard CRUD.
+- **Zero-Overwrite & Portable:** Mark outdated facts as `status: Archived` (never overwrite history). Always use workspace-relative paths (`src/...`) and AST symbol names instead of hardcoded disk paths or rigid line numbers.
+- **No Silent Mutate:** Never edit memory files automatically without proposing to the developer and receiving affirmative confirmation via `/learn` or explicit instructions.
+