ai-developer-skill-os 9.3.1 → 10.2.0

package/.agents/workflows/feature-delivery.yml

@@ -1,124 +1,158 @@
-name: feature-delivery
-version: 8.0.0
-description: "Pipeline end-to-end để phát triển tính năng mới: từ requirement đến verified implementation."
-
-owner:
-  type: engineering
-  maintained_by: qk-team
-
-verification_profile: feature
-
-triggers:
-  - "add feature"
-  - "thêm tính năng"
-  - "implement feature"
-  - "build a new"
-  - "new component"
-  - "làm tính năng mới"
-
-ide_binding:
-  slash_command: "/feature"
-  aliases: ["/build", "/implement"]
-
-steps:
-  - id: requirement
-    name: "Phân tích yêu cầu"
-    purpose: "Xác định rõ feature cần làm gì, cho ai, thành công trông như thế nào"
-    required: true
-    skip_if: null
-    inputs:
-      - user_description
-      - existing_context
-    outputs:
-      - feature_scope        # What's in, what's out
-      - acceptance_criteria  # How to know it's done
-      - affected_areas       # Which parts of codebase are touched
-    min_confidence: HIGH
-    actions:
-      - "Viết lại requirement bằng ngôn ngữ kỹ thuật"
-      - "Xác định acceptance criteria rõ ràng"
-      - "Identify files/modules sẽ bị ảnh hưởng"
-    exit_on_fail: BLOCKED
-
-  - id: context
-    name: "Load context"
-    purpose: "Hiểu codebase hiện tại đủ để implement đúng cách"
-    required: true
-    skip_if: "Context graph đã có từ qk-context-loader"
-    inputs:
-      - affected_areas
-    outputs:
-      - existing_patterns    # How similar things are done in this codebase
-      - integration_points   # Where new code will connect
-      - constraints          # Tech stack, conventions to follow
-    actions:
-      - "Đọc các file liên quan (targeted, không đọc toàn bộ)"
-      - "Tìm pattern tương tự trong codebase"
-      - "Xác định integration points"
-
-  - id: design
-    name: "Thiết kế solution"
-    purpose: "Quyết định approach trước khi code"
-    required: true
-    skip_if: "Feature đơn giản, single file, no design decision needed"
-    inputs:
-      - feature_scope
-      - existing_patterns
-      - constraints
-    outputs:
-      - implementation_plan  # Files to create/modify + what changes
-      - data_structures      # New types, interfaces if needed
-      - api_contract         # If adding/changing API
-    min_confidence: HIGH
-    actions:
-      - "Outline: files to create, files to modify"
-      - "Define data structures và types"
-      - "Xác định API contract nếu cần"
-    human_checkpoint:
-      condition: "affected_areas thuộc complexity level 'high' hoặc 'critical' (5+ files, có external dependency hoặc breaking change)"
-      message: "Feature này có độ phức tạp cao. Xác nhận implementation_plan trước khi bắt đầu code."
-  - id: implement
-    name: "Implement"
-    purpose: "Viết code theo design đã approved"
-    required: true
-    skip_if: null
-    inputs:
-      - implementation_plan
-      - existing_patterns
-    outputs:
-      - created_files
-      - modified_files
-      - implementation_summary
-    actions:
-      - "Implement theo thứ tự: types → logic → UI → tests"
-      - "Follow existing patterns và conventions"
-      - "Code phải tuân thủ nghiêm ngặt R-C-09 (Zero-Slop)"
-      - "Phải validate input/output theo R-SEC-04"
-      - "Không refactor ngoài scope"
-
-  - id: verify
-    name: "Verify implementation"
-    purpose: "Xác nhận feature hoạt động đúng theo acceptance criteria — quality gate bắt buộc"
-    required: true
-    skip_if: null
-    inputs:
-      - acceptance_criteria
-      - created_files
-      - modified_files
-    outputs:
-      - verification_result
-      - unmet_criteria
-      - quality_gate_result   # PASS | PARTIAL | FAIL
-    actions:
-      - "Đối chiếu từng acceptance criterion — list unmet nếu có"
-      - "Re-read key implementation sections"
-      - "Run linter nếu có (npm run lint / ruff / eslint)"
-      - "Run tests nếu có (npm test / pytest / go test)"
-      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
-      - "  Checklist: universal_checks + feature-delivery specific checks"
-      - "Ghi log execution trace vào evals/traces/"
-    exit_on_fail: PARTIAL
-
-escalation:
-  max_retries: 1
-  on_failure: "Report implementation_plan + what was completed + what remains + blocker reason"
+name: feature-delivery
+version: 10.2.0
+platforms: [antigravity, claude, opencode]
+runtime_version: 1
+description: "Pipeline end-to-end để phát triển tính năng mới: từ requirement đến verified implementation."
+
+owner:
+  type: engineering
+  maintained_by: qk-team
+
+verification_profile: feature
+
+triggers:
+  - "add feature"
+  - "thêm tính năng"
+  - "implement feature"
+  - "build a new"
+  - "new component"
+  - "làm tính năng mới"
+
+ide_binding:
+  slash_command: "/feature"
+  aliases: ["/build", "/implement"]
+
+steps:
+  - id: requirement
+    name: "Phân tích yêu cầu"
+    purpose: "Xác định rõ feature cần làm gì, cho ai, thành công trông như thế nào"
+    required: true
+    skip_if: null
+    inputs:
+      - user_description
+      - existing_context
+    outputs:
+      - feature_scope        # What's in, what's out
+      - acceptance_criteria  # How to know it's done
+      - affected_areas       # Which parts of codebase are touched
+    min_confidence: HIGH
+    actions:
+      - "Viết lại requirement bằng ngôn ngữ kỹ thuật"
+      - "Xác định acceptance criteria rõ ràng"
+      - "Identify files/modules sẽ bị ảnh hưởng"
+    exit_on_fail: BLOCKED
+
+  - id: context
+    name: "Load context"
+    purpose: "Hiểu codebase hiện tại đủ để implement đúng cách"
+    required: true
+    skip_if: "Context graph đã có từ qk-orchestrator"
+    inputs:
+      - affected_areas
+    outputs:
+      - existing_patterns    # How similar things are done in this codebase
+      - integration_points   # Where new code will connect
+      - constraints          # Tech stack, conventions to follow
+    actions:
+      - "Đọc các file liên quan (targeted, không đọc toàn bộ)"
+      - "Tìm pattern tương tự trong codebase"
+      - "Xác định integration points"
+
+  - id: design
+    name: "Thiết kế solution"
+    purpose: "Quyết định approach trước khi code"
+    required: true
+    skip_if: "Feature đơn giản, single file, no design decision needed"
+    inputs:
+      - feature_scope
+      - existing_patterns
+      - constraints
+    outputs:
+      - implementation_plan  # Files to create/modify + what changes
+      - data_structures      # New types, interfaces if needed
+      - api_contract         # If adding/changing API
+    min_confidence: HIGH
+    actions:
+      - "Outline: files to create, files to modify"
+      - "Define data structures và types"
+      - "Xác định API contract nếu cần"
+    human_checkpoint:
+      condition: "affected_areas thuộc complexity level 'high' hoặc 'critical' (5+ files, có external dependency hoặc breaking change)"
+      message: "Feature này có độ phức tạp cao. Xác nhận implementation_plan trước khi bắt đầu code."
+  - id: implement
+    name: "Implement"
+    purpose: "Viết code theo design đã approved"
+    required: true
+    skip_if: null
+    inputs:
+      - implementation_plan
+      - existing_patterns
+    outputs:
+      - created_files
+      - modified_files
+      - implementation_summary
+    actions:
+      - "Implement theo thứ tự: types → logic → UI → tests"
+      - "Follow existing patterns và conventions"
+      - "Code phải tuân thủ nghiêm ngặt R-C-09 (Zero-Slop)"
+      - "Phải validate input/output theo R-SEC-04"
+      - "Không refactor ngoài scope"
+
+  - id: verify
+    name: "Verify implementation"
+    purpose: "Xác nhận feature hoạt động đúng theo acceptance criteria — quality gate bắt buộc"
+    required: true
+    skip_if: null
+    inputs:
+      - acceptance_criteria
+      - created_files
+      - modified_files
+    outputs:
+      - verification_result
+      - unmet_criteria
+      - quality_gate_result   # PASS | PARTIAL | FAIL
+    actions:
+      - "Đối chiếu từng acceptance criterion — list unmet nếu có"
+      - "Re-read key implementation sections"
+      - "Run linter nếu có (npm run lint / ruff / eslint)"
+      - "Run tests nếu có (npm test / pytest / go test)"
+      - "Áp dụng shared quality gate → xem: .agents/workflows/shared/quality-gate.yml"
+      - "  Checklist: universal_checks + feature-delivery specific checks"
+      - "Ghi log execution trace vào evals/traces/"
+    exit_on_fail: PARTIAL
+
+escalation:
+  max_retries: 1
+  on_failure: "Report implementation_plan + what was completed + what remains + blocker 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]