ai-developer-skill-os 3.1.5 → 5.0.0

package/skills/qk-policy-engine/SKILL.md

@@ -1,60 +1,55 @@
 ---
 name: qk-policy-engine
-version: 3.1.5
-updated: 2026-07-02
+version: 5.0.0
+updated: 2026-07-03
 description: Hệ thống đánh giá chính sách để đảm bảo các hành động an toàn và được ủy quyền.
 category: security
-behavior: static-analysis
-intent: review-code
-priority: high
-tags: [security, policy, guardrails, authorization]
+tags: [security, policy, safety, guardrails]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to perform a high-risk destructive action (e.g., DROP table, mass delete).
-inputs: [Requested Action, Context]
-outputs: [Approval/Denial, Policy violations]
-allowed_tools: [read_file]
-pipeline: [analyze, evaluate, complete]
 ---
 
-# 🛠️ qk-policy-engine - Standard Operating Procedure
+# 🛠️ qk-policy-engine
 
-> **Goal:** Đóng vai trò là "Bộ quy tắc thép" (Policy Enforcer). Ngăn chặn các lệnh sai lầm có thể phá hoại hệ thống.
+> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
+> Output bắt buộc là Decision Summary.
 
-## 🔄 1. Chain of Thought (SOP)
+---
 
-1. **Analyze (Risk Assessment):**
-   - Classify the user's request (Low, Medium, High risk).
-   - High Risk: Dropping databases, deleting multiple files, force-pushing to `main`.
-2. **Evaluate (Policy Check):**
-   - Load security policies (from `.agents/AGENTS.md` or `.cursorrules`).
-   - Check if the action violates any safety constraints.
-3. **Complete (Decision):**
-   - Approve (Allow execution) or Deny (Block execution) with explicit reasons.
+## 🎯 Mission (Scope)
+- ✅ Đóng vai trò Guardrails, ngăn chặn các hành vi phá hoại trước khi chúng diễn ra.
+- ❌ Do NOT đồng ý thực thi lệnh nguy hiểm (drop table, rm -rf) trừ khi có sự xác nhận mạnh mẽ.
 
-## 🛡️ 2. Constraints & Rules
+---
 
-- **Deny by Default:** If an action is highly destructive and no backup plan exists, DENY it.
-- **Override:** Only allow skipping the policy if the user explicitly passes an `--override` flag in their prompt.
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - bias-review
+  - ship-check
+```
 
-## 🌳 3. Decision Tree
+---
 
-```text
-Does the action involve deleting data or resources in Production?
-  ├── YES → Has the user provided a backup confirmation?
-  │       ├── YES → Approve.
-  │       └── NO → DENY and request backup confirmation.
-  └── NO → Approve.
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
 ```
 
-## 🤝 4. Handoff Pipeline
-
-1. `complete`: Generate the Policy Decision Report.
+---
 
-## 📝 5. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: swallow-errors
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Mức độ rủi ro (Risk Level).
-- **Phán quyết (Decision):** ✅ APPROVED hoặc ❌ DENIED.
-- **Nguyên nhân (Reasoning):** Vi phạm chính sách nào (nếu bị Deny).
-- **Hành động tiếp (Next Action):** ...
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: delegation-only
+```

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

@@ -1,52 +1,56 @@
 ---
 name: qk-production-release
-version: 3.1.5
-updated: 2026-07-02
+version: 5.0.0
+updated: 2026-07-03
 description: Chuẩn bị codebase để phát hành lên production (Build, CI/CD, Security).
-category: operations
-behavior: validation
-intent: validate
-priority: high
-tags: [deploy, release, build, production]
+category: devops
+tags: [devops, ci-cd, release, deployment]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to deploy the app, build for production, or release a new version.
-inputs: [Release request, Environment configs]
-outputs: [Deployment artifacts, Release checklist]
-allowed_tools: [run_command, grep_search]
-pipeline: [analyze, review, implement, validate, complete]
 ---
 
-# 🛠️ qk-production-release - Standard Operating Procedure
+# 🛠️ qk-production-release
 
-> **Goal:** Chuẩn bị gói phần mềm để đẩy lên môi trường Production an toàn và tối ưu nhất (Minified, Tree-shaked).
+> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
+> Output bắt buộc là Decision Summary.
 
-## 🔄 1. Chain of Thought (SOP)
+---
+
+## 🎯 Mission (Scope)
+- ✅ Chạy kiểm tra chất lượng cuối cùng trước khi build.
+- ❌ Do NOT tự tay deploy lên Production server mà không hỏi ý kiến.
 
