ai-developer-skill-os 2.0.1 → 3.0.0

package/skills/qk-orchestrator/SKILL.md

@@ -1,272 +1,52 @@
----
-name: qk-orchestrator
-purpose: Điều hướng request, phân tích ý đồ và chọn workflow phù hợp nhất.
-mode_supported: [standard]
-input: [User request]
-output: [Workflow được chọn và bàn giao cho skill tương ứng]
-workflow: [1. Nhận lệnh -> 2. Phân tích -> 3. Handoff]
-allowed_tools: [ask_question, run_command]
-handoff_to: [qk-context-loader]
----
-
-# 🛠️ qk-orchestrator - Quy Trình Vận Hành Chuẩn (SOP)
-
-> **Mô tả:** Điều hướng request, phân tích ý đồ và chọn workflow phù hợp nhất.
-
-## 🎯 1. Mục Tiêu (Goal)
-- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
-- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
-
-## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
-*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
-1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
-2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
-3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
-4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
-
-## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
-- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
-- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
-
-## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
-- Đích đến: `qk-context-loader`
-- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.
-
-## 📚 5. Kiến Thức Chuyên Sâu (Deep Knowledge)
-
-*(Nền tảng kiến thức và quy tắc chi tiết kế thừa từ kỹ sư)*
-
----
-
-
-
-# Agent Orchestrator
-
-> **Language rule:**
-> Use English for: code, identifiers, file names, architecture terms, technical decisions.
-> Use the user's language for: explanations, questions, summaries, and feedback.
-> The user may write in any language — detect and match it automatically.
-
-> ⚠️ **CRITICAL CONSTRAINT: This skill MUST NOT write any code.**
-> Its only job is to analyze, plan, and delegate.
-> If the orchestrator starts writing implementation code — it is violating its role.
-> Immediately stop and delegate to the appropriate skill instead.
-
----
-
-## Trigger
-
-Activate this skill when:
-- User describes a task without knowing where to start
-- User request spans multiple concerns (UI + API + state + tests)
-- Request is ambiguous and needs decomposition before action
-- User says: "help me plan", "what should I do first", "how do I approach this"
-
----
-
-## Scope
-
-- ✅ Analyze the user's request
-- ✅ Identify which skills are needed
-- ✅ Define the correct execution order
-- ✅ Create a step-by-step plan
-- ✅ Delegate each step to the correct skill
-- ✅ Track overall progress
-
----
-
-## Non-goals
-
-- ❌ Do NOT write implementation code
-- ❌ Do NOT modify files
-- ❌ Do NOT fix bugs directly (delegate to `bug-fix`)
-- ❌ Do NOT build UI directly (delegate to `ui-builder`)
-- ❌ Do NOT make architectural decisions unilaterally (delegate to `frontend-architecture`)
-
----
-
-## Workflow
-
-### Phase 1 — Request Analysis
-
-Parse the user's request:
-
-1. **What** is being asked? (feature, fix, refactor, review, deploy?)
-2. **Where** does it belong? (frontend, backend, shared, infrastructure?)
-3. **What is the scope?** (single component, full feature, entire codebase?)
-4. **What is unknown?** List any ambiguities that need clarification.
-
-If critical information is missing → ask before planning.
-
----
-
-### Phase 2 — Skill Selection
-
-Map the request to skills from the registry:
-
-| Request type | Recommended skill(s) |
-|---|---|
-| "I don't know what's wrong" | `project-audit` → `bug-fix` |
-| "Build a new page" | `frontend-architecture` → `design-system` → `ui-builder` |
-| "Add API call" | `context-manager` → `api-integration` |
-| "App is slow" | `project-audit` → `frontend-performance` |
-| "Upgrade dependencies" | `migration` |
-| "Write tests" | `frontend-testing` |
-
-Always check dependencies from `skills.json` — load dependent skills first.
-
----
-
-### Phase 3 — Execution Plan
-
-Produce a numbered, ordered plan. Each step maps to one skill.
-
-Format:
-```
-Step 1: [skill-name] — [what it will do]
-Step 2: [skill-name] — [what it will do]
-Step 3: [skill-name] — [what it will do]
-```
-
-Mark dependencies explicitly:
-```
-Step 2 requires Step 1 to complete first.
-```
-
----
-
-### Phase 4 — Delegation
-
-For each step in the plan:
-1. Announce which skill is being activated
-2. Pass relevant context to that skill
-3. Wait for skill output
-4. Confirm completion before moving to next step
-
----
-
-### Phase 5 — Progress Tracking
-
-After each skill completes:
-- Mark step as ✅ done
-- Note any output or blockers
-- Adjust remaining plan if needed
-- Report overall progress to user
-
----
-
-## Decision Tree
-
-```
-Is the request clear enough to plan?
-  ├── No  → Ask 1-3 clarifying questions, then plan
-  └── Yes → Does it span multiple concerns?
-              ├── Yes → Create multi-step plan with skill sequence
-              └── No  → Route directly to single skill
-```
-
-```
-Does a skill dependency exist?
-  ├── Yes → Run dependency skill first
-  └── No  → Run skill directly
-```
-
----
-
-## Output Format
-
-```
-📋 Plan: [Brief description of what we're doing]
-
-Step 1: `[skill-name]` — [Purpose]
-Step 2: `[skill-name]` — [Purpose]  ← requires Step 1
-Step 3: `[skill-name]` — [Purpose]
-
-⏳ Starting with Step 1...
-```
-
-After each step:
-```
-✅ Step 1 complete: [Brief outcome]
-▶️  Moving to Step 2: `[skill-name]`
-```
-
----
-
-## Validation Checklist
-
-Before finishing orchestration:
-
-- [ ] All planned steps completed
-- [ ] Each step was handled by the correct skill
-- [ ] No code was written by the orchestrator itself
-- [ ] User has been informed of final outcome
-- [ ] Next recommended actions provided if relevant
-
----
-
-## Examples
-
-See `examples/` folder.
-
----
-
-
-
-# 📚 Cẩm nang AI Developer Skill OS
-
-> **Nhiệm vụ của bạn (AI):** Khi người dùng gọi lệnh `./qk-help`, hãy xuất ra màn hình (bằng tiếng Việt) danh sách các kỹ năng phân theo nhóm và các Mẹo sử dụng (Pro-tips) dưới đây một cách sinh động, dễ đọc (dùng markdown, in đậm, emoji). Không cần phân tích code, chỉ đóng vai trò là "Sách hướng dẫn sử dụng".
-
----
-
-## 🎯 1. Danh sách Kỹ năng (Skills Directory)
-
-Dưới đây là các kỹ năng chính bạn có thể gọi bằng cách gõ `./qk-[tên-kỹ-năng]`:
-
-### 🎨 Frontend (Giao diện)
-- **`qk-ui-builder`**: Xây dựng UI, Layout, Component, Modal phức tạp.
-- **`qk-table-crud-generator`**: Chuyên vẽ bảng danh sách (Table), phân trang, lọc và form Thêm/Sửa/Xóa.
-- **`qk-form-builder`**: Chuyên làm Form nhập liệu, validate (Zod/Yup).
-- **`qk-component-generator`**: Tạo Component độc lập, tái sử dụng (Button, Input, Card).
-- **`qk-state-management`**: Xử lý Redux, Zustand, React Query.
-- **`qk-frontend-debug`**: Bắt bệnh vỡ layout, infinite re-render, lỗi Hydration.
-- **`qk-frontend-performance`**: Tối ưu tốc độ, chống re-render thừa.
-- **`qk-frontend-architecture`**: Tư vấn kiến trúc thư mục Frontend.
-- **`qk-frontend-testing`**: Viết Unit Test / E2E Test cho Frontend.
-- **`qk-accessibility-audit`**: Sửa lỗi a11y, hỗ trợ Screen reader.
-
-### ⚙️ Engineering & Integration (Tích hợp)
-- **`qk-api-integration`**: [Cực mạnh] Bóc tách tài liệu API (Curl, Postman) -> Gen Type, Service, Hook -> (Tùy chọn) Ốp thẳng vào UI.
-- **`qk-refactor`**: Tối ưu, dọn dẹp mã nguồn sạch sẽ.
-- **`qk-bug-fix`**: Chẩn đoán lỗi sâu và sửa an toàn.
-- **`qk-project-audit`**: Quét toàn bộ dự án tìm nợ kỹ thuật.
-- **`qk-git-engineer`**: Viết Commit / PR chuẩn Conventional.
-- **`qk-migration`**: Nâng cấp version framework / thư viện.
-- **`qk-agent-orchestrator`**: Kiến trúc sư, lên plan phân rã task lớn.
-- **`qk-context-manager`**: Tóm tắt kiến trúc dự án.
-
-### 🗄️ Backend (Máy chủ)
-- **`qk-database-engineer`**: Thiết kế Schema, ORM (Prisma/Drizzle), Migration.
-- **`qk-backend-architecture`**: Setup kiến trúc Backend (Node/Nest/Python).
-- **`qk-auth-security`**: Phân quyền RBAC, JWT, OAuth.
-- **`qk-deployment`**: Viết Dockerfile, CI/CD Pipeline.
-
----
-
-## 💡 2. Mẹo sử dụng Nâng cao (Pro-Tips)
-
-### Mẹo 1: Kết hợp Kỹ năng (Skill Chaining) 🔗
-Đừng bắt AI làm từ A-Z bằng 1 câu prompt. Hãy gọi liên hoàn:
-> *"Hãy dùng `./qk-api-integration` để bóc tách API này thành hook React Query. Sau đó dùng `./qk-table-crud-generator` vẽ cái Bảng hiển thị danh sách tích hợp hook đó."*
-
-### Mẹo 2: Chế độ "Một phát ăn ngay" (End-to-End) 🚀
-Nếu bạn đã có sẵn 1 màn hình UI (chỉ thiếu data), hãy ép `qk-api-integration` làm End-to-End:
-> *"./qk-api-integration Dưới đây là API Get Profile. Hãy khai báo Type, viết Hook và TÍCH HỢP THẲNG LUÔN vào file \`Profile.tsx\` đang mở."*
-
-### Mẹo 3: Truyền tham số ép buộc (Arguments) 🎯
-Bạn có thể ép AI dùng công nghệ bạn muốn bằng cách thêm \`--tham_số\`:
-> *"./qk-ui-builder --fw=react --css=tailwind Hãy vẽ màn hình Đăng nhập."*
-
-### Mẹo 4: Nhờ "Kiến trúc sư" phân việc 🧠
-Nếu bạn có một tính năng quá lớn (ví dụ: Làm tính năng Giỏ Hàng), đừng tự chia việc, hãy gọi:
-> *"./qk-agent-orchestrator Tôi muốn làm tính năng Giỏ hàng. Hãy phân tích và lên kế hoạch gọi các skill \`qk-\` nào cho phù hợp."*
+---
+name: qk-orchestrator
+version: 3.0.0
+updated: 2026-07-02
+description: Route user requests, parse intents, and delegate to the correct sub-skills.
+category: orchestration
+priority: critical
+tags: [router, orchestrator, delegation, ai-manager]
+platforms: [claude-code, cursor, windsurf, gemini-cli]
+trigger: Triggered initially when the user provides a vague or complex multi-step request.
+inputs: [User intent, Raw Context]
+outputs: [Workflow routing, Sub-skill delegation]
+allowed_tools: [grep_search, read_file]
+pipeline: [analyze, plan, delegate]
+---
+
+# 🛠️ qk-orchestrator - Standard Operating Procedure
+
+> **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):**
+   - Determine which specific files are needed.
+   - Select the most appropriate Skill (e.g., `qk-feature-delivery` for new UI, `qk-bug-resolution` for fixing errors).
+3. **Delegate (Handoff):**
+   - 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:
+  │       1. `qk-project-bootstrap` (Setup)
+  │       2. `qk-data-lifecycle` (DB Schema)
+  │       3. `qk-api-lifecycle` (Endpoints)
+  │       4. `qk-feature-delivery` (UI).
+  └── NO → Delegate to the single most appropriate skill.
+```
+
+## 🤝 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,33 +1,52 @@
----
-name: qk-policy-engine
-purpose: Động cơ xét duyệt chính sách, đảm bảo tác vụ hợp lệ trước khi thực thi.
-mode_supported: [enterprise]
-input: [Task request]
-output: [Policy validation result]
-workflow: [1. Đọc chính sách -> 2. Đối chiếu request -> 3. Phê duyệt/Từ chối]
-allowed_tools: [read_file]
-handoff_to: [qk-access-policy]
----
-
-# 🛠️ qk-policy-engine - Quy Trình Vận Hành Chuẩn (SOP)
-
-> **Mô tả:** Động cơ xét duyệt chính sách, đảm bảo tác vụ hợp lệ trước khi thực thi.
-
-## 🎯 1. Mục Tiêu (Goal)
-- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
-- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
-
-## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
-*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
-1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
-2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
-3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
-4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
-
-## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
-- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
-- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
-
-## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
-- Đích đến: `qk-access-policy`
-- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.
+---
+name: qk-policy-engine
+version: 3.0.0
+updated: 2026-07-02
+description: Policy evaluation engine to ensure actions are authorized and safe.
+category: security
+priority: high
+tags: [security, policy, guardrails, authorization]
+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
+
+> **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`.
+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.
+
+## 🛡️ 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?
+  │       ├── YES → Approve.
+  │       └── NO → DENY and request backup confirmation.
+  └── NO → Approve.
+```
+
+## 🤝 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).
+- **Hành động tiếp (Next Action):** ...

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

