ai-developer-skill-os 8.2.1 → 8.3.1

package/.agents/workflows/production-release.yml

@@ -0,0 +1,173 @@
+name: production-release
+version: 8.0.0
+description: "Chuẩn bị release production với 8-gate checklist bắt buộc — không pass gate = không deploy."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: release-safety
+
+triggers:
+  - "release production"
+  - "deploy production"
+  - "chuẩn bị release"
+  - "kiểm tra release"
+
+ide_binding:
+  slash_command: "/release"
+  aliases: ["/deploy", "/prod-release"]
+
+steps:
+  - id: gate_1_validation
+    name: "Gate 1: Validation Gate"
+    purpose: "Đảm bảo qk-validation-gate đã pass trước khi release"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - validation_result
+    actions:
+      - "Chạy npm run test:registry"
+      - "Chạy npm run lint"
+      - "Chạy npm run test:agent"
+      - "Chạy npm run test:graph"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "any validation gate fails"
+      message: "Validation gate thất bại. Fix trước khi tiếp tục."
+
+  - id: gate_2_capability
+    name: "Gate 2: Capability Integrity"
+    purpose: "Kiểm tra tất cả capability.yaml hợp lệ và không trùng lặp"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - capability_check
+    actions:
+      - "Validate tất cả capability.yaml files có schema_version: 1"
+      - "Kiểm tra không có capability.yaml trùng id"
+      - "Verify mỗi skill có SKILL.md tương ứng"
+      - "Verify mỗi SKILL.md có capability.yaml tương ứng"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "capability.yaml missing or invalid"
+      message: "Một số capability.yaml bị thiếu hoặc không hợp lệ."
+
+  - id: gate_3_registry
+    name: "Gate 3: Registry Consistency"
+    purpose: "Kiểm tra registry files nhất quán với filesystem"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - registry_check
+    actions:
+      - "Chạy node tooling/build-registry.js"
+      - "So sánh index.yaml với filesystem实际"
+      - "Kiểm tra graph.json không có cycles"
+      - "Kiểm tra không có orphan nodes"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "registry inconsistency detected"
+      message: "Registry không nhất quán với filesystem."
+
+  - id: gate_4_workflows
+    name: "Gate 4: Workflow Validation"
+    purpose: "Kiểm tra tất cả workflow files hợp lệ"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - workflow_check
+    actions:
+      - "Validate tất cả workflow YAML files có schema hợp lệ"
+      - "Kiểm tra mỗi workflow có steps, triggers, exit_codes"
+      - "Verify mỗi skill reference workflow tồn tại"
+      - "Kiểm tra không có workflow reference đến internal"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "workflow validation fails"
+      message: "Một hoặc nhiều workflow không hợp lệ."
+
+  - id: gate_5_security
+    name: "Gate 5: Security Scan"
+    purpose: "Quét bảo mật trước khi release"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - security_report
+    actions:
+      - "Chạy npm audit --production"
+      - "grep_search cho secrets, tokens, API keys trong code"
+      - "Kiểm tra không có hardcoded credentials"
+      - "Verify .env files không bị commit"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "critical or high security issues found"
+      message: "Có vấn đề bảo mật nghiêm trọng. Cần fix trước khi release."
+
+  - id: gate_6_size
+    name: "Gate 6: Bundle & Size Check"
+    purpose: "Kiểm tra kích thước bundle và dependencies"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - size_report
+    actions:
+      - "Chạy npm run build (production mode)"
+      - "Kiểm tra bundle size trong giới hạn"
+      - "Kiểm tra không có devDependencies trong production"
+      - "Verify tree-shaking hoạt động đúng"
+    exit_on_fail: FAILED
+    human_checkpoint:
+      condition: "bundle size exceeds limit"
+      message: "Bundle size vượt hạn chế. Cần tối ưu trước khi deploy."
+
+  - id: gate_7_changelog
+    name: "Gate 7: Changelog & Documentation"
+    purpose: "Kiểm tra CHANGELOG.md và documentation đã cập nhật"
+    required: true
+    skip_if: null
+    inputs: []
+    outputs:
+      - docs_check
+    actions:
+      - "Kiểm tra CHANGELOG.md có entry cho version này"
+      - "Verify README.md phản ánh đúng capabilities hiện tại"
+      - "Kiểm tra SKILL.md descriptions không bị encoding issues"
+      - "Verify capability.yaml descriptions chính xác"
+    exit_on_fail: PARTIAL
+    human_checkpoint:
+      condition: "changelog missing or docs outdated"
+      message: "CHANGELOG hoặc documentation chưa cập nhật. Cần fix trước khi release."
+
+  - id: gate_8_report
+    name: "Gate 8: Release Report"
+    purpose: "Tạo báo cáo release có signed kết quả tất cả gates"
+    required: true
+    skip_if: null
+    inputs:
+      - validation_result
+      - capability_check
+      - registry_check
+      - workflow_check
+      - security_report
+      - size_report
+      - docs_check
+    outputs:
+      - release_report
+    actions:
+      - "Tổng hợp tất cả gate results"
+      - "Generate structured release report"
+      - "Include evidence format cho mỗi gate"
+      - "Record exit code và timestamp"
+      - "Sign report với qk-team key"
+    exit_on_fail: FAILED
+
+escalation:
+  max_retries: 1
+  on_failure: "Report which gates failed and exact fix required. Do NOT deploy."

package/.agents/workflows/refactor.yml

