universal-dev-standards 5.6.0 → 5.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (98) hide show
  1. package/bundled/ai/standards/agent-communication-protocol.ai.yaml +8 -9
  2. package/bundled/ai/standards/agent-dispatch.ai.yaml +8 -9
  3. package/bundled/ai/standards/branch-completion.ai.yaml +8 -10
  4. package/bundled/ai/standards/capability-declaration.ai.yaml +4 -4
  5. package/bundled/ai/standards/change-batching-standards.ai.yaml +8 -10
  6. package/bundled/ai/standards/circuit-breaker.ai.yaml +7 -7
  7. package/bundled/ai/standards/disaster-recovery-drill.ai.yaml +1 -1
  8. package/bundled/ai/standards/dual-phase-output.ai.yaml +3 -3
  9. package/bundled/ai/standards/execution-history.ai.yaml +8 -10
  10. package/bundled/ai/standards/failure-source-taxonomy.ai.yaml +8 -10
  11. package/bundled/ai/standards/git-worktree.ai.yaml +1 -1
  12. package/bundled/ai/standards/governance-layer.ai.yaml +114 -0
  13. package/bundled/ai/standards/mock-boundary.ai.yaml +1 -1
  14. package/bundled/ai/standards/model-selection.ai.yaml +1 -1
  15. package/bundled/ai/standards/packaging-standards.ai.yaml +8 -8
  16. package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +8 -9
  17. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +4 -0
  18. package/bundled/ai/standards/recovery-recipe-registry.ai.yaml +6 -10
  19. package/bundled/ai/standards/security-decision.ai.yaml +3 -3
  20. package/bundled/ai/standards/server-ops-security.ai.yaml +1 -1
  21. package/bundled/ai/standards/standard-admission-criteria.ai.yaml +1 -1
  22. package/bundled/ai/standards/standard-lifecycle-management.ai.yaml +1 -1
  23. package/bundled/ai/standards/supply-chain-attestation.ai.yaml +1 -1
  24. package/bundled/ai/standards/token-budget.ai.yaml +3 -3
  25. package/bundled/ai/standards/workflow-enforcement.ai.yaml +8 -11
  26. package/bundled/ai/standards/workflow-state-protocol.ai.yaml +8 -10
  27. package/bundled/core/adversarial-test.md +1 -1
  28. package/bundled/core/agent-behavior-discipline.md +4 -4
  29. package/bundled/core/agent-communication-protocol.md +5 -5
  30. package/bundled/core/circuit-breaker.md +4 -4
  31. package/bundled/core/container-security.md +8 -8
  32. package/bundled/core/disaster-recovery-drill.md +3 -3
  33. package/bundled/core/dual-phase-output.md +1 -1
  34. package/bundled/core/failure-source-taxonomy.md +3 -3
  35. package/bundled/core/git-worktree.md +1 -1
  36. package/bundled/core/governance-layer.md +151 -0
  37. package/bundled/core/llm-output-validation.md +2 -2
  38. package/bundled/core/mock-boundary.md +1 -1
  39. package/bundled/core/packaging-standards.md +14 -14
  40. package/bundled/core/policy-as-code-testing.md +9 -9
  41. package/bundled/core/recovery-recipe-registry.md +2 -2
  42. package/bundled/core/release-quality-manifest.md +2 -2
  43. package/bundled/core/sast-advanced.md +5 -5
  44. package/bundled/core/secure-op.md +5 -5
  45. package/bundled/core/security-decision.md +1 -1
  46. package/bundled/core/server-ops-security.md +15 -15
  47. package/bundled/core/smoke-test.md +1 -1
  48. package/bundled/core/standard-admission-criteria.md +1 -1
  49. package/bundled/core/standard-lifecycle-management.md +1 -1
  50. package/bundled/core/supply-chain-attestation.md +4 -4
  51. package/bundled/core/token-budget.md +3 -3
  52. package/bundled/locales/zh-CN/CHANGELOG.md +65 -4
  53. package/bundled/locales/zh-CN/README.md +11 -27
  54. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +5 -5
  55. package/bundled/locales/zh-CN/core/circuit-breaker.md +1 -1
  56. package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
  57. package/bundled/locales/zh-CN/core/packaging-standards.md +14 -14
  58. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +6 -9
  59. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +1 -1
  60. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +1 -1
  61. package/bundled/locales/zh-CN/core/token-budget.md +1 -1
  62. package/bundled/locales/zh-TW/CHANGELOG.md +65 -4
  63. package/bundled/locales/zh-TW/README.md +11 -27
  64. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +5 -5
  65. package/bundled/locales/zh-TW/core/capability-declaration.md +4 -4
  66. package/bundled/locales/zh-TW/core/circuit-breaker.md +7 -7
  67. package/bundled/locales/zh-TW/core/dual-phase-output.md +3 -3
  68. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +7 -9
  69. package/bundled/locales/zh-TW/core/governance-layer.md +159 -0
  70. package/bundled/locales/zh-TW/core/packaging-standards.md +14 -14
  71. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +6 -9
  72. package/bundled/locales/zh-TW/core/security-decision.md +3 -3
  73. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +1 -1
  74. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +1 -1
  75. package/bundled/locales/zh-TW/core/token-budget.md +3 -3
  76. package/bundled/skills/README.md +23 -0
  77. package/bundled/skills/atdd-assistant/SKILL.md +4 -5
  78. package/bundled/skills/bdd-assistant/SKILL.md +4 -5
  79. package/bundled/skills/checkin-assistant/SKILL.md +4 -6
  80. package/bundled/skills/code-review-assistant/SKILL.md +4 -5
  81. package/bundled/skills/commands/observability.md +42 -0
  82. package/bundled/skills/commands/runbook.md +44 -0
  83. package/bundled/skills/commands/slo.md +45 -0
  84. package/bundled/skills/journey-test-assistant/SKILL.md +1 -1
  85. package/bundled/skills/orchestrate/SKILL.md +1 -1
  86. package/bundled/skills/plan/SKILL.md +1 -1
  87. package/bundled/skills/pr-automation-assistant/SKILL.md +4 -5
  88. package/bundled/skills/push/SKILL.md +1 -1
  89. package/bundled/skills/spec-driven-dev/SKILL.md +4 -5
  90. package/bundled/skills/sweep/SKILL.md +3 -3
  91. package/bundled/skills/tdd-assistant/SKILL.md +4 -5
  92. package/package.json +1 -1
  93. package/src/commands/flow.js +7 -5
  94. package/src/commands/start.js +7 -6
  95. package/src/commands/sweep.js +7 -6
  96. package/src/commands/workflow.js +7 -6
  97. package/src/core/agent-communication-protocol.js +10 -3
  98. package/standards-registry.json +50 -50