-1. **Analyze (Pre-flight Checks):**
-   - Check if the git branch is clean.
-   - Verify environment variables are documented.
-2. **Implement (Build & Optimize):**
-   - Run `npm run build`.
-3. **Validate (Security Gate):**
-   - Scan the build output (e.g., `dist/` or `.next/`) for leaked API Keys (`grep_search`).
-4. **Complete (Deployment Plan):**
-   - Provide a manual checklist for the user to execute the final deployment.
+---
 
-## 🛡️ 3. Constraints & Rules
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-- **No Rogue Deploys:** Never run commands like `firebase deploy` or `vercel --prod` without explicit, undeniable user approval.
-- **Secret Safety:** Never hardcode URLs. Ensure they are injected via ENV.
+---
 
-## 🤝 3. Handoff Pipeline
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
+```
 
-1. `validate`: Run security sweep on the build output.
-2. `complete`: Output the Release Report.
+---
 
-## 📝 4. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: hallucinated-tools # (Tự chạy lệnh deploy không tồn tại)
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Trạng thái Build.
-- **Chi tiết (Changes):** Dung lượng Bundle (Bundle size optimization).
-- **Rủi ro (Risks):** Có lộ secret không.
-- **Hành động tiếp (Next Action):** Checklist để user tự Deploy.
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: end-to-end-validation
+```

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

@@ -1,50 +1,57 @@
 ---
 name: qk-project-bootstrap
-version: 3.1.5
-updated: 2026-07-02
+version: 5.0.0
+updated: 2026-07-03
 description: Khởi tạo dự án mới với các best practices, linters, và cấu trúc thư mục chuẩn.
 category: setup
-behavior: development
-intent: implement-feature
-priority: high
 tags: [bootstrap, scaffolding, setup, init]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to start a new project, create a new repo, or setup standard configurations.
-inputs: [Stack selection, Project Name]
-outputs: [Scaffolded Codebase, Configs]
-allowed_tools: [run_command, write_to_file]
-pipeline: [analyze, implement, engineering-standard, validate, complete]
 ---
 
-# 🛠️ qk-project-bootstrap - Standard Operating Procedure
+# 🛠️ qk-project-bootstrap
 
-> **Goal:** "Thợ xây móng". Khởi tạo một dự án mới hoàn toàn với các cấu hình chuẩn mực nhất từ Day 1.
+> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
+> Output bắt buộc là Decision Summary.
 
-## 🔄 1. Chain of Thought (SOP)
+---
+
+## 🎯 Mission (Scope)
+- ✅ Setup dự án mới từ đầu.
+- ❌ Do NOT khởi tạo với cấu hình lỏng lẻo (Linter tắt).
 
-1. **Analyze (Requirements):**
-   - Ask the user for their preferred stack (e.g., Next.js, Vite, NestJS).
-2. **Implement (Scaffolding):**
-   - Run the initialization command (e.g., `npx create-next-app@latest`).
-   - Overwrite `.eslintrc`, `prettierrc`, `tsconfig.json` with strict rules.
-   - Scaffold the architecture (e.g., create `src/features/`, `src/components/shared/`).
-3. **Verify (Validation):**
-   - Run `npm run dev` in a short background task to ensure it doesn't crash.
+---
 
-## 🛡️ 2. Constraints & Rules
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-- **Strict Mode:** Always enable `strict: true` in TypeScript configurations.
-- **Package Manager Check:** If the user uses `pnpm`, do NOT run `npm install`. Stick to one package manager.
+---
 
-## 🤝 3. Handoff Pipeline
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
+  - id: complexity-budget
+```
 
-1. `engineering-standard`: Verify the generated folder structure.
-2. `complete`: Output the Bootstrap Report.
+---
 
-## 📝 4. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: enterprise-crud
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Dự án đã được khởi tạo với Stack nào.
-- **Chi tiết (Changes):** Cấu trúc thư mục mới và các file cấu hình.
-- **Xác thực (Verification):** Cách chạy dự án.
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: no-unnecessary-dependencies
+```

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

@@ -1,64 +1,56 @@
 ---
 name: qk-project-health
-version: 3.1.5
-updated: 2026-07-02
+version: 5.0.0
+updated: 2026-07-03
 description: Kiểm toán toàn diện về Code Smells, Tech Debt, và Architecture.
 category: architecture
-behavior: static-analysis
-intent: review-code
-priority: medium
 tags: [audit, architecture, tech-debt, code-smell]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks for a project review, architecture audit, or health check.
