ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/workflows/refactor.yml

@@ -1,102 +1,136 @@
-name: refactor
-version: 8.0.0
-description: "Pipeline refactor an toàn: giữ nguyên behavior bên ngoài, cải thiện chất lượng bên trong."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: refactor
-
-triggers:
-  - "refactor"
-  - "tái cấu trúc"
-  - "clean up this code"
-  - "simplify"
-  - "reduce complexity"
-  - "dọn dẹp code"
-
-ide_binding:
-  slash_command: "/refactor"
-  aliases: ["/cleanup", "/simplify"]
-
-steps:
-  - id: baseline
-    name: "Thiết lập baseline"
-    purpose: "Hiểu code hiện tại trước khi thay đổi"
-    required: true
-    skip_if: null
-    inputs:
-      - target_files
-      - refactor_goal    # e.g. "extract functions", "reduce complexity", "improve naming"
-    outputs:
-      - current_behavior_summary   # What the code does now
-      - pain_points                # Specific issues to address
-      - test_coverage_status       # Có tests không?
-    context_budget: 200
-    actions:
-      - "Đọc toàn bộ target section"
-      - "Mô tả behavior hiện tại"
-      - "Identify specific code smells"
-    exit_on_fail: BLOCKED
-
-  - id: plan
-    name: "Lên kế hoạch refactor"
-    purpose: "Quyết định approach để không thay đổi external behavior"
-    required: true
-    skip_if: null
-    inputs:
-      - pain_points
-      - current_behavior_summary
-    outputs:
-      - refactor_steps     # Ordered list of changes
-      - risk_assessment    # What could break
-      - rollback_point     # Git commit or checkpoint
-    min_confidence: HIGH
-    actions:
-      - "Outline từng bước thay đổi"
-      - "Xác định gì có thể break"
-    human_checkpoint:
-      condition: "risk_assessment cho thấy có thể breaking change hoặc thiếu test coverage"
-      message: "Refactor rủi ro cao. Vui lòng duyệt qua refactor_steps và risk_assessment."
-  - id: execute
-    name: "Thực hiện refactor"
-    purpose: "Apply changes theo plan, step by step"
-    required: true
-    skip_if: null
-    inputs:
-      - refactor_steps
-    outputs:
-      - modified_files
-      - changes_summary
-    actions:
-      - "Làm từng bước nhỏ, verify sau mỗi bước"
-      - "Không refactor ngoài scope đã định"
-      - "Chỉ refactor, KHÔNG add behavior mới"
-      - "Đảm bảo code sau refactor pass R-C-09"
-      - "Không add functionality mới trong khi refactor"
-
-  - id: verify
-    name: "Verify behavior unchanged + quality gate"
-    purpose: "Xác nhận external behavior giống hệt trước refactor VÀ quality cải thiện"
-    required: true
-    skip_if: null
-    inputs:
-      - current_behavior_summary
-      - modified_files
-    outputs:
-      - behavior_preserved    # true/false
-      - test_results          # pass/fail/na
-      - quality_gate_result   # PASS | FAIL
-    actions:
-      - "Re-read modified sections"
-      - "So sánh với current_behavior_summary — behavior PHẢI giống hệt"
-      - "Chạy tests nếu có"
-      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
-      - "  Checklist: universal_checks + refactor specific checks"
-      - "Ghi log execution trace vào evals/traces/"
-    exit_on_fail: FAILED
-
-escalation:
-  max_retries: 1
-  on_failure: "Revert to rollback_point. Report what was completed and what remains."
+name: refactor
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline refactor an toàn: giữ nguyên behavior bên ngoài, cải thiện chất lượng bên trong."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: refactor
+
+triggers:
+  - "refactor"
+  - "tái cấu trúc"
+  - "clean up this code"
+  - "simplify"
+  - "reduce complexity"
+  - "dọn dẹp code"
+
+ide_binding:
+  slash_command: "/refactor"
+  aliases: ["/cleanup", "/simplify"]
+
+steps:
+  - id: baseline
+    name: "Thiết lập baseline"
+    purpose: "Hiểu code hiện tại trước khi thay đổi"
+    required: true
+    skip_if: null
+    inputs:
+      - target_files
+      - refactor_goal    # e.g. "extract functions", "reduce complexity", "improve naming"
+    outputs:
+      - current_behavior_summary   # What the code does now
+      - pain_points                # Specific issues to address
+      - test_coverage_status       # Có tests không?
+    context_budget: 200
+    actions:
+      - "Đọc toàn bộ target section"
+      - "Mô tả behavior hiện tại"
+      - "Identify specific code smells"
+    exit_on_fail: BLOCKED
+
+  - id: plan
+    name: "Lên kế hoạch refactor"
+    purpose: "Quyết định approach để không thay đổi external behavior"
+    required: true
+    skip_if: null
+    inputs:
+      - pain_points
+      - current_behavior_summary
+    outputs:
+      - refactor_steps     # Ordered list of changes
+      - risk_assessment    # What could break
+      - rollback_point     # Git commit or checkpoint
+    min_confidence: HIGH
+    actions:
+      - "Outline từng bước thay đổi"
+      - "Xác định gì có thể break"
+    human_checkpoint:
+      condition: "risk_assessment cho thấy có thể breaking change hoặc thiếu test coverage"
+      message: "Refactor rủi ro cao. Vui lòng duyệt qua refactor_steps và risk_assessment."
+  - id: execute
+    name: "Thực hiện refactor"
+    purpose: "Apply changes theo plan, step by step"
+    required: true
+    skip_if: null
+    inputs:
+      - refactor_steps
+    outputs:
+      - modified_files
+      - changes_summary
+    actions:
+      - "Làm từng bước nhỏ, verify sau mỗi bước"
+      - "Không refactor ngoài scope đã định"
+      - "Chỉ refactor, KHÔNG add behavior mới"
+      - "Đảm bảo code sau refactor pass R-C-09"
+      - "Không add functionality mới trong khi refactor"
+
+  - id: verify
+    name: "Verify behavior unchanged + quality gate"
+    purpose: "Xác nhận external behavior giống hệt trước refactor VÀ quality cải thiện"
+    required: true
+    skip_if: null
+    inputs:
+      - current_behavior_summary
+      - modified_files
+    outputs:
+      - behavior_preserved    # true/false
+      - test_results          # pass/fail/na
+      - quality_gate_result   # PASS | FAIL
+    actions:
+      - "Re-read modified sections"
+      - "So sánh với current_behavior_summary — behavior PHẢI giống hệt"
+      - "Chạy tests nếu có"
+      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
+      - "  Checklist: universal_checks + refactor specific checks"
+      - "Ghi log execution trace vào evals/traces/"
+    exit_on_fail: FAILED
+
+escalation:
+  max_retries: 1
+  on_failure: "Revert to rollback_point. Report what was completed and what remains."
+
+# ── 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/security-audit.yml

