ai-developer-skill-os 3.1.4 → 5.0.0

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

@@ -1,52 +1,56 @@
 ---
 name: qk-production-release
-version: 3.1.4
-updated: 2026-07-02
-description: Prepare the codebase for a production release (Build, CI/CD, Security).
-category: operations
-behavior: validation
-intent: validate
-priority: high
-tags: [deploy, release, build, production]
+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: 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.4
-updated: 2026-07-02
-description: Initialize a new project with best practices, linters, and folder structures.
+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.4
-updated: 2026-07-02
-description: Comprehensive audit of Code Smells, Tech Debt, and Architecture.
+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.4
-updated: 2026-07-02
-description: Store and retrieve long-term project context across sessions.
+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.4
-updated: 2026-07-02
-description: Safely upgrade dependencies, migrate frameworks, and manage rollbacks.
+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):**
-   - Apply the dependency updates in `package.json`.
-   - Run Codemods (if provided by the library).
-   - Manually fix code affected by Breaking Changes.
-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
+```

package/skills/qk-ui-audit/SKILL.md

@@ -1,66 +1,57 @@
 ---
 name: qk-ui-audit
-version: 3.1.4
-updated: 2026-07-02
-description: Audit UI for Consistency, Accessibility, Responsive, and Performance.
+version: 5.0.0
+updated: 2026-07-03
+description: Kiểm toán giao diện (UI) để đảm bảo tính nhất quán, khả năng truy cập (A11y), độ phản hồi (Responsive) và hiệu suất.
 category: validation
-behavior: static-analysis
-intent: review-code
-priority: medium
 tags: [ui, audit, frontend, a11y, responsive]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to check the UI, review styling, or run an audit on a component.
-inputs: [Target UI component, File path]
-outputs: [UI Audit Score, Fix recommendations]
-allowed_tools: [grep_search, read_file]
-pipeline: [analyze, review, validate, complete]
 ---
 
-# 🛠️ qk-ui-audit - Standard Operating Procedure
+# 🛠️ qk-ui-audit
 
-> **Goal:** Kiểm toán chất lượng Giao diện Người dùng (UI QA). Tìm ra các lỗi hiển thị, sự thiếu đồng nhất và vi phạm Accessibility (a11y).
+> **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 (Scan UI):**
-   - Read the UI component's source code.
-   - Look for inline styles (`style={{...}}`) and hardcoded magic numbers (e.g., `px`, `%` instead of standard tokens).
-2. **Review (Consistency & Responsive):**
-   - Check if standard Design System tokens (e.g., Tailwind classes like `p-4`, `text-lg`) are used.
-   - Check for mobile-first implementation (e.g., base classes for mobile, `md:` for desktop).
-3. **Validate (Accessibility - A11y):**
-   - Verify `<img>` tags have `alt` attributes.
-   - Verify `<button>` tags without text have `aria-label`.
-   - Verify interactive `<div>` elements have `role="button"` and `tabIndex`.
-4. **Complete (Report):**
-   - Calculate a rough score (0-100) based on violations.
+---
 
-## 🛡️ 3. Constraints & Rules
+## 🎯 Mission (Scope)
+- ✅ Audit UI/UX, rà soát Design Tokens, A11y, và Responsive.
+- ❌ Do NOT tự tiện sửa code trừ khi user ra lệnh.
 
-- **Audit Only:** Do not modify the code automatically unless the user explicitly requests you to apply the fixes.
-- **Evidence Based:** Point out the exact line number where the violation occurs.
+---
 
-## 🌳 3. Decision Tree
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-```text
-Does the component contain hardcoded `#hex` colors or `px` values?
-  ├── YES → Deduct Consistency score. Recommend using Design Tokens.
-  └── NO → Pass.
+---
 
-Does the component have clickable `<div>` elements?
-  ├── YES → Deduct A11y score. Recommend using `<button>` or adding roles.
-  └── NO → Pass.
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: aesthetic-vibe
+  - id: strictness
 ```
 
-## 🤝 4. Handoff Pipeline
-
-1. `complete`: Generate the UI Audit Report.
+---
 
-## 📝 5. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: cosmetic-refactor # (Audit format code thay vì audit UX/Tokens)
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Chấm điểm Giao diện (Score: X/100).
-- **Chi tiết (Changes):** Liệt kê các lỗi Consistency, A11y, Responsive (ghi rõ dòng).
-- **Nguyên nhân (Reasoning):** Tại sao lại đánh lỗi điểm đó.
-- **Hành động tiếp (Next Action):** Hỏi User có muốn tự động sửa các lỗi này không.
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: delegation-only # (Chỉ đọc và Report)
+```

package/skills/qk-ui-system-builder/SKILL.md

@@ -1,47 +1,56 @@
 ---
 name: qk-ui-system-builder
-version: 3.1.4
-updated: 2026-07-02
-description: Build and maintain Design Systems, Token extraction, and shared UI libraries.
+version: 5.0.0
+updated: 2026-07-03
+description: Xây dựng và duy trì Design Systems, Token extraction, và các thư viện UI dùng chung.
 category: frontend
-behavior: development
-intent: implement-feature
-priority: medium
 tags: [design-system, tokens, shared-components, storybook]
 platforms: [claude-code, cursor, windsurf, gemini-cli]
-trigger: User asks to create a shared component (Button, Input) or extract a color palette.
-inputs: [UI Requirements]
-outputs: [Shared Components, Design Tokens]
-allowed_tools: [write_to_file, read_file]
-pipeline: [analyze, implement, engineering-standard, validate, complete]
 ---
 
-# 🛠️ qk-ui-system-builder - Standard Operating Procedure
+# 🛠️ qk-ui-system-builder
 
-> **Goal:** Đảm bảo tính Nhất quán Giao diện (Consistency). Quản lý Design Tokens và xây dựng thư viện Shared Components.
+> **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)
+- ✅ Xây dựng Shared Components (Dumb components).
+- ❌ Do NOT nhét logic API hoặc Fetch data vào core component.
 
-1. **Analyze (Token Extraction):**
-   - Extract raw colors and typography into CSS Variables or Tailwind config.
-2. **Implement (Component Factory):**
-   - Build foundational components (`<Button>`, `<TextInput>`) using generic polymorphic props if possible (e.g., `as="a"` or `as="button"`).
-3. **Validate (Story/Documentation):**
-   - Ensure every variation (primary, secondary, disabled) is accounted for.
+---
 
-## 🛡️ 2. Constraints & Rules
+## ⚙️ Capabilities (Cognitive Pipeline)
+```yaml
+Pipeline:
+  - inference
+  - planning
+  - execution
+  - bias-review
+  - ship-check
+```
 
-- **Stateless:** System UI components should NEVER have their own backend logic or hardcoded strings.
-- **Extendable:** Always allow users to pass `className` and `...props` to the base element.
+---
 
-## 🤝 3. Handoff Pipeline
+## 🎛️ Dials (Hành vi)
+```yaml
+Dials:
+  - id: strictness
+```
 
-1. `engineering-standard`: Verify naming conventions.
-2. `complete`: Output the Design System Report.
+---
 
-## 📝 4. Output Format
+## 🛡️ Biases (Sửa lỗi mặc định)
+```yaml
+Biases:
+  - id: missing-ui-states
+```
 
-Vui lòng trả kết quả bằng Tiếng Việt.
+---
 
-- **Tóm tắt (Summary):** Thư viện Component vừa cập nhật.
-- **Chi tiết (Changes):** Liệt kê các variant (màu sắc, kích cỡ).
+## 🛫 Ship Criteria
+```yaml
+Rules:
+  - id: end-to-end-validation
+```