@@ -1,6 +1,6 @@
1
1
  # Agent Communication Protocol - DEPRECATED STUB
2
- # This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
3
- # Canonical location: dev-autopilot/standards/orchestration/agent-communication-protocol.ai.yaml
2
+ # Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
3
+ # Adoption layer must implement an equivalent runtime; UDS retains only the human-readable concept under core/.
4
4
  # Migration: XSPEC-086 Phase 2 (2026-04-27)
5
5
  #
6
6
  # Human-readable standard: core/agent-communication-protocol.md (remains in UDS)
@@ -14,20 +14,19 @@ standard:
14
14
  deprecated: true
15
15
  deprecated_since: "5.4.0"
16
16
  removal_version: "6.0.0"
17
- canonical_owner: devap
18
- canonical_path: "dev-autopilot/standards/orchestration/agent-communication-protocol.ai.yaml"
17
+ canonical_owner: adoption-layer
18
+ canonical_path: "" # adoption-layer responsibility
19
19
  source: core/agent-communication-protocol.md
20
20
  description: >
21
- DEPRECATED: This standard has moved to DevAP (orchestration layer).
22
- Install DevAP and load standards/orchestration/agent-communication-protocol.ai.yaml instead.
21
+ DEPRECATED: Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
22
+ Adoption layer must implement an equivalent runtime.
23
23
 
24
24
  rules:
25
25
  - id: deprecation-notice
26
26
  trigger: any agent communication operation
27
27
  instruction: >
28
- This standard (agent-communication-protocol.ai.yaml) has been migrated to DevAP.
28
+ Runtime details for this standard are now adoption-layer responsibility (runtime moved to adoption layer 2026-04-28).
29
29
  For the canonical executable definition, load:
30
- dev-autopilot/standards/orchestration/agent-communication-protocol.ai.yaml
31
30
 
32
31
  The human-readable standard remains at:
33
32
  universal-dev-standards/core/agent-communication-protocol.md
@@ -36,7 +35,7 @@ standard:
36
35
  - id: ACP-001
37
36
  trigger: "訊息缺少必要欄位"
38
37
  instruction: >
39
- DEPRECATED — load dev-autopilot/standards/orchestration/agent-communication-protocol.ai.yaml
38
+ DEPRECATED — see universal-dev-standards/core/ for human-readable concept; runtime is adoption-layer responsibility
40
39
  for the current executable communication protocol.
41
40
 
42
41
  Minimal fallback: Reject messages missing required Envelope fields and report INVALID_ENVELOPE.
@@ -1,6 +1,6 @@
1
1
  # Agent Dispatch & Parallel Coordination - DEPRECATED STUB
2
- # This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
3
- # Canonical location: dev-autopilot/standards/orchestration/agent-dispatch.ai.yaml
2
+ # Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
3
+ # Adoption layer must implement an equivalent runtime; UDS retains only the human-readable concept under core/.
4
4
  # Migration: XSPEC-086 Phase 2 (2026-04-27)
5
5
  #
6
6
  # Human-readable standard: core/agent-dispatch.md (remains in UDS)
@@ -14,20 +14,19 @@ standard:
14
14
  deprecated: true
15
15
  deprecated_since: "5.4.0"