@@ -1,115 +1,149 @@
-name: security-audit
-version: 8.0.0
-description: "Workflow kiểm toán an toàn mã nguồn và chống xâm nhập (Security Audit)."
-
-owner:
-  type: security
-  maintained_by: qk-team
-
-verification_profile: security-audit
-
-triggers:
-  - "security audit"
-  - "kiểm toán bảo mật"
-  - "check for vulnerabilities"
-  - "scan for secrets"
-  - "is this secure"
-  - "audit an toàn"
-
-ide_binding:
-  slash_command: "/security-audit"
-  aliases: ["/audit", "/sec-scan"]
-
-steps:
-  - id: observe
-    name: "Observe System"
-    purpose: "Thu thập metadata về cấu trúc và các thành phần"
-    required: true
-    inputs:
-      - source_code
-    outputs:
-      - system_context
-    actions:
-      - "Xác định tech stack, boundaries và các third-party libs"
-
-  - id: dependency_scan
-    name: "Dependency Scan"
-    purpose: "Kiểm tra rủi ro từ package bên ngoài"
-    required: true
-    inputs:
-      - system_context
-      - package_files
-    outputs:
-      - dependency_vulnerabilities
-    actions:
-      - "Kiểm tra version cũ, thư viện có CVE"
-
-  - id: secret_scan
-    name: "Secret Scan"
-    purpose: "Tìm kiếm thông tin nhạy cảm bị rò rỉ"
-    required: true
-    inputs:
-      - source_code
-    outputs:
-      - leaked_secrets
-    actions:
-      - "Quét hardcoded API keys, tokens, passwords trong code"
-
-  - id: permission_review
-    name: "Permission Review"
-    purpose: "Rà soát mô hình phân quyền và RBAC"
-    required: true
-    inputs:
-      - system_context
-      - access_control_code
-    outputs:
-      - permission_flaws
-    actions:
-      - "Kiểm tra nguyên tắc least privilege"
-      - "Tìm lỗ hổng authentication/authorization bypass"
-
-  - id: risk_classification
-    name: "Risk Classification"
-    purpose: "Đánh giá mức độ nghiêm trọng"
-    required: true
-    inputs:
-      - dependency_vulnerabilities
-      - leaked_secrets
-      - permission_flaws
-    outputs:
-      - classified_risks
-    actions:
-      - "Phân loại LOW/MEDIUM/HIGH/CRITICAL"
-
-  - id: recommendation
-    name: "Recommendation"
-    purpose: "Đề xuất giải pháp khắc phục"
-    required: true
-    inputs:
-      - classified_risks
-    outputs:
-      - security_report
-    actions:
-      - "Tạo báo cáo chi tiết kèm actionable steps"
-      - "Đề xuất giải pháp phải enforce R-SEC-04"
-    human_checkpoint:
-      condition: "classified_risks chứa bất kỳ mục nào ở mức CRITICAL"
-      message: "Phát hiện lỗ hổng CRITICAL. Xác nhận trước khi tiến hành áp dụng fix."
-  - id: verify
-    name: "Verify Fixes"
-    purpose: "Đảm bảo lỗ hổng đã được vá"
-    required: true
-    skip_if: "Không có remediation nào được apply trong phiên làm việc này"
-    inputs:
-      - source_code
-      - security_report
-    outputs:
-      - final_audit_status
-    actions:
-      - "Check lại các vị trí đã report"
-      - "Ghi log execution trace vào evals/traces/"
-    exit_on_fail: PARTIAL
-
-escalation:
-  max_retries: 0
-  on_failure: "Báo động đỏ (CRITICAL) nếu phát hiện secret leak"
+name: security-audit
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Workflow kiểm toán an toàn mã nguồn và chống xâm nhập (Security Audit)."
+
+owner:
+  type: security
+  maintained_by: qk-team
+
+verification_profile: security-audit
+
+triggers:
+  - "security audit"
+  - "kiểm toán bảo mật"
+  - "check for vulnerabilities"
+  - "scan for secrets"
+  - "is this secure"
+  - "audit an toàn"
+
+ide_binding:
+  slash_command: "/security-audit"
+  aliases: ["/audit", "/sec-scan"]
+
+steps:
+  - id: observe
+    name: "Observe System"
+    purpose: "Thu thập metadata về cấu trúc và các thành phần"
+    required: true
+    inputs:
+      - source_code
+    outputs:
+      - system_context
+    actions:
+      - "Xác định tech stack, boundaries và các third-party libs"
+
+  - id: dependency_scan
+    name: "Dependency Scan"
+    purpose: "Kiểm tra rủi ro từ package bên ngoài"
+    required: true
+    inputs:
+      - system_context
+      - package_files
+    outputs:
+      - dependency_vulnerabilities
+    actions:
+      - "Kiểm tra version cũ, thư viện có CVE"
+
+  - id: secret_scan
+    name: "Secret Scan"
+    purpose: "Tìm kiếm thông tin nhạy cảm bị rò rỉ"
+    required: true
+    inputs:
+      - source_code
+    outputs:
+      - leaked_secrets
+    actions:
+      - "Quét hardcoded API keys, tokens, passwords trong code"
+
+  - id: permission_review
+    name: "Permission Review"
+    purpose: "Rà soát mô hình phân quyền và RBAC"
+    required: true
+    inputs:
+      - system_context
+      - access_control_code
+    outputs:
+      - permission_flaws
+    actions:
+      - "Kiểm tra nguyên tắc least privilege"
+      - "Tìm lỗ hổng authentication/authorization bypass"
+
+  - id: risk_classification
+    name: "Risk Classification"
+    purpose: "Đánh giá mức độ nghiêm trọng"
+    required: true
+    inputs:
+      - dependency_vulnerabilities
+      - leaked_secrets
+      - permission_flaws
+    outputs:
+      - classified_risks
+    actions:
+      - "Phân loại LOW/MEDIUM/HIGH/CRITICAL"
+
+  - id: recommendation
+    name: "Recommendation"
+    purpose: "Đề xuất giải pháp khắc phục"
+    required: true
+    inputs:
+      - classified_risks
+    outputs:
+      - security_report
+    actions:
+      - "Tạo báo cáo chi tiết kèm actionable steps"
+      - "Đề xuất giải pháp phải enforce R-SEC-04"
+    human_checkpoint:
+      condition: "classified_risks chứa bất kỳ mục nào ở mức CRITICAL"
+      message: "Phát hiện lỗ hổng CRITICAL. Xác nhận trước khi tiến hành áp dụng fix."
+  - id: verify
+    name: "Verify Fixes"
+    purpose: "Đảm bảo lỗ hổng đã được vá"
+    required: true
+    skip_if: "Không có remediation nào được apply trong phiên làm việc này"
+    inputs:
+      - source_code
+      - security_report
+    outputs:
+      - final_audit_status
+    actions:
+      - "Check lại các vị trí đã report"
+      - "Ghi log execution trace vào evals/traces/"
+    exit_on_fail: PARTIAL
+
+escalation:
+  max_retries: 0
+  on_failure: "Báo động đỏ (CRITICAL) nếu phát hiện secret leak"
+
+# ── 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/shared/quality-gate.yml

@@ -1,5 +1,7 @@
 name: quality-gate
-version: 9.2.0
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
 description: "Shared quality gate — embedded vào bước verify của feature-delivery, bug-resolution, refactor. Source of truth duy nhất cho R-C-10 checklist."
 type: shared-step