ai-developer-skill-os 8.2.1 → 8.3.1

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

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-production-release
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -28,7 +28,7 @@ triggers:
   - "kiểm tra release"
 
 # ── V8: References ─────────────────────────────────────────
-workflow: internal
+workflow: production-release
 
 rules:
   - global
@@ -47,6 +47,18 @@ knowledge_scope:
     - deployment-gate
   references:
     - architecture
+    - security
+    - anti-patterns
+
+decision_boundary:
+  owns:
+    - release-gate-checklist
+    - deployment-readiness-verdict
+  does_not_own:
+    - ci-cd-pipeline-design
+    - infrastructure-provisioning
+  conflicts_with:
+    - qk-devops-platform
 
 # ── V8: Verification ───────────────────────────────────────
 verification:
@@ -80,12 +92,7 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 # qk-production-release — Release Gate
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ## Preconditions
 - [ ] `qk-validation-gate` has been run and returned SUCCESS or PARTIAL
@@ -98,11 +105,6 @@ On missing precondition:
   Message: "qk-validation-gate must pass before release. Run it first."
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Scope
 - ✅ Run 8-gate release checklist
 - ✅ Verify no dev artifacts in production build
@@ -113,11 +115,6 @@ schema_version: 2
 - ❌ Deploy to infrastructure — that's DevOps/CI system
 - ❌ Skip any gate unless user explicitly overrides
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Priority Order
 
 | Priority | Gate | Block Release? |
@@ -128,14 +125,9 @@ schema_version: 2
 | P4 | .env.production exists (not .env.development) | YES — hard block |
 | P5 | Build succeeds in production mode | YES — hard block |
 | P6 | Bundle size within limit (< 500KB gzipped) | WARN only |
-| P7 | No dev dependencies in production build | YES — hard block |
+| P7 | No dev dependencies in production build. Check vulnerabilities (`npm audit`) | YES — hard block (Nếu có CRITICAL, báo gọi `qk-security-audit`) |
 | P8 | CHANGELOG.md updated with release notes | WARN only |
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Release Checklist (Mandatory)
 
 ```
@@ -149,11 +141,6 @@ schema_version: 2
 [ ] P8: CHANGELOG.md has entry for this release
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Workflow
 
 ### Phase 1 — Pre-flight Checks (P1–P4)
@@ -173,11 +160,6 @@ IF all P1–P4 pass
   → go to Phase 2
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ### Phase 2 — Build & Size Gate (P5–P7)
 
 **Steps:**
@@ -197,11 +179,6 @@ IF production audit has critical/high
   → EXIT: FAILED
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ### Phase 3 — Release Report
 
 Generate signed release report with all gate results.
@@ -218,11 +195,6 @@ IF any hard-block gate failed
   → EXIT: FAILED — do NOT deploy
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Evidence Format
 
 ```
@@ -234,11 +206,6 @@ Actual:     [what was found]
 Fix:        [what must be done before release]
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Escalation Rules
 
 ```
@@ -250,11 +217,6 @@ Questions:
   2. Có bug nào HIGH/CRITICAL chưa fix không?
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Handoff Contract
 
 ### Consumes
@@ -274,11 +236,6 @@ schema_version: 2
 }
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
 ## Output Format
 
 ```
