ai-developer-skill-os 9.3.1 → 10.1.0

package/.agents/registry/index.yaml

@@ -2,285 +2,109 @@
 # DO NOT EDIT MANUALLY. THIS IS A GENERATED RUNTIME ARTIFACT.
 schema_version: 1
 manifest_version: '8.2'
-generated_at: '2026-09-14T04:59:07.121Z'
+generated_at: '2026-09-15T03:45:16.804Z'
 stats:
-  total_scanned: 34
-  active: 29
-  archived: 2
-  relocated: 2
+  total_scanned: 11
+  active: 11
+  archived: 0
+  relocated: 0
 capabilities:
-  qk-access-policy:
-    path: .agents/skills/qk-access-policy
-    version: 9.1.0
+  qk-api-data-discovery:
+    path: .agents/skills/qk-api-data-discovery
+    version: 10.1.0
     status: stable
     tags:
-      - access
-      - policy
-    dependencies: []
-  qk-agent-observability:
-    path: .agents/skills/qk-agent-observability
-    version: 9.1.0
-    status: archived
-    tags:
-      - agent
-      - observability
-    dependencies: []
-  qk-ai-builder:
-    path: .agents/skills/qk-ai-builder
-    version: 9.1.0
-    status: stable
-    tags:
-      - ai
-      - builder
-    dependencies: []
-  qk-fe-api-integration:
-    path: .agents/skills/qk-fe-api-integration
-    version: 9.1.0
-    status: stable
-    tags:
-      - fe
       - api
-      - integration
-    dependencies: []
-  qk-api-lifecycle:
-    path: .agents/skills/qk-api-lifecycle
-    version: 9.1.0
+      - data
+      - discovery
+    dependencies:
+      - context-discovery
+  qk-backend-data:
+    path: .agents/skills/qk-backend-data
+    version: 10.1.0
     status: stable
     tags:
-      - api
-      - lifecycle
-    dependencies: []
+      - backend
+      - data
+    dependencies:
+      - feature-delivery
   qk-bug-resolution:
     path: .agents/skills/qk-bug-resolution
-    version: 9.1.0
+    version: 10.1.0
     status: stable
     tags:
       - bug
       - resolution
-    dependencies: []
+    dependencies:
+      - bug-resolution
+  qk-code-cleaner:
+    path: .agents/skills/qk-code-cleaner
+    version: 10.1.0
+    status: stable
+    tags:
+      - code
+      - cleaner
+    dependencies:
+      - refactor
   qk-code-review:
     path: .agents/skills/qk-code-review
-    version: 9.1.0
+    version: 10.1.0
     status: stable
     tags:
       - code
       - review
-    dependencies: []
-  qk-context-loader:
-    path: .agents/skills/qk-context-loader
-    version: 9.1.0
-    status: stable
-    tags:
-      - context
-      - loader
-    dependencies: []
-  qk-data-engineer:
-    path: .agents/skills/qk-data-engineer
-    version: 9.2.0
-    status: stable
-    tags:
-      - data
-      - engineer
     dependencies:
-      - feature-delivery
-  qk-data-lifecycle:
-    path: .agents/skills/qk-data-lifecycle
-    version: 9.1.0
+      - code-review
+  qk-devops-release:
+    path: .agents/skills/qk-devops-release
+    version: 10.1.0
     status: stable
-    tags:
-      - data
-      - lifecycle
-    dependencies: []
-  qk-db-optimizer:
-    path: .agents/skills/qk-db-optimizer
-    version: 9.1.0
-    status: stable
-    tags:
-      - db
-      - optimizer
-    dependencies: []
-  qk-design-system-engineering:
-    path: .agents/skills/qk-design-system-engineering
-    version: 9.1.0
-    status: experimental
-    tags:
-      - design
-      - system
-      - engineering
-    dependencies: []
-  qk-devops-platform:
-    path: .agents/skills/qk-devops-platform
-    version: 9.1.0
-    status: experimental
     tags:
       - devops
