ai-developer-skill-os 7.5.0 → 7.5.1

package/.agents/CHANGELOG.md

@@ -14,7 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed (The "Anti-Slop & Zero-Trust" Architecture Upgrade)
 - **Zero-Trust Logic**: Core logic skills (`qk-context-loader`, `qk-orchestrator`, `qk-feature-delivery`) now mandate a Topological Context Graph prior to any code generation.
-- **Strict Design Contract**: Frontend skills (`qk-ui-system-builder`, `qk-design-to-code`, `qk-ui-audit`) now explicitly reject generic styling (slop) and enforce strict token matching against a mandated `DESIGN.md`.
+- **Strict Design Contract**: Frontend skills (`qk-ui-system-builder`, `qk-ui-builder`, `qk-ui-audit`) now explicitly reject generic styling (slop) and enforce strict token matching against a mandated `DESIGN.md`.
 - **Repair Loop Enforcement**: `qk-bug-resolution` updated to strictly prohibit jumping to fixes without explicitly establishing an `Observe -> Hypothesis -> Evidence` chain.
 - **Contract-First APIs**: `qk-api-lifecycle` now requires explicit OpenAPI/Swagger definitions prior to endpoint implementation.
 - **Upgraded Testing Framework**: Fixed regex and validation logic in `behavior-conformance.test.js` to rigorously support YAML array strings and precise V7 markdown constraints. All 22 skills bumped to `v7.0.0`.
@@ -67,3 +67,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added detailed user documentation in `docs/HUONG_DAN_SU_DUNG.md` and `docs/CHI_TIET_SKILLS.md`.
 - Translated all skill frontmatter descriptions to Vietnamese for better UX in agent terminals.
 - Included generic English and Vietnamese usage examples in `_template/examples/`.
+

package/.agents/README.md

@@ -1,6 +1,6 @@
-# 🚀 AI Developer Skill OS (ai-developer-skill-os) v7.0.0
+# 🚀 AI Developer Skill OS (ai-developer-skill-os) v7.5.0
 
-> **V7.0.0 "Anti-Slop & Zero-Trust Architecture"**
+> **V7.5.0 "Anti-Slop & Zero-Trust Architecture"**
 
 Hệ sinh thái AI Developer Skill OS đã được tái cấu trúc hoàn toàn. Thay vì cung cấp các "công cụ rời rạc" (Toolbox), phiên bản V7 được thiết kế như một **Hệ điều hành khép kín, hoạt động theo kỷ luật của một Kiến trúc sư Hệ thống (50 năm kinh nghiệm)**.
 
@@ -21,31 +21,71 @@ Bảo vệ mã nguồn khỏi thói quen "sửa vội" của AI. Lỗi bắt bu
 
 ---
 
-## 🧩 Danh sách 23 Master Skills
+## 🧩 Danh sách 22 Master Skills
 
 Các kỹ năng được quản lý cực kỳ chặt chẽ với bài kiểm tra tự động (Vitest) để đảm bảo tính nhất quán của luật lệ:
-- **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-policy-engine`, `qk-access-policy`
-- **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-fe-api-integration`, `qk-data-lifecycle`, `qk-design-to-code`, `qk-ui-system-builder`
+- **Orchestration:** `qk-orchestrator`, `qk-context-loader`, `qk-access-policy`
+- **Engineering / Dev:** `qk-feature-delivery`, `qk-api-lifecycle`, `qk-fe-api-integration`, `qk-data-lifecycle`, `qk-ui-builder`, `qk-ui-system-builder`
 - **Validation & Standards:** `qk-validation-gate`, `qk-engineering-standard`, `qk-ui-audit`, `qk-project-health`, `qk-bug-resolution`
 - **Ops & AI:** `qk-system-evolution`, `qk-production-release`, `qk-ai-builder`, `qk-project-bootstrap`
-- **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`
+- **Docs & Utils:** `qk-docs`, `qk-project-memory`, `qk-help`, `qk-db-optimizer`
 
 ---
 
 ## 💻 Cách Cài Đặt (Installation)
 
-Sử dụng npm:
+### Cách 1: NPM Global (Khuyên dùng cho nhiều máy)
 ```bash
 npm i -g ai-developer-skill-os
 ```
-Hoặc khởi tạo thông qua `npx`:
+
+### Cách 2: NXP (Không cần cài global)
+```bash
+npx ai-developer-skill-os init --ide=antigravity --scope=2
+```
+
+### Cách 3: NPM Scripts (Trong dự án)
 ```bash
