ai-developer-skill-os 7.5.0 → 7.5.1

package/skills.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://ai-developer-skill-os.dev/schema/skills-registry.json",
-    "version": "7.5.0",
+    "version": "7.5.1",
     "name": "AI Developer Skill OS",
     "description": "Enterprise-ready Agentic Framework for AI Coding Agents — Engineering + Frontend + Backend",
     "language": "en",
@@ -15,7 +15,7 @@
         {
             "name": "qk-access-policy",
             "path": "skills/qk-access-policy/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "security",
             "subcategory": "orchestration",
             "behavior": "static-analysis",
@@ -49,7 +49,7 @@
         {
             "name": "qk-ai-builder",
             "path": "skills/qk-ai-builder/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "ai",
             "subcategory": "engineering",
             "behavior": "development",
@@ -83,7 +83,7 @@
         {
             "name": "qk-api-lifecycle",
             "path": "skills/qk-api-lifecycle/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "engineering",
             "subcategory": "backend",
             "behavior": "development",
@@ -117,7 +117,7 @@
         {
             "name": "qk-bug-resolution",
             "path": "skills/qk-bug-resolution/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "engineering",
             "subcategory": "validation",
             "behavior": "development",
@@ -154,7 +154,7 @@
         {
             "name": "qk-context-loader",
             "path": "skills/qk-context-loader/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "utilities",
             "subcategory": "orchestration",
             "behavior": "static-analysis",
@@ -188,7 +188,7 @@
         {
             "name": "qk-data-lifecycle",
             "path": "skills/qk-data-lifecycle/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "database",
             "subcategory": "backend",
             "behavior": "development",
@@ -224,7 +224,7 @@
         {
             "name": "qk-db-optimizer",
             "path": "skills/qk-db-optimizer/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "database",
             "subcategory": "backend",
             "behavior": "development",
@@ -256,9 +256,9 @@
             "description": "Tối ưu hóa Database (đánh Index, xử lý N+1 Queries, Slow Queries)."
         },
         {
-            "name": "qk-design-to-code",
-            "path": "skills/qk-design-to-code/SKILL.md",
-            "version": "7.5.0",
+            "name": "qk-ui-builder",
+            "path": "skills/qk-ui-builder/SKILL.md",
+            "version": "7.5.1",
             "category": "frontend",
             "subcategory": "visual",
             "behavior": "development",
@@ -292,7 +292,7 @@
         {
             "name": "qk-docs",
             "path": "skills/qk-docs/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "documentation",
             "subcategory": "maintenance",
             "behavior": "static-analysis",
@@ -325,7 +325,7 @@
         {
             "name": "qk-engineering-standard",
             "path": "skills/qk-engineering-standard/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "standard",
             "subcategory": "validation",
             "behavior": "static-analysis",
@@ -361,7 +361,7 @@
         {
             "name": "qk-feature-delivery",
             "path": "skills/qk-feature-delivery/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "engineering",
             "subcategory": "fullstack",
             "behavior": "development",
@@ -395,7 +395,7 @@
         {
             "name": "qk-help",
             "path": "skills/qk-help/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "utilities",
             "subcategory": "orchestration",
             "behavior": "static-analysis",
@@ -429,7 +429,7 @@
         {
             "name": "qk-orchestrator",
             "path": "skills/qk-orchestrator/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "orchestration",
             "subcategory": "meta",
             "behavior": "static-analysis",
@@ -464,7 +464,7 @@
         {
             "name": "qk-production-release",
             "path": "skills/qk-production-release/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "operations",
             "subcategory": "devops",
             "behavior": "validation",
@@ -497,7 +497,7 @@
         {
             "name": "qk-project-bootstrap",
             "path": "skills/qk-project-bootstrap/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "setup",
             "subcategory": "engineering",
             "behavior": "development",
@@ -530,7 +530,7 @@
         {
             "name": "qk-project-health",
             "path": "skills/qk-project-health/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "architecture",
             "subcategory": "validation",
             "behavior": "static-analysis",
@@ -564,7 +564,7 @@
         {
             "name": "qk-project-memory",
             "path": "skills/qk-project-memory/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "utilities",
             "subcategory": "maintenance",
             "behavior": "static-analysis",
@@ -596,7 +596,7 @@
         {
             "name": "qk-system-evolution",
             "path": "skills/qk-system-evolution/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "operations",
             "subcategory": "maintenance",
             "behavior": "maintenance",
@@ -629,7 +629,7 @@
         {
             "name": "qk-ui-audit",
             "path": "skills/qk-ui-audit/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "validation",
             "subcategory": "frontend",
             "behavior": "static-analysis",
@@ -664,7 +664,7 @@
         {
             "name": "qk-ui-system-builder",
             "path": "skills/qk-ui-system-builder/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "frontend",
             "subcategory": "design",
             "behavior": "development",
@@ -697,7 +697,7 @@
         {
             "name": "qk-validation-gate",
             "path": "skills/qk-validation-gate/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "validation",
             "subcategory": "quality",
             "behavior": "validation",
@@ -733,7 +733,7 @@
         {
             "name": "qk-fe-api-integration",
             "path": "skills/qk-fe-api-integration/SKILL.md",
-            "version": "7.5.0",
+            "version": "7.5.1",
             "category": "engineering",
             "subcategory": "frontend",
             "behavior": "development",
@@ -783,7 +783,7 @@
             "qk-api-lifecycle",
             "qk-data-lifecycle",
             "qk-db-optimizer",
-            "qk-design-to-code",
+            "qk-ui-builder",
             "qk-feature-delivery",
             "qk-project-bootstrap",
             "qk-ui-system-builder",
@@ -816,4 +816,5 @@
         "readySkills": 23,
         "archivedSkills": 22
     }
-}
+}
+

package/.agents/_template/BEHAVIOR_SPEC.md

@@ -1,96 +0,0 @@
----
-name: qk-[tên-behavior]
-version: 6.0.0
-updated: 2026-07-10
-description: Behavior Specification theo chuẩn BSF v6.0.
----
-
-# 📜 Behavior Specification: [Tên Behavior]
-
-## 1. Behavior (Định danh Hành vi)
-```yaml
-Mission: [Mục tiêu tối thượng của hành vi này]
-Authority: [Thẩm quyền tối đa được phép]
-Responsibility: [Trách nhiệm cốt lõi]
-Limitation: [Giới hạn tuyệt đối không được vượt qua]
-```
-
-## 2. Contracts (Hợp đồng)
-
-### 2.1. Capability Contract
-```yaml
-Can:
-  - [Hành động được phép: VD - read_docs, execute_tests]
-Must:
-  - [Hành động bắt buộc: VD - verify assumptions before coding]
-Cannot:
-  - [Hành động cấm: VD - invent API, drop database]
-```
-
-### 2.2. Output Contract
-```yaml
-Artifacts:
-  - [Artifact 1: VD - plan.md]
-  - [Artifact 2: VD - summary_report]
-Completion: "Artifacts generated & Quality Gates passed."
-```
-
-## 3. Policies (Chính sách)
-
-### 3.1. Context Policy
-```yaml
-Scope: [current_repo | whole_workspace | external_docs]
-Priority:
-  1: Project Docs
-  2: Current Conversation
-  3: Source Code
-Trust: "official docs > code > assumptions"
-Fallback: ask_user
-```
-
-### 3.2. Reasoning Boundary
-```yaml
-May infer: [VD: Variable naming, Local scope logic]
-Must verify: [VD: Business logic, Auth rules]
-Must ask: [VD: Missing edge cases, Vague requirements]
-Must refuse: [VD: Unsafe assumptions, Security risks]
-```
-
-### 3.3. Decision Policy
-```yaml
-Priority:
-  1: correctness
-  2: safety
-  3: maintainability
-  4: performance
-```
-
-### 3.4. Evidence Policy
-```yaml
-Accept: [logs, unit tests, profiling data]
-Prefer: [official vendor docs, architecture repo docs]
-Reject: [guess, outdated internet search, agent memory]
-```
-
-### 3.5. Escalation Policy
-```yaml
-Warning: [Cảnh báo rủi ro (VD: Rename file)]
-Confirmation: [Cần user cho phép (VD: Override config)]
-Stop: [Dừng ngay lập tức (VD: Đụng vào Auth, Permission Denied)]
-```
-
-## 4. Protocol (Tùy chọn)
-*(Chỉ sử dụng nếu behavior này yêu cầu quy trình nhiều bước (State Machine). Xóa phần này nếu không cần thiết).*
-
-```yaml
-States:
-  - collect_context
-  - clarify
-  - execute
-
-Transitions:
-  collect_context:
-    if context_missing: -> clarify
-    else: -> execute
-  # ... (Các rule chuyển trạng thái khác) ...
-```

package/.agents/_template/examples/example-en.md

@@ -1,49 +0,0 @@
----
-# AI Developer Skill OS
-# Example usage file (English)
-# Copy this as a starting point for your skill examples
----
-
-# Example: [Skill Name]
-
-## Input
-
-**User request:**
-```
-[Describe what the user said or asked]
-```
-
-**Project context:**
-- Framework: [React 18 / Next.js 14 / Vue 3 / etc.]
-- Relevant files: `[path/to/file.ts]`
-- Current state: [Brief description]
-
----
-
-## Execution
-
-**Skill activated:** `[skill-name]`
-
-**Phase 1 — Analysis:**
-> [What the AI analyzed]
-
-**Phase 2 — Plan:**
-> [What the AI decided to do]
-
-**Phase 3 — Output:**
-
-```typescript
-// [filename.ts]
-// [Generated or modified code]
-```
-
----
-
-## Result
-
-```
-✅ Summary:    [What was done]
-📁 Files:      [List of files]
-⚠️  Warnings:  [Any notes]
-🔗 Next steps: [Follow-up suggestion]
-```

package/.agents/_template/examples/example-vi.md

@@ -1,49 +0,0 @@
----
-# AI Developer Skill OS
-# File ví dụ sử dụng (Tiếng Việt)
-# Sao chép file này làm điểm khởi đầu cho ví dụ của bạn
----
-
-# Ví dụ: [Tên Skill]
-
-## Input (Đầu vào)
-
-**Yêu cầu của người dùng:**
-```
-[Mô tả người dùng đã nói hoặc yêu cầu gì]
-```
-
-**Bối cảnh dự án:**
-- Framework: [React 18 / Next.js 14 / Vue 3 / v.v.]
-- File liên quan: `[path/to/file.ts]`
-- Trạng thái hiện tại: [Mô tả ngắn]
-
----
-
-## Thực thi
-
-**Skill được kích hoạt:** `[skill-name]`
-
-**Phase 1 — Phân tích:**
-> [AI đã phân tích gì]
-
-**Phase 2 — Kế hoạch:**
-> [AI quyết định làm gì]
-
-**Phase 3 — Kết quả:**
-
-```typescript
-// [filename.ts]
-// [Code được tạo hoặc chỉnh sửa]
-```
-
----
-
-## Kết quả
-
-```
-✅ Tóm tắt:       [Đã làm gì]
-📁 Files:         [Danh sách file]
-⚠️  Lưu ý:        [Ghi chú quan trọng]
-🔗 Bước tiếp theo: [Gợi ý skill hoặc hành động tiếp theo]
-```

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

@@ -1,285 +0,0 @@
----
-name: qk-design-to-code
-category: frontend
-version: 7.5.0
-description: "Chuyển thiết kế Figma/Image thành UI component chuẩn pixel — zero AI-slop, 100% DESIGN.md."
-platforms: [antigravity, claude-code, cursor, windsurf, kilo-code]
-execution_mode: deterministic
-
-cost: high
-latency: slow
-risk: low
-side_effects: edit_files
-produces: [code]
-consumes: [design-md, design-asset]
-
-token_budget:
-  max_files_read: 4
-  max_lines_per_read: 150
-  max_shell_commands: 0
-  stop_early: false
-
-exit_codes: [SUCCESS, BLOCKED, FAILED, PARTIAL]
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-# qk-design-to-code — Pixel-Perfect Builder
-
-> **Language rule:** Code, identifiers, file names ? English. Explanations, summaries ? Vietnamese.
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Preconditions
-- [ ] `DESIGN.md` exists with color tokens, spacing scale, typography
-- [ ] Design reference (Figma link, image, or wireframe description) provided
-
-```
-On missing precondition:
-  EXIT: BLOCKED
-  Message: "DESIGN.md missing or design reference not provided."
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Scope
-- ✅ Build UI from design reference using ONLY DESIGN.md tokens
-- ✅ Include all interactive states: hover, focus, active, disabled, loading
-- ✅ Responsive layouts (mobile + desktop)
-- ✅ Semantic HTML with ARIA roles
-
-## Non-Goals
-- ❌ Invent design tokens not in DESIGN.md
-- ❌ Use hardcoded hex colors, px sizes not from token system
-- ❌ Copy generic Tailwind/Bootstrap templates
-- ❌ Skip loading/error/empty states
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Priority Order
-
-| Priority | Task | Skip Threshold |
-|----------|------|----------------|
-| P1 | HTML structure + semantic markup | Never |
-| P2 | DESIGN.md token application (colors, spacing, typography) | Never |
-| P3 | Interactive states (hover, focus, active) | Budget < 30% |
-| P4 | Responsive breakpoints (mobile) | Budget < 50% |
-| P5 | Loading / error / empty states | Budget < 60% |
-| P6 | Animation / micro-interactions | Budget < 70% |
-| P7 | ARIA roles + keyboard navigation | Budget < 80% |
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Workflow
-
-### Phase 1 — Extract Design System
-
-**Steps:**
-1. Read `DESIGN.md` → extract: colors (HSL), spacing scale, font families, border-radius, shadows, animation timing
-2. Map tokens to CSS variables or framework equivalents
-
-**Decision:**
-```
-IF DESIGN.md has all required tokens
-  → go to Phase 2
-
-ELSE IF some tokens missing
-  → Use reasonable fallback, note gap in output
-  → Confidence: MEDIUM
-
-ELSE IF DESIGN.md empty
-  → EXIT: BLOCKED
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-### Phase 2 — Build Structure
-
-**Steps:**
-1. Create HTML structure (semantic: `article`, `section`, `nav`, `button`, NOT `div` soup)
-2. Apply layout: CSS Grid / Flexbox (NO absolute positioning unless unavoidable)
-3. Apply DESIGN.md tokens for colors, spacing, typography
-
-**Self-Check before next phase:**
-```
-✅ No hardcoded hex/rgb values (only CSS vars or DESIGN.md tokens)
-✅ No magic numbers for spacing (only from scale: 4, 8, 16, 24, 32...)
-✅ Semantic HTML elements used
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-### Phase 3 — Interactive States
-
-**Steps:**
-1. Add hover, focus, active states for all interactive elements
-2. Add disabled state for form elements
-3. Use CSS transitions (duration from DESIGN.md, typically 150–300ms)
-
-**Self-Check:**
-```
-✅ Every button/link has hover + focus state
-✅ Focus visible (not outline: none without replacement)
-✅ Transition duration matches DESIGN.md
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-### Phase 4 — Self-Audit (Anti-Slop Check)
-
-**Checklist (must pass ALL):**
-- [ ] No hardcoded colors — only DESIGN.md tokens
-- [ ] No font-size in px without token — use rem/token
-- [ ] No `margin: auto` soup — use proper grid/flex
-- [ ] All interactive elements have hover + focus state
-- [ ] Mobile viewport works (no horizontal overflow)
-- [ ] No `!important` overrides (except resets)
-- [ ] No inline styles except dynamic values
-- [ ] Loading state implemented (skeleton or spinner)
-- [ ] Error state implemented (clear message)
-- [ ] Empty state implemented (helpful illustration/text)
-
-**Decision:**
-```
-IF all 10 anti-slop checks pass
-  → EXIT: SUCCESS
-
-ELSE IF 1–2 minor fails
-  → Fix immediately, EXIT: SUCCESS
-
-ELSE IF > 2 fails OR hardcoded colors found
-  → Fix all, re-audit, EXIT: PARTIAL if still one gap
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Confidence Model
-
-| Level | Condition | Action |
-|-------|-----------|--------|
-| HIGH | DESIGN.md complete, design reference clear | Build directly |
-| MEDIUM | Some tokens missing, inferring from context | Note gaps, proceed |
-| LOW | Design reference too vague or DESIGN.md empty | EXIT: BLOCKED |
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Evidence Format (Self-Audit Violations)
-
-```
-[SEVERITY] path/to/Component.tsx:LINE
-Category:   [TOKEN|SEMANTIC|INTERACTION|RESPONSIVE|STATE|ARIA]
-Reason:     [specific anti-slop violation]
-Confidence: HIGH
-Fix:        [applied immediately]
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Handoff Contract
-
-### Consumes
-```json
-{
-  "from": "user",
-  "required_fields": ["design_reference", "design_md_path"],
-  "optional_fields": ["component_name", "framework"]
-}
-```
-
-### Produces
-```json
-{
-  "to": "qk-ui-audit (for verification)",
-  "output_fields": ["component_files", "tokens_used", "states_implemented", "exit_code"]
-}
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-## Output Format
-
-```
-🎨 Design → Code
-─────────────────────────────────────────────────
-Component:   [ComponentName]
-Tokens used: [list of DESIGN.md tokens applied]
-
-States implemented:
-  ✅ Default / ✅ Hover / ✅ Focus / ✅ Active
-  ✅ Loading / ✅ Error / ✅ Empty
-  ⚠️ [any state skipped — reason]
-
-Anti-Slop Audit:
-  ✅ [10/10 checks passed | N/10 — list failures]
-
-Exit Code:   [SUCCESS | PARTIAL | BLOCKED | FAILED]
-```
-
-skill_version: 7.5.0
-runtime_version: 1
-schema_version: 2
----
-
-
----
-
-## Escalation Rules
-
-
----
-
-## Severity
-
-
----
-
-## Retry Policy
-
-
----
-## Exit Codes
-
-| Code | Meaning | When |
-|------|---------|------|
-| SUCCESS | Component built, all 10 anti-slop checks passed | Production ready |
-| PARTIAL | Built but 1–2 minor gaps (e.g., animation skipped) | User review recommended |
-| BLOCKED | DESIGN.md or design reference missing | Cannot build |
-| FAILED | Anti-slop audit finds > 2 violations or hardcoded values | Rebuild required |
-
----
-
-