-      - platform
-    dependencies: []
-  qk-docs:
-    path: .agents/skills/qk-docs
-    version: 9.1.0
-    status: stable
-    tags:
-      - docs
-    dependencies: []
-  qk-engineering-standard:
-    path: .agents/skills/qk-engineering-standard
-    version: 9.1.0
-    status: relocated
-    tags:
-      - engineering
-      - standard
-    dependencies: []
+      - release
+    dependencies:
+      - production-release
   qk-feature-delivery:
     path: .agents/skills/qk-feature-delivery
-    version: 9.1.0
+    version: 10.1.0
     status: stable
     tags:
       - feature
       - delivery
-    dependencies: []
-  qk-frontend-architecture:
-    path: .agents/skills/qk-frontend-architecture
-    version: 9.1.0
-    status: archived
-    tags:
-      - frontend
-      - architecture
-    dependencies: []
-  qk-help:
-    path: .agents/skills/qk-help
-    version: 9.1.0
-    status: deprecated
-    tags:
-      - help
-    dependencies: []
+    dependencies:
+      - feature-delivery
   qk-orchestrator:
     path: .agents/skills/qk-orchestrator
-    version: 9.1.0
+    version: 10.1.0
     status: stable
     tags:
       - orchestrator
-    dependencies: []
-  qk-product-specification:
-    path: .agents/skills/qk-product-specification
-    version: 9.1.0
-    status: experimental
-    tags:
-      - product
-      - specification
-    dependencies: []
-  qk-production-release:
-    path: .agents/skills/qk-production-release
-    version: 9.1.0
-    status: stable
-    tags:
-      - production
-      - release
-    dependencies: []
-  qk-project-audit:
-    path: .agents/skills/qk-project-audit
-    version: 9.2.0
-    status: stable
-    tags:
-      - project
-      - audit
     dependencies:
-      - feature-delivery
-  qk-project-bootstrap:
-    path: .agents/skills/qk-project-bootstrap
-    version: 9.1.0
-    status: stable
-    tags:
-      - project
-      - bootstrap
-    dependencies: []
-  qk-project-health:
-    path: .agents/skills/qk-project-health
-    version: 9.1.0
-    status: stable
-    tags:
-      - project
-      - health
-    dependencies: []
-  qk-project-memory:
-    path: .agents/skills/qk-project-memory
-    version: 9.1.0
-    status: stable
-    tags:
-      - project
-      - memory
-    dependencies: []
-  qk-refactor:
-    path: .agents/skills/qk-refactor
-    version: 9.1.0
+      - context-discovery
+  qk-product-spec:
+    path: .agents/skills/qk-product-spec
+    version: 10.1.0
     status: stable
     tags:
-      - refactor
+      - product
+      - spec
     dependencies:
-      - refactor
-  qk-security-audit:
-    path: .agents/skills/qk-security-audit
-    version: 9.1.0
-    status: experimental
-    tags:
-      - security
-      - audit
-    dependencies: []
-  qk-system-evolution:
-    path: .agents/skills/qk-upgrade
-    version: 9.1.0
-    status: stable
-    tags:
-      - upgrade
-    dependencies: []
-  qk-test-engineering:
-    path: .agents/skills/qk-test-engineering
-    version: 9.1.0
-    status: stable
-    tags:
-      - test
-      - engineering
-    dependencies: []
-  qk-ui-audit:
-    path: .agents/skills/qk-ui-audit
-    version: 9.1.0
+      - spec-driven-development
+  qk-prompt-compiler:
+    path: .agents/skills/qk-prompt-compiler
+    version: 11.1.0
     status: stable
     tags:
-      - ui
-      - audit
-    dependencies: []
-  qk-ui-builder:
-    path: .agents/skills/qk-ui-builder
-    version: 9.1.0
+      - prompt
+      - compiler
+    dependencies:
+      - prompt-compilation
+  qk-ui-engineer:
+    path: .agents/skills/qk-ui-engineer
+    version: 10.1.0
     status: stable
     tags:
       - ui
-      - builder
+      - engineer
     dependencies:
       - feature-delivery