-inputs: [Project directory]
-outputs: [Health Audit Score, Refactor roadmap]
-allowed_tools: [grep_search, run_command, read_file]
-pipeline: [analyze, review, validate, complete]
 ---
 
-# 🛠️ qk-project-health - Standard Operating Procedure
+# 🛠️ qk-project-health
 
-> **Goal:** "Khám sức khỏe" toàn diện cho Codebase. Tìm ra các Nợ Kỹ Thuật (Tech Debt), Mã Lỗi Thời (Code Smells), và các rủi ro cấu trúc dài hạn.
+> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
+> Output bắt buộc là Decision Summary.
 
-## 🔄 1. Chain of Thought (SOP)
-
-1. **Analyze (Dependency Scan):**
-   - Read `package.json` to identify outdated libraries, bloated dependencies, or unused packages.
-2. **Review (Architecture Scan):**
-   - Use `list_dir` or tree commands to review the directory structure.
-   - Check if the project follows a scalable pattern (e.g., Feature-based vs flat `components` folder).
-3. **Validate (Smell Detection):**
-   - Scan for "God Components" (Files > 500 lines).
-   - Scan for heavy Prop Drilling (>3 levels deep).
-4. **Complete (Roadmap):**
-   - Generate a prioritized Refactor Roadmap (High, Medium, Low).
+---
 
-## 🛡️ 3. Constraints & Rules
+## 🎯 Mission (Scope)
+- ✅ Phân tích tech debt và code smells.
+- ❌ Do NOT bắt lỗi thụt lề, khoảng trắng (Việc của linter).
 
-- **Audit Only - No Touch:** Do not modify any code. You are diagnosing, not performing surgery.
-- **Evidence Based:** Provide concrete metrics (e.g., "Folder `components` has 45 files, making it hard to navigate").
+---
 
-## 🌳 3. Decision Tree
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-```text
-Is the `src/components` folder bloated (>30 files)?
-  ├── YES → Recommend migrating to a Feature-driven structure (e.g., `src/features/auth`).
-  └── NO → Pass.
+---
 
-Are there components exceeding 500 lines?
-  ├── YES → Flag as "God Object" and recommend splitting.
-  └── NO → Pass.
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
 ```
 
-## 🤝 4. Handoff Pipeline
-
-1. `complete`: Output the Health Audit Report.
+---
 
-## 📝 5. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: cosmetic-refactor
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Đánh giá tổng quan Sức Khỏe Dự Án (Điểm: X/100).
-- **Chi tiết (Changes):** Phân tích Dependencies, Architecture, Code Smells.
-- **Xác thực (Verification):** Các bằng chứng thu thập được từ code (dòng nào, file nào phình to).
-- **Hành động tiếp (Next Action):** Lên Lộ trình Refactor (Refactor Roadmap) (Cao - Trung - Thấp).
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: delegation-only # (Chỉ đọc và tư vấn, cấm tự ý đổi code)
+```

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

@@ -1,42 +1,56 @@
 ---
 name: qk-project-memory
-version: 3.1.5
-updated: 2026-07-02
+version: 5.0.0
+updated: 2026-07-03
 description: Lưu trữ và truy xuất ngữ cảnh dự án dài hạn qua các phiên làm việc.
 category: utilities
-behavior: static-analysis
-intent: maintain
-priority: low
 tags: [memory, context, storage]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to remember a specific configuration, rule, or architectural decision.
-inputs: [Context to remember]
-outputs: [Memory file updated]
-allowed_tools: [write_to_file, read_file]
-pipeline: [analyze, implement, complete]
 ---
 
-# 🛠️ qk-project-memory - Standard Operating Procedure
+# 🛠️ qk-project-memory
 
-> **Goal:** "Bộ nhớ dài hạn". Giúp Agent nhớ lại các cấu hình, đường dẫn API hoặc luật lệ riêng của dự án mà không cần User nhắc lại.
+> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
+> Output bắt buộc là Decision Summary.
 
-## 🔄 1. Chain of Thought (SOP)
+---
+
+## 🎯 Mission (Scope)
+- ✅ Lưu trữ các Rule, ADR, và cấu hình bất biến vào memory.
+- ❌ Do NOT dump toàn bộ file mã nguồn hoặc hội thoại vào memory gây phình to token.
 
-1. **Analyze (Fact Extraction):**
-   - Extract the core facts from the conversation (e.g., "The project uses pnpm, not npm").
-2. **Implement (Storage):**
-   - Append the fact to `.ai-memory.md` or a similar configuration file.
+---
 
-## 🛡️ 2. Constraints & Rules
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-- **Keep it small:** Do not write entire source files into memory. Only save abstract facts and rules.
+---
 
-## 🤝 3. Handoff Pipeline
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
+```
 
