ai-developer-skill-os 7.5.0 → 8.1.4

package/.agents/skills/qk-orchestrator/SKILL.md

@@ -1,11 +1,71 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-orchestrator
-category: core
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Điều hướng yêu cầu của người dùng đến đúng skill với kỷ luật thép — kiểm tra preconditions và routing table."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: orchestrator
+
+intent:
+  - task-routing
+  - skill-selection
+  - precondition-checking
+
+complexity:
+  level: low
+  criteria:
+    files_affected: "1"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "which skill"
+  - "what should i use"
+  - "route this"
+  - "help me choose"
+  - "what skill for"
+  - "help"
+  - "list skills"
+  - "what can you do"
+
+selection:
+  priority: high
+  confidence_threshold: 0.80
+
+# ── V8: References ─────────────────────────────────────────
+workflow: research                  # Uses research workflow to understand request
+
+rules:
+  - global
+
+tools:
+  - filesystem
+
+related_skills:
+  - qk-context-loader
+
+knowledge_scope:
+  owns:
+    - task-routing
+    - skill-selection
+    - precondition-validation
+  references:
+    - all-skills                    # References registry to make decisions
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: low
 latency: fast
 risk: low
@@ -20,19 +80,12 @@ token_budget:
   stop_early: true
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-orchestrator — Request Routing
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
 
 ## Preconditions
 - [ ] User request is provided (any language)
@@ -143,7 +196,7 @@ schema_version: 2
 **Pipeline Rules:**
 ```
 UI tasks:
-  [DESIGN.md check] → [qk-ui-audit (optional)] → [qk-design-to-code | qk-feature-delivery]
+  [DESIGN.md check] → [qk-ui-audit (optional)] → [qk-ui-builder | qk-feature-delivery]
 
 Logic tasks:
   [qk-context-loader] → [qk-feature-delivery | qk-bug-resolution | qk-api-lifecycle]
@@ -167,7 +220,7 @@ Full table: see `references/routing-table.md`
 |----------------|---------------|----------|
 | bug, lỗi, error, broken, crash, fix, sửa | `qk-bug-resolution` | direct |
 | tính năng, feature, thêm, mới, add, implement | `qk-feature-delivery` | context-loader first |
-| UI, giao diện, design, component, layout, màn hình | `qk-design-to-code` | DESIGN.md check |
+| UI, giao diện, design, component, layout, màn hình | `qk-ui-builder` | DESIGN.md check |
 | slow, query, index, N+1, performance DB | `qk-db-optimizer` | context-loader first |
 | deploy, release, production, CI/CD, build | `qk-production-release` | validation-gate first |
 | schema, migration, database, table, model | `qk-data-lifecycle` | context-loader first |
@@ -275,3 +328,4 @@ schema_version: 2
 
 ---
 
+

package/.agents/skills/qk-orchestrator/references/routing-table.md

@@ -10,7 +10,7 @@
 |----------------------------------------|---------------|-------------------|
 | bug, lỗi, error, broken, crash, fix, sửa, không hoạt động | `qk-bug-resolution` | direct |
 | tính năng, feature, thêm, mới, add, implement, xây dựng | `qk-feature-delivery` | `qk-context-loader` first |
-| UI, giao diện, design, component, layout, màn hình, hiển thị | `qk-design-to-code` | DESIGN.md check |
+| UI, giao diện, design, component, layout, màn hình, hiển thị | `qk-ui-builder` | DESIGN.md check |
 | slow, chậm, query, index, N+1, performance DB, tối ưu DB | `qk-db-optimizer` | `qk-context-loader` first |
 | deploy, release, production, CI/CD, build, xuất bản | `qk-production-release` | `qk-validation-gate` first |
 | schema, migration, database, table, model, ORM | `qk-data-lifecycle` | `qk-context-loader` first |
@@ -24,9 +24,9 @@
 | design system, token, CSS variable, design tokens | `qk-ui-system-builder` | DESIGN.md check |
 | project audit, health, tech debt, kiểm toán dự án | `qk-project-health` | direct |
 | new project, bootstrap, init, khởi tạo dự án | `qk-project-bootstrap` | direct |
+| help, list skills, danh sách, trợ giúp | `qk-orchestrator` | direct |
 | memory, context, recall, lưu ngữ cảnh | `qk-project-memory` | direct |
 | security, policy, authorization, bảo mật | `qk-policy-engine` | → redirect to `qk-access-policy` |
-| help, danh sách, list skills, hướng dẫn | `qk-help` | direct |
 | consume API, tích hợp API backend, gọi API từ FE | `qk-fe-api-integration` | `qk-context-loader` first |
 | UI audit, kiểm tra giao diện, anti-slop check | `qk-ui-audit` | DESIGN.md check |
 
@@ -38,7 +38,7 @@
 ```
 1. Check DESIGN.md exists (qk-project-bootstrap if missing)
 2. [Optional] qk-ui-audit — audit existing UI