16
16
  removal_version: "6.0.0"
17
- canonical_owner: devap
18
- canonical_path: "dev-autopilot/standards/orchestration/agent-dispatch.ai.yaml"
17
+ canonical_owner: adoption-layer
18
+ canonical_path: "" # adoption-layer responsibility
19
19
  source: core/agent-dispatch.md
20
20
  description: >
21
- DEPRECATED: This standard has moved to DevAP (orchestration layer).
22
- Install DevAP and load standards/orchestration/agent-dispatch.ai.yaml instead.
21
+ DEPRECATED: Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
22
+ Adoption layer must implement an equivalent runtime.
23
23
 
24
24
  rules:
25
25
  - id: deprecation-notice
26
26
  trigger: any agent dispatch operation
27
27
  instruction: >
28
- This standard (agent-dispatch.ai.yaml) has been migrated to DevAP.
28
+ Runtime details for this standard are now adoption-layer responsibility (runtime moved to adoption layer 2026-04-28).
29
29
  For the canonical executable definition, load:
30
- dev-autopilot/standards/orchestration/agent-dispatch.ai.yaml
31
30
 
32
31
  The human-readable standard remains at:
33
32
  universal-dev-standards/core/agent-dispatch.md
@@ -36,7 +35,7 @@ standard:
36
35
  - id: AD-003
37
36
  trigger: "所有並行代理完成"
38
37
  instruction: >
39
- DEPRECATED — load dev-autopilot/standards/orchestration/agent-dispatch.ai.yaml
38
+ DEPRECATED — see universal-dev-standards/core/ for human-readable concept; runtime is adoption-layer responsibility
40
39
  for the current executable dispatch protocol.
41
40
 
42
41
  Minimal fallback: Run full test suite after all parallel agents complete.
@@ -1,6 +1,6 @@
1
1
  # Branch Completion Workflow - DEPRECATED STUB
2
- # This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
3
- # Canonical location: dev-autopilot/standards/flow/branch-completion.ai.yaml
2
+ # Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
3
+ # Adoption layer must implement an equivalent runtime; UDS retains only the human-readable concept under core/.
4
4
  # Migration: XSPEC-086 Phase 2 (2026-04-27)
5
5
  #
6
6
  # Human-readable standard: core/branch-completion.md (remains in UDS)
@@ -14,31 +14,29 @@ standard:
14
14
  deprecated: true
15
15
  deprecated_since: "5.4.0"
16
16
  removal_version: "6.0.0"
17
- canonical_owner: devap
18
- canonical_path: "dev-autopilot/standards/flow/branch-completion.ai.yaml"
17
+ canonical_owner: adoption-layer
18
+ canonical_path: "" # adoption-layer responsibility
19
19
  source: core/branch-completion.md
20
20
  description: >
21
- DEPRECATED: This standard has moved to DevAP (flow orchestration layer).
22
- Install DevAP and load standards/flow/branch-completion.ai.yaml instead.
21
+ DEPRECATED: Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
22
+ Adoption layer must implement an equivalent runtime.
23
23
 
24
24
  rules:
25
25
  - id: deprecation-notice
26
26
  trigger: any branch completion operation
27
27
  instruction: >
28
- This standard (branch-completion.ai.yaml) has been migrated to DevAP.
28
+ Runtime details for this standard are now adoption-layer responsibility (runtime moved to adoption layer 2026-04-28).
29
29
  For the canonical executable definition, load:
30
- dev-autopilot/standards/flow/branch-completion.ai.yaml
31
30
 
32
31
  The human-readable standard remains at:
33
32
  universal-dev-standards/core/branch-completion.md
34
33
 
35
- To install DevAP: npm install -g @devap/cli
36
34
  priority: required
37
35
 
38
36
  - id: BC-003
39
37
  trigger: "前置條件未滿足"
40
38
  instruction: >
41
- DEPRECATED — load dev-autopilot/standards/flow/branch-completion.ai.yaml
39
+ DEPRECATED — see universal-dev-standards/core/ for human-readable concept; runtime is adoption-layer responsibility
42
40
  for the current executable branch completion flow.
43
41
 
