ai-developer-skill-os 7.5.1 → 8.1.5

package/.agents/knowledge/design-intelligence/visual-language/layout.md

@@ -0,0 +1,18 @@
+# Layout Intelligence (Bố cục)
+
+## 1. Container & Max-Width
+Không bao giờ để văn bản chạy tràn màn hình siêu rộng (Ultra-wide).
+- Đọc tối ưu: Đoạn văn chỉ nên dài từ 60-80 ký tự/dòng. (Tailwind: `max-w-prose` hoặc `max-w-2xl`).
+- Main Layout: Thường bọc trong một container có max-width (Tailwind: `max-w-7xl mx-auto px-4 sm:px-6 lg:px-8`).
+
+## 2. Flex vs Grid
+- **Flexbox**: Dành cho giao diện 1 chiều (hàng hoặc cột). Ví dụ: Navbar, Danh sách tag, Nhóm nút bấm.
+- **CSS Grid**: Dành cho bố cục 2 chiều, các Card đều nhau. (Tailwind: `grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6`).
+
+## 3. Responsive Breakpoints
+Tư duy Mobile-First:
+- Code mặc định luôn áp dụng cho Mobile (Màn hình dọc).
+- `sm:` (640px) - Tablet nhỏ.
+- `md:` (768px) - Tablet ngang / iPad.
+- `lg:` (1024px) - Desktop / Laptop.
+- Tránh dùng quá nhiều breakpoint trên 1 class, chỉ dùng khi layout thực sự vỡ.

package/.agents/knowledge/design-intelligence/visual-language/spacing.md

@@ -0,0 +1,19 @@
+# Spacing Intelligence (Khoảng cách & Lưới)
+
+## 1. Hệ thống Lưới 8pt (8-Point Grid System)
+Khoảng cách (Margin/Padding), kích thước Icon, chiều cao Component **PHẢI** là bội số của 8 (hoặc 4 đối với chi tiết nhỏ).
+- 4px (`gap-1`, `p-1`)
+- 8px (`gap-2`, `p-2`)
+- 12px (`gap-3`, `p-3`) - Phổ biến cho padding bên trong nút bấm.
+- 16px (`gap-4`, `p-4`) - Base padding cho Card, Container nhỏ.
+- 24px (`gap-6`, `p-6`) - Khoảng cách giữa các sections nhỏ.
+- 32px (`gap-8`, `p-8`) - Padding tiêu chuẩn cho Container lớn.
+- 48px (`gap-12`, `p-12`) / 64px (`gap-16`) - Khoảng cách giữa các Section chính của Landing Page.
+
+## 2. Quy luật gần gũi (Law of Proximity)
+Các thành phần có liên quan logic với nhau phải nằm gần nhau hơn so với các phần khác.
+- Ví dụ Card: Khoảng cách giữa Icon và Text (8px) phải nhỏ hơn khoảng cách từ Text đến Border (16px).
+- Label và Input: `gap-1` (4px). Giữa 2 Field Form: `gap-4` (16px). Giữa Form và Submit Button: `gap-6` (24px).
+
+## 3. Optical Alignment (Căn chỉnh quang học)
+Đôi khi một icon tròn trông sẽ nhỏ hơn một icon vuông có cùng kích thước (bounding box). Tránh dùng số lẻ, sử dụng lưới 8pt để tự động căn bằng.

package/.agents/knowledge/design-intelligence/visual-language/typography.md

@@ -0,0 +1,23 @@
+# Typography Intelligence (Font Scale & Pairing)
+
+## 1. Hệ thống tỉ lệ (Scale System)
+Dựa trên nguyên lý phổ biến của thị trường (như Tailwind, Radix UI):
+- **Base (16px / 1rem)**: Nội dung đoạn văn mặc định. (Tailwind: `text-base`)
+- **Small (14px / 0.875rem)**: Chú thích, phụ đề nhỏ, label form. (Tailwind: `text-sm`)
+- **Tiny (12px / 0.75rem)**: Badge, tag, footnote. (Tailwind: `text-xs`)
+- **H3 / Subheading (20px / 1.25rem)**: Tiêu đề phụ, card title. (Tailwind: `text-xl`)
+- **H2 / Section Title (24px / 1.5rem)**: Tiêu đề mục lớn. (Tailwind: `text-2xl`)
+- **H1 / Hero Title (36px+ / 2.25rem+)**: Tiêu đề trang, landing page hero. (Tailwind: `text-4xl` hoặc `text-5xl`)
+
+## 2. Line Height (Chiều cao dòng)
+- Tiêu đề (H1, H2): Dùng `1.1` đến `1.2` (Tailwind: `leading-tight`) để tránh khoảng trống thừa.
+- Đoạn văn (Paragraph): Dùng `1.5` đến `1.6` (Tailwind: `leading-relaxed`) để dễ đọc.
+
+## 3. Font Pairing (Ghép cặp font chuẩn)
+- **Modern SaaS**: Inter (Sans-serif) cho toàn bộ, hoặc Cal Sans cho tiêu đề + Inter cho nội dung.
+- **Editorial / Blog**: Merriweather (Serif) cho tiêu đề + Roboto (Sans-serif) cho nội dung.
+- **Developer / Tech**: Fira Code hoặc JetBrains Mono cho code/badge + System UI (San Francisco/Segoe UI) cho UI.
+
+## 4. Trọng lượng chữ (Font Weight)
+- Tránh dùng Semibold (600) tràn lan. Dùng Medium (500) cho button/label và Bold (700) cho tiêu đề.
+- Body text luôn là Regular (400).

package/.agents/learnings/draft/README.md

@@ -0,0 +1,37 @@
+# Learning Draft — Placeholder
+
+This directory contains draft learnings created by AI agents or humans that have NOT yet been validated.
+
+## How to add a draft learning
+
+Create a new file: `YYYY-MM-[short-slug].md`
+
+```markdown
+---
+claim: "..."
+context: "When does this apply?"
+lifecycle: draft
+observed_by: agent | human
+observed_date: YYYY-MM
+related_skills: []
+---
+
+## Observation
+
+What was observed?
+
+## Why it matters
+
+Why is this worth noting?
+
+## Counter examples (if any)
+
+When does this NOT apply?
+```
+
+## How to promote to validated
+
+1. Fill the `evidence` field with links to issues/experiments
+2. Human reviews and agrees
+3. Move file to `validated/`
+4. Git commit with `[validated]` in message

package/.agents/registry/capability-graph.yml

@@ -0,0 +1,500 @@
+# registry/capability-graph.yml
+# GENERATED FILE — DO NOT EDIT MANUALLY
+version: 8.1.3
+generated_at: '2026-07-23T06:25:44.563Z'
+nodes:
+  qk-access-policy:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-agent-observability:
+    type: capability
+    maturity: experimental
+    owns:
+      - agent_decision_trace
+      - routing_accuracy_metrics
+      - skill_success_rate
+      - failure_pattern_detection
+      - feedback_loop
+    does_not_own:
+      - application_monitoring
+      - infrastructure_monitoring
+      - log_aggregation
+      - uptime_monitoring
+    conflicts: []
+    workflow: skill-evolution
+  qk-ai-builder:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-api-lifecycle:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-bug-resolution:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: bug-resolution
+  qk-context-loader:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: research
+  qk-data-lifecycle:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-db-optimizer:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: refactor
+  qk-design-system-engineering:
+    type: capability
+    maturity: experimental
+    owns:
+      - tokens
+      - components rules
+      - design governance
+    does_not_own:
+      - page implementation
+      - business logic
+    conflicts:
+      - qk-ui-system-builder
+    workflow: feature-delivery
+  qk-devops-platform:
+    type: capability
+    maturity: experimental
+    owns:
+      - CI/CD strategy
+      - deployment architecture
+      - environment management
+      - rollback strategy
+    does_not_own:
+      - application code
+      - cloud billing
+      - releasing features
+    conflicts:
+      - qk-production-release
+    workflow: feature-delivery
+  qk-docs:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: documentation
+  qk-engineering-standard:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: code-review
+  qk-fe-api-integration:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-feature-delivery:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-frontend-architecture:
+    type: capability
+    maturity: experimental
+    owns:
+      - architecture decisions
+      - state strategy
+    does_not_own:
+      - component implementation
+      - pixel styling
+    conflicts:
+      - qk-ui-builder
+    workflow: feature-delivery
+  qk-help:
+    type: capability
+    maturity: deprecated
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: internal
+  qk-orchestrator:
+    type: orchestrator
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: research
+  qk-product-specification:
+    type: capability
+    maturity: experimental
+    owns:
+      - technical-ready specification
+      - acceptance criteria
+    does_not_own:
+      - market research
+      - pricing
+      - roadmap
+    conflicts: []
+    workflow: spec-driven-development
+  qk-production-release:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: internal
+  qk-project-bootstrap:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-project-health:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: code-review
+  qk-project-memory:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: documentation
+  qk-security-audit:
+    type: capability
+    maturity: experimental
+    owns:
+      - application-security
+      - agent-security
+      - prompt-injection
+      - dependency-risk
+    does_not_own:
+      - access control implementation
+      - penetration testing
+      - compliance certification
+    conflicts: []
+    workflow: security-audit
+  qk-system-evolution:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: refactor
+  qk-test-engineering:
+    type: capability
+    maturity: experimental
+    owns:
+      - test pyramid
+      - coverage strategy
+      - regression planning
+    does_not_own:
+      - business logic implementation
+      - writing tests
+    conflicts: []
+    workflow: feature-delivery
+  qk-ui-audit:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: code-review
+  qk-ui-builder:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-ui-system-builder:
+    type: capability
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: feature-delivery
+  qk-validation-gate:
+    type: utility
+    maturity: stable
+    owns: []
+    does_not_own: []
+    conflicts: []
+    workflow: code-review
+  qk-web-quality-gate:
+    type: capability
+    maturity: experimental
+    owns:
+      - lighthouse audit
+      - accessibility review
+      - performance audit
+      - seo audit
+    does_not_own:
+      - ui component implementation
+    conflicts: []
+    workflow: feature-delivery
+edges:
+  - from: qk-access-policy
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-access-policy
+    to: qk-api-lifecycle
+    relation: feeds
+  - from: qk-agent-observability
+    to: skill-evolution
+    relation: depends_on
+  - from: qk-ai-builder
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-ai-builder
+    to: qk-system-evolution
+    relation: feeds
+  - from: qk-api-lifecycle
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-api-lifecycle
+    to: qk-data-lifecycle
+    relation: feeds
+  - from: qk-bug-resolution
+    to: bug-resolution
+    relation: depends_on
+  - from: qk-bug-resolution
+    to: qk-context-loader
+    relation: feeds
+  - from: qk-bug-resolution
+    to: qk-validation-gate
+    relation: feeds
+  - from: qk-context-loader
+    to: research
+    relation: depends_on
+  - from: qk-context-loader
+    to: qk-feature-delivery
+    relation: feeds
+  - from: qk-context-loader
+    to: qk-orchestrator
+    relation: feeds
+  - from: qk-data-lifecycle
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-data-lifecycle
+    to: qk-db-optimizer
+    relation: feeds
+  - from: qk-db-optimizer
+    to: refactor
+    relation: depends_on
+  - from: qk-db-optimizer
+    to: qk-data-lifecycle
+    relation: feeds
+  - from: qk-design-system-engineering
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-design-system-engineering
+    to: qk-ui-system-builder
+    relation: conflicts_with
+  - from: qk-design-system-engineering
+    to: qk-frontend-architecture
+    relation: feeds
+  - from: qk-devops-platform
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-devops-platform
+    to: qk-production-release
+    relation: conflicts_with
+  - from: qk-devops-platform
+    to: qk-production-release
+    relation: feeds
+  - from: qk-devops-platform
+    to: qk-security-audit
+    relation: feeds
+  - from: qk-docs
+    to: documentation
+    relation: depends_on
+  - from: qk-docs
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-engineering-standard
+    to: code-review
+    relation: depends_on
+  - from: qk-engineering-standard
+    to: qk-project-health
+    relation: feeds
+  - from: qk-engineering-standard
+    to: qk-system-evolution
+    relation: feeds
+  - from: qk-fe-api-integration
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-fe-api-integration
+    to: qk-api-lifecycle
+    relation: feeds
+  - from: qk-fe-api-integration
+    to: qk-ui-builder
+    relation: feeds
+  - from: qk-feature-delivery
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-feature-delivery
+    to: qk-context-loader
+    relation: feeds
+  - from: qk-feature-delivery
+    to: qk-validation-gate
+    relation: feeds
+  - from: qk-frontend-architecture
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-frontend-architecture
+    to: qk-ui-builder
+    relation: conflicts_with
+  - from: qk-frontend-architecture
+    to: qk-ui-builder
+    relation: delegates_to
+  - from: qk-ui-builder
+    to: qk-frontend-architecture
+    relation: implemented_by
+  - from: qk-frontend-architecture
+    to: qk-ui-system-builder
+    relation: delegates_to
+  - from: qk-ui-system-builder
+    to: qk-frontend-architecture
+    relation: implemented_by
+  - from: qk-frontend-architecture
+    to: qk-design-system-engineering
+    relation: feeds
+  - from: qk-frontend-architecture
+    to: qk-web-quality-gate
+    relation: feeds
+  - from: qk-help
+    to: internal
+    relation: depends_on
+  - from: qk-help
+    to: qk-orchestrator
+    relation: feeds
+  - from: qk-orchestrator
+    to: research
+    relation: depends_on
+  - from: qk-orchestrator
+    to: qk-context-loader
+    relation: feeds
+  - from: qk-product-specification
+    to: spec-driven-development
+    relation: depends_on
+  - from: qk-product-specification
+    to: qk-feature-delivery
+    relation: delegates_to
+  - from: qk-feature-delivery
+    to: qk-product-specification
+    relation: implemented_by
+  - from: qk-product-specification
+    to: qk-feature-delivery
+    relation: feeds
+  - from: qk-production-release
+    to: internal
+    relation: depends_on
+  - from: qk-production-release
+    to: qk-validation-gate
+    relation: feeds
+  - from: qk-project-bootstrap
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-project-bootstrap
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-project-health
+    to: code-review
+    relation: depends_on
+  - from: qk-project-health
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-project-memory
+    to: documentation
+    relation: depends_on
+  - from: qk-project-memory
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-security-audit
+    to: security-audit
+    relation: depends_on
+  - from: qk-security-audit
+    to: qk-validation-gate
+    relation: delegates_to
+  - from: qk-validation-gate
+    to: qk-security-audit
+    relation: implemented_by
+  - from: qk-security-audit
+    to: qk-access-policy
+    relation: feeds
+  - from: qk-system-evolution
+    to: refactor
+    relation: depends_on
+  - from: qk-system-evolution
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-system-evolution
+    to: qk-project-health
+    relation: feeds
+  - from: qk-test-engineering
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-test-engineering
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-ui-audit
+    to: code-review
+    relation: depends_on
+  - from: qk-ui-audit
+    to: qk-ui-builder
+    relation: feeds
+  - from: qk-ui-builder
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-ui-builder
+    to: qk-ui-system-builder
+    relation: feeds
+  - from: qk-ui-system-builder
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-ui-system-builder
+    to: qk-ui-builder
+    relation: feeds
+  - from: qk-validation-gate
+    to: code-review
+    relation: depends_on
+  - from: qk-validation-gate
+    to: qk-engineering-standard
+    relation: feeds
+  - from: qk-web-quality-gate
+    to: feature-delivery
+    relation: depends_on
+  - from: qk-web-quality-gate
+    to: qk-frontend-architecture
+    relation: feeds