ai-developer-skill-os 3.1.0 → 3.1.1

package/skills/qk-context-loader/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-context-loader
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Load relevant files and map the dependency graph for a task.
 category: utilities
+behavior: static-analysis
+intent: review-code
 priority: medium
 tags: [context, filesystem, dependencies, graph]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, implement, complete]
 > **Goal:** "Người thu thập tình báo". Đảm bảo AI hiểu rõ môi trường xung quanh một file code trước khi tiến hành sửa nó, tránh lỗi thiếu context.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Target Identification):**
    - Identify the main file that needs modification.
 2. **Implement (Graph Traversal):**
@@ -29,9 +32,11 @@ pipeline: [analyze, implement, complete]
    - Build a mental map of how the data flows.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **Token Optimization:** Do not load `node_modules` or massive minified build files. Extract only the exact logic needed.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Is the target file a UI Component?
   ├── YES → Load its CSS/Theme tokens and any nested Child components.
@@ -39,9 +44,12 @@ Is the target file a UI Component?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `complete`: Provide the context map to the Orchestrator or Target Skill.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Đã nạp thành công ngữ cảnh.
 - **Chi tiết (Changes):** Các file có liên quan trực tiếp.

package/skills/qk-data-lifecycle/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-data-lifecycle
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Manage Database Schema, Migrations, and Repositories.
 category: database
+behavior: development
+intent: implement-feature
 priority: medium
 tags: [database, sql, migration, schema, orm]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, design, implement, engineering-standard, validate, complete]
 > **Goal:** Quản lý an toàn vòng đời dữ liệu, đảm bảo Schema chuẩn xác, Migration có thể Rollback và Query tối ưu.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Requirements):**
    - Understand the entities and their relationships (1:1, 1:N, N:N).
    - Identify the ORM/Query Builder used in the project (e.g., Prisma, TypeORM, Drizzle).
@@ -33,11 +36,13 @@ pipeline: [analyze, design, implement, engineering-standard, validate, complete]
    - Review the migration script for destructive operations (e.g., `DROP TABLE`, `DROP COLUMN`).
 
 ## 🛡️ 2. Constraints & Rules
+
 - **No Data Loss:** NEVER execute a migration that drops data on Production without explicit User approval and a backup plan.
 - **Decoupling:** Do not write SQL queries directly in Controllers. Always use the Repository or DAO pattern.
 - **Index Rule:** Any column used in a `WHERE`, `JOIN`, or `ORDER BY` clause should be evaluated for an index.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Is this modifying an existing table in Production?
   ├── YES → Does it drop a column or change a data type destructively?
@@ -47,12 +52,15 @@ Is this modifying an existing table in Production?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `engineering-standard`: Verify naming conventions (e.g., snake_case for DB columns if required).
 2. `validate`: Run dry-run migrations or unit tests.
 3. `complete`: Generate the Database report.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Bảng nào được tạo/sửa.
 - **Chi tiết (Changes):** File migration và Model đã sinh ra.
 - **Kiến trúc (Reasoning):** Lý do thiết kế quan hệ bảng và các Index.

package/skills/qk-design-to-code/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-design-to-code
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Convert Figma/Images to semantic, pixel-perfect code components.
 category: frontend
+behavior: development
+intent: implement-feature
 priority: high
 tags: [ui, figma, frontend, styling, css]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 > **Goal:** Dịch thiết kế (Mockups/Images) thành mã nguồn (React, Vue, HTML/CSS) với độ chính xác Pixel-Perfect.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Deconstruct Design):**
    - Look at the provided mockup.
    - Break it down from Outside-In (Container -> Rows -> Columns -> Elements).
@@ -31,16 +34,20 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
    - Ensure the component uses relative units where necessary and scales on mobile.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **No Magic Values:** Do not use random hex codes or pixel values if a Design System is available.
 - **Accessibility:** Always include `alt` for images and `aria-label` for icon-only buttons.
 
 ## 🤝 3. Handoff Pipeline
+
 1. `engineering-standard`: Ensure the UI component has no business logic.
 2. `validate`: Trigger `qk-ui-audit` checks.
 3. `complete`: Generate the UI Component Report.
 
 ## 📝 4. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Tên Component vừa tạo.
 - **Chi tiết (Changes):** File chứa component.
 - **Rủi ro (Risks):** Vấn đề responsive nếu có.

package/skills/qk-docs/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-docs
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Write and maintain human-readable project documentation.
 category: documentation
+behavior: static-analysis
+intent: maintain
 priority: low
 tags: [docs, markdown, jsdoc, readme]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, implement, validate, complete]
 > **Goal:** Đóng vai trò là "Technical Writer". Viết tài liệu (README, API Docs, Code Comments) rõ ràng, dễ hiểu cho con người.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Context Extraction):**
    - Read the target source code to understand its Inputs, Outputs, and side effects.
 2. **Implement (Drafting):**