-  qk-ui-system-builder:
-    path: .agents/skills/qk-ui-system-builder
-    version: 9.1.0
-    status: stable
-    tags:
-      - ui
-      - system
-      - builder
-    dependencies: []
-  qk-validation-gate:
-    path: .agents/skills/qk-validation-gate
-    version: 9.1.0
-    status: relocated
-    tags:
-      - validation
-      - gate
-    dependencies: []
-  qk-web-quality-gate:
-    path: .agents/skills/qk-web-quality-gate
-    version: 9.1.0
-    status: experimental
-    tags:
-      - web
-      - quality
-      - gate
-    dependencies: []

package/.agents/rules/coding.md

@@ -43,13 +43,19 @@ view_file[StartLine:EndLine] → read only that section
 
 ---
 
-## R-C-04: Naming Conventions
-
-- **Functions/methods:** `camelCase`, verb prefix (`getUser`, `buildPayload`, `validateInput`)
-- **Classes/types:** `PascalCase`
-- **Constants:** `UPPER_SNAKE_CASE`
-- **Files:** `kebab-case` (e.g., `user-service.ts`)
-- **Booleans:** `is`, `has`, `can` prefix (`isLoading`, `hasError`)
+## R-C-04: Naming Conventions (Language-Aware)
+
+- **Functions/methods:**
+  - TypeScript/JavaScript/Java/Go: `camelCase`, verb prefix (`getUser`, `buildPayload`, `validateInput`).
+  - Python (PEP 8): `snake_case`, verb prefix (`get_user`, `build_payload`, `validate_input`).
+- **Classes/types:** `PascalCase` (mọi ngôn ngữ).
+- **Constants:** `UPPER_SNAKE_CASE`.
+- **Files:**
+  - TypeScript/JavaScript utilities: `kebab-case` (e.g., `user-service.ts`).
+  - React/UI Components: `PascalCase` (e.g., `UserCard.tsx`, `SidebarNav.vue`).
+  - Python: `snake_case` (e.g., `user_service.py`, `auth_middleware.py`).
+  - Java/C#: `PascalCase` (e.g., `UserService.java`, `OrderController.cs`).
+- **Booleans:** `is`, `has`, `can` prefix (`isLoading` / `is_loading`, `hasError` / `has_error`).
 
 ---
 