-npx ai-developer-skill-os init
+# Antigravity Global — 1 lần cài, mọi dự án dùng chung
+npm run install:antigravity
+
+# Antigravity Local — cài riêng cho dự án này
+npm run install:antigravity:local
+
+# Các IDE khác
+npm run install:cursor        # Global Cursor
+npm run install:windsurf      # Global Windsurf
+npm run install:claude        # Global Claude Code
+npm run install:kilo          # Global Kilo Code
+npm run install:multi         # Multi-IDE
+```
+
+## 📦 Tham số cho `init`
+
+| Tham số | Giá trị | Mô tả |
+|---------|---------|-------|
+| `--ide` | `antigravity`, `cursor`, `windsurf`, `claude`, `kilo`, `multi-ide` | IDE/AI Assistant |
+| `--scope` | `1` = Local, `2` = Global | Phạm vi cài đặt |
+
+### Ví dụ thực tế
+
+```bash
+# Cài Antigravity Global (toàn máy)
+npx ai-developer-skill-os init --ide=antigravity --scope=2
+
+# Cài Antigravity Local (chỉ dự án này)
+npx ai-developer-skill-os init --ide=antigravity --scope=1
+
+# Cài Cursor Local
+npx ai-developer-skill-os init --ide=cursor --scope=1
+
+# Cài Multi-IDE (tạo CLAUDE.md + .qk-ai-skill-os)
+npx ai-developer-skill-os init --ide=multi-ide --scope=2
 ```
 
 ## 🧪 Testing
 
-Hệ thống được bảo vệ bằng bộ Test Suite (Vitest) để tự động kiểm toán tính hợp lệ của toàn bộ 23 file Kỹ năng trước khi xuất bản:
+Hệ thống được bảo vệ bằng bộ Test Suite (Vitest) để tự động kiểm toán tính hợp lệ của toàn bộ 22 file Kỹ năng trước khi xuất bản:
 
 ```bash
 npm test
@@ -57,3 +97,4 @@ npm test
 ```bash
 ./qk-help
 ```
+

package/.agents/docs/CHI_TIET_SKILLS.md

@@ -40,7 +40,7 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 - **Mô tả:** Quản lý Design Token, tạo ra các Component có thể tái sử dụng (Button, Table, Form) đảm bảo tính nhất quán toàn dự án.
 - **Khi nào dùng:** Xây dựng thư viện giao diện, tránh viết CSS lộn xộn.
 
-### 8. `qk-design-to-code` (Chuyển Đổi Thiết Kế)
+### 8. `qk-ui-builder` (Chuyển Đổi Thiết Kế)
 - **Mô tả:** Đọc hiểu hình ảnh/Figma để tự động chuyển thành mã nguồn giao diện (React, Tailwind, v.v.).
 - **Khi nào dùng:** Bóc tách UI từ bản thiết kế.
 
@@ -123,3 +123,4 @@ Dưới đây là danh sách chi tiết và giải thích cụ thể cho toàn b
 ### 22. `qk-help` (Tra Cứu Nhanh)
 - **Mô tả:** Cuốn từ điển sống. Cung cấp thông tin và hướng dẫn chi tiết (Pro-tips) về cách sử dụng toàn bộ hệ thống.
 - **Khi nào dùng:** Bất kỳ khi nào người dùng cần hỗ trợ sử dụng hệ điều hành.
+

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

@@ -143,7 +143,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 +167,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 +275,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 |
@@ -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-project-bootstrap/SKILL.md

@@ -224,7 +224,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 +232,4 @@ Recommended Assumptions (if proceeding):
 ---
 
 
+

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

@@ -170,3 +170,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
+
+---
+

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

@@ -56,7 +56,7 @@ schema_version: 2
 - ✅ Validate responsive, interactive, and animation states
 
 ## Non-Goals
-- ❌ Fix the UI — only audit and report (fixes go to qk-design-to-code)
+- ❌ Fix the UI — only audit and report (fixes go to qk-ui-builder)
 - ❌ Pixel-level screenshot comparison
 - ❌ Read entire CSS files — use targeted reads
 
@@ -248,7 +248,7 @@ schema_version: 2
 ### Produces
 ```json
 {
-  "to": "qk-design-to-code (if fixes needed)",
+  "to": "qk-ui-builder (if fixes needed)",
   "output_fields": ["audit_score", "violations_list", "top_3_fixes", "exit_code"]
 }
 ```
@@ -312,3 +312,4 @@ schema_version: 2
 
 ---
 
+