@@ -30,10 +33,12 @@ pipeline: [analyze, implement, validate, complete]
    - Ensure proper Markdown syntax (bolding, code blocks with languages).
 
 ## 🛡️ 2. Constraints & Rules
+
 - **Human Friendly:** Avoid overly academic language. Explain it as if explaining to a junior developer.
 - **Language Hybrid:** If writing Vietnamese documentation, keep technical keywords (props, state, endpoint, fetch) in English.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Is this an API Documentation?
   ├── YES → Use standard REST/GraphQL documentation layout (Endpoint, Method, Body, Response).
@@ -43,10 +48,13 @@ Is this an API Documentation?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `complete`: Generate the Docs and save them to the project files.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Tài liệu nào đã được tạo/cập nhật.
 - **Chi tiết (Changes):** Cấu trúc tài liệu.
 - **Xác thực (Verification):** Yêu cầu User đọc lướt qua tài liệu.

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

@@ -1,9 +1,11 @@
 ---
 name: qk-documentation-system
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Maintain system-level architecture docs and DevOps runbooks.
 category: documentation
+behavior: static-analysis
+intent: maintain
 priority: low
 tags: [architecture, diagrams, mermaid, runbooks]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, design, implement, complete]
 > **Goal:** Quản lý tài liệu cấp hệ thống (System Architecture, Sequence Diagrams, Runbooks).
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (System Flow):**
    - Understand the flow of data across microservices or complex components.
 2. **Design (Diagramming):**
@@ -27,12 +30,16 @@ pipeline: [analyze, design, implement, complete]
    - Save the documentation into the `/docs/` folder.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **Syntax Check:** Ensure Mermaid diagrams are syntactically valid before saving.
 
 ## 🤝 3. Handoff Pipeline
+
 1. `complete`: Output the System Documentation Report.
 
 ## 📝 4. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Tài liệu kiến trúc nào đã được tạo.
 - **Chi tiết (Changes):** Đường dẫn file.

package/skills/qk-engineering-standard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qk-engineering-standard
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Enforce SOLID, DRY, Clean Code, and Naming conventions.
 category: standard
@@ -21,6 +21,7 @@ pipeline: [analyze, review, implement, validate, complete]
 > **Goal:** Đóng vai trò là "Kiến trúc sư trưởng", rà soát và ép buộc mã nguồn phải tuân thủ chuẩn mực Clean Code, dễ đọc và dễ bảo trì.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Context Review):**
    - Scan the target file(s) and determine their role (UI, Logic, API, Config).
 2. **Review (Smell Detection):**
@@ -35,11 +36,13 @@ pipeline: [analyze, review, implement, validate, complete]
    - Ensure the refactoring did NOT change the business logic or behavior of the app (Regression check).
 
 ## 🛡️ 3. Constraints & Rules
+
 - **Code is for Humans:** Write code that junior developers can easily understand. Avoid overly clever or obscure syntax.
 - **Scope Limit:** Do NOT refactor the entire project if the user only asked to review one file. Limit the scope to the current task context.
 - **Preserve Behavior:** Refactoring must strictly preserve backward compatibility.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Is the file larger than 300 lines?
   ├── YES → Propose splitting the file into sub-components or moving logic to hooks.
@@ -51,11 +54,14 @@ Does the React Component contain `fetch()` or heavy data mapping?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `validate`: Run static analysis (Linters, TypeScript compiler) to ensure the refactored code has no syntax errors.
 2. `complete`: Generate the review report.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt. Cấu trúc báo cáo bao gồm:
+
 - **Tóm tắt (Summary):** File nào vừa được Refactor / Review.
 - **Chi tiết (Changes):** Các thay đổi cụ thể về Tên biến, Cấu trúc.
 - **Nguyên nhân (Reasoning):** Giải thích tại sao code cũ là "Bad Practice" và code mới tốt hơn thế nào.

package/skills/qk-feature-delivery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qk-feature-delivery
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Develop new features end-to-end (Frontend & Backend).
 category: engineering
@@ -21,6 +21,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 > **Goal:** Phát triển một tính năng mới hoàn chỉnh, từ giao diện (Frontend) đến API (Backend) và Cơ sở dữ liệu (nếu có).
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Requirements Gathering):**
    - Read the user's requirements.
    - Break down the feature into sub-tasks (e.g., Schema -> API -> UI Component -> Integration).
@@ -35,11 +36,13 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
    - Ensure the API handles edge cases (empty states, loading, error).
 
 ## 🛡️ 3. Constraints & Rules
