ai-developer-skill-os 9.3.1 → 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,87 +1,116 @@
-name: spec-driven-development
-version: 8.0.0
-description: "Workflow phát triển dựa trên đặc tả (Specification-Driven Development)."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: spec-driven
-
-triggers:
-  - "write a spec"
-  - "viết đặc tả"
-  - "spec this out"
-  - "design before implementing"
-  - "technical spec for"
-
-ide_binding:
-  slash_command: "/spec"
-  aliases: ["/spec-driven"]
-
-steps:
-  - id: clarify_requirement
-    name: "Clarify Requirements"
-    purpose: "Làm rõ yêu cầu từ ý tưởng ban đầu"
-    required: true
-    inputs:
-      - user_idea
-    outputs:
-      - clarified_requirement
-    actions:
-      - "Hỏi các câu hỏi làm rõ scope và constraints"
-      - "Xác định rõ outcome mong muốn"
-
-  - id: create_spec
-    name: "Create Specification"
-    purpose: "Viết tài liệu đặc tả kỹ thuật"
-    required: true
-    inputs:
-      - clarified_requirement
-    outputs:
-      - technical_spec
-    actions:
-      - "Thiết kế API contracts, data models"
-      - "Xác định UI/UX heuristics"
-      - "Spec phải quy định rõ boundary validation (R-SEC-04)"
-      - "Xác định edge cases"
-
-  - id: create_plan
-    name: "Create Plan"
-    purpose: "Lên kế hoạch triển khai"
-    required: true
-    inputs:
-      - technical_spec
-    outputs:
-      - implementation_plan
-    actions:
-      - "Chia nhỏ spec thành các task cụ thể"
-      - "Đánh giá rủi ro và thứ tự ưu tiên"
-
-  - id: implement
-    name: "Implement"
-    purpose: "Triển khai mã nguồn"
-    required: true
-    inputs:
-      - implementation_plan
-      - technical_spec
-    outputs:
-      - source_code
-    actions:
-      - "Code theo đúng spec"
-
-  - id: verify
-    name: "Verify Implementation"
-    purpose: "Kiểm tra mã nguồn với đặc tả"
-    required: true
-    inputs:
-      - source_code
-      - technical_spec
-    outputs:
-      - verification_result
-    actions:
-      - "Đối chiếu kết quả code với acceptance criteria"
-
-escalation:
-  max_retries: 2
-  on_failure: "Báo cáo lệch spec và xin chỉ thị"
+name: spec-driven-development
+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
+  maintained_by: qk-team
+
+verification_profile: spec-driven
+
+triggers:
+  - "viết spec"
+  - "viết prd"
+  - "acceptance criteria"
+  - "bdd"
+
+ide_binding:
+  slash_command: "/spec"
+  aliases: ["/prd", "/specify"]
+
+steps:
+  - 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
+    outputs:
+      - task_scale
+      - clarity_level
+    actions:
+      - "Xác định Nhỏ/Vừa/Lớn"
+      - "Kích hoạt /grill-me nếu thiếu thông tin"
+
+  - id: gap_scan
+    name: "Codebase Gap Scan"
+    purpose: "Đối chiếu models & APIs hiện có để đánh giá khả thi"
+    required: true
+    outputs:
+      - reusable_components
+      - new_requirements
+    actions:
+      - "Quét codebase cho models, APIs hiện có"
+      - "Xác định Gap Analysis"
+
+  - id: bdd_write
+    name: "BDD Spec Writing"
+    purpose: "Viết Acceptance Criteria chuẩn Gherkin"
+    required: true
+    outputs:
+      - bdd_scenarios
+      - acceptance_criteria
+    actions:
+      - "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: plan
+    name: "Implementation Plan"
+    purpose: "Tạo implementation_plan.md và kích hoạt modal"
+    required: true
+    outputs:
+      - implementation_plan_path
+    actions:
+      - "Tạo implementation_plan.md với RequestFeedback: true"
+    human_checkpoint:
+      condition: "Always"
+      message: "Review implementation_plan trước khi code."
+
+  - id: verify
+    name: "Verify Against Spec"
+    purpose: "Xác nhận implementation match spec"
+    required: true
+    outputs:
+      - spec_compliance
+    actions:
+      - "Đối chiếu từng acceptance criteria"
+      - "Verify edge cases covered"
+    exit_on_fail: PARTIAL
+
+escalation:
+  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,42 @@ 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
+- **`qk-api-data-discovery` (Super-Skill thứ 11)**: Kỹ nghệ Khám phá API & Hợp đồng Dữ liệu thực nghiệm (API Discovery → Real Evidence → Schema Discovery → Data Contract → Bronze Medallion Assessment).
+  - Tôn chỉ vàng: *"Never infer an API contract from endpoint names alone. Observe the real API response first, preserve raw evidence, then derive the schema and standardized collection from observed evidence."*
+  - Mô hình 2 Pha với **Checkpoint STOP**: Pha A (Khám phá & xuất báo cáo Checkpoint `docs/api-discovery/<collection>-analysis.md`) → Dừng lại chờ người dùng quyết định → Pha B (Triển khai đúng Option được chọn).
+  - Quy tắc Handoff Contract: Báo cáo checkpoint chứa 3 tầng thông tin độc lập (FACT, ANALYSIS, DECISION OPTIONS) để chuyển giao quyền kiểm soát cho người dùng.
+- **`qk-prompt-compiler` v11.1**: Tích hợp Control Plane & Behavioral Gate với 4 chốt chặn kiểm soát: Risk Gate (`Complexity ≠ Risk`), Change Budget Gate (1–5 files, 0 deps), Scope Expansion Gate (chặn lan tầng), và Evidence Gate (`CLAIM LEVEL <= EVIDENCE LEVEL`).
+- **Nâng cấp Antigravity Cockpit**: Hỗ trợ 14 Senior Developer Roles, Interactive Planning Mode tự động (`RequestFeedback: true`), Dual-Stream Reporting và Unicode Box Drawing Diagrams.
+
+### Changed
+- **Quy hoạch 11 Core Super-Skills**: Đồng bộ hóa toàn bộ registry O(1), routing table và tài liệu hướng dẫn về chuẩn 11 Super-Skills tập trung, xóa bỏ hoàn toàn phân mảnh.
+- **Test Suite v10+**: Nâng cấp test suite tự động nhận diện các phiên bản Super-Skills v10+ và v11+, đạt 10/10 test cases passed (<1s).
+
+---
+
 ## [9.3.1] — 2026-09-14 — EDAOS v9.3: SSOT Trigger Discipline, Full-Body Execution & Complete Documentation
 
 ### Added
@@ -212,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)