@@ -301,28 +258,37 @@ Verdict:    [✅ SAFE TO DEPLOY | ❌ DO NOT DEPLOY — fix: list]
 Exit Code:  [SUCCESS | PARTIAL | BLOCKED | FAILED]
 ```
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-
 ---
 
 ## Confidence Model
 
+| Level | Condition | Action |
+|-------|-----------|--------|
+| HIGH | validation-gate result confirmed + all 8 gates checked directly | Deploy approved |
+| MEDIUM | some gates inferred from partial CI output | Deploy with caution |
+| LOW | validation-gate not run / gate results stale | EXIT: BLOCKED |
 
 ---
 
 ## Severity
 
+| Level | Definition |
+|-------|-----------|
+| CRITICAL | deploying with unresolved P1–P5 hard-block gate failure |
+| HIGH | P6/P7 warning ignored without user override |
+| MEDIUM | CHANGELOG missing |
+| LOW | minor formatting in release report |
 
 ---
 
 ## Retry Policy
 
-
----
+```
+Build fails during Phase 2
+  └─ check syntax vs. environment error
+       ├─ fix and retry once
+       └─ do not retry more than 1 time (risk of masking a real failure)
+```
 ## Exit Codes
 
 | Code | Meaning | When |
@@ -334,4 +300,3 @@ schema_version: 2
 
 ---
 
-

package/.agents/skills/qk-production-release/capability.yaml

@@ -0,0 +1,27 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-production-release"
+version: "8.3.1"
+description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "release-checklist"
+    - "deployment-gate"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "release-gate-checklist"
+    - "deployment-readiness-verdict"
+  does_not_own:
+    - "ci-cd-pipeline-design"
+    - "infrastructure-provisioning"
+  conflicts_with:
+    - "qk-devops-platform"

package/.agents/skills/qk-production-release/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-production-release-eval
+description: Đánh giá quá trình kiểm duyệt phát hành (Release Gate)
+version: 8.3.1
+threshold: 100 # Phải đạt 100 điểm vì lỗi ở Gate này có thể gây sập Production
+
+metrics:
+  - id: strict_gate_enforcement
+    name: Kỷ luật thi hành Checklist 8-Gate
+    description: Agent có nghiêm túc chặn việc release nếu phát hiện lỗi Hard-block không?
+    weight: 40
+    criteria:
+      - BẮT BUỘC chặn đứng (EXIT: FAILED) nếu các cổng P1–P5 hoặc P7 (CRITICAL security) thất bại (40đ)
+
+  - id: pre_flight_checks
+    name: Kiểm tra rác mã và Cấu hình (Pre-flight)
+    description: Agent có phát hiện được log rác và nhầm lẫn file môi trường không?
+    weight: 30
+    criteria:
+      - Rà soát thành công các tàn dư debug (console.log, debugger) trong mã nguồn (15đ)
+      - Xác minh chắc chắn biến môi trường đang trỏ về Production (.env.production) (15đ)
+
+  - id: build_and_security
+    name: Kiểm thử Build và Bảo mật
+    description: Phân tích Build Bundle và Dependency Audit có được chạy không?
+    weight: 30
+    criteria:
+      - Chạy lệnh build để đảm bảo source code không bị gãy (15đ)
+      - Chạy npm audit/yarn audit để chặn mã độc/vulnerabilities lên server (15đ)

package/.agents/skills/qk-project-bootstrap/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-bootstrap
-version: 8.2.0
+version: 8.3.1
 status: stable
 description: "Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -49,6 +49,8 @@ knowledge_scope:
     - initial-setup
   references:
     - architecture
+    - security
+    - anti-patterns
 
 # ── V8: Verification ───────────────────────────────────────
 verification:
@@ -67,9 +69,7 @@ execution_mode: deterministic
 cost: high
 latency: slow
 risk: low
-side_effects: 
-  - create_files
-  - create_structure
+side_effects: edit_files
 produces: [code, schema, plan]
 consumes: [user-description]
 
@@ -84,7 +84,7 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 # qk-project-bootstrap — Project Foundation Builder
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ---
 
@@ -173,6 +173,8 @@ evals/                    # Traceability logs
 [ ] README.md — project description + setup instructions
 [ ] DESIGN.md — (UI projects) brand contract with color/font/spacing tokens
 [ ] evals/scorecard.yaml — (AI/RAG/Workflow projects) eval standard
+[ ] .agents/rules/anti-patterns.md — Bắt buộc phải có (chuẩn V8.3 R-C-09)
+[ ] .agents/rules/security.md — Bắt buộc phải có (chuẩn V8.3 R-SEC-04)
 ```
 -----
 
@@ -204,21 +206,72 @@ evals/                    # Traceability logs
 
 ---
 
-
 ---
 
 ## Workflow
 
+### Phase 1 — Blueprint Selection
+**Steps:**
+1. Assess Preconditions to determine framework/purpose.
+2. Select appropriate blueprint (coding, rag, workflow, enterprise).
+
+**Decision:**
+```
+IF framework/purpose is clear
+  → Confidence: HIGH → go to Phase 2
+ELSE
+  → EXIT: BLOCKED — ask user
+```
+
+### Phase 2 — Scaffold Generation
+**Steps:**
+1. Generate `project.yaml` manifest.
+2. Create directory tree structure based on blueprint.
+3. Configure tooling and generate `DESIGN.md` if UI project.
+
+**Decision:**
+```
+IF directories and files are generated
+  → Confidence: HIGH → go to Phase 3
+ELSE
+  → EXIT: FAILED
+```
+
+### Phase 3 — Verification
+**Steps:**
+1. Check Required Files Checklist against what was actually created.
+2. Ensure no mandatory files are missing.
+
+**Decision:**
+```
+IF all required files exist
+  → EXIT: SUCCESS
+ELSE
+  → EXIT: PARTIAL
+```
 
 ---
 
 ## Evidence Format
 
