ai-developer-skill-os 9.1.0 → 9.1.1

package/.agents/AGENTS.md

@@ -47,18 +47,18 @@ Khi thực thi BẤT KỲ kỹ năng nào (tất cả các lệnh `./qk-*` hoặ
    - *"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).
+2. **Cơ chế tự động khởi tạo & tra cứu (Self-Init & Pre-flight Load)**:
+   - **Tự động Khởi tạo & Gitignore:** Nếu thư mục `.ai-local/` chưa tồn tại trong project, AI BẮT BUỘC phải tự động tạo cấu trúc thư mục (`.ai-local/knowledge/`, `.ai-local/candidates/`) và tự động thêm dòng `.ai-local/` vào file `.gitignore` của dự án (nếu chưa có) để đảm bảo AI biết rõ nơi tra cứu/lưu trữ và tuyệt đối bảo mật tri thức cá nhân.
+   - **Tra cứu trước khi làm:** 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 tại `.ai-local/knowledge/index.yaml`.
    - 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)**:
+3. **Cơ chế thu hoạ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).
+4. **Kỷ luật lưu trữ Local Private (Zero-Overwrite)**:
+   - *Chế độ Local Private duy nhất:* Toàn bộ tri thức bộ nhớ dự án được lưu tại `.ai-local/` (bắt buộc chèn vào `.gitignore`). Đã loại bỏ hoàn toàn việc lưu trữ chung qua `.agents/knowledge/` (Shared Mode) để tập trung vào không gian làm việc cá nhân, tránh nhầm lẫn và không xâm lấn git.
+   - *Giới hạn siêu gọn*: File `.ai-local/AGENTS.md` 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`).

package/.agents/registry/graph.json

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

package/.agents/rules/global.md

@@ -140,7 +140,7 @@ Agent **SHOULD**:
 
 **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).
+- **Self-Init & Local Private Mode:** Always use `.ai-local/` (Private Mode, gitignored) as the sole storage for learned knowledge and memory. If `.ai-local/` does not exist in the project root, the agent **MUST** automatically create the folder structure (`.ai-local/knowledge/`, `.ai-local/candidates/`) and add `.ai-local/` to the project's `.gitignore` file immediately before proceeding. Shared Mode (`.agents/knowledge/index.yaml`) is explicitly disabled and prohibited for dynamic project memory.
 - **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.

package/.agents/skills/_template/SKILL.md

@@ -91,6 +91,83 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 ## Memory Workflow
 
+### 0. Self-Init Protocol (Khởi Tạo Bộ Nhớ Local & Gitignore)
+- Trước khi tra cứu hoặc lưu trữ tri thức, BẮT BUỘC kiểm tra sự tồn tại của thư mục `.ai-local/` tại gốc dự án:
+  - **Tự động tạo mới:** Nếu `.ai-local/` chưa tồn tại, AI phải tự động tạo cấu trúc thư mục `.ai-local/knowledge/` (và file `index.yaml` nếu cần thiết) cùng `.ai-local/candidates/`. Tuyệt đối không ngưng chạy hay hỏi ý kiến người dùng về thao tác khởi tạo tiêu chuẩn này.
+  - **Bảo mật Gitignore:** BẮT BUỘC kiểm tra file `.gitignore` của dự án, nếu chưa có dòng `.ai-local/` thì phải tự động thêm vào để tuyệt đối bảo mật tri thức cá nhân và tránh lộ lọt lên Git.
+
+---
+
+### Pre-flight Retrieve (Trước khi thực thi)
+- Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
+  bắt buộc tra cứu:
+  - `.ai-local/knowledge/index.yaml` (Private Local Knowledge)
+
+- Ưu tiên sử dụng các Knowledge đang có trạng thái `Active` thuộc:
+  - Architecture
+  - Hard Bug
+  - Convention
+  - Pattern
+  - Tech Debt Pattern
+
+- Memory chỉ đóng vai trò **Navigator (bản đồ chỉ đường)**.
+  Không được xem Memory là Source of Truth.
+  Luôn xác minh lại bằng source code, configuration và trạng thái hiện tại của dự án trước khi áp dụng.
+
+---
+
+### Learning Flow (AI tự học có kiểm soát)
+- Trong quá trình làm việc, AI được phép tự phát hiện và tạo **Candidate Memory** khi nhận thấy:
+  - Hard Bug có khả năng tái diễn.
+  - Pattern làm việc lặp lại trong dự án.
+  - Convention hoặc quy tắc kiến trúc mới.
+  - Quyết định Architecture quan trọng.
+  - Tech Debt Pattern hoặc Code Smell có tính hệ thống.
+
+- Candidate Memory chỉ là bản nháp quan sát, chưa phải tri thức chính thức.
+- Candidate Memory có thể lưu tạm tại: `.ai-local/candidates/`
+- AI không được tự động Promote Candidate Memory thành Project Knowledge.
+
+---
+
+### Post-flight Harvest (Đề xuất → Phê duyệt)
+Sau khi hoàn thành task:
+- AI đánh giá các Candidate Memory đã tạo.
+- Nếu phát hiện tri thức có giá trị tái sử dụng:
+  - Đề xuất người dùng xem xét.
+  - Gửi yêu cầu phê duyệt thông qua:
+    - `/learn`
+    - `qk-project-memory`
+- Chỉ sau khi được phê duyệt, Candidate Memory mới được chuyển thành Knowledge chính thức:
+
+```
+.ai-local/candidates/  ──(Approve)──>  .ai-local/knowledge/index.yaml
+```
+
+- Project Knowledge phải được xem như tài sản kỹ thuật của dự án:
+  - Có thể review, cập nhật, loại bỏ và có lịch sử thay đổi.
+
+---
+
+### Ignore (Không đưa vào Memory)
+Không lưu:
+- Trace log của một session đơn lẻ.
+- Temporary debugging data.
+- Output của một lần chạy test/scan.
+- Report health tạm thời của một đợt kiểm tra.
+- Lỗi nhỏ chỉ xảy ra một lần.
+- Thông tin không có khả năng tái sử dụng.
+
+---
+
+### Golden Rule
+> **AI được phép học, nhưng không được tự quyết định tri thức chính thức.**
+> **AI quan sát → Đề xuất → Con người phê duyệt → Dự án tiến hóa.**
+
+---
+
+
+
 ### Pre-flight Retrieve (Trước khi thực thi)
 - Trước các task có tính lặp lại, debug, refactor, kiến trúc hoặc rủi ro cao:
   bắt buộc tra cứu: