ai-developer-skill-os 10.1.0 → 10.2.0

package/.agents/workflows/skin-governance.yml

@@ -1,115 +1,149 @@
-name: skin-governance
-version: 9.2.0
-description: "Workflow tối ưu hóa, kiểm định và nâng cấp AI Skin — observe usage, measure success, improve, validate, promote."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: skill-evolution
-
-triggers:
-  - "improve this skill"
-  - "tối ưu skill"
-  - "why does this skill keep failing"
-  - "optimize this workflow"
-  - "phân tích usage skill"
-  - "nâng cấp skin"
-  - "skin governance"
-
-ide_binding:
-  slash_command: "/skin-tune"
-  aliases: ["/evolve-skill", "/skin-governance"]
-
-steps:
-  - id: observe_usage
-    name: "Observe Usage"
-    purpose: "Thống kê cách skill được gọi, token consumed, exit codes phân bổ"
-    required: true
-    inputs:
-      - skill_logs
-      - evals_traces
-    outputs:
-      - usage_metrics        # trigger_rate, avg_tokens, exit_distribution
-    actions:
-      - "Đọc evals/traces/ của skill target"
-      - "Thống kê trigger rate và token usage per exit code"
-      - "Phát hiện pattern gọi sai skill (routing error)"
-
-  - id: measure_success
-    name: "Measure Success Rate"
-    purpose: "Đánh giá chất lượng thực thi theo scorecard"
-    required: true
-    inputs:
-      - usage_metrics
-      - scorecard_yaml
-    outputs:
-      - success_rate         # % SUCCESS / total runs
-      - weak_areas           # Steps hay fail nhất
-    actions:
-      - "Tính SUCCESS / FAILED / PARTIAL / BLOCKED ratio"
-      - "Xác định bước nào trong workflow hay bị BLOCKED nhất"
-      - "So sánh với threshold trong scorecard.yaml"
-
-  - id: detect_failure
-    name: "Detect Failure Patterns"
-    purpose: "Tìm root cause của các lần fail — không đoán mò"
-    required: true
-    inputs:
-      - execution_results
-      - evals_traces
-    outputs:
-      - failure_patterns     # Categorized: ambiguous_input | hallucination | budget_overrun | wrong_routing
-    actions:
-      - "Phân loại lỗi: ambiguous_input / hallucination / budget_overrun / wrong_routing"
-      - "Tìm ví dụ cụ thể từ traces"
-      - "Ghi root cause evidence cho từng category"
-
-  - id: improve_skill
-    name: "Propose Improvement"
-    purpose: "Đề xuất thay đổi cụ thể — không thay đổi ngầm"
-    required: true
-    inputs:
-      - failure_patterns
-      - skill_body
-    outputs:
-      - improvement_proposal   # Diff: what to add/remove/change + reason
-    actions:
-      - "Giảm noise trong instruction (xóa rule không được enforce)"
-      - "Cập nhật examples với case thực tế từ traces"
-      - "Tinh chỉnh token_budget nếu hay bị overrun"
-      - "Cập nhật triggers nếu routing hay sai"
-      - "KHÔNG tự sửa — trả proposal để human review"
-    human_checkpoint:
-      condition: always
-      message: "Review improvement proposal trước khi apply vào SKILL.md"
-
-  - id: validate
-    name: "Validate Proposal"
-    purpose: "Đảm bảo bản cải tiến không vi phạm governance rules"
-    required: true
-    inputs:
-      - improvement_proposal
-    outputs:
-      - validation_result    # PASS | FAIL với lý do
-    actions:
-      - "Kiểm tra schema compliance (SPEC.md frontmatter)"
-      - "Đảm bảo không tạo scope overlap với skill khác"
-      - "Verify triggers không trùng skill khác trong routing table"
-
-  - id: promote
-    name: "Promote to Stable"
-    purpose: "Đưa bản cải tiến vào production sau khi đã validate"
-    required: true
-    inputs:
-      - validation_result
-    outputs:
-      - promoted_skill       # version bumped SKILL.md
-    actions:
-      - "Bump patch version (9.2.x → 9.2.x+1)"
-      - "Cập nhật registry: node tooling/generate-registry.js"
-      - "Ghi changelog entry"
-
-escalation:
-  max_retries: 1
-  on_failure: "Hủy bỏ bản cải tiến, giữ nguyên version hiện tại, ghi failure reason"
+name: skin-governance
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Workflow tối ưu hóa, kiểm định và nâng cấp AI Skin — observe usage, measure success, improve, validate, promote."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: skill-evolution
+
+triggers:
+  - "improve this skill"
+  - "tối ưu skill"
+  - "why does this skill keep failing"
+  - "optimize this workflow"
+  - "phân tích usage skill"
+  - "nâng cấp skin"
+  - "skin governance"
+
+ide_binding:
+  slash_command: "/skin-tune"
+  aliases: ["/evolve-skill", "/skin-governance"]
+
+steps:
+  - id: observe_usage
+    name: "Observe Usage"
+    purpose: "Thống kê cách skill được gọi, token consumed, exit codes phân bổ"
+    required: true
+    inputs:
+      - skill_logs
+      - evals_traces
+    outputs:
+      - usage_metrics        # trigger_rate, avg_tokens, exit_distribution
+    actions:
+      - "Đọc evals/traces/ của skill target"
+      - "Thống kê trigger rate và token usage per exit code"
+      - "Phát hiện pattern gọi sai skill (routing error)"
+
+  - id: measure_success
+    name: "Measure Success Rate"
+    purpose: "Đánh giá chất lượng thực thi theo scorecard"
+    required: true
+    inputs:
+      - usage_metrics
+      - scorecard_yaml
+    outputs:
+      - success_rate         # % SUCCESS / total runs
+      - weak_areas           # Steps hay fail nhất
+    actions:
+      - "Tính SUCCESS / FAILED / PARTIAL / BLOCKED ratio"
+      - "Xác định bước nào trong workflow hay bị BLOCKED nhất"
+      - "So sánh với threshold trong scorecard.yaml"
+
+  - id: detect_failure
+    name: "Detect Failure Patterns"
+    purpose: "Tìm root cause của các lần fail — không đoán mò"
+    required: true
+    inputs:
+      - execution_results
+      - evals_traces
+    outputs:
+      - failure_patterns     # Categorized: ambiguous_input | hallucination | budget_overrun | wrong_routing
+    actions:
+      - "Phân loại lỗi: ambiguous_input / hallucination / budget_overrun / wrong_routing"
+      - "Tìm ví dụ cụ thể từ traces"
+      - "Ghi root cause evidence cho từng category"
+
+  - id: improve_skill
+    name: "Propose Improvement"
+    purpose: "Đề xuất thay đổi cụ thể — không thay đổi ngầm"
+    required: true
+    inputs:
+      - failure_patterns
+      - skill_body
+    outputs:
+      - improvement_proposal   # Diff: what to add/remove/change + reason
+    actions:
+      - "Giảm noise trong instruction (xóa rule không được enforce)"
+      - "Cập nhật examples với case thực tế từ traces"
+      - "Tinh chỉnh token_budget nếu hay bị overrun"
+      - "Cập nhật triggers nếu routing hay sai"
+      - "KHÔNG tự sửa — trả proposal để human review"
+    human_checkpoint:
+      condition: always
+      message: "Review improvement proposal trước khi apply vào SKILL.md"
+
+  - id: validate
+    name: "Validate Proposal"
+    purpose: "Đảm bảo bản cải tiến không vi phạm governance rules"
+    required: true
+    inputs:
+      - improvement_proposal
+    outputs:
+      - validation_result    # PASS | FAIL với lý do
+    actions:
+      - "Kiểm tra schema compliance (SPEC.md frontmatter)"
+      - "Đảm bảo không tạo scope overlap với skill khác"
+      - "Verify triggers không trùng skill khác trong routing table"
+
+  - id: promote
+    name: "Promote to Stable"
+    purpose: "Đưa bản cải tiến vào production sau khi đã validate"
+    required: true
+    inputs:
+      - validation_result
+    outputs:
+      - promoted_skill       # version bumped SKILL.md
+    actions:
+      - "Bump patch version (10.2.x → 10.2.x+1)"
+      - "Cập nhật registry: node tooling/build-registry.js"
+      - "Ghi changelog entry"
+
+escalation:
+  max_retries: 1
+  on_failure: "Hủy bỏ bản cải tiến, giữ nguyên version hiện tại, ghi failure reason"
+
+# ── V10.2 Additions ──────────────────────────────
+# Confidence Model
+# | Level  | Condition              | Action       |
+# |--------|------------------------|--------------|
+# | HIGH   | Step inputs provided   | Proceed      |
+# | MEDIUM | Some assumptions needed | Note assumptions |
+# | LOW    | Insufficient evidence  | EXIT: BLOCKED|
+#
+# Exit Codes
+# | Code    | Meaning                       | When                    |
+# |---------|-------------------------------|-------------------------|
+# | SUCCESS | Step completed and verified   | All criteria met        |
+# | PARTIAL | Step done with minor gaps    | Some checks skipped     |
+# | BLOCKED | Missing precondition         | Ask user                |
+# | FAILED  | Step failed after max retries | Report error            |
+#
+# Evidence Format:
+#   [SEVERITY] step_id: [step-name]
+#   Reason:     [why this matters]
+#   Confidence: [HIGH|MEDIUM|LOW]
+#   Fix:        [suggestion]
+#
+# Compliance:
+#   Runtime Standard: 11/11
+#   Frontmatter Complete: yes
+#   References Valid: yes
+#   Decision Trees: PASS
+#   Thresholds Defined: PASS
+#   schema_version: 10.2.0
+#   runtime_version: 1
+#   platforms: [antigravity, claude, opencode]

package/.agents/workflows/spec-driven-development.yml

@@ -1,6 +1,8 @@
 name: spec-driven-development
-version: 9.3.0
-description: "Workflow phát triển sản phẩm dựa trên đặc tả kỹ thuật (Specification-Driven Development): Idea → Requirements → Acceptance Criteria (BDD) → Technical Spec → Plan → Verify."
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline phát triển dựa trên đặc tả: Requirement → Acceptance Criteria → Technical Spec → Implementation."
 
 owner:
   type: engineering
@@ -9,101 +11,106 @@ owner:
 verification_profile: spec-driven
 
 triggers:
-  - "write a spec"
-  - "viết đặc tả"
-  - "spec this out"
+  - "viết spec"
+  - "viết prd"
   - "acceptance criteria"
-  - "prd"
-  - "technical spec"
-  - "user story"
-  - "design before implementing"
+  - "bdd"
 
 ide_binding:
   slash_command: "/spec"
-  aliases: ["/grill-me", "/prd", "/spec-driven"]
+  aliases: ["/prd", "/specify"]
 
 steps:
-  - id: clarify_requirements
-    name: "Làm rõ yêu cầu & Bóc tách ý tưởng"
-    purpose: "Biến ý tưởng thô sơ thành mục tiêu sản phẩm rõ ràng, không mơ hồ"
+  - id: triage
+    name: "Triage & Clarify"
+    purpose: "Xác định quy mô task và kích hoạt /grill-me nếu thiếu thông tin"
     required: true
-    inputs:
-      - user_idea
-      - dev_profile
     outputs:
-      - problem_statement    # Vấn đề cần giải quyết
-      - target_actors        # Ai sử dụng tính năng này
-      - scope_boundary       # In-scope vs Out-of-scope rõ ràng
+      - task_scale
+      - clarity_level
     actions:
-      - "Gợi ý người dùng chạy lệnh slash /grill-me để phỏng vấn sâu nếu yêu cầu còn nhiều giả định chưa rõ"
-      - "Xác định rõ vấn đề cốt lõi (Core Problem) và giá trị kinh doanh (Value)"
-      - "Vạch rõ ranh giới: Làm gì (In-scope) và KHÔNG làm gì (Out-of-scope)"
-    exit_on_fail: BLOCKED
+      - "Xác định Nhỏ/Vừa/Lớn"
+      - "Kích hoạt /grill-me nếu thiếu thông tin"
 
-  - id: acceptance_criteria
-    name: "Xây dựng Acceptance Criteria (BDD)"
-    purpose: "Định nghĩa định lượng tiêu chí hoàn thành theo chuẩn Given / When / Then"
+  - id: gap_scan
+    name: "Codebase Gap Scan"
+    purpose: "Đối chiếu models & APIs hiện có để đánh giá khả thi"
     required: true
-    inputs:
-      - problem_statement
-      - target_actors
-      - scope_boundary
     outputs:
-      - criteria_matrix      # Bảng Given / When / Then cho từng use-case
-      - edge_cases           # Kịch bản biên, lỗi, rớt mạng, mất quyền
+      - reusable_components
+      - new_requirements
     actions:
-      - "Viết kịch bản theo chuẩn BDD (Given / When / Then) cho từng User Story"
-      - "Liệt kê ít nhất 3 edge cases (dữ liệu rỗng, timeout, quyền truy cập không hợp lệ)"
-      - "Xác định rõ HTTP status code mong đợi cho từng kịch bản lỗi"
+      - "Quét codebase cho models, APIs hiện có"
+      - "Xác định Gap Analysis"
 
-  - id: technical_specification
-    name: "Thiết kế Đặc tả Kỹ thuật (Technical Spec)"
-    purpose: "Xác định kiến trúc hệ thống, API contracts, và Data schema trước khi code"
+  - id: bdd_write
+    name: "BDD Spec Writing"
+    purpose: "Viết Acceptance Criteria chuẩn Gherkin"
     required: true
-    inputs:
-      - criteria_matrix
-      - edge_cases
     outputs:
-      - data_models          # Entities, Interfaces, DB Schema migrations
-      - api_contracts        # Endpoint, Method, Request/Response JSON schemas
-      - architecture_diagram # Sơ đồ luồng ASCII Unicode Box Drawing
+      - bdd_scenarios
+      - acceptance_criteria
     actions:
-      - "Vẽ sơ đồ luồng dữ liệu (Data Flow) bằng Unicode/ASCII Box Drawing (chuẩn GEMINI.md)"
-      - "Thiết kế Type contracts (TypeScript interfaces / Pydantic models / Protobuf)"
-      - "Xác định rõ các điểm chốt chặn bảo mật (Boundary Validation R-SEC-04)"
-      - "Đảm bảo contract giữa Frontend và Backend đồng bộ 100%"
+      - "Viết Given/When/Then cho Happy Path + Edge Cases"
+    human_checkpoint:
+      condition: "Task scale = Lớn"
+      message: "Feature lớn. Xác nhận BDD spec trước khi tiếp tục."
 
-  - id: create_plan
-    name: "Lập Kế hoạch Triển khai (Implementation Plan)"
-    purpose: "Phân rã spec thành các task cụ thể và kích hoạt phê duyệt tương tác"
+  - id: plan
+    name: "Implementation Plan"
+    purpose: "Tạo implementation_plan.md và kích hoạt modal"
     required: true
-    inputs:
-      - technical_specification
     outputs:
-      - implementation_plan  # File implementation_plan.md
+      - implementation_plan_path
     actions:
-      - "Phân chia task theo thứ tự an toàn: Types/Schema → Business Logic/Service → UI/Route → Tests"
-      - "Ước lượng rủi ro và blast radius cho từng file"
-      - "Trên Antigravity IDE: Tạo implementation_plan.md kèm RequestFeedback: true để kích hoạt Modal phê duyệt"
+      - "Tạo implementation_plan.md với RequestFeedback: true"
     human_checkpoint:
-      condition: "Task có độ phức tạp medium/high (≥ 2 files hoặc sửa schema DB)"
-      message: "Bản đặc tả và kế hoạch kỹ thuật đã sẵn sàng. Xác nhận để chuyển sang bước thực thi."
+      condition: "Always"
+      message: "Review implementation_plan trước khi code."
 
-  - id: verify_compliance
-    name: "Kiểm định Tuân thủ Đặc tả"
-    purpose: "Đối chiếu mã nguồn sau khi code với 100% Acceptance Criteria ban đầu"
+  - id: verify
+    name: "Verify Against Spec"
+    purpose: "Xác nhận implementation match spec"
     required: true
-    inputs:
-      - source_code
-      - criteria_matrix
     outputs:
-      - compliance_report    # Pass rate, tiêu chí chưa đạt (nếu có)
+      - spec_compliance
     actions:
-      - "Kiểm tra từng tiêu chí Given/When/Then — đánh dấu ✅ hoặc ❌"
-      - "Chạy automated tests nếu có để chứng minh tiêu chí đã đạt"
-      - "Không cho phép đóng task nếu còn bất kỳ acceptance criterion nào chưa thỏa mãn"
+      - "Đối chiếu từng acceptance criteria"
+      - "Verify edge cases covered"
     exit_on_fail: PARTIAL
 
 escalation:
-  max_retries: 2
-  on_failure: "Báo cáo độ lệch so với spec, chỉ ra blocker và yêu cầu chỉ thị từ Tech Lead / User"
+  max_retries: 1
+  on_failure: "Report spec compliance gaps and ask user to update spec"
+
+# ── V10.2 Additions ──────────────────────────────
+# Confidence Model
+# | Level  | Condition              | Action       |
+# |--------|------------------------|--------------|
+# | HIGH   | Step inputs provided   | Proceed      |
+# | MEDIUM | Some assumptions needed | Note assumptions |
+# | LOW    | Insufficient evidence  | EXIT: BLOCKED|
+#
+# Exit Codes
+# | Code    | Meaning                       | When                    |
+# |---------|-------------------------------|-------------------------|
+# | SUCCESS | Step completed and verified   | All criteria met        |
+# | PARTIAL | Step done with minor gaps    | Some checks skipped     |
+# | BLOCKED | Missing precondition         | Ask user                |
+# | FAILED  | Step failed after max retries | Report error            |
+#
+# Evidence Format:
+#   [SEVERITY] step_id: [step-name]
+#   Reason:     [why this matters]
+#   Confidence: [HIGH|MEDIUM|LOW]
+#   Fix:        [suggestion]
+#
+# Compliance:
+#   Runtime Standard: 11/11
+#   Frontmatter Complete: yes
+#   References Valid: yes
+#   Decision Trees: PASS
+#   Thresholds Defined: PASS
+#   schema_version: 10.2.0
+#   runtime_version: 1
+#   platforms: [antigravity, claude, opencode]

package/CHANGELOG.md

@@ -5,6 +5,26 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 
 ---
 
+## [10.2.0] — 2026-09-24 — AI Developer Skill OS v10.2: 3 IDEs (Antigravity, Claude, OpenCode), Platform-Specific Sections, graph.json edges
+
+### Added
+- 3 IDE support: Antigravity, Claude, OpenCode
+- Platform-Specific Instructions section in every SKILL.md
+- `platforms` and `runtime_version` fields in all frontmatters
+- `.claude/CLAUDE.md`, `.opencode/config.yaml` created
+- CI workflow updated to ubuntu-latest
+
+### Changed
+- Removed Cursor, Windsurf, Kilo, Codex support
+- Removed old `/skills/` directory and `capability-graph.yml`
+- Removed stale worktree `.kilo/worktrees/stealth-octagon`
+
+### Fixed
+- `copyOpenCodeConfig` order fix in install.js
+- `validate-skills.js` V10 status default
+- `build-registry.js` dependency mapping with crossEdges
+- `sync-versions.js` V9→V10 fix
+
 ## [10.1.0] — 2026-09-15 — AI Developer Skill OS v10.1: 11 Super-Skills, API-to-Data Discovery & Prompt Compiler v11.1
 
 ### Added
@@ -228,3 +248,44 @@ Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 ## [7.0.0] — 2026
 
 - V7 release: 22 skills, YAML frontmatter, token budget system
+
+---
+
+## [10.2.0] — 2026-09-24 — AI Developer Skill OS v10.2: Clean Architecture & Full Validation
+
+### Upgraded
+- All 11 SKILL.md files version bumped to 10.2.0
+- All 9 rule files version bumped to 10.2.0
+- All 12 workflow YAML files version bumped to 10.2.0
+- _template/SKILL.md upgraded from V9.2 to V10.2
+
+### Added — Every Skill Now Has:
+- **Confidence Model** — HIGH/MEDIUM/LOW routing confidence
+- **Exit Codes** — SUCCESS/PARTIAL/BLOCKED/FAILED
+- **Evidence Format** — Structured evidence with severity + confidence
+- **Compliance** — schema_version 10.2.0, runtime_version 1
+
+### Enhanced
+- **qk-orchestrator**: Added Role Adaptation, Failure Path, Retry Policy (108→187 lines)
+- **qk-code-review**: Added Role Adaptation, Failure Path, Evidence Format (132→220 lines)
+- **qk-api-data-discovery**: Reduced 470→330 lines, split report templates to references/
+- **qk-prompt-compiler**: Added Core Principles, Role Adaptation, Evidence Gate (321→408 lines)
+- **7 other skills**: Added missing Exit Codes + Confidence Model + Evidence Format
+
+### Removed
+- Deleted old `/skills/` directory (22-file legacy system)
+- Deleted `capability-graph.yml` and `skills-index.yml` (old registry)
+- Deleted `.kilo/worktrees/stealth-octagon` (stale git worktree)
+- Deleted `_template/capability.yaml` (old system manifest)
+- Deleted `_template/evals/scorecard.yaml` (old V8 format)
+
+### Fixed Tooling
+- `validate-skills.js`: Updated to check V10 sections instead of V8 fields
+- `build-registry.js`: Updated from V8.2 to V10.2, added edges array to graph.json
+- `validate-graph.js`: Updated to read graph.json, fixed orphan detection
+- `sync-versions.js`: Updated targetVersion from 9.1.0 to 10.2.0
+
+### Validation
+- `npm run test:registry`: 10/10 tests passed
+- `node tooling/validate-skills.js`: 11/11 valid
+- `node tooling/validate-graph.js`: **Score 100/100** (0 orphans, 0 cycles, 11 edges)

package/README.md

@@ -1,8 +1,8 @@
-# AI Developer Skill OS v10.1.0 — Lean Core Edition
+# AI Developer Skill OS v10.2.0 — Lean Core Edition
 
-> **v10.1.0 "Lean Core Revolution & API-to-Data Discovery Integration"**
+> **v10.2.0 "Lean Core Revolution & API-to-Data Discovery Integration"**
 
-Phiên bản **v10.1.0** giải quyết triệt để vấn đề phân mảnh quá mức (extreme fragmentation) từ 37 thư mục vi kỹ năng (micro-skills) xuống còn **11 Core Super-Skills** mạnh mẽ, không làm mất bất kỳ tính năng chuyên sâu nào, đồng thời tích hợp toàn diện cỗ máy biên dịch Prompt Compiler v11.1 và Discovery Engine cho Antigravity IDE.
+Phiên bản **v10.2.0** giải quyết triệt để vấn đề phân mảnh quá mức (extreme fragmentation) từ 37 thư mục vi kỹ năng (micro-skills) xuống còn **11 Core Super-Skills** mạnh mẽ, không làm mất bất kỳ tính năng chuyên sâu nào, đồng thời tích hợp toàn diện cỗ máy biên dịch Prompt Compiler v10.2 và Discovery Engine cho Antigravity IDE.
 
 ---