+```
+[SEVERITY] path/to/expected-file
+Issue:      [MISSING_MANIFEST | MISSING_DESIGN_MD | WRONG_STRUCTURE]
+Confidence: HIGH
+Fix:        [specific file to create]
+```
 
 ---
 
 ## Priority Order
 
+| Priority | Task | Skip Threshold |
+|----------|------|----------------|
+| P1 | project.yaml manifest created | Never |
+| P2 | Core scaffolding per blueprint type | Never |
+| P3 | Tooling config | Budget < 40% |
+| P4 | DESIGN.md for UI projects | Never for UI |
+| P5 | README | Budget < 60% |
 
 ---
 ## Exit Codes
@@ -295,5 +348,3 @@ Recommended Assumptions (if proceeding):
 
 ---
 
-
-

package/.agents/skills/qk-project-bootstrap/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-project-bootstrap"
+version: "8.3.1"
+description: "Khởi tạo dự án mới theo chuẩn V8.2 Blueprint Plugin Generator (project.yaml, 4-folder AI RAG hoặc Coding) với cấu trúc kiên cường."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "project-structure"
+    - "initial-setup"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-project-bootstrap"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-project-bootstrap/evals/scorecard.yaml

@@ -0,0 +1,28 @@
+name: qk-project-bootstrap-eval
+description: Đánh giá chất lượng khởi tạo dự án V8.2 Blueprint
+version: 8.3.1
+threshold: 85 # Đảm bảo cấu trúc kiến trúc được thiết lập chuẩn xác ngay từ đầu
+
+metrics:
+  - id: blueprint_selection
+    name: Lựa chọn Blueprint phù hợp
+    description: Chọn đúng Blueprint và Manifest project.yaml tương ứng chưa?
+    weight: 35
+    criteria:
+      - Nhận diện đúng loại hình dự án (Coding, RAG/AI, Workflow) và áp dụng Blueprint cấu trúc thư mục phù hợp (15đ)
+      - Tạo ra file project.yaml chứa manifest của workspace (20đ)
+
+  - id: mandatory_files_scaffolding
+    name: Cấu trúc thư mục và File bắt buộc
+    description: Cây thư mục có thiếu các file quản lý chất lượng lõi không?
+    weight: 40
+    criteria:
+      - Sinh đúng kiến trúc (Ví dụ: 4-folder architecture cho AI RAG) (20đ)
+      - Đảm bảo đầy đủ các files chống thoái hóa: DESIGN.md, security.md, anti-patterns.md, scorecard.yaml (20đ)
+
+  - id: tooling_configuration
+    name: Cấu hình Công cụ (Tooling)
+    description: Môi trường có được thiết lập strict type và linter chưa?
+    weight: 25
+    criteria:
+      - Các cấu hình (tsconfig, eslint, prettier) được thiết lập chặt chẽ, không dễ dãi (25đ)

package/.agents/skills/qk-project-health/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-health
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score 0–100 với actionable roadmap."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -48,6 +48,8 @@ knowledge_scope:
     - codebase-health
   references:
     - architecture
+    - security
+    - anti-patterns
 
 # ── V8: Verification ───────────────────────────────────────
 verification:
@@ -105,8 +107,8 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 
 | Dimension | Max Points | Key Checks |
 |-----------|-----------|------------|
-| Security | 20 | 0 critical CVEs, no hardcoded secrets, auth guards present |
-| Code Quality | 20 | Functions ≤ 30L, complexity ≤ 10, no God Files |
+| Security | 20 | 0 critical CVEs, no hardcoded secrets, auth guards present, **tuân thủ Zero-Trust (R-SEC-04)** |
+| Code Quality | 20 | Functions ≤ 30L, complexity ≤ 10, no God Files, **sạch bóng Anti-patterns (R-C-09)** |
 | Architecture | 20 | Clean layers (UI/Logic/Data separated), no circular imports |
 | Dependencies | 20 | No deprecated packages, no unused deps, versions pinned |
 | Documentation | 20 | README complete, public APIs documented, DESIGN.md exists |