@@ -72,11 +78,14 @@ if (retryCount > MAX_RETRIES) { ... }
 
 ```typescript
 // ❌ Never
-try { ... } catch (_) {}
-const value = data!.field;
-const value = data?.field ?? defaultValue; // OK only if intentional
+try { ... } catch (_) {}              // Suppressing errors silently
+const value = data!.field;            // Non-null assertion (!) bypasses type safety
+const value = (data as any).field;    // Bypassing compiler checks with 'any'
+
+// ✅ Safe Navigation (Allowed & Recommended)
+const value = data?.field ?? defaultValue; // Optional chaining is SAFE for nullable/optional properties
 
-// ✅ Always
+// ✅ Always handle errors explicitly
 try { ... } catch (err) { 
   logger.error(err); 
   throw new AppError('Context message', { cause: err }); 
@@ -129,7 +138,16 @@ Trước khi báo cáo task hoàn thành, **MUST** verify từng điểm:
 | 6 | No magic numbers | Dùng named constants |
 | 7 | No silent errors | Không empty catch, không `!`, không `any` |
 | 8 | DRY | Extract khi logic lặp ≥ 2 lần |
-| 9 | Naming conventions | camelCase fn, PascalCase class, UPPER_SNAKE constant |
+| 9 | Naming conventions | Tuân thủ R-C-04 theo ngôn ngữ |
 | 10 | No `console.log` in production code | Dùng logger hoặc xóa trước commit |
 
 **Violation:** Nếu bất kỳ điểm nào không đạt → sửa trước khi report SUCCESS. Không report PARTIAL chỉ vì threshold bị vi phạm.
+
+---
+
+## R-C-11: Data Science & Exploratory Notebooks Exemption
+
+> Áp dụng cho: Files `.ipynb` (Jupyter Notebooks), thư mục `notebooks/`, hoặc scripts phân tích dữ liệu thử nghiệm (EDA).
+
+- **Miễn trừ:** Các cell thử nghiệm dữ liệu trong Notebooks được miễn trừ khỏi ngưỡng cứng R-C-03 (Function length ≤ 40 dòng, Cyclomatic complexity ≤ 10) để bảo toàn sự liền mạch trong nghiên cứu mô hình.
+- **Quy chuẩn chuyển giao (Handoff):** Khi chuyển đổi code phân tích/model từ Notebook thành Pipeline chính thức (`dbt`, `Airflow`, API inference service), code hoàn chỉnh **PHẢI** tuân thủ đầy đủ R-C-01 đến R-C-10.

package/.agents/rules/command-safety.md

@@ -17,11 +17,18 @@ applies_to: [skills-with-side_effects-shell_exec]
 
 Tương ứng `safety.md` R-S-01 (`critical`) và R-S-03 (*BLOCKED without explicit request*).
 
-- `rm -rf /`, `rm -rf *`, `rm -rf node_modules` (trừ khi context task xác nhận đây là bước dọn dẹp hợp lệ và đã được user xác nhận).
-- Xóa database: `DROP DATABASE`, `DROP TABLE`, `TRUNCATE`.
-- Lệnh Git phá hủy lịch sử: `git reset --hard`, `git push --force`.
-- Hạ tầng: `terraform destroy`, `aws nuke`.
-- `chmod 777`.
+- File system:
+  - Linux/macOS: `rm -rf /`, `rm -rf *`, `rm -rf node_modules` (trừ khi context task xác nhận dọn dẹp hợp lệ).
+  - Windows PowerShell/CMD: `Remove-Item -Recurse -Force`, `rmdir /s /q`, `rd /s /q`.
+- Database:
+  - SQL: `DROP DATABASE`, `DROP TABLE`, `TRUNCATE`.
+- Git phá hủy lịch sử:
+  - `git reset --hard`, `git push --force`.
+- Hạ tầng:
+  - `terraform destroy`, `aws nuke`.
+- Quyền truy cập:
+  - Linux: `chmod 777`.
+  - Windows: `icacls ... /grant Everyone:F`.
 
 Khi gặp lệnh thuộc nhóm này, Agent **MUST** dùng đúng format xác nhận tại `safety.md` R-S-02 (`⚠️ BREAKING CHANGE DETECTED`) và chờ phản hồi rõ ràng ("yes") trước khi thực thi.
 
@@ -31,9 +38,13 @@ Khi gặp lệnh thuộc nhóm này, Agent **MUST** dùng đúng format xác nh
 
 Có thể chạy nhưng **PHẢI** verify path/scope trước, không chạy mù:
 
-- Thao tác file hàng loạt: `find . -name "*.js" -delete`.
+- Thao tác file hàng loạt:
+  - Linux: `find . -name "*.js" -delete`.
+  - Windows PowerShell: `Get-ChildItem -Recurse -Filter "*.js" | Remove-Item`.
 - Cài đặt ảnh hưởng phạm vi toàn cục: `npm install -g`, `pip install` (ngoài venv/project scope).
-- Khởi động lại service hệ thống: `systemctl restart`.
+- Khởi động lại service hệ thống:
+  - Linux: `systemctl restart`, `service ... restart`.
+  - Windows PowerShell: `Restart-Service`, `Stop-Service`.
 - `git commit`, `git push` (cấp `medium` theo `safety.md` R-S-03 — chạy được nhưng phải báo cáo thay đổi).
 
 ---
@@ -41,4 +52,4 @@ Có thể chạy nhưng **PHẢI** verify path/scope trước, không chạy mù
 ## R-CS-03: Action Plan
 
 - Với lệnh **R-CS-01**: dừng lại, áp dụng format xác nhận `safety.md` R-S-02, không tự động chạy.
-- Với lệnh **R-CS-02**: xác minh scope trước (ví dụ chạy `ls`/`git status` trước), chỉ chạy tiếp khi scope đúng như dự kiến; không cần dừng hỏi user trừ khi phát hiện scope bất thường.
+- Với lệnh **R-CS-02**: xác minh scope trước (ví dụ chạy `ls`/`dir`/`git status` trước), chỉ chạy tiếp khi scope đúng như dự kiến; không cần dừng hỏi user trừ khi phát hiện scope bất thường.