+
 - **Contract First:** Always define the Type/Interface contract before writing the implementation logic.
 - **Component Reusability:** Do not create a new Button or Input if a Shared Component already exists in `src/components/shared/`.
 - **DRY (Don't Repeat Yourself):** Extract inline styles or duplicate logic into hooks/utilities.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Does the feature require Backend API changes?
   ├── YES → Start with Database Schema/Types -> API Route -> UI Integration.
@@ -49,14 +52,19 @@ Does the feature require Backend API changes?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 After implementing the feature, map to the pipeline:
+
 1. `engineering-standard`: Ensure naming conventions and file size limits are respected.
 2. `validate`: Run tests and format the code.
 3. `complete`: Output the final report.
 
 ## 📝 5. Output Format
+
 Vui lòng báo cáo lại bằng Tiếng Việt với cấu trúc tương tự `templates/bug-report.md` nhưng thay đổi tiêu đề thành:
+
 ### 🚀 Báo Cáo Triển Khai Tính Năng (Feature Report)
+
 - **Tóm tắt (Summary):** Tính năng gì đã được làm.
 - **Chi tiết (Changes):** Liệt kê các file tạo mới / chỉnh sửa.
 - **Kiến trúc (Reasoning):** Giải thích quyết định thiết kế State/API.

package/skills/qk-help/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-help
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Display the list of available skills and pro-tips.
 category: utilities
+behavior: static-analysis
+intent: review-code
 priority: low
 tags: [help, manual, list, tutorial]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,19 +21,24 @@ pipeline: [analyze, complete]
 > **Goal:** Bản đồ hướng dẫn sử dụng Agent Skills. Giúp User tra cứu nhanh lệnh.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Scan):**
    - Read the skills directory to list all available tools.
 2. **Complete (Format):**
    - Format the skills into a neat Markdown table.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **Keep it short:** Do not print the entire content of `SKILL.md`. Only print the Name and Description from the metadata.
 
 ## 🤝 3. Handoff Pipeline
+
 1. `complete`: Output the Help table.
 
 ## 📝 4. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt dạng Bảng (Table).
+
 - **Cột 1:** Tên Skill
 - **Cột 2:** Mô tả ngắn (Tiếng Việt)
 - **Cột 3:** Lệnh kích hoạt (Ví dụ: `@qk-bug-resolution`)

package/skills/qk-orchestrator/SKILL.md

@@ -1,9 +1,11 @@
 ---
 name: qk-orchestrator
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Route user requests, parse intents, and delegate to the correct sub-skills.
 category: orchestration
+behavior: static-analysis
+intent: review-code
 priority: critical
 tags: [router, orchestrator, delegation, ai-manager]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, plan, delegate]
 > **Goal:** "Tổng tư lệnh" (Master Orchestrator). Phân tích ý đồ của người dùng và điều phối các kỹ năng (Skills) khác để giải quyết vấn đề thay vì làm mọi thứ một cách thủ công.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Intent Parsing):**
    - Read the user's request. Determine the goal: Is it a Bug Fix, a New Feature, a Refactor, or just a Question?
 2. **Plan (Context Gathering & Skill Selection):**
@@ -28,10 +31,12 @@ pipeline: [analyze, plan, delegate]
    - Handoff the gathered context to the selected Skill.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **Delegation First:** Do not write source code directly while acting as the Orchestrator. Delegate to the correct specialized Skill.
 - **Ambiguity Check:** If the user's intent is unclear, give them 2-3 Skill suggestions to choose from.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Is the task a massive project (e.g., "Build an Admin Dashboard")?
   ├── YES → Break it down:
@@ -43,10 +48,13 @@ Is the task a massive project (e.g., "Build an Admin Dashboard")?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `delegate`: Call the target Skill.
 
 ## 📝 5. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Đã phân tích xong yêu cầu của User.
 - **Quyết định điều phối (Reasoning):** Giao việc cho Skill nào.
 - **Hành động tiếp (Next Action):** Tự động chuyển vai trò sang Skill được chọn.

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

@@ -1,9 +1,11 @@
 ---
 name: qk-policy-engine
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Policy evaluation engine to ensure actions are authorized and safe.
 category: security
+behavior: static-analysis
+intent: review-code
 priority: high
 tags: [security, policy, guardrails, authorization]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, evaluate, complete]
 > **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.
 
 ## 🔄 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`.
@@ -29,10 +32,12 @@ pipeline: [analyze, evaluate, complete]
    - Approve (Allow execution) or Deny (Block execution) with explicit reasons.
 
 ## 🛡️ 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.
 
 ## 🌳 3. Decision Tree
+
 ```text
 Does the action involve deleting data or resources in Production?
   ├── YES → Has the user provided a backup confirmation?
@@ -42,10 +47,13 @@ Does the action involve deleting data or resources in Production?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `complete`: Generate the Policy Decision Report.
 
 ## 📝 5. Output Format
+
 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).

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

@@ -1,6 +1,6 @@
 ---
 name: qk-production-release
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Prepare the codebase for a production release (Build, CI/CD, Security).
 category: operations
@@ -21,6 +21,7 @@ pipeline: [analyze, review, implement, validate, complete]
 > **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).
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Pre-flight Checks):**
    - Check if the git branch is clean.
    - Verify environment variables are documented.
@@ -32,15 +33,19 @@ pipeline: [analyze, review, implement, validate, complete]
    - Provide a manual checklist for the user to execute the final deployment.
 
 ## 🛡️ 3. Constraints & Rules
+
 - **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
+
 1. `validate`: Run security sweep on the build output.
 2. `complete`: Output the Release Report.
 
 ## 📝 4. Output Format
+
 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.

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

@@ -1,9 +1,11 @@
 ---
 name: qk-project-bootstrap
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Initialize a new project with best practices, linters, and folder structures.
 category: setup
+behavior: development
+intent: implement-feature
 priority: high
 tags: [bootstrap, scaffolding, setup, init]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,6 +21,7 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
 > **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.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 1. **Analyze (Requirements):**
    - Ask the user for their preferred stack (e.g., Next.js, Vite, NestJS).
 2. **Implement (Scaffolding):**
@@ -29,15 +32,19 @@ pipeline: [analyze, implement, engineering-standard, validate, complete]
    - Run `npm run dev` in a short background task to ensure it doesn't crash.
 
 ## 🛡️ 2. Constraints & Rules
+
 - **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
+
 1. `engineering-standard`: Verify the generated folder structure.
 2. `complete`: Output the Bootstrap Report.
 
 ## 📝 4. Output Format
+
 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.

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

@@ -1,6 +1,6 @@
 ---
 name: qk-project-health
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Comprehensive audit of Code Smells, Tech Debt, and Architecture.
 category: architecture
@@ -21,6 +21,7 @@ pipeline: [analyze, review, validate, complete]
 > **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.
 
 ## 🔄 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):**
@@ -33,10 +34,12 @@ pipeline: [analyze, review, validate, complete]
    - Generate a prioritized Refactor Roadmap (High, Medium, Low).
 
 ## 🛡️ 3. Constraints & Rules
+
 - **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
+
 ```text
 Is the `src/components` folder bloated (>30 files)?
   ├── YES → Recommend migrating to a Feature-driven structure (e.g., `src/features/auth`).
@@ -48,10 +51,13 @@ Are there components exceeding 500 lines?
 ```
 
 ## 🤝 4. Handoff Pipeline
+
 1. `complete`: Output the Health Audit Report.
 
 ## 📝 5. Output Format
+
 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).

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

@@ -1,9 +1,11 @@
 ---
 name: qk-project-memory
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Store and retrieve long-term project context across sessions.
 category: utilities
+behavior: static-analysis
+intent: maintain
 priority: low
 tags: [memory, context, storage]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
@@ -19,17 +21,22 @@ pipeline: [analyze, implement, complete]
 > **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.
 
 ## 🔄 1. Chain of Thought (SOP)
+
 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
+
 - **Keep it small:** Do not write entire source files into memory. Only save abstract facts and rules.
 
 ## 🤝 3. Handoff Pipeline
+
 1. `complete`: Output confirmation.
 
 ## 📝 4. Output Format
+
 Vui lòng trả kết quả bằng Tiếng Việt.
+
 - **Tóm tắt (Summary):** Đã ghi nhớ thông tin gì.

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

@@ -1,6 +1,6 @@
 ---
 name: qk-system-evolution
-version: 3.0.0
+version: 3.1.0
 updated: 2026-07-02
 description: Safely upgrade dependencies, migrate frameworks, and manage rollbacks.
 category: operations
@@ -21,6 +21,7 @@ pipeline: [analyze, plan, implement, validate, complete]
 > **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ố.
 
 ## 🔄 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.
@@ -36,11 +37,13 @@ pipeline: [analyze, plan, implement, validate, complete]
    - Run the build process to ensure the system compiles.
 
 ## 🛡️ 3. Constraints & Rules
+
 - **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
+
 ```text
 Are there Breaking Changes in the target version?
   ├── YES → Create a migration checklist based on the official docs. Update code systematically.
@@ -54,11 +57,14 @@ Did the Build fail after the update?
 ```
 
 ## 🤝 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
+
 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.