package/.agents/skills/qk-project-health/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-project-health"
+version: "8.3.1"
+description: "Kiểm toán toàn diện Code Smells, Tech Debt, Architecture — health score 0–100 với actionable roadmap."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "tech-debt"
+    - "codebase-health"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-project-health"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-project-health/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-project-health-eval
+description: Đánh giá năng lực Kiểm toán toàn diện sức khỏe Codebase
+version: 8.3.1
+threshold: 85 # Đảm bảo chấm điểm công tâm và vạch ra Roadmap cải thiện rõ ràng
+
+metrics:
+  - id: five_dimensions_scoring
+    name: Chấm điểm 5 Phương diện (5 Dimensions)
+    description: Đánh giá toàn diện 5 yếu tố cốt lõi của codebase chưa?
+    weight: 40
+    criteria:
+      - Quét và tính điểm đầy đủ 5 phương diện: Security, Code Quality, Architecture, Dependencies, Documentation (20đ)
+      - Có bằng chứng (Evidence) cho các vi phạm bị trừ điểm (20đ)
+
+  - id: security_and_antipatterns
+    name: Quét Bảo mật (R-SEC-04) và Anti-patterns (R-C-09)
+    description: Agent có tìm ra các lỗ hổng bảo mật hoặc rác mã nghiêm trọng không?
+    weight: 30
+    criteria:
+      - Tìm thấy hardcoded secrets, eval(), hoặc vi phạm kiến trúc (God files, circular deps) nếu có (30đ)
+
+  - id: actionable_roadmap
+    name: Roadmap Tái cấu trúc thực tiễn
+    description: Báo cáo có vạch ra con đường sửa chữa rõ ràng không?
+    weight: 30
+    criteria:
+      - Output không chỉ chê bai mà còn sắp xếp các vấn đề theo độ ưu tiên (CRITICAL sửa trước) để team fix (30đ)

package/.agents/skills/qk-project-memory/SKILL.md

@@ -1,7 +1,7 @@
 ---
 # ── Identity ───────────────────────────────────────────────
 name: qk-project-memory
-version: 8.0.0
+version: 8.3.1
 status: stable
 description: "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh, không lưu giả thuyết."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
@@ -48,6 +48,8 @@ knowledge_scope:
     - verified-context
   references:
     - architecture
+    - security
+    - anti-patterns
 
 # ── V8: Verification ───────────────────────────────────────
 verification:
@@ -98,7 +100,7 @@ exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
 ## Non-Goals
 - ❌ Store assumptions or unverified hypotheses
 - ❌ Overwrite architectural rules without explicit user consent
-- ❌ Store sensitive data (env vars, secrets)
+- ❌ Store sensitive data (env vars, secrets). **Tuyệt đối cấm lưu trữ PII, API Keys, raw JWTs, hoặc các bad practices vi phạm R-C-09 vào bộ nhớ dài hạn.**
 
 ---
 

package/.agents/skills/qk-project-memory/capability.yaml

@@ -0,0 +1,23 @@
+# Auto-generated from SKILL.md frontmatter
+schema_version: 1
+id: "qk-project-memory"
+version: "8.3.1"
+description: "Lưu trữ và truy xuất ngữ cảnh dự án dài hạn — chỉ lưu fact đã xác minh, không lưu giả thuyết."
+tools:
+  - "filesystem"
+  - "terminal"
+knowledge:
+  owns:
+    - "project-facts"
+    - "verified-context"
+  references:
+    - "architecture"
+    - "security"
+    - "anti-patterns"
+eval:
+  scorecard: "evals/scorecard.yaml"
+decision_boundary:
+  owns:
+    - "qk-project-memory"
+  does_not_own: []
+  conflicts_with: []

package/.agents/skills/qk-project-memory/evals/scorecard.yaml

@@ -0,0 +1,27 @@
+name: qk-project-memory-eval
+description: Đánh giá quá trình lưu trữ và truy xuất ngữ cảnh dài hạn (Project Memory)
+version: 8.3.1
+threshold: 85 # Yêu cầu độ chính xác cao khi ghi đè hoặc lưu trữ để tránh ảo giác
+
+metrics:
+  - id: fact_verification
+    name: Chỉ lưu trữ Sự thật (Fact), không lưu Giả thuyết
+    description: Agent có kiểm chứng thông tin qua source code trước khi lưu vào Memory không?
+    weight: 40
+    criteria:
+      - Tuyệt đối không lưu các giả định (assumptions) hoặc fact có Confidence LOW (20đ)
+      - Có bằng chứng (file:line) đính kèm khi ghi dữ liệu (20đ)
+
+  - id: zero_trust_memory
+    name: An toàn dữ liệu trong Memory (Zero Trust)
+    description: Agent có vô tình lưu thông tin nhạy cảm vào Memory không?
+    weight: 35
+    criteria:
+      - KHÔNG lưu trữ PII, API Keys, raw JWTs hay credentials dưới dạng clear text (35đ)
+
+  - id: ui_diversification
+    name: Áp dụng UI Diversification
+    description: Có lưu và kiểm tra lịch sử thiết kế để tránh UI lặp lại nhàm chán không?
+    weight: 25
+    criteria:
+      - Đọc và ghi đúng vào file `ui-diversification.json` để ngăn chặn trùng lặp theme/macrostructure (25đ)