@@ -1,81 +1,99 @@
-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
-
-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?
-    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"
-
-  - 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"
-      - "Không add functionality mới trong khi refactor"
-
-  - id: verify
-    name: "Verify behavior unchanged"
-    purpose: "Xác nhận external behavior giống hệt trước refactor"
-    required: true
-    skip_if: null
-    inputs:
-      - current_behavior_summary
-      - modified_files
-    outputs:
-      - behavior_preserved    # true/false
-      - test_results          # pass/fail/na
-    actions:
-      - "Re-read modified sections"
-      - "So sánh với current_behavior_summary"
-      - "Chạy tests nếu có"
-    exit_on_fail: FAILED
-
-escalation:
-  max_retries: 1
-  on_failure: "Revert to rollback_point. Report what was completed and what remains."
+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"
+    purpose: "Xác nhận external behavior giống hệt trước refactor"
+    required: true
+    skip_if: null
+    inputs:
+      - current_behavior_summary
+      - modified_files
+    outputs:
+      - behavior_preserved    # true/false
+      - test_results          # pass/fail/na
+    actions:
+      - "Re-read modified sections"
+      - "So sánh với current_behavior_summary"
+      - "Chạy tests nếu có"
+      - "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."

package/.agents/workflows/research.yml

@@ -1,60 +1,75 @@
-name: research
-version: 8.0.0
-description: "Pipeline nghiên cứu codebase để hiểu context, dependency, và architecture trước khi thực hiện task lớn."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: review
-
-steps:
-  - id: define_scope
-    name: "Xác định phạm vi nghiên cứu"
-    purpose: "Biết chính xác cần tìm hiểu gì để phục vụ task"
-    required: true
-    skip_if: null
-    inputs:
-      - research_goal    # What decision does this research enable?
-    outputs:
-      - research_questions   # Specific questions to answer
-      - entry_points         # Files to start reading
-    exit_on_fail: BLOCKED
-
-  - id: explore
-    name: "Khám phá codebase"
-    purpose: "Thu thập thông tin đủ để trả lời research questions"
-    required: true
-    skip_if: null
-    inputs:
-      - entry_points
-      - research_questions
-    outputs:
-      - findings           # Answers to research questions
-      - dependency_map     # How components relate
-      - relevant_files     # Files most relevant to the task
-    actions:
-      - "Dùng grep_search để tìm patterns, không đọc toàn bộ repo"
-      - "Đọc targeted sections (≤ 100 lines per read)"
-      - "Build mental model của dependency relationship"
-
-  - id: synthesize
-    name: "Tổng hợp kết quả"
-    purpose: "Trả lời research questions + tạo context cho task tiếp theo"
-    required: true
-    skip_if: null
-    inputs:
-      - findings
-      - dependency_map
-    outputs:
-      - context_summary      # Ready-to-use context for next skill
-      - architecture_notes   # Key patterns và conventions
-      - warnings             # Gotchas, deprecated patterns, risks
-    actions:
-      - "Viết summary ngắn gọn (không cần exhaustive)"
-      - "Flag các pattern cũ/deprecated nếu thấy"
-      - "Liệt kê relevant files để task tiếp theo load"
-
-escalation:
-  max_retries: 1
-  on_failure: "Report partial findings với confidence level"
+name: research
+version: 8.0.0
+description: "Pipeline nghiên cứu codebase để hiểu context, dependency, và architecture trước khi thực hiện task lớn."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: review
+
+triggers:
+  - "how does this work"
+  - "tìm hiểu codebase"
+  - "explore this repo"
+  - "nghiên cứu"
+  - "explain the architecture"
+  - "trace dependency"
+
+ide_binding:
+  slash_command: "/research"
+  aliases: ["/explore", "/explain"]
+
+steps:
+  - id: define_scope
+    name: "Xác định phạm vi nghiên cứu"
+    purpose: "Biết chính xác cần tìm hiểu gì để phục vụ task"
+    required: true
+    skip_if: null
+    inputs:
+      - research_goal    # What decision does this research enable?
+    outputs:
+      - research_questions   # Specific questions to answer
+      - entry_points         # Files to start reading
+    exit_on_fail: BLOCKED
+
+  - id: explore
+    name: "Khám phá codebase"
+    purpose: "Thu thập thông tin đủ để trả lời research questions"
+    required: true
+    skip_if: null
+    inputs:
+      - entry_points
+      - research_questions
+    outputs:
+      - findings           # Answers to research questions
+      - dependency_map     # How components relate
+      - relevant_files     # Files most relevant to the task
+    context_budget: 100
+    actions:
+      - "Dùng grep_search để tìm patterns, không đọc toàn bộ repo"
+      - "Đọc targeted sections (≤ 100 lines per read)"
+      - "Build mental model của dependency relationship"
+
+  - id: synthesize
+    name: "Tổng hợp kết quả"
+    purpose: "Trả lời research questions + tạo context cho task tiếp theo"
+    required: true
+    skip_if: null
+    inputs:
+      - findings
+      - dependency_map
+    outputs:
+      - context_summary      # Ready-to-use context for next skill
+      - architecture_notes   # Key patterns và conventions
+      - warnings             # Gotchas, deprecated patterns, risks
+    actions:
+      - "Viết summary ngắn gọn (không cần exhaustive)"
+      - "Flag các pattern cũ/deprecated nếu thấy"
+      - "Báo cáo mọi pattern vi phạm R-SEC-04 nếu thấy"
+      - "Ghi log execution trace vào evals/traces/"
+      - "Liệt kê relevant files để task tiếp theo load"
+
+escalation:
+  max_retries: 1
+  on_failure: "Report partial findings với confidence level"