universal-dev-standards 5.6.0 → 5.7.0
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.
- package/bundled/ai/standards/agent-communication-protocol.ai.yaml +8 -9
- package/bundled/ai/standards/agent-dispatch.ai.yaml +8 -9
- package/bundled/ai/standards/branch-completion.ai.yaml +8 -10
- package/bundled/ai/standards/capability-declaration.ai.yaml +4 -4
- package/bundled/ai/standards/change-batching-standards.ai.yaml +8 -10
- package/bundled/ai/standards/circuit-breaker.ai.yaml +7 -7
- package/bundled/ai/standards/disaster-recovery-drill.ai.yaml +1 -1
- package/bundled/ai/standards/dual-phase-output.ai.yaml +3 -3
- package/bundled/ai/standards/execution-history.ai.yaml +8 -10
- package/bundled/ai/standards/failure-source-taxonomy.ai.yaml +8 -10
- package/bundled/ai/standards/git-worktree.ai.yaml +1 -1
- package/bundled/ai/standards/governance-layer.ai.yaml +114 -0
- package/bundled/ai/standards/mock-boundary.ai.yaml +1 -1
- package/bundled/ai/standards/model-selection.ai.yaml +1 -1
- package/bundled/ai/standards/packaging-standards.ai.yaml +8 -8
- package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +8 -9
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +4 -0
- package/bundled/ai/standards/recovery-recipe-registry.ai.yaml +6 -10
- package/bundled/ai/standards/security-decision.ai.yaml +3 -3
- package/bundled/ai/standards/server-ops-security.ai.yaml +1 -1
- package/bundled/ai/standards/standard-admission-criteria.ai.yaml +1 -1
- package/bundled/ai/standards/standard-lifecycle-management.ai.yaml +1 -1
- package/bundled/ai/standards/supply-chain-attestation.ai.yaml +1 -1
- package/bundled/ai/standards/token-budget.ai.yaml +3 -3
- package/bundled/ai/standards/workflow-enforcement.ai.yaml +8 -11
- package/bundled/ai/standards/workflow-state-protocol.ai.yaml +8 -10
- package/bundled/core/adversarial-test.md +1 -1
- package/bundled/core/agent-behavior-discipline.md +4 -4
- package/bundled/core/agent-communication-protocol.md +5 -5
- package/bundled/core/circuit-breaker.md +4 -4
- package/bundled/core/container-security.md +8 -8
- package/bundled/core/disaster-recovery-drill.md +3 -3
- package/bundled/core/dual-phase-output.md +1 -1
- package/bundled/core/failure-source-taxonomy.md +3 -3
- package/bundled/core/git-worktree.md +1 -1
- package/bundled/core/governance-layer.md +151 -0
- package/bundled/core/llm-output-validation.md +2 -2
- package/bundled/core/mock-boundary.md +1 -1
- package/bundled/core/packaging-standards.md +14 -14
- package/bundled/core/policy-as-code-testing.md +9 -9
- package/bundled/core/recovery-recipe-registry.md +2 -2
- package/bundled/core/release-quality-manifest.md +2 -2
- package/bundled/core/sast-advanced.md +5 -5
- package/bundled/core/secure-op.md +5 -5
- package/bundled/core/security-decision.md +1 -1
- package/bundled/core/server-ops-security.md +15 -15
- package/bundled/core/smoke-test.md +1 -1
- package/bundled/core/standard-admission-criteria.md +1 -1
- package/bundled/core/standard-lifecycle-management.md +1 -1
- package/bundled/core/supply-chain-attestation.md +4 -4
- package/bundled/core/token-budget.md +3 -3
- package/bundled/locales/zh-CN/CHANGELOG.md +51 -4
- package/bundled/locales/zh-CN/README.md +11 -27
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +5 -5
- package/bundled/locales/zh-CN/core/circuit-breaker.md +1 -1
- package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
- package/bundled/locales/zh-CN/core/packaging-standards.md +14 -14
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +6 -9
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +1 -1
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +1 -1
- package/bundled/locales/zh-CN/core/token-budget.md +1 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +51 -4
- package/bundled/locales/zh-TW/README.md +11 -27
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +5 -5
- package/bundled/locales/zh-TW/core/capability-declaration.md +4 -4
- package/bundled/locales/zh-TW/core/circuit-breaker.md +7 -7
- package/bundled/locales/zh-TW/core/dual-phase-output.md +3 -3
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +7 -9
- package/bundled/locales/zh-TW/core/governance-layer.md +159 -0
- package/bundled/locales/zh-TW/core/packaging-standards.md +14 -14
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +6 -9
- package/bundled/locales/zh-TW/core/security-decision.md +3 -3
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +1 -1
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +1 -1
- package/bundled/locales/zh-TW/core/token-budget.md +3 -3
- package/bundled/skills/README.md +23 -0
- package/bundled/skills/atdd-assistant/SKILL.md +4 -5
- package/bundled/skills/bdd-assistant/SKILL.md +4 -5
- package/bundled/skills/checkin-assistant/SKILL.md +4 -6
- package/bundled/skills/code-review-assistant/SKILL.md +4 -5
- package/bundled/skills/commands/observability.md +42 -0
- package/bundled/skills/commands/runbook.md +44 -0
- package/bundled/skills/commands/slo.md +45 -0
- package/bundled/skills/journey-test-assistant/SKILL.md +1 -1
- package/bundled/skills/orchestrate/SKILL.md +1 -1
- package/bundled/skills/plan/SKILL.md +1 -1
- package/bundled/skills/pr-automation-assistant/SKILL.md +4 -5
- package/bundled/skills/push/SKILL.md +1 -1
- package/bundled/skills/spec-driven-dev/SKILL.md +4 -5
- package/bundled/skills/sweep/SKILL.md +3 -3
- package/bundled/skills/tdd-assistant/SKILL.md +4 -5
- package/package.json +1 -1
- package/src/commands/flow.js +7 -5
- package/src/commands/start.js +7 -6
- package/src/commands/sweep.js +7 -6
- package/src/commands/workflow.js +7 -6
- package/src/core/agent-communication-protocol.js +10 -3
- package/standards-registry.json +50 -50
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Agent Communication Protocol - DEPRECATED STUB
|
|
2
|
-
#
|
|
3
|
-
#
|
|
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:
|
|
18
|
-
canonical_path: "
|
|
17
|
+
canonical_owner: adoption-layer
|
|
18
|
+
canonical_path: "" # adoption-layer responsibility
|
|
19
19
|
source: core/agent-communication-protocol.md
|
|
20
20
|
description: >
|
|
21
|
-
DEPRECATED:
|
|
22
|
-
|
|
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
|
-
|
|
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 —
|
|
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
|
-
#
|
|
3
|
-
#
|
|
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:
|
|
18
|
-
canonical_path: "
|
|
17
|
+
canonical_owner: adoption-layer
|
|
18
|
+
canonical_path: "" # adoption-layer responsibility
|
|
19
19
|
source: core/agent-dispatch.md
|
|
20
20
|
description: >
|
|
21
|
-
DEPRECATED:
|
|
22
|
-
|
|
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
|
-
|
|
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 —
|
|
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
|
-
#
|
|
3
|
-
#
|
|
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:
|
|
18
|
-
canonical_path: "
|
|
17
|
+
canonical_owner: adoption-layer
|
|
18
|
+
canonical_path: "" # adoption-layer responsibility
|
|
19
19
|
source: core/branch-completion.md
|
|
20
20
|
description: >
|
|
21
|
-
DEPRECATED:
|
|
22
|
-
|
|
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
|
-
|
|
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 —
|
|
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
|
-
- "
|
|
104
|
-
- "
|
|
105
|
-
- "
|
|
106
|
-
- "
|
|
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
|
-
#
|
|
3
|
-
#
|
|
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:
|
|
18
|
-
canonical_path: "
|
|
17
|
+
canonical_owner: adoption-layer
|
|
18
|
+
canonical_path: "" # adoption-layer responsibility
|
|
19
19
|
source: core/change-batching-standards.md
|
|
20
20
|
description: >
|
|
21
|
-
DEPRECATED:
|
|
22
|
-
|
|
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
|
-
|
|
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 —
|
|
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
|
|
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
|
-
- "
|
|
84
|
-
- "
|
|
85
|
-
- "
|
|
86
|
-
- "
|
|
87
|
-
- "
|
|
88
|
-
- "
|
|
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
|
-
- "
|
|
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
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
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
|
-
#
|
|
3
|
-
#
|
|
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:
|
|
18
|
-
canonical_path: "
|
|
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:
|
|
22
|
-
|
|
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
|
-
|
|
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 —
|
|
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
|
-
- "
|
|
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
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
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"
|
|
@@ -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 (
|
|
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: "
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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 .
|
|
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
|
-
#
|
|
3
|
-
#
|
|
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:
|
|
18
|
-
canonical_path: "
|
|
17
|
+
canonical_owner: adoption-layer
|
|
18
|
+
canonical_path: "" # adoption-layer responsibility
|
|
19
19
|
source: core/pipeline-integration-standards.md
|
|
20
20
|
description: >
|
|
21
|
-
DEPRECATED:
|
|
22
|
-
|
|
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
|
-
|
|
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 —
|
|
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
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
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
|
-
- "
|
|
80
|
-
- "
|
|
81
|
-
- "
|
|
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/
|
|
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)
|