-1. `complete`: Output confirmation.
+---
 
-## 📝 4. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: hallucinated-tools
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Đã ghi nhớ thông tin gì.
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: minimal-diff
+```

package/skills/qk-system-evolution/SKILL.md

@@ -1,71 +1,56 @@
 ---
 name: qk-system-evolution
-version: 3.1.5
-updated: 2026-07-02
+version: 5.0.0
+updated: 2026-07-03
 description: Cập nhật an toàn các thư viện dependencies, di chuyển frameworks và quản lý quá trình rollback.
 category: operations
-behavior: maintenance
-intent: maintain
-priority: high
 tags: [upgrade, migration, devops, dependencies]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User wants to update a library, upgrade a framework (e.g., Next.js 13 to 14), or perform a major refactor.
-inputs: [Target package, Target version]
-outputs: [Upgraded codebase, Rollback plan]
-allowed_tools: [run_command, grep_search, read_file]
-pipeline: [analyze, plan, implement, validate, complete]
 ---
 
-# 🛠️ qk-system-evolution - Standard Operating Procedure
+# 🛠️ qk-system-evolution
 
-> **Goal:** Quản lý các thay đổi lớn cấp hệ thống (Major Updates) một cách an toàn, luôn có đường lui (Rollback) nếu xảy ra sự cố.
+> **Inheritance:** Kỹ năng này tuân thủ Kiến trúc v5.0 của `framework/KERNEL.md`.
+> Output bắt buộc là Decision Summary.
 
-## 🔄 1. Chain of Thought (SOP)
-
-1. **Analyze (Impact Analysis):**
-   - Read the Changelog or Migration Guide for the new version.
-   - Identify Breaking Changes and Deprecated APIs.
-   - Search the codebase to see how many files are affected.
-2. **Plan (Rollback Strategy):**
-   - Document the exact Git commands or NPM commands needed to revert the system if the upgrade fails completely.
-3. **Implement (Dry-Run & Upgrade):**
-   - **Mandatory Dry Run:** Create a temporary branch (e.g., `git checkout -b upgrade-dry-run`).
-   - Update dependencies and run Codemods on this branch.
-   - Fix Breaking Changes and pass the Validation Gate. Merge only if safe.
-4. **Verify (System Test):**
-   - Reinstall dependencies cleanly (`npm ci` or `yarn install`).
-   - Run the build process to ensure the system compiles.
+---
 
-## 🛡️ 3. Constraints & Rules
+## 🎯 Mission (Scope)
+- ✅ Nâng cấp dependencies và xử lý breaking changes.
+- ❌ Do NOT xóa file lock tuỳ tiện hoặc cập nhật `latest` mù quáng.
 
-- **Safety First:** Never run `npm update` blindly across all packages. Update only what was requested.
-- **Lockfiles:** Do not delete `package-lock.json` or `yarn.lock` unless resolving extreme merge conflicts.
-- **Always Rollback:** If the system produces >50 compilation errors after an upgrade and you cannot fix them in 1 turn, immediately trigger the Rollback Plan.
+---
 
-## 🌳 3. Decision Tree
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-```text
-Are there Breaking Changes in the target version?
-  ├── YES → Create a migration checklist based on the official docs. Update code systematically.
-  └── NO (Minor/Patch) → Update version and run tests.
+---
 
-Did the Build fail after the update?
-  ├── YES → Are there too many errors to fix easily?
-  │       ├── YES → Execute Rollback Plan (`git reset --hard HEAD`).
-  │       └── NO → Fix the specific API changes.
-  └── NO → Proceed to Validation.
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
 ```
 
-## 🤝 4. Handoff Pipeline
-
-1. `validate`: Run the full test suite and `npm run build` via `qk-validation-gate`.
-2. `complete`: Generate the Evolution report.
+---
 
-## 📝 5. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: swallow-errors
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Đã nâng cấp package nào, từ vX lên vY.
-- **Chi tiết (Changes):** Số lượng file phải sửa do Breaking Changes.
-- **Kế hoạch lùi (Reasoning/Risks):** Ghi rõ lệnh Rollback để User copy-paste nếu cần.
-- **Xác thực (Verification):** Kết quả của Build/Test.
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: end-to-end-validation
+```