-3. qk-design-to-code OR qk-feature-delivery (UI part)
+3. qk-ui-builder OR qk-feature-delivery (UI part)
 4. qk-validation-gate — lint + type check
 ```
 
@@ -75,3 +75,4 @@ When 2+ skills match:
 | "refactor" + API | `qk-engineering-standard` if code quality focus, `qk-api-lifecycle` if contract change |
 | "add feature" + DB | Route `qk-feature-delivery` with `qk-data-lifecycle` in pipeline |
 | "optimize" without context | Ask: "DB performance or code quality?" |
+

package/.agents/skills/qk-product-specification/SKILL.md

@@ -0,0 +1,130 @@
+---
+# ── Identity ───────────────────────────────────────────────
+name: qk-product-specification
+version: 8.1.0
+status: experimental
+description: "Product thinking (Idea → Requirement → Acceptance criteria → Technical spec)."
+platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - product-specification
+  - requirement-analysis
+  - acceptance-criteria
+  - technical-spec
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-3"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "viết spec"
+  - "phân tích yêu cầu"
+  - "ý tưởng sản phẩm"
+  - "acceptance criteria"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: spec-driven-development
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+
+related_skills:
+  - qk-feature-delivery
+
+knowledge_scope:
+  domain:
+    - product-requirements
+    - technical-specifications
+  concepts:
+    - user-story
+    - acceptance-criteria
+  references:
+    - architecture
+
+decision_boundary:
+  owns:
+    - technical-ready specification
+    - acceptance criteria
+  does_not_own:
+    - market research
+    - pricing
+    - roadmap
+  conflicts_with: []
+  delegates_to:
+    - qk-feature-delivery
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: feature
+
+lifecycle:
+  promotion_gate:
+    requirements:
+      tests:
+        minimum_pass_rate: 0.95
+      usage:
+        minimum_runs: 20
+      conflicts:
+        zero_boundary_violation: true
+      evidence:
+        required:
+          - evaluation_report
+          - usage_history
+          - boundary_audit
+  demotion_gate:
+    triggers:
+      - repeated_failure
+      - boundary_violation
+      - outdated_reference
+    action:
+      change_status: "stable -> experimental"
+
+selection:
+  priority: medium
+  confidence_threshold: 0.80
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
+cost: medium
+latency: medium
+risk: low
+side_effects: read_only
+produces: [report, specification]
+consumes: [user-description]
+
+token_budget:
+  max_files_read: 3
+  max_lines_per_read: 150
+  max_shell_commands: 0
+  stop_early: false
+
+exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
+---
+
+# qk-product-specification — Product Specifier
+
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
+
+## Preconditions
+- [ ] Tuân thủ workflow `spec-driven-development`.
+
+## Scope
+- Tiếp nhận Idea ban đầu từ user, thực hiện phân tích yêu cầu (Requirement Analysis).
+- Xác định và làm rõ ranh giới của tính năng.
+- Lên danh sách Acceptance Criteria (Tiêu chí nghiệm thu).
+- Đóng gói thành Technical Spec (đặc tả kỹ thuật) để chuẩn bị cho quá trình code (Plan & Implementation).

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

@@ -1,11 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-production-release
-category: devops
-version: 7.5.0
+version: 8.0.0
+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]
-execution_mode: deterministic
 
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - release-management
+  - production-deployment
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "1-5"
+    has_behavior_change: false
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "release production"
+  - "deploy production"
+  - "chuẩn bị release"
+  - "kiểm tra release"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: internal
+
+rules:
+  - global
+  - safety
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-validation-gate
+
+knowledge_scope:
+  owns:
+    - release-checklist
+    - deployment-gate
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: release-safety
+
+selection:
+  priority: high
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
+execution_mode: deterministic
 cost: medium
 latency: slow
 risk: high
@@ -20,9 +76,6 @@ token_budget:
   stop_early: false
 
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-production-release — Release Gate

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

@@ -1,25 +1,85 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-project-bootstrap
-category: fullstack
-version: 7.5.0
+version: 8.0.0
+status: stable
 description: "Khởi tạo dự án mới với cấu trúc chuẩn, linters, DESIGN.md — không bao giờ thiếu foundation."
 platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
+
+# ── V8: Classification ─────────────────────────────────────
+type: capability
+
+intent:
+  - project-initialization
+  - setup
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "10+"
+    has_behavior_change: true
+    has_external_dependency: true
+    has_breaking_change: false
+
+triggers:
+  - "khởi tạo project"
+  - "tạo dự án mới"
+  - "bootstrap"
+  - "setup project"
+  - "init repo"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: feature-delivery
+
+rules:
+  - global
+  - safety
+  - filesystem-boundary
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - project-structure
+    - initial-setup
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: bootstrap-validation
+
+selection:
+  priority: medium
+  confidence_threshold: 0.85
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: high
 latency: slow
 risk: low
-side_effects: edit_files
+side_effects: 
+  - create_files
+  - create_structure
 produces: [code, schema, plan]
 consumes: [user-description]
+
 token_budget:
   max_files_read: 1
   max_lines_per_read: 50
   max_shell_commands: 2
   stop_early: false
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-project-bootstrap — Project Foundation Builder
@@ -224,7 +284,7 @@ Recommended Assumptions (if proceeding):
 ### Produces
 ```json
 {
-  "to": "qk-feature-delivery or qk-design-to-code",
+  "to": "qk-feature-delivery or qk-ui-builder",
   "output_fields": ["project_structure", "design_md_path", "tooling_config", "exit_code"]
 }
 ```
@@ -232,3 +292,4 @@ Recommended Assumptions (if proceeding):
 ---
 
 
+

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

@@ -1,9 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-project-health
-category: qa
-version: 7.5.0
+version: 8.0.0
+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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - project-audit
+  - codebase-health
+
+complexity:
+  level: high
+  criteria:
+    files_affected: "10+"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "audit code"
+  - "check health"
+  - "tech debt"
+  - "code smell"
+  - "kiểm toán"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: code-review
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - tech-debt
+    - codebase-health
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+selection:
+  priority: medium
+  confidence_threshold: 0.75
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: high
 latency: slow
@@ -11,20 +69,19 @@ risk: low
 side_effects: read_only
 produces: [report]
 consumes: [source-code]
+
 token_budget:
   max_files_read: 5
   max_lines_per_read: 100
   max_shell_commands: 1
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-project-health — Complete Codebase Audit
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ---
 

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

@@ -1,9 +1,67 @@
 ---
+# ── Identity ───────────────────────────────────────────────
 name: qk-project-memory
-category: core
-version: 7.5.0
+version: 8.0.0
+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]
+
+# ── V8: Classification ─────────────────────────────────────
+type: utility
+
+intent:
+  - context-management
+  - knowledge-retrieval
+
+complexity:
+  level: medium
+  criteria:
+    files_affected: "1-2"
+    has_behavior_change: false
+    has_external_dependency: false
+    has_breaking_change: false
+
+triggers:
+  - "lưu context"
+  - "nhớ lại"
+  - "project memory"
+  - "lưu vào bộ nhớ"
+  - "tìm lại fact"
+
+# ── V8: References ─────────────────────────────────────────
+workflow: documentation
+
+rules:
+  - global
+  - coding
+
+tools:
+  - filesystem
+  - terminal
+
+related_skills:
+  - qk-engineering-standard
+
+knowledge_scope:
+  owns:
+    - project-facts
+    - verified-context
+  references:
+    - architecture
+
+# ── V8: Verification ───────────────────────────────────────
+verification:
+  required: true
+  strategy: review
+
+selection:
+  priority: medium
+  confidence_threshold: 0.75
+
+examples: []
+learnings: []
+
+# ── V7 Runtime ─────────────────────────────────────────────
 execution_mode: deterministic
 cost: low
 latency: fast
@@ -11,20 +69,19 @@ risk: low
 side_effects: edit_files
 produces: [plan]
 consumes: [source-code, context-graph]
+
 token_budget:
   max_files_read: 2
   max_lines_per_read: 100
   max_shell_commands: 0
   stop_early: true
+
 exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
 ---
 
 # qk-project-memory — Long-Term Context Store
 
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
+> **Language rule:** Code, identifiers, file names → English. Explanations, summaries → Vietnamese.
 
 ---
 
@@ -170,3 +227,49 @@ Recommended Assumptions:
 
 ---
 
+## UI Diversification Memory
+
+### Purpose
+Prevent UI template repetition across project builds. Inspired by Hallmark's `.hallmark/log.json`.
+
+### Storage Path
+```
+.agents/memory/
+├── architecture.json
+├── patterns.json
+├── decisions.json
+├── warnings.json
+└── ui-diversification.json    # NEW: UI build history
+```
+
+### Schema
+```json
+{
+  "id": "ui_[timestamp]",
+  "category": "ui-diversification",
+  "fact": "Built [component] with [theme] theme and [macrostructure] macrostructure",
+  "evidence": "path/to/component.tsx",
+  "confidence": "HIGH",
+  "created_at": "ISO8601",
+  "expires_at": null,
+  "tags": ["theme", "macrostructure", "component"]
+}
+```
+
+### Rule
+**No two consecutive UI builds in the same project may share the same theme + macrostructure combination.**
+
+When `qk-ui-builder` runs:
+1. Read `.agents/memory/ui-diversification.json` (if exists)
+2. Get last entry's theme + macrostructure
+3. Pick different combination for current build
+4. After build, append new entry to `ui-diversification.json`
+
+### Enforcement
+If user requests same theme/macrostructure as last build:
+- Note the conflict in output
+- Recommend alternative
+- Proceed only if user explicitly overrides
+
+---
+