ai-developer-skill-os 8.3.0 → 9.0.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-23T06:25:44.563Z'
+# GENERATED FILE - DO NOT EDIT MANUALLY.
+version: 9.0.0
+generated_at: '2026-08-03T10:30:00.000Z'
 nodes:
   qk-access-policy:
     type: capability
@@ -24,6 +24,7 @@ nodes:
       - infrastructure_monitoring
       - log_aggregation
       - uptime_monitoring
+      - pass_fail_enforcement
     conflicts: []
     workflow: skill-evolution
   qk-ai-builder:
@@ -47,6 +48,13 @@ nodes:
     does_not_own: []
     conflicts: []
     workflow: bug-resolution
+  qk-code-review:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: code-review
   qk-context-loader:
     type: utility
     maturity: stable
@@ -142,7 +150,7 @@ nodes:
     owns: []
     does_not_own: []
     conflicts: []
-    workflow: internal
+    workflow: documentation
   qk-orchestrator:
     type: orchestrator
     maturity: stable
@@ -165,10 +173,15 @@ nodes:
   qk-production-release:
     type: capability
     maturity: stable
-    owns: []
-    does_not_own: []
-    conflicts: []
-    workflow: internal
+    owns:
+      - release-gate-checklist
+      - deployment-readiness-verdict
+    does_not_own:
+      - ci-cd-pipeline-design
+      - infrastructure-provisioning
+    conflicts:
+      - qk-devops-platform
+    workflow: production-release
   qk-project-bootstrap:
     type: capability
     maturity: stable
@@ -190,6 +203,13 @@ nodes:
     does_not_own: []
     conflicts: []
     workflow: documentation
+  qk-refactor:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: refactor
   qk-security-audit:
     type: capability
     maturity: experimental
@@ -233,16 +253,25 @@ nodes:
   qk-ui-builder:
     type: capability
     maturity: stable
-    owns: []
-    does_not_own: []
+    owns:
+      - ui components
+      - frontend layouts
+    does_not_own:
+      - design tokens
+      - system rules
     conflicts: []
     workflow: feature-delivery
   qk-ui-system-builder:
     type: capability
     maturity: stable
-    owns: []
-    does_not_own: []
-    conflicts: []
+    owns:
+      - tokens
+      - ui-system
+    does_not_own:
+      - page implementation
+      - visual direction
+    conflicts:
+      - qk-design-system-engineering
     workflow: feature-delivery
   qk-validation-gate:
     type: utility
@@ -273,6 +302,9 @@ edges:
   - from: qk-agent-observability
     to: skill-evolution
     relation: depends_on
+  - from: qk-agent-observability
+    to: qk-validation-gate
+    relation: feeds
   - from: qk-ai-builder
     to: feature-delivery
     relation: depends_on
@@ -294,6 +326,18 @@ edges:
   - from: qk-bug-resolution
     to: qk-validation-gate
     relation: feeds
+  - from: qk-code-review
+    to: code-review
+    relation: depends_on
+  - from: qk-code-review
+    to: qk-validation-gate
+    relation: feeds
+  - from: qk-code-review
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-code-review
+    to: qk-project-health
+    relation: feeds
   - from: qk-context-loader
     to: research
     relation: depends_on
@@ -394,7 +438,7 @@ edges:
     to: qk-web-quality-gate
     relation: feeds
   - from: qk-help
-    to: internal
+    to: documentation
     relation: depends_on
   - from: qk-help
     to: qk-orchestrator
@@ -418,8 +462,11 @@ edges:
     to: qk-feature-delivery
     relation: feeds
   - from: qk-production-release
-    to: internal
+    to: production-release
     relation: depends_on
+  - from: qk-production-release
+    to: qk-devops-platform
+    relation: conflicts_with
   - from: qk-production-release
     to: qk-validation-gate
     relation: feeds
@@ -441,6 +488,15 @@ edges:
   - from: qk-project-memory
     to: qk-engineering-standard
     relation: feeds
+  - from: qk-refactor
+    to: refactor
+    relation: depends_on
+  - from: qk-refactor
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-refactor
+    to: qk-project-health
+    relation: feeds
   - from: qk-security-audit
     to: security-audit
     relation: depends_on
@@ -474,15 +530,12 @@ edges:
   - from: qk-ui-audit
     to: qk-ui-builder
     relation: feeds
-  - from: qk-ui-builder
-    to: feature-delivery
-    relation: depends_on
-  - from: qk-ui-builder
-    to: qk-ui-system-builder
-    relation: feeds
   - from: qk-ui-system-builder
     to: feature-delivery
     relation: depends_on
+  - from: qk-ui-system-builder
+    to: qk-design-system-engineering
+    relation: conflicts_with
   - from: qk-ui-system-builder
     to: qk-ui-builder
     relation: feeds