@@ -1,127 +1,45 @@
----
-name: qk-production-release
-purpose: Build, CI/CD, Deploy, Observability, Security Release.
-mode_supported: [enterprise]
-input: [Release candidate]
-output: [Production deployment]
-workflow: [1. Build -> 2. CI -> 3. Deploy -> 4. Observe -> 5. Security Audit]
-allowed_tools: [run_command]
-handoff_to: [none]
----
-
-# 🛠️ qk-production-release - Quy Trình Vận Hành Chuẩn (SOP)
-
-> **Mô tả:** Build, CI/CD, Deploy, Observability, Security Release.
-
-## 🎯 1. Mục Tiêu (Goal)
-- Hoàn thành thành công tác vụ được giao liên quan đến nhiệm vụ của skill.
-- Đảm bảo chất lượng mã nguồn và tính nhất quán của hệ thống.
-
-## 🔄 2. Chuỗi Hành Động (Chain of Thought / SOP)
-*(Bắt buộc AI phải suy nghĩ và làm theo đúng thứ tự)*
-1. **Phân tích (Analyze):** Thu thập ngữ cảnh và hiểu rõ yêu cầu đầu vào.
-2. **Lên kế hoạch (Plan):** Xác định các bước cần thay đổi/tạo mới dựa trên bộ luật (rules).
-3. **Thực thi (Execute):** Tiến hành sửa đổi mã nguồn hoặc tạo tài liệu.
-4. **Xác thực (Verify):** Đảm bảo đầu ra đáp ứng đúng yêu cầu và không vi phạm quy định.
-
-## 🛡️ 3. Ràng Buộc & Quy Tắc (Constraints)
-- CẤM bỏ qua việc kiểm tra `qk-engineering-standard` trước khi viết code.
-- Mọi quyết định kỹ thuật phải dựa trên nội dung tại phần Deep Knowledge (nếu có).
-
-## 🤝 4. Giao Thức Bàn Giao (Handoff Protocol)
-- Đích đến: `none`
-- Nội dung bàn giao: Chuyển toàn bộ ngữ cảnh và kết quả đã thực thi cho bước tiếp theo.
-
-## 📚 5. Kiến Thức Chuyên Sâu (Deep Knowledge)
-
-*(Nền tảng kiến thức và quy tắc chi tiết kế thừa từ kỹ sư)*
-
----
-
-
-
-# Deployment & DevOps
-
-> **Language rule:**
-> Use English for: code, identifiers, file names, architecture terms, technical decisions.
-> Use the user's language for: explanations, questions, summaries, and feedback.
-> The user may write in any language — detect and match it automatically.
-
----
-
-## Trigger
-
-Activate this skill when:
-- User asks "how do I deploy this?", "create a Dockerfile", or "setup CI/CD"
-- Configuring GitHub Actions, GitLab CI, or Jenkins
-- Preparing a project for Vercel, Netlify, Render, or AWS
-- Setting up environment variables for production
-
----
-
-## Scope
-
-- ✅ **Containerization:** Write `Dockerfile` and `docker-compose.yml`.
-- ✅ **CI/CD Pipelines:** Write GitHub Actions YAML for testing, building, and deploying.
-- ✅ **Environment Setup:** Create `.env.example` and document required production variables.
-- ✅ **Build Scripts:** Ensure `package.json` has correct build and start commands.
-
----
-
-## Non-goals
-
-- ❌ Do NOT expose real production secrets. Always use placeholders or CI secrets.
-- ❌ Do NOT over-complicate (e.g., don't setup Kubernetes if a simple Docker container on a VPS is enough).
-
----
-
-## Workflow
-
-### Phase 1 — Platform Selection
-
-Ask the user where they are deploying (if not specified):
-1. **PaaS (Vercel, Render, Heroku):** Very easy, mostly relies on `vercel.json` or standard build scripts. No Docker needed usually.
-2. **VPS/VM (DigitalOcean, AWS EC2):** Needs Docker and/or PM2 + Nginx reverse proxy.
-3. **Container Service (AWS ECS, Google Cloud Run):** Needs a highly optimized Dockerfile.
-
-### Phase 2 — Containerization (If required)
-
-Create a multi-stage Dockerfile for minimal image size:
-1. `deps` stage: Install dependencies.
-2. `builder` stage: Build the app.
-3. `runner` stage: Copy only the built assets and prod modules, start the app.
-
-### Phase 3 — CI/CD Pipeline
-
-Create `.github/workflows/deploy.yml`:
-- Trigger on `push` to `main`.
-- Job 1: Setup Node/Python/Go, install deps, run tests, run linter.
-- Job 2: Build image and push to registry, or deploy to PaaS.
-
-### Phase 4 — Environment Variables
-
-Audit the codebase for `process.env.XYZ` and create a `.env.example` file listing every required variable.
-
----
-
-## Output Format
-
-```
-🚀 Deployment Plan
-─────────────────────────────────────────────────
-Target:     [Vercel / Docker VPS / AWS]
-Tooling:    [GitHub Actions, Docker]
-
-Files Created/Modified:
-  ✅ `Dockerfile` (Multi-stage build)
-  ✅ `.github/workflows/deploy.yml`
-  ✅ `.env.example`
-
-⚠️ Prerequisites:
-  Before deploying, you must set these secrets in GitHub Actions:
-  - `DOCKER_USERNAME`
-  - `DATABASE_URL`
-
-🔗 Next Steps:
-  Commit these files and push to `main` to trigger the pipeline.
-```
+---
+name: qk-production-release
+version: 3.0.0
+updated: 2026-07-02
+description: Prepare the codebase for a production release (Build, CI/CD, Security).
+category: operations
+priority: high
+tags: [deploy, release, build, production]
+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
+
+> **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.
+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.
+
+## 🛡️ 2. 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.
+- **Hành động tiếp (Next Action):** Checklist để user tự Deploy.