44
42
  Minimal fallback: Block branch completion when prerequisites (tests, lint,
@@ -100,10 +100,10 @@ standard:
100
100
  consequence: "記錄 CAPABILITY_MISMATCH 事件,降級至 FAIL_CLOSED_DEFAULTS"
101
101
 
102
102
  applicable_components:
103
- - "DevAP AgentAdapter(ClaudeAdapter / OpenCodeAdapter / CliAdapter"
104
- - "DevAP Tool 呼叫系統"
105
- - "VibeOps ToolExecutor"
106
- - "VibeOps Agentplanner / builder / evaluator 等)"
103
+ - "AgentAdapter implementations (e.g., ClaudeAdapter / OpenCodeAdapter / CliAdapter at the adoption layer)"
104
+ - "Tool 呼叫系統(採用層 runtime)"
105
+ - "ToolExecutor 實作(採用層)"
106
+ - "Agent(採用層;planner / builder / evaluator 等角色)"
107
107
  - "所有 MCP 工具插件"
108
108
 
109
109
  error_codes:
@@ -1,6 +1,6 @@
1
1
  # Change Batching Standards - DEPRECATED STUB
2
- # This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
3
- # Canonical location: dev-autopilot/standards/flow/change-batching-standards.ai.yaml
2
+ # Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
3
+ # Adoption layer must implement an equivalent runtime; UDS retains only the human-readable concept under core/.
4
4
  # Migration: XSPEC-086 Phase 2 (2026-04-27)
5
5
  #
6
6
  # Human-readable standard: core/change-batching-standards.md (remains in UDS)
@@ -14,31 +14,29 @@ standard:
14
14
  deprecated: true
15
15
  deprecated_since: "5.4.0"
16
16
  removal_version: "6.0.0"
17
- canonical_owner: devap
18
- canonical_path: "dev-autopilot/standards/flow/change-batching-standards.ai.yaml"
17
+ canonical_owner: adoption-layer
18
+ canonical_path: "" # adoption-layer responsibility
19
19
  source: core/change-batching-standards.md
20
20
  description: >
21
- DEPRECATED: This standard has moved to DevAP (flow orchestration layer).
22
- Install DevAP and load standards/flow/change-batching-standards.ai.yaml instead.
21
+ DEPRECATED: Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
22
+ Adoption layer must implement an equivalent runtime.
23
23
 
24
24
  rules:
25
25
  - id: deprecation-notice
26
26
  trigger: any batch change operation
27
27
  instruction: >
28
- This standard (change-batching-standards.ai.yaml) has been migrated to DevAP.
28
+ Runtime details for this standard are now adoption-layer responsibility (runtime moved to adoption layer 2026-04-28).
29
29
  For the canonical executable definition, load:
30
- dev-autopilot/standards/flow/change-batching-standards.ai.yaml
31
30
 
32
31
  The human-readable standard remains at:
33
32
  universal-dev-standards/core/change-batching-standards.md
34
33
 
35
- To install DevAP: npm install -g @devap/cli
36
34
  priority: required
37
35
 
38
36
  - id: atomic-commits
39
37
  trigger: merging a batch
40
38
  instruction: >
41
- DEPRECATED — load dev-autopilot/standards/flow/change-batching-standards.ai.yaml
39
+ DEPRECATED — see universal-dev-standards/core/ for human-readable concept; runtime is adoption-layer responsibility
42
40
  for the current executable batch orchestration rules.
43
41
 
44
42
  Minimal fallback: Enforce all-or-nothing batch merging — either all changes
@@ -20,7 +20,7 @@ standard:
20
20
  - "任何重試機制必須使用斷路器包裝,不得直接無限重試"
21
21
  - "斷路器狀態必須透過遙測可觀測(circuit_breaker_state_change 事件)"
22
22
  - "OPEN 狀態下的請求必須立即失敗(fail fast),不等待 timeout"
23
- - "failureThreshold 預設值為 3,與 claude-code-book DevAP Fix Loop 一致"
23
+ - "failureThreshold 預設值為 3,與 claude-code-book 及常見 Fix Loop 實作慣例一致"
24
24
  - "斷路器必須按照「功能單元」建立,不得全域共享單一斷路器"
25
25
 
26
26
  states:
@@ -80,12 +80,12 @@ standard:
80
80
  when: "每次狀態轉換時上傳"
81
81
 
82
82
  applicable_scenarios:
83
- - "DevAP Fix Loop Agent 呼叫重試"
84
- - "DevAP Judge / Quality Gate 重試"
85
- - "DevAP API 呼叫(LLM API 不穩定保護)"
86
- - "VibeOps Feedback Loop 重試"
87
- - "VibeOps FLARE 主動檢索重試"
88
- - "VibeOps AutoCompact(原始靈感來源)"
83
+ - "Fix Loop Agent 呼叫重試(採用層)"
84
+ - "Judge / Quality Gate 重試(採用層)"
85
+ - "LLM API 呼叫(不穩定保護)"
86
+ - "Feedback Loop 重試(採用層)"
87
+ - "FLARE 主動檢索重試(採用層)"
88
+ - "AutoCompact 風格的對話壓縮重試(claude-code-book 為原始靈感來源)"
89
89
 
90
90
  error_codes:
91
91
  CB-001: "CIRCUIT_OPEN — 斷路器開路,請求被拒絕"
@@ -20,7 +20,7 @@ requirements:
20
20
  (Recovery Point Objective) targets. These must be agreed with stakeholders
21
21
  before any DR drill can be considered meaningful.
22
22
  examples:
23
- - "VibeOps commercial: RTO < 1 hour, RPO < 24 hours (daily backup)"
23
+ - "Commercial-grade SaaS example: RTO < 1 hour, RPO < 24 hours (daily backup)"
24
24
 
25
25
  - id: REQ-02
26
26
  title: Backup Restore Test
@@ -97,9 +97,9 @@ standard:
97
97
  note: "Savings accumulate in repeated review scenarios (Fix Loop, Feedback Loop)"
98
98
 
99
99
  applicable_agents:
100
- - DevAP Judge Agent
101
- - VibeOps Evaluator Agent
102
- - VibeOps Guardian Agent
100
+ - Judge Agent (adoption layer)
101
+ - Evaluator Agent (adoption layer)
102
+ - Guardian Agent (adoption layer)
103
103
  - Any LLM-driven AutoCompact / summarization component
104
104
 
105
105
  error_codes:
@@ -1,6 +1,6 @@
1
1
  # Execution History Repository Standards - DEPRECATED STUB
2
- # This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
3
- # Canonical location: dev-autopilot/standards/orchestration/execution-history.ai.yaml
2
+ # Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
3
+ # Adoption layer must implement an equivalent runtime; UDS retains only the human-readable concept under core/.
4
4
  # Migration: XSPEC-086 Phase 2 (2026-04-27)
5
5
  #
6
6
  # Source spec: cross-project/specs/XSPEC-003-execution-history-standard-sdd.md
@@ -14,29 +14,27 @@ standard:
14
14
  deprecated: true
15
15
  deprecated_since: "5.4.0"
16
16
  removal_version: "6.0.0"
17
- canonical_owner: devap
18
- canonical_path: "dev-autopilot/standards/orchestration/execution-history.ai.yaml"
17
+ canonical_owner: adoption-layer
18
+ canonical_path: "" # adoption-layer responsibility
19
19
  source: cross-project/specs/XSPEC-003-execution-history-standard-sdd.md
20
20
  description: >
21
- DEPRECATED: This standard has moved to DevAP (orchestration layer).
22
- Install DevAP and load standards/orchestration/execution-history.ai.yaml instead.
21
+ DEPRECATED: Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
22
+ Adoption layer must implement an equivalent runtime.
23
23
 
24
24
  rules:
25
25
  - id: deprecation-notice
26
26
  trigger: any execution history operation
27
27
  instruction: >
28
- This standard (execution-history.ai.yaml) has been migrated to DevAP.
28
+ Runtime details for this standard are now adoption-layer responsibility (runtime moved to adoption layer 2026-04-28).
29
29
  For the canonical executable definition, load:
30
- dev-autopilot/standards/orchestration/execution-history.ai.yaml
31
30
 
32
- Note: DevAP's packages/core already implements execution history (ExecutionHistoryStorage).
33
31
  The YAML standard is now co-located with the implementation.
34
32
  priority: required
35
33
 
36
34
  - id: record-on-completion
37
35
  trigger: "Agent 任務執行完畢"
38
36
  instruction: >
39
- DEPRECATED — load dev-autopilot/standards/orchestration/execution-history.ai.yaml
37
+ DEPRECATED — see universal-dev-standards/core/ for human-readable concept; runtime is adoption-layer responsibility
40
38
  for the current executable history protocol.
41
39
 
42
40
  Minimal fallback: Write required artifacts to .execution-history/{task-id}/{run-number}/
@@ -22,7 +22,7 @@ standard:
22
22
  - "failureSource 為 optional 欄位,不得破壞現有不含此欄位的程式碼"
23
23
  - "在同一失敗事件中,選擇最根本的來源作為 failureSource(例如 branch_divergence 比 compilation 更根本)"
24
24
  - "failureSource 應由偵測到失敗的元件設定(QualityGate / Adapter / SafetyHook / BranchDriftChecker)"
25
- - "跨專案(DevAP / VibeOps)各自獨立定義 FailureSource type,語義保持一致"
25
+ - "各採用層各自獨立定義 FailureSource type,語義保持一致(避免跨層耦合)"
26
26
 
27
27
  failure_sources:
28
28
  prompt_delivery:
@@ -103,13 +103,11 @@ standard:
103
103
  - "resource_exhaustion > 其他(資源耗盡時無意義重試)"
104
104
  - "其他情況取最先偵測到的來源"
105
105
 
106
+ # Integration guidance (informative only; concrete file paths are
107
+ # adoption-layer concerns and intentionally omitted from the standard).
106
108
  integration_points:
107
- devap:
108
- files:
109
- - "packages/core/src/types.tsTaskResult.failureSource / FailureSource type"
110
- - "packages/core/src/quality-gate.tsQualityGateResult.failureSource 推斷"
111
- - "packages/adapter-claude/src/claude-adapter.tsresource_exhaustion 映射"
112
- vibeops:
113
- files:
114
- - "src/types/index.ts — IterationRecord.failureSource(獨立定義,AGPL 隔離)"
115
- - "src/runner/pipeline-runner.ts — agent:error 事件 payload"
109
+ expected_call_sites:
110
+ - "core types module — TaskResult.failureSource / FailureSource type"
111
+ - "quality-gate module QualityGateResult.failureSource 推斷"
112
+ - "agent adapter resource_exhaustion / network_error 映射"
113
+ - "pipeline runner agent:error / agent:retry 事件 payload"
@@ -23,7 +23,7 @@ standard:
23
23
  lifecycle:
24
24
  - phase: setup
25
25
  steps:
26
- - "選擇 worktree 目錄位置(優先順序:existing → .devap/worktrees → 詢問使用者)"
26
+ - "選擇 worktree 目錄位置(優先順序:existing → .uds/worktrees → 詢問使用者)"
27
27
  - "執行 git check-ignore 確認目錄被忽略"
28
28
  - "建立 worktree + 新分支"
29
29
  - "安裝依賴(若需要)"
@@ -0,0 +1,114 @@
1
+ # Governance Layer Standard - AI Optimized
2
+ # Source: core/governance-layer.md
3
+
4
+ id: governance-layer
5
+ meta:
6
+ version: "1.0.0"
7
+ updated: "2026-05-07"
8
+ source: core/governance-layer.md
9
+ description: "治理層標準(Vision/Mission/Goals 三層架構 + KPI + 紅線清單)"
10
+ scope: universal
11
+ priority: meta
12
+
13
+ # This is Standard #0 — evaluated before all other standards
14
+ priority_order:
15
+ rule: "Governance layer overrides all other standards on conflict"
16
+ resolution_order:
17
+ 1: governance-layer (this standard)
18
+ 2: domain standards (testing, commit, deployment, etc.)
19
+ 3: project-specific overrides
20
+
21
+ # Three-layer schema requirements
22
+ schema:
23
+ vision:
24
+ required: true
25
+ format: "Single sentence, ≤ 50 tokens"
26
+ content: "Long-term direction; timeless; no metrics"
27
+ change_frequency: annual
28
+
29
+ mission:
30
+ required: true
31
+ format: "3–5 commitments + red_lines table (≤ 300 tokens total)"
32
+ content: "What we do / don't do; red lines with trigger conditions + actions"
33
+ change_frequency: quarterly
34
+ red_lines:
35
+ required_fields:
36
+ - id # Unique identifier (e.g., R1, GUARD-001)
37
+ - category # quality | safety | compliance | ethics
38
+ - clause # Human-readable forbidden/required statement
39
+ - action # block | warn | escalate_to_human
40
+ recommended_fields:
41
+ - mission_clause_ref # Reference to the mission commitment this enforces
42
+
43
+ goals:
44
+ required: true
45
+ format: "KPI table, ≤ 500 tokens"
46
+ change_frequency: per_sprint
47
+ falsifiability: "Every KPI must be measurable — no 'improve', 'enhance', 'better'"
48
+ kpi:
49
+ required_fields:
50
+ - id # Unique identifier (e.g., KPI-01)
51
+ - metric_name # Name of the tracked metric
52
+ - threshold # Quantified target (e.g., ≥ 95%, < 200 ms)
53
+ - measurement_method # How and when the metric is measured
54
+
55
+ # Red line action semantics
56
+ red_line_actions:
57
+ block:
58
+ description: "Halt pipeline immediately; do not proceed"
59
+ warn:
60
+ description: "Log violation and continue; escalate if threshold exceeded"
61
+ escalate_to_human:
62
+ description: "Pause and require human decision before continuing"
63
+
64
+ # AI evaluator integration
65
+ evaluator:
66
+ scoring_axes:
67
+ correctness:
68
+ weight: 0.4
69
+ veto_threshold: 0.3
70
+ mission_alignment:
71
+ weight: 0.3
72
+ veto_threshold: 0.3
73
+ goal_achievement:
74
+ weight: 0.3
75
+ veto_threshold: 0.3
76
+ veto_rule: "Any single axis < 0.3 → FAIL regardless of weighted sum"
77
+
78
+ # Risk acceptance for relaxed gates
79
+ risk_acceptance:
80
+ trigger: "gate.mode = trace_only (or any human gate bypass)"
81
+ required_fields:
82
+ - date
83
+ - signatory
84
+ - gates_bypassed
85
+ - risks_accepted
86
+ fail_closed: "Pipeline MUST refuse to start without a valid Risk Acceptance Clause"
87
+
88
+ # Governance file structure
89
+ file_structure:
90
+ directory: "governance/"
91
+ files:
92
+ - name: "vision.md"
93
+ content: "Single-sentence vision statement"
94
+ - name: "mission.md"
95
+ content: "Commitments + red lines table; Risk Acceptance Clause if applicable"
96
+ - name: "goals.md"
97
+ content: "KPI table (updated each Sprint)"
98
+
99
+ # Compliance checklist (AI-verifiable)
100
+ compliance_checks:
101
+ - id: CK-01
102
+ check: "Vision is a single sentence ≤ 50 tokens with no metrics"
103
+ - id: CK-02
104
+ check: "Mission has 3–5 commitments and a red_lines table"
105
+ - id: CK-03
106
+ check: "Every red line has: id, category, clause, action"
107
+ - id: CK-04
108
+ check: "Goals table present with all KPIs containing required fields"
109
+ - id: CK-05
110
+ check: "No KPI uses vague language (improve / enhance / better)"
111
+ - id: CK-06
112
+ check: "If gate.mode=trace_only, Risk Acceptance Clause exists in mission.md"
113
+ - id: CK-07
114
+ check: "Evaluator weights 0.4/0.3/0.3 with fail-closed veto at < 0.3"
@@ -20,7 +20,7 @@ core_problem:
20
20
  a specification of mock behavior rather than system behavior.
21
21
  The tests pass in CI while the real system silently fails.
22
22
  real_world_example: |
23
- // SPEC-002.test.ts (VibeOps) — hollow test example
23
+ // SPEC-002.test.ts (multi-agent pipeline project) — hollow test example
24
24
  vi.mock('../../src/runner/agent-runner.js') // Core dependency mocked
25
25
  vi.mock('../../src/runner/guardian-hooks.js') // Core dependency mocked
26
26
  vi.mock('../../src/runner/prototyper.js') // Core dependency mocked
@@ -103,7 +103,7 @@ standard:
103
103
  description: "數學推理準確率"
104
104
  benchmark: "gsm8k"
105
105
  instruction_following:
106
- description: "複雜多步驟指令遵循率(VibeOps 最重視)"
106
+ description: "複雜多步驟指令遵循率(多 Agent pipeline 場景最重視)"
107
107
  benchmark: "internal-instruction-bench"
108
108
  long_context_quality:
109
109
  description: "長文件中間段資訊存取(Lost-in-the-Middle)"
@@ -4,12 +4,12 @@
4
4
  standard:
5
5
  id: packaging
6
6
  name: Packaging Standards
7
- description: Recipe-based packaging framework for user projects using UDS/DevAP toolchain
7
+ description: Recipe-based packaging framework for user projects using a UDS-aware toolchain
8
8
  guidelines:
9
9
  - "Recipe-based: use built-in or custom recipes for each packaging target"
10
- - "Declarative: declare targets in .devap/packaging.yaml"
10
+ - "Declarative: declare targets in your project's packaging config (path is adoption-layer specific)"
11
11
  - "Customizable: override config, inject hooks, or write custom recipes"
12
- - "Pipeline-integrated: packaging runs between Review and Deploy in VibeOps"
12
+ - "Pipeline-integrated: packaging runs between Review and Deploy in the adoption-layer pipeline"
13
13
 
14
14
  meta:
15
15
  version: "1.0.0"
@@ -19,7 +19,7 @@ standard:
19
19
  principles:
20
20
  core:
21
21
  - recipe_based: "Every packaging target references a named Recipe; no ad-hoc scripts in pipeline YAML"
22
- - declarative_targets: "Projects declare targets in .devap/packaging.yaml; DevAP resolves and executes"
22
+ - declarative_targets: "Projects declare targets in their packaging config (file path is adoption-layer specific); the adoption-layer runtime resolves and executes"
23
23
  - customizable: "Four customization layers allow config overrides, hook injection, custom Recipes, and escape hatches"
24
24
  - pipeline_integrated: "Packaging runs as a named stage between Review and Deploy"
25
25
 
@@ -82,15 +82,15 @@ built_in_recipes:
82
82
  customization_layers:
83
83
  L1:
84
84
  name: config_override
85
- mechanism: "config: block in .devap/packaging.yaml"
85
+ mechanism: "config: block in .uds/packaging.yaml"
86
86
  when: "Change default values (registry URL, tag, output dir)"
87
87
  L2:
88
88
  name: hook_injection
89
- mechanism: "hooks: block in .devap/packaging.yaml"
89
+ mechanism: "hooks: block in .uds/packaging.yaml"
90
90
  when: "Run extra commands before/after build or publish"
91
91
  L3:
92
92
  name: custom_recipe
93
- mechanism: "New .yaml file in project's .devap/recipes/"
93
+ mechanism: "New .yaml file in project's .uds/recipes/"
94
94
  when: "Entirely different build process; built-ins don't apply"
95
95
  L4:
96
96
  name: escape_hatch
@@ -138,5 +138,5 @@ recipe_selection_guide:
138
138
  physical_spec:
139
139
  type: custom_script
140
140
  validator:
141
- command: "test -f .devap/packaging.yaml"
141
+ command: "test -f .uds/packaging.yaml"
142
142
  rule: "packaging_config_declared"
@@ -1,6 +1,6 @@
1
1
  # Pipeline Integration Standards - DEPRECATED STUB
2
- # This file has been migrated to DevAP per DEC-049 (UDS/DevAP responsibility split).
3
- # Canonical location: dev-autopilot/standards/flow/pipeline-integration-standards.ai.yaml
2
+ # Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
3
+ # Adoption layer must implement an equivalent runtime; UDS retains only the human-readable concept under core/.
4
4
  # Migration: XSPEC-086 Phase 2 (2026-04-27)
5
5
  #
6
6
  # Human-readable standard: core/pipeline-integration-standards.md (remains in UDS)
@@ -14,20 +14,19 @@ standard:
14
14
  deprecated: true
15
15
  deprecated_since: "5.4.0"
16
16
  removal_version: "6.0.0"
17
- canonical_owner: devap
18
- canonical_path: "dev-autopilot/standards/flow/pipeline-integration-standards.ai.yaml"
17
+ canonical_owner: adoption-layer
18
+ canonical_path: "" # adoption-layer responsibility
19
19
  source: core/pipeline-integration-standards.md
20
20
  description: >
21
- DEPRECATED: This standard has moved to DevAP (flow orchestration layer).
22
- Install DevAP and load standards/flow/pipeline-integration-standards.ai.yaml instead.
21
+ DEPRECATED: Runtime details relocated to adoption layer (runtime moved to adoption layer 2026-04-28).
22
+ Adoption layer must implement an equivalent runtime.
23
23
 
24
24
  rules:
25
25
  - id: deprecation-notice
26
26
  trigger: starting pipeline execution
27
27
  instruction: >
28
- This standard (pipeline-integration-standards.ai.yaml) has been migrated to DevAP.
28
+ Runtime details for this standard are now adoption-layer responsibility (runtime moved to adoption layer 2026-04-28).
29
29
  For the canonical executable definition, load:
30
- dev-autopilot/standards/flow/pipeline-integration-standards.ai.yaml
31
30
 
32
31
  The human-readable standard remains at:
33
32
  universal-dev-standards/core/pipeline-integration-standards.md
@@ -36,7 +35,7 @@ standard:
36
35
  - id: fail-safe-defaults
37
36
  trigger: toggle not found in configuration
38
37
  instruction: >
39
- DEPRECATED — load dev-autopilot/standards/flow/pipeline-integration-standards.ai.yaml
38
+ DEPRECATED — see universal-dev-standards/core/ for human-readable concept; runtime is adoption-layer responsibility
40
39
  for the current executable pipeline integration rules.
41
40
 
42
41
  Minimal fallback: Default all unset pipeline toggles to OFF (manual mode).
@@ -1,5 +1,9 @@
1
1
  # Pipeline Security Gates (AI-Optimized v1)
2
2
  # Source: core/pipeline-security-gates.md
3
+ # DEPRECATION NOTICE (XSPEC-086 Phase 3, 2026-04-28):
4
+ # Security gate orchestration (pipeline stage ordering, escalation flow) is now
5
+ # adoption-layer responsibility — UDS no longer ships an executable runtime.
6
+ # This file retains gate definitions, tools, severity levels, and failure_behavior only.
3
7
 
4
8
  standard:
5
9
  id: pipeline-security-gates
@@ -187,14 +187,10 @@ standard:
187
187
  on_exhaust: RecoveryStrategy
188
188
  message: "string (optional)"
189
189
 
190
+ # Integration guidance (informative; concrete file paths are adoption-layer concerns).
190
191
  integration_points:
191
- devap:
192
- files:
193
- - "packages/core/src/types.tsRecoveryRecipe / RecoveryStrategy type"
194
- - "packages/core/src/recovery-registry.tsRegistry 實作與預設 recipe"
195
- - "packages/core/src/orchestrator.tsfix loop 前查詢 Registry"
196
- vibeops:
197
- files:
198
- - "src/types/index.ts — 獨立定義 RecoveryRecipe(AGPL 隔離)"
199
- - "src/runner/recovery-registry.ts — 獨立實作"
200
- - "recovery-recipes.yaml — 預設 recipe 配置"
192
+ expected_call_sites:
193
+ - "core types module — RecoveryRecipe / RecoveryStrategy type"
194
+ - "recovery-registry module Registry 實作與預設 recipe"
195
+ - "orchestrator module fix loop 前查詢 Registry"
196
+ - "recovery-recipes config 預設 recipe 配置(檔名由採用層決定)"
@@ -76,9 +76,9 @@ standard:
76
76
  message: "[WARN] projectSettings security override rejected: {operation}"
77
77
 
78
78
  applicable_components:
79
- - "DevAP Safety Hook"
80
- - "VibeOps CommandPolicy"
81
- - "VibeOps Governance Framework (SPEC-049)"
79
+ - "Safety Hook 實作(採用層)"
80
+ - "CommandPolicy 實作(採用層)"
81
+ - "Governance Framework(採用層;OPA / Cedar / 自訂 policy engine 皆可)"
82
82
  - "任何多來源規則合併的安全仲裁場景"
83
83
 
84
84
  error_codes:
@@ -180,7 +180,7 @@ categories:
180
180
  aws: [Security Groups, NACLs, VPC Flow Logs]
181
181
  gcp: [VPC Firewall Rules, Cloud Armor]
182
182
  outbound_allowlist_format: |
183
- # Example: /etc/vibeops/outbound-allowlist.conf
183
+ # Example: /etc/ai-agent/outbound-allowlist.conf
184
184
  ALLOW api.openai.com:443
185
185
  ALLOW registry.npmjs.org:443
186
186
